https://github.com/python/cpython/commit/5bde996950f5cd4a76c3736f5711dcd453029f28
commit: 5bde996950f5cd4a76c3736f5711dcd453029f28
branch: main
author: Victor Stinner <[email protected]>
committer: encukou <[email protected]>
date: 2026-09-23T13:07:11Z
summary:
gh-148233: Group stable_abi.toml entries per Python version (GH-157990)
files:
M Misc/stable_abi.toml
diff --git a/Misc/stable_abi.toml b/Misc/stable_abi.toml
index 36d4f094f9e85a..8ae17142dcc67a 100644
--- a/Misc/stable_abi.toml
+++ b/Misc/stable_abi.toml
@@ -95,6 +95,8 @@
windows = 'maybe'
+### Python 3.2 (initial version) ############################################
+
# Mentioned in PEP 384:
[struct.PyObject]
@@ -627,8 +629,6 @@
added = '3.2'
[function.PyErr_Display]
added = '3.2'
-[function.PyErr_DisplayException]
- added = '3.12'
[function.PyErr_ExceptionMatches]
added = '3.2'
[function.PyErr_Fetch]
@@ -735,8 +735,6 @@
added = '3.2'
[data.PyExc_BaseException]
added = '3.2'
-[data.PyExc_BaseExceptionGroup]
- added = '3.11'
[data.PyExc_BufferError]
added = '3.2'
[data.PyExc_BytesWarning]
@@ -1867,6 +1865,9 @@
[function.PyThread_start_new_thread]
added = '3.2'
+
+### Python 3.3 ##############################################################
+
# The following were added in PC/python3.def in Python 3.3:
# 7800f75827b1be557be16f3b18f5170fbf9fae08
# 9c56409d3353b8cd4cfc19e0467bbe23fd34fc92
@@ -1896,6 +1897,9 @@
[function.PyThread_GetInfo]
added = '3.3'
+
+### Python 3.4 ##############################################################
+
# The following were added in PC/python3.def in Python 3.4:
# 3ba3a3ee56c142e93d6bbe20ff6bf939212a30f0
@@ -1904,6 +1908,9 @@
[function.PyType_GetSlot]
added = '3.4'
+
+### Python 3.5 ##############################################################
+
# The following were added in PC/python3.def in Python 3.5:
# 11d7b1423fc44d764eba7065ea5eba58ed748b21
# f3b73ad51da3097d7915796fdc62608b1ab90c0a
@@ -1942,6 +1949,9 @@
[const.Py_tp_finalize]
added = '3.5'
+
+### Python 3.6 ##############################################################
+
# The following were added in PC/python3.def in Python 3.6:
[function.Py_FinalizeEx]
@@ -1956,6 +1966,9 @@
[data.PyExc_ModuleNotFoundError]
added = '3.6'
+
+### Python 3.7 ##############################################################
+
# The following were added in PC/python3.def in Python 3.6.1 and 3.5.3/3.5.4:
[function.PyCodec_NameReplaceErrors]
@@ -2151,6 +2164,9 @@
[const.METH_METHOD]
added = '3.7'
+
+### Python 3.8 ##############################################################
+
# The following were added in PC/python3.def in Python 3.8:
[function.PyImport_GetModule]
@@ -2174,11 +2190,14 @@
[function.Py_BytesMain]
added = '3.8'
-# New type flag (PEP 590):
+# New type flag in Python 3.8 (PEP 590):
[const.Py_TPFLAGS_METHOD_DESCRIPTOR]
added = '3.8'
+
+### Python 3.9 ##############################################################
+
# The following were added in PC/python3.def in Python 3.9:
[function.Py_EnterRecursiveCall]
@@ -2198,6 +2217,9 @@
[function.PyObject_GC_IsTracked]
added = '3.9'
+
+### Python 3.10 #############################################################
+
# The following were added in PC/python3.def in Python 3.10:
[function.Py_GetArgcArgv]
@@ -2262,7 +2284,11 @@
[data.PyExc_EncodingWarning]
added = '3.10'
-# Support for Stable ABI in debug builds
+# Added in 3.7 but in the Stable ABI from 3.10
+[const.METH_FASTCALL]
+ added = '3.10'
+
+# Support for Stable ABI in debug builds (Python 3.10)
[data._Py_RefTotal]
added = '3.10'
@@ -2273,13 +2299,13 @@
ifdef = 'Py_REF_DEBUG'
abi_only = true
-# New slots in 3.10:
+# New slots in Python 3.10:
[const.Py_am_send]
added = '3.10'
-# New GC control functions in Py3.10 (https://bugs.python.org/issue28254)
+# New GC control functions in Python 3.10
(https://github.com/python/cpython/issues/72441)
[function.PyGC_Disable]
added = '3.10'
@@ -2288,8 +2314,11 @@
[function.PyGC_IsEnabled]
added = '3.10'
-# Add new C API in Python 3.11
+### Python 3.11 #############################################################
+
+[data.PyExc_BaseExceptionGroup]
+ added = '3.11'
[function.PyType_GetName]
added = '3.11'
[function.PyType_GetQualName]
@@ -2297,10 +2326,6 @@
[data.PyStructSequence_UnnamedField]
added = '3.11'
-# Added in 3.7 but in the Stable ABI from 3.10
-[const.METH_FASTCALL]
- added = '3.10'
-
# Add stable Py_buffer API in Python 3.11 (https://bugs.python.org/issue45459)
[struct.Py_buffer]
added = '3.11'
@@ -2379,7 +2404,6 @@
[const.PyBUF_WRITE]
added = '3.11'
-
# (Detailed comments aren't really needed for further entries: from here on
# we can use version control logs.)
@@ -2390,6 +2414,11 @@
[function.PyErr_SetHandledException]
added = '3.11'
+
+### Python 3.12 #############################################################
+
+[function.PyErr_DisplayException]
+ added = '3.12'
[function.PyType_FromMetaclass]
added = '3.12'
[const.Py_TPFLAGS_HAVE_VECTORCALL]
@@ -2473,6 +2502,9 @@
# Note: value changed in 3.15 (old value is still accepted)
added = '3.12'
+
+### Python 3.13 #############################################################
+
[function.PyImport_AddModuleRef]
added = '3.13'
[function.PyWeakref_GetRef]
@@ -2555,6 +2587,9 @@
# Note: value changed in 3.15 (old value is still accepted)
added = '3.13'
+
+### Python 3.14 #############################################################
+
[function.Py_TYPE]
# Before 3.14, this was a macro that accessed the PyObject member
added = '3.14'
@@ -2616,6 +2651,9 @@
[function.Py_PACK_VERSION]
added = '3.14'
+
+### Python 3.15 #############################################################
+
[function.PySys_GetAttr]
added = '3.15'
[function.PySys_GetAttrString]
@@ -2773,10 +2811,10 @@
added = '3.15'
[const.Py_tp_module]
added = '3.15'
-[function.Py_HashBuffer]
- added = '3.16'
+[function.PyObject_CallFinalizerFromDealloc]
+ added = '3.15'
-# PEP 757 import/export API.
+# Python 3.15 PEP 757 import/export API.
[function.PyLong_GetNativeLayout]
added = '3.15'
@@ -2802,7 +2840,7 @@
# (The definition of 'full-abi' was clarified when this entry was added.)
struct_abi_kind = 'full-abi'
-# PEP 788 finalization protection
+# Python 3.15 PEP 788 finalization protection
[struct.PyInterpreterGuard]
added = '3.15'
@@ -2832,5 +2870,8 @@
added = '3.15'
struct_abi_kind = 'opaque'
-[function.PyObject_CallFinalizerFromDealloc]
- added = '3.15'
+
+### Python 3.16 #############################################################
+
+[function.Py_HashBuffer]
+ added = '3.16'
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
