gh-149101: Implement PEP 788 - #149116

Merged

ZeroIntensity merged 93 commits into

python:mainfrom

ZeroIntensity:pep-788

May 6, 2026

Commits on Apr 28, 2026

Copy the reference implementation.
ZeroIntensity
committed
43b0798
Merge branch 'main' of https://github.com/python/cpython into pep-788
ZeroIntensity
committed
722dbdf
Document the new APIs.
ZeroIntensity
committed
73cccbb
Add a whatsnew entry.
ZeroIntensity
committed
25e1cf0
Fix stable ABI things.
ZeroIntensity
committed
af1022a
Fix test_embed.
ZeroIntensity
committed
2fb8419
SIlly news entry.
ZeroIntensity
committed
1096a32
Documentation fixes.
ZeroIntensity
committed
407062f
Make the sentinel const instead of changing the C analyzer.
ZeroIntensity
committed
a33bdfc
Fix the html IDs job.
ZeroIntensity
committed
c504a9f

Commits on Apr 29, 2026

Merge branch 'main' into pep-788
encukou
authored
f95bfc7
Apply suggestions from code review

ZeroIntensity
and
encukou
authored
a00bfbb
Update Doc/c-api/threads.rst

ZeroIntensity
and
encukou
authored
6ca2499
Fix lint and remove dead comment.
ZeroIntensity
committed
74259f8
Improve new PyThreadState API docs.

ZeroIntensity
and
encukou
committed
eff9b40
Fix lint.
ZeroIntensity
committed
bc78c10

Commits on Apr 30, 2026

Apply suggestions from code review

ZeroIntensity
and
encukou
authored
0a30c25
Update Doc/c-api/threads.rst

ZeroIntensity
and
encukou
authored
fe3d8a1
Fix line endings.
ZeroIntensity
committed
ad69f96
Remove accidental formatting changes.
ZeroIntensity
committed
1623556
Fix memory ordering for the event reset.
ZeroIntensity
committed
cad8786
Improve NO_TSTATE_SENTINEL.
ZeroIntensity
committed
e042656
Fix some test things.
ZeroIntensity
committed
6a05c90
Remove note about deallocation.
ZeroIntensity
committed
728ee3a
Explicitly mark implementation details in the docs.
ZeroIntensity
committed
d9e1170
Add missing versionadded markers.
ZeroIntensity
committed
2f824d3
Remove dead comment.
ZeroIntensity
committed
ab9d783
Merge branch 'main' of https://github.com/python/cpython into pep-788
ZeroIntensity
committed
10e241e

Commits on May 1, 2026

Some improvements to PyThreadState_Release() based on review.
ZeroIntensity
committed
25687af
Add a comment.
ZeroIntensity
committed
6d3b40a
Remove _ prefix from struct names.
ZeroIntensity
committed
0c08141
Only issue a fatal error for KeyboardInterrupt.
ZeroIntensity
committed
31f1155
Don't use a full PyThreadState for NO_TSTATE_SENTINEL on release builds.
ZeroIntensity
committed
6c62b40
Fix race during event spinning.
ZeroIntensity
committed
d8ce02d
Merge branch 'main' of https://github.com/python/cpython into pep-788
ZeroIntensity
committed
e105120

Commits on May 4, 2026

Merge in the main branch
encukou
committed
eb73203
Switch to PyThreadStateToken
encukou
committed
09a0d69
Remove ensure_tstate_is_valid
encukou
committed
5a3f808
Merge in the main branch
encukou
committed
d43ba9d
Apply suggestions from code review

ZeroIntensity
and
colesbury
authored
9a04e93
Simply exit instead of emitting a fatal error upon CTRL^C.
ZeroIntensity
committed
a382721
Hardcode zero as the main interpreter ID.
ZeroIntensity
committed
03862fb
Fix leak in get_main_interp_guard.
ZeroIntensity
committed
df720a5
Improve readability and fix warning.
ZeroIntensity
committed
767c894
Use void instead of a struct for PyThreadStateToken.
ZeroIntensity
committed
38a2153
Run test_embed with TSan.
ZeroIntensity
committed
321c783

Commits on May 5, 2026

