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

Commits on Apr 29, 2026

Merge branch 'main' into pep-788
encukou
authored
f95bfc7
Copy full SHA for f95bfc7
Apply suggestions from code review
Show description for a00bfbb

ZeroIntensity
and
encukou
authored
a00bfbb
Copy full SHA for a00bfbb
Update Doc/c-api/threads.rst
Show description for 6ca2499

ZeroIntensity
and
encukou
authored
6ca2499
Copy full SHA for 6ca2499
Fix lint and remove dead comment.
ZeroIntensity
committed
74259f8
Copy full SHA for 74259f8
Improve new PyThreadState API docs.
Show description for eff9b40

ZeroIntensity
and
encukou
committed
eff9b40
Copy full SHA for eff9b40
Fix lint.
ZeroIntensity
committed
bc78c10
Copy full SHA for bc78c10

Commits on Apr 30, 2026

Apply suggestions from code review
Show description for 0a30c25

ZeroIntensity
and
encukou
authored
0a30c25
Copy full SHA for 0a30c25
Update Doc/c-api/threads.rst
Show description for fe3d8a1

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

Commits on May 1, 2026

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

Commits on May 4, 2026

Merge in the main branch
encukou
committed
eb73203
Copy full SHA for eb73203
Switch to PyThreadStateToken
encukou
committed
09a0d69
Copy full SHA for 09a0d69
Remove ensure_tstate_is_valid
encukou
committed
5a3f808
Copy full SHA for 5a3f808
Merge in the main branch
encukou
committed
d43ba9d
Copy full SHA for d43ba9d
Apply suggestions from code review
Show description for 9a04e93

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

Commits on May 5, 2026

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

ZeroIntensity
and
colesbury
authored
5e25ba9
Copy full SHA for 5e25ba9
Update Python/pylifecycle.c
Show description for 08e845c

ZeroIntensity
and
colesbury
authored
08e845c
Copy full SHA for 08e845c
Update Doc/c-api/interp-lifecycle.rst
Show description for 17b0e2a

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

Commits on May 6, 2026

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