gh-146636: Add Free-threaded Stable ABI migration guide by encukou · Pull Request #150580 · python/cpython

clin1234

and others added 20 commits

May 17, 2026 05:33

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.

Clarified access restrictions on PyObject members and recommended functions for type and reference count manipulation.

Clarified that direct access to PyObject members is prohibited.

Co-authored-by: da-woods <dw-git@d-woods.co.uk>

Updated documentation to clarify the identification of free-threaded limited API builds in C, including changes to macros and initialization methods.

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.

Removed sections on API guidelines, critical sections, and thread safety from the documentation.

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>
Co-authored-by: Petr Viktorin <encukou@gmail.com>

encukou deleted the abi3t-migration-sq branch

June 3, 2026 12:02

hugovk added a commit that referenced this pull request

Jun 3, 2026

…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

…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>