Switch to a single atomic field instead of using locks and events.
ZeroIntensity
committed
811ca19
Fix existing thread-safety issue with interp_has_threads().
ZeroIntensity
committed
ac58a16
Use the parking lot to avoid eating CPU cycles.
ZeroIntensity
committed
4ced3a1
Stupid merge conflicts.
ZeroIntensity
committed
9345afd
Fix C analyzer.
ZeroIntensity
committed
11cbe5c
Stupid warnings.
ZeroIntensity
committed
99098d7
Fix thread leaks in test_embed.
ZeroIntensity
committed
1c184f1
Fix deadlock in test_atexit.
ZeroIntensity
committed
af57d9d
Fix missing newline.
ZeroIntensity
committed
7289037
Remove stray newline change from pycore_lock.h
ZeroIntensity
committed
a538acc
Use sequential memory ordering in _testembed.
ZeroIntensity
committed
4bec1e7
Potentially fix some things?
ZeroIntensity
committed
5d28e1a
Add a test stressing a lot of threads against finalization.
ZeroIntensity
committed
62b137e
Export _Py_yield.
ZeroIntensity
committed
2378c88
Fix race in interp_has_threads.
ZeroIntensity
committed
e7466f1
Fix formatting.
ZeroIntensity
committed
5d797cf
Merge branch 'main' of https://github.com/python/cpython into pep-788
ZeroIntensity
committed
5f1d2e0
Close owned guards before deleting them, not after.
ZeroIntensity
committed
4b446e7
Add assertions to ensure that the guard count is zero upon reinitialization.
ZeroIntensity
committed
b4db0a6
Move PyInterpreterGuard_Close call to after the deletion again.
ZeroIntensity
committed
c43cae7
Update Python/pystate.c

ZeroIntensity
and
colesbury
authored
5e25ba9
Update Python/pylifecycle.c

ZeroIntensity
and
colesbury
authored
08e845c
Update Doc/c-api/interp-lifecycle.rst

ZeroIntensity
and
colesbury
authored
17b0e2a
Use PyThreadStateToken in the example.
ZeroIntensity
committed
f60d888
Merge branch 'pep-788' of https://github.com/zerointensity/cpython into pep-788
ZeroIntensity
committed
dd930ef
Fix swapped links the whatsnew.
ZeroIntensity
committed
7aa2f65
Fix failure note + use affirmative tone in PyInterpreterView_FromMain docs.
ZeroIntensity
committed
541169d
Remove usage of _Py_yield.
ZeroIntensity
committed
d75e6d9
Fix issue with re-entrant clearing.
ZeroIntensity
committed
9f7b014
Remove needless calls to _PyThreadState_Attach/_PyThreadState_Detach.
ZeroIntensity
committed
f9cb8f7
Simplify locking in make_pre_finalization_calls.
ZeroIntensity
committed
29fa419
Fix a few other bugs.
ZeroIntensity
committed
211edf1
Move some tests to _testinternalcapi.
ZeroIntensity
committed
aaa516e
Add a test stressing detachment behavior.
ZeroIntensity
committed
e1da86c
Fix unused test.
ZeroIntensity
committed
95cdd3a
Release the GIL while joining the thread in test_thread_state_release_with_destructor.
ZeroIntensity
committed
e203fd5

Commits on May 6, 2026

Fix detached gilstates being attached upon release.
ZeroIntensity
committed
3987445
Don't use an actual thread for test_thread_state_release_with_destructor.
ZeroIntensity
committed
45d6ece
Remove dead comment.
ZeroIntensity
committed
319b700
Fix the C analyzer yet again.
ZeroIntensity
committed
a34dbc6
Merge branch 'main' of https://github.com/python/cpython into pep-788
ZeroIntensity
committed
9e48209
Fix whatsnew reference.
ZeroIntensity
committed
59e2d9a
Fix typos.
ZeroIntensity
committed
7a6cc0c
Fix test name.
ZeroIntensity
committed
0945129
Avoid using a second sentinel.
ZeroIntensity
committed
c5148d1
Do the compare-exchange under the head lock.
ZeroIntensity
committed
adb985f
Don't try to clear owned_guard in PyThreadState_Clear().
ZeroIntensity
committed
53fa94b