Skip to content

add asyncio guide for Free-Threaded Python#150456

Open
kumaraditya303 wants to merge 3 commits into
python:mainfrom
kumaraditya303:asyncio-threadsafety
Open

add asyncio guide for Free-Threaded Python#150456
kumaraditya303 wants to merge 3 commits into
python:mainfrom
kumaraditya303:asyncio-threadsafety

Conversation

@kumaraditya303
Copy link
Copy Markdown
Contributor

No description provided.

@read-the-docs-community
Copy link
Copy Markdown

read-the-docs-community Bot commented May 26, 2026

Documentation build overview

📚 cpython-previews | 🛠️ Build #32850770 | 📁 Comparing 308ce2b against main (629da5c)

  🔍 Preview build  

2 files changed
+ library/asyncio-threading.html
± library/asyncio.html

Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
Comment thread Doc/library/asyncio-threading.rst Outdated
kumaraditya303 and others added 2 commits May 26, 2026 15:31
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
@kumaraditya303 kumaraditya303 added needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes labels May 26, 2026
pool, but that is still limited by the :term:`global interpreter lock`
in CPython.

However, with :pep:`703`, Python can now be built in a "free-threaded"
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Let's find doc references instead of PEPs to help people understand free-threading.

I/O-bound concurrency by switching between tasks during non-blocking I/O
operations. It allows off-loading CPU-bound work to a thread or process
pool, but that is still limited by the :term:`global interpreter lock`
in CPython.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Perhaps we can say a bit more about when asyncio+threads makes sense and when it does not.

@bedevere-app
Copy link
Copy Markdown

bedevere-app Bot commented May 26, 2026

When you're done making the requested changes, leave the comment: I have made the requested changes; please review again.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting changes docs Documentation in the Doc dir needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes skip issue skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants