Skip to content

gh-135944: Add a "Runtime Components" Section to the Execution Model Docs - #135945

Merged
ericsnowcurrently merged 23 commits into
python:mainfrom
ericsnowcurrently:exec-model-runtime-components
Oct 2, 2025
Merged

gh-135944: Add a "Runtime Components" Section to the Execution Model Docs#135945
ericsnowcurrently merged 23 commits into
python:mainfrom
ericsnowcurrently:exec-model-runtime-components

Conversation

@ericsnowcurrently

@ericsnowcurrentlyericsnowcurrently commented Jun 25, 2025•
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Member

The section provides a brief overview of the Python runtime's execution environment.

This is meant to be implementation agnostic, If that doesn't hold true then we should take a different approach.

📚 Documentation preview 📚: https://cpython-previews--135945.org.readthedocs.build/

@ericsnowcurrentlyericsnowcurrently added skip news needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes labels Jun 25, 2025
@bedevere-appbedevere-appBot added awaiting core review docs Documentation in the Doc dir labels Jun 25, 2025
@bedevere-appbedevere-appBot mentioned this pull request Jun 25, 2025
Closed
ZeroIntensity
ZeroIntensity reviewed Jun 25, 2025
View reviewed changes
Comment threadDoc/reference/executionmodel.rst
Comment threadDoc/reference/executionmodel.rst Outdated
neonene
neonene reviewed Jun 26, 2025
View reviewed changes
Comment threadDoc/reference/executionmodel.rst Outdated
Comment threadDoc/reference/executionmodel.rst Outdated
@ericsnowcurrently

ericsnowcurrently commented Jun 27, 2025

Copy link
Copy Markdown
MemberAuthor

FWIW, I'm going to open a DPO thread about this addition before merging, to make sure there's sufficient visibility.

@ericsnowcurrently

ericsnowcurrently commented Jun 27, 2025

Copy link
Copy Markdown
MemberAuthor

https://discuss.python.org/t/96922

jeff5
jeff5 reviewed Jun 30, 2025
View reviewed changes

@jeff5jeff5 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very much support the idea of clearly explaining this. I hope the comments are not too ignorant to be useful.

Comment threadDoc/reference/executionmodel.rst
Comment threadDoc/reference/executionmodel.rst Outdated
Comment threadDoc/reference/executionmodel.rst Outdated
Comment threadDoc/reference/executionmodel.rst Outdated
Comment threadDoc/reference/executionmodel.rst Outdated
Comment threadDoc/reference/executionmodel.rst
@ericsnowcurrently

ericsnowcurrently commented Jun 30, 2025

Copy link
Copy Markdown
MemberAuthor

@gpshead, I've updated the PR to address your comments at https://discuss.python.org/t/proposal-add-text-to-the-language-reference-about-runtime-components/96922/2, Thanks!

@jeff5

jeff5 commented Jul 1, 2025

Copy link
Copy Markdown
Contributor

Thanks @ericsnowcurrently for giving this so much thought. All good by me. Ping me if I ought to signify this myself by resolving each.

@ericsnowcurrently

ericsnowcurrently commented Sep 25, 2025

Copy link
Copy Markdown
MemberAuthor

FYI, given the nice break I had from this change, I came back to with fresh eyes and found ways I think it could be more clear.

@ericsnowcurrently

ericsnowcurrently commented Sep 29, 2025

Copy link
Copy Markdown
MemberAuthor

@ncoghlan, do you have any thoughts about this new section?

FWIW, my intent is to keep the section implementation-agnostic, even if some of the terminology comes from CPython. The described concepts are meant to be conceptual, even if they correspond closely to concrete implementation details.

@ericsnowcurrently

ericsnowcurrently commented Sep 29, 2025

Copy link
Copy Markdown
MemberAuthor

I have toyed with the idea of specifying what it means to "call into Python", but that can be addressed separately, if at all.

ncoghlan
ncoghlan approved these changes Sep 30, 2025
View reviewed changes

@ncoghlanncoghlan left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Couple of minor comments inline, but nothing I'd consider merge blocking.

Comment threadDoc/reference/executionmodel.rst Outdated
Comment threadDoc/reference/executionmodel.rst Outdated
@ncoghlan

ncoghlan commented Sep 30, 2025

Copy link
Copy Markdown
Contributor

I have toyed with the idea of specifying what it means to "call into Python", but that can be addressed separately, if at all.

If you tried to cover all the subtleties, I think you'd end up with something three times as long that was actually worse for the primary topic you're aiming to address (giving folks that aren't already familiar with the way threads and processes work in general the gist of how they work for Python in particular).

@jeff5

jeff5 commented Oct 2, 2025•
edited
Loading

Copy link
Copy Markdown
Contributor

This is really helpful to my understanding, especially of the possible multiplicity (or not) of relationships amongst the separate concepts. It's hard to express this kind of thing accurately and independent of a particular implementation, but I think you have. Thanks for the hard work.

@ericsnowcurrently
ericsnowcurrently merged commit 46a1f0a into python:mainOct 2, 2025
27 checks passed
@github-project-automationgithub-project-automationBot moved this from Todo to Done in Docs PRsOct 2, 2025
@miss-islington-app

miss-islington-appBot commented Oct 2, 2025

Copy link
Copy Markdown

Thanks @ericsnowcurrently for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖

@ericsnowcurrently
ericsnowcurrently deleted the exec-model-runtime-components branch October 2, 2025 15:13
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Oct 2, 2025
@ericsnowcurrently@miss-islington
pythongh-135944: Add a "Runtime Components" Section to the Execution …
5478c7f
…Model Docs (pythongh-135945)
The section provides a brief overview of the Python runtime's execution environment. It is meant to be implementation agnostic,
(cherry picked from commit 46a1f0a)
Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Oct 2, 2025
@ericsnowcurrently@miss-islington
pythongh-135944: Add a "Runtime Components" Section to the Execution …
047136b
…Model Docs (pythongh-135945)
The section provides a brief overview of the Python runtime's execution environment. It is meant to be implementation agnostic,
(cherry picked from commit 46a1f0a)
Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
@bedevere-app

bedevere-appBot commented Oct 2, 2025

Copy link
Copy Markdown

GH-139509 is a backport of this pull request to the 3.14 branch.

@bedevere-appbedevere-appBot removed the needs backport to 3.14 bugs and security fixes label Oct 2, 2025
@bedevere-app

bedevere-appBot commented Oct 2, 2025

Copy link
Copy Markdown

GH-139510 is a backport of this pull request to the 3.13 branch.

@bedevere-appbedevere-appBot removed the needs backport to 3.13 bugs and security fixes label Oct 2, 2025
AA-Turner pushed a commit that referenced this pull request Oct 7, 2025
@miss-islington@ericsnowcurrently
[3.14]gh-135944: Add a "Runtime Components" Section to the Execution…
9eee7fe
… Model Docs (gh-135945) (#139509)
gh-135944: Add a "Runtime Components" Section to the Execution Model Docs (gh-135945)
The section provides a brief overview of the Python runtime's execution environment. It is meant to be implementation agnostic,
(cherry picked from commit 46a1f0a)
Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
@m-aciekm-aciek mentioned this pull request Oct 29, 2025
Merged
pablogsal pushed a commit that referenced this pull request Apr 30, 2026
@miss-islington@ericsnowcurrently
@Yhg1s@kumaraditya303@vstinner
[3.13]gh-135944: Add a "Runtime Components" Section to the Execution…
c38c463
… Model Docs (gh-135945) (#139510)
* gh-135944: Add a "Runtime Components" Section to the Execution Model Docs (gh-135945)
The section provides a brief overview of the Python runtime's execution environment. It is meant to be implementation agnostic,
(cherry picked from commit 46a1f0a)
Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
* concurrent.interpreters was added to Python 3.14
---------
Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
Co-authored-by: T. Wouters <thomas@python.org>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Victor Stinner <vstinner@python.org>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@ZeroIntensityZeroIntensityZeroIntensity left review comments
@ncoghlanncoghlanncoghlan approved these changes
@willingcwillingcAwaiting requested review from willingcwillingc is a code owner
@AA-TurnerAA-TurnerAwaiting requested review from AA-TurnerAA-Turner is a code owner
+2 more reviewers
@jeff5jeff5jeff5 left review comments
@neoneneneoneneneonene left review comments
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

docsDocumentation in the Doc dirskip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@ericsnowcurrently@jeff5@ncoghlan@ZeroIntensity@neonene