gh-134939: Fill Out the concurrent.interpreters Docs by ericsnowcurrently · Pull Request #135902 · python/cpython

ericsnowcurrently · 2025-06-24T20:08:51Z

Issue: Add the interpreters Module, Implementing PEP 734 #134939

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

auvipy

I'm not sure if the double spaces were intended or not. so suggested some edits....

StanFromIreland · 2025-06-25T08:19:55Z

@auvipy I presume Eric is using emacs, the double spaces are fine and conform to many technical writing style guides IIRC. You will find many occurrences throughout out the docs.

auvipy · 2025-06-25T08:21:24Z

Interesting! Didn’t know that to be honest

ericsnowcurrently · 2025-06-25T15:30:17Z

Using double space between sentences is fairly standard. Traditionally the practice was meant to introduce a stronger visual separation between sentences, to help readers identify the boundary. Using a single space is a relatively recent practice, one that reflects an assumption that the software which renders (lays out) the text, like a browser, will render the inter-sentence boundary sufficiently distinctly. However, in my experience that isn't what actually happens most of the time. (Plus, the same software could just as easily detect the double space and render it how it likes.) Furthermore, text editors in particular don't necessarily follow this practice. For example, I use a fixed-width font in my terminal. Ultimately, any time the the text is rendered naively this way, it presents a readability challenge. Thus, I avoid using a single space between sentences.

StanFromIreland · 2025-06-25T15:52:21Z

Traditionally

Very, historically started when type writers where introduced :-)

neonene · 2025-06-26T10:03:08Z

+Running mostly involves switching to an interpreter (in the current
+thread) and calling a function in that execution context.


I'd like a reference to the "Runtime Components" section after #135944 is landed, regarding the OS thread?

Places like these are a large part of why I opened that issue. 😄

neonene · 2025-06-26T10:05:05Z

+* :class:`float`
+* :class:`tuple` (of similarly supported objects)
+
+There is a small number of Python types that actually share mutable


Suggested change
There is a small number of Python types that actually share mutable
There are a small number of Python types that actually share mutable

The subject of the verb is "a small number", which is singular. Otherwise, I'd agree that "There are Python types that..." would be correct.

Co-authored-by: neonene <53406459+neonene@users.noreply.github.com>

ericsnowcurrently · 2025-06-27T16:51:26Z

Unless there are any major objections, I'd like to land this today;, I have a "multiple interpreters HOWTO" branch, on top of this change, that I want to put up for review. If there are little things to tweak, I think we can take care of that in a follow-up PR.

miss-islington-app · 2025-06-30T16:54:56Z

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

…135902) (cherry picked from commit fc82cb9) Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

bedevere-app · 2025-06-30T16:55:06Z

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

(cherry picked from commit fc82cb9, AKA gh-135902) Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

…135902)

ericsnowcurrently added 7 commits June 20, 2025 15:58

Expand interpreters module doc introduction.
e146e84

Add docs for Queue and create_queue().
c1acf93

Drop references to object sharing.
d41d8c7

Add info about object sharing.
9c6defc

Elaborate about the main interpreter.
8f5e90f

Clarify about the ID.
d96ed19

Add an extra example.
fe0ce84

ericsnowcurrently added skip news needs backport to 3.14 bugs and security fixes labels Jun 24, 2025

bedevere-appBot added awaiting core review docs Documentation in the Doc dir labels Jun 24, 2025

github-project-automationBot added this to Docs PRs Jun 24, 2025

github-project-automationBot moved this to Todo in Docs PRs Jun 24, 2025

bedevere-appBot mentioned this pull request Jun 24, 2025
Add the interpreters Module, Implementing PEP 734 #134939
Open
4 tasks

Fix a ref.
543363b

auvipy suggested changes Jun 25, 2025
View reviewed changes

neonene reviewed Jun 26, 2025
View reviewed changes

Fix typos.
7cbd933
Co-authored-by: neonene <53406459+neonene@users.noreply.github.com>

ericsnowcurrently merged commit fc82cb9 into python:mainJun 30, 2025
25 checks passed

github-project-automationBot moved this from Todo to Done in Docs PRs Jun 30, 2025

bedevere-appBot removed the awaiting core review label Jun 30, 2025

ericsnowcurrently deleted the interp-module-docs branch June 30, 2025 16:54

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Jun 30, 2025
pythongh-134939: Fill Out the concurrent.interpreters Docs (pythongh-…
d40c6a8
…135902) (cherry picked from commit fc82cb9) Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

bedevere-appBot removed the needs backport to 3.14 bugs and security fixes label Jun 30, 2025

ericsnowcurrently added a commit that referenced this pull request Jun 30, 2025
[3.14]gh-134939: Fill Out the concurrent.interpreters Docs (gh-136141)
ebab7c8
(cherry picked from commit fc82cb9, AKA gh-135902) Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

AndPuQing pushed a commit to AndPuQing/cpython that referenced this pull request Jul 11, 2025
pythongh-134939: Fill Out the concurrent.interpreters Docs (pythongh-…
764ecdc
…135902)

Pranjal095 pushed a commit to Pranjal095/cpython that referenced this pull request Jul 12, 2025
pythongh-134939: Fill Out the concurrent.interpreters Docs (pythongh-…
9b50a95
…135902)

picnixz pushed a commit to picnixz/cpython that referenced this pull request Jul 13, 2025
pythongh-134939: Fill Out the concurrent.interpreters Docs (pythongh-…
f34b9e2
…135902)

taegyunkim pushed a commit to taegyunkim/cpython that referenced this pull request Aug 4, 2025
pythongh-134939: Fill Out the concurrent.interpreters Docs (pythongh-…
9eb433a
…135902)

Agent-Hellboy pushed a commit to Agent-Hellboy/cpython that referenced this pull request Aug 19, 2025
pythongh-134939: Fill Out the concurrent.interpreters Docs (pythongh-…
64acf8c
…135902)

		Running mostly involves switching to an interpreter (in the current
		thread) and calling a function in that execution context.

	There is a small number of Python types that actually share mutable
	There are a small number of Python types that actually share mutable

Uh oh!

Uh oh!

Conversation

ericsnowcurrently commented Jun 24, 2025• edited by github-actions BotLoading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

auvipy left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

StanFromIreland commented Jun 25, 2025

Uh oh!

auvipy commented Jun 25, 2025

Uh oh!

ericsnowcurrently commented Jun 25, 2025

Uh oh!

StanFromIreland commented Jun 25, 2025

Uh oh!

neoneneJun 26, 2025

Choose a reason for hiding this comment

Uh oh!

ericsnowcurrentlyJun 26, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

neoneneJun 26, 2025

Choose a reason for hiding this comment

Uh oh!

ericsnowcurrentlyJun 26, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

ericsnowcurrently commented Jun 27, 2025

Uh oh!

Uh oh!

miss-islington-appBot commented Jun 30, 2025

Uh oh!

bedevere-appBot commented Jun 30, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

ericsnowcurrently commented Jun 24, 2025•
edited by github-actions Bot
Loading