◐ Shell
reader mode source ↗
Skip to content

gh-146636: Add Free-threaded Stable ABI migration guide#150580

Merged
encukou merged 27 commits into
python:mainfrom
encukou:abi3t-migration-sq
Jun 3, 2026
Merged

gh-146636: Add Free-threaded Stable ABI migration guide#150580
encukou merged 27 commits into
python:mainfrom
encukou:abi3t-migration-sq

Conversation

@encukou

@encukou encukou commented May 29, 2026 •
edited by bedevere-app Bot
Loading

Copy link
Copy Markdown
Member

clin1234 and others added 20 commits May 17, 2026 05:33
@clin1234
Add reference to freethreading-stable-abi-howto
8040796
@clin1234
Add documentation for Free Threading Stable ABI usage …
7175e14 
This document provides detailed instructions on how to use the Free Threading Stable ABI in CPython, including guidelines for module initialization, API usage, and thread safety considerations.
@clin1234
Update documentation on PyObject opaqueness and module init …
e0f3bd2 
Clarified access restrictions on PyObject members and recommended functions for type and reference count manipulation.
@clin1234
Fix formatting for PyObject opaqueness section
3739aec
@clin1234
Fix formatting of code snippet in documentation
c235a75
@clin1234
Update documentation on PyObject opaqueness …
753156b 
Clarified that direct access to PyObject members is prohibited.
@clin1234 @da-woods
Py_Type …
344105e 
Co-authored-by: da-woods <dw-git@d-woods.co.uk>
@clin1234
Clarify free-threaded limited API build documentation …
29b932d 
Updated documentation to clarify the identification of free-threaded limited API builds in C, including changes to macros and initialization methods.
@clin1234
Revise freethreading-stable-abi.rst for clarity …
8545eeb 
Updated the documentation to clarify the use of the stable ABI and GIL management in Python extensions, including changes to member access and initialization methods.
@clin1234
Add freethreading-stable-abi.rst to documentation index
2a11368
@clin1234
Simplify threading and API guidelines in documentation …
2f2e756 
Removed sections on API guidelines, critical sections, and thread safety from the documentation.
@clin1234
Update freethreading-stable-abi.rst
5d23810
@clin1234
Update freethreading-stable-abi.rst
a8294fa
@clin1234
Update freethreading-stable-abi.rst
43538cf
@clin1234
Update module slot definitions to use PySlot from PEP 820
ed0e4fe
@clin1234
Update freethreading-stable-abi.rst
a7fcbcc
@clin1234
Fix typo in freethreading-stable-abi.rst
ccdedb0
@clin1234
Update freethreading-stable-abi.rst
3b401db
@encukou
Merge in the main branch
a7fdaaf
@encukou
Rewrite as a guide
cb9545a
@bedevere-app bedevere-app Bot mentioned this pull request May 29, 2026
Open
9 tasks
@encukou encukou mentioned this pull request May 29, 2026
Closed
@read-the-docs-community

read-the-docs-community Bot commented May 29, 2026 •
edited
Loading

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #32953252 | 📁 Comparing 51a55ac against main (26696a6)

  🔍 Preview build  

38 files changed · + 1 added · ± 37 modified

+ Added

± Modified

@ngoldbaum

ngoldbaum commented May 29, 2026

Copy link
Copy Markdown
Contributor

Thanks, this looks great! I'll probably use the tables in my EuroPython talk.

I'm hopeful that we'll be able to ship abi3t support in the next releases of PyO3 and Maturin (see PyO3/pyo3#5807 and PyO3/maturin#3113).

I am also planning to add a section to the free-threaded guide about building abi3t extensions, including practicalities like dealing with bindings generators and the NumPy C API. When that is ready, maybe we can just link there for all the ecosystem-wide details that don't belong in the CPython docs?

@encukou encukou mentioned this pull request Jun 1, 2026
Merged
encukou and others added 3 commits June 1, 2026 14:15
@encukou @da-woods @StanFromIreland
Apply suggestions from code review …
fcc553a 
Co-authored-by: da-woods <dw-git@d-woods.co.uk>
Co-authored-by: Stan Ulbrych <stan@python.org>
@encukou
Address reviews
6d8dc71
@encukou
Add link to What's New
d89c007
@encukou

encukou commented Jun 1, 2026

Copy link
Copy Markdown
Member Author

Thanks for the reviews and suggestions!

I am also planning to add a section to the free-threaded guide about building abi3t extensions, including practicalities like dealing with bindings generators and the NumPy C API. When that is ready, maybe we can just link there for all the ecosystem-wide details that don't belong in the CPython docs?

That sounds great!

encukou and others added 2 commits June 2, 2026 13:41
@encukou @hugovk
Apply suggestions from code review …
370ef9b 
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
@encukou
Remove heading-like incomplete sentence
51a55ac
@encukou encukou mentioned this pull request Jun 2, 2026
Closed
@encukou

encukou commented Jun 3, 2026

Copy link
Copy Markdown
Member Author

I'll merge now; any improvements can go in separate PRs.

Hide details View details @encukou encukou merged commit c720e18 into python:main Jun 3, 2026
30 checks passed
@encukou encukou added awaiting core review needs backport to 3.15 pre-release feature fixes, bugs and security fixes labels Jun 3, 2026
@miss-islington-app

miss-islington-app Bot commented Jun 3, 2026

Copy link
Copy Markdown

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

@encukou encukou deleted the abi3t-migration-sq branch June 3, 2026 12:02
@bedevere-app

bedevere-app Bot commented Jun 3, 2026

Copy link
Copy Markdown

GH-150844 is a backport of this pull request to the 3.15 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 pre-release feature fixes, bugs and security fixes label Jun 3, 2026
hugovk added a commit that referenced this pull request Jun 3, 2026
@miss-islington @encukou
@clin1234 @da-woods @StanFromIreland @hugovk
[3.15] gh-146636: Add Free-threaded Stable ABI migration guide (GH-15… …
24f5d3d 
…0580) (#150844)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Charlie Lin <tuug@gmx.us>
Co-authored-by: da-woods <dw-git@d-woods.co.uk>
Co-authored-by: Stan Ulbrych <stan@python.org>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
philthompson10 pushed a commit to philthompson10/cpython that referenced this pull request Jun 17, 2026
@encukou @clin1234
@da-woods @StanFromIreland @hugovk @philthompson10
pythongh-146636: Add Free-threaded Stable ABI migration guide (python… …
7c4b466 
…GH-150580)

Co-authored-by: Charlie Lin <tuug@gmx.us>
Co-authored-by: da-woods <dw-git@d-woods.co.uk>
Co-authored-by: Stan Ulbrych <stan@python.org>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@hugovk hugovk hugovk left review comments

@StanFromIreland StanFromIreland StanFromIreland left review comments

@AA-Turner AA-Turner Awaiting requested review from AA-Turner AA-Turner is a code owner

+1 more reviewer

@da-woods da-woods da-woods left review comments

Assignees

No one assigned

Labels

awaiting core review skip news

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

6 participants

@encukou @ngoldbaum @hugovk @da-woods @StanFromIreland @clin1234