diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst
index 99500e1f321468..2d27cb5352aaa0 100644
--- a/Doc/whatsnew/3.12.rst
+++ b/Doc/whatsnew/3.12.rst
@@ -69,6 +69,10 @@ New grammar features:
* :pep:`701`: Syntactic formalization of f-strings
+Interpreter improvements:
+
+* :ref:`whatsnew312-pep684`
+
New typing features:
* :pep:`688`: Making the buffer protocol accessible in Python
@@ -276,6 +280,36 @@ The new :class:`inspect.BufferFlags` enum represents the flags that
can be used to customize buffer creation.
(Contributed by Jelle Zijlstra in :gh:`102500`.)
+.. _whatsnew312-pep684:
+
+PEP 684: A Per-Interpreter GIL
+------------------------------
+
+Sub-interpreters may now be created with a unique GIL per interpreter.
+This allows Python programs to take full advantage of multiple CPU
+cores.
+
+Use the new :c:func:`Py_NewInterpreterFromConfig` function to
+create an interpreter with its own GIL::
+
+ PyInterpreterConfig config = {
+ .check_multi_interp_extensions = 1,
+ .gil = PyInterpreterConfig_OWN_GIL,
+ };
+ PyThreadState *tstate = NULL;
+ PyStatus status = Py_NewInterpreterFromConfig(&tstate, &config);
+ if (PyStatus_Exception(status)) {
+ return -1;
+ }
+ /* The new interpeter is now active in the current thread. */
+
+For further examples how to use the C-API for sub-interpreters with a
+per-interpreter GIL, see :source:`Modules/_xxsubinterpretersmodule.c`.
+
+A Python API is anticipated for 3.13. (See :pep:`554`.)
+
+(Contributed by Eric Snow in :gh:`104210`, etc.)
+
New Features Related to Type Hints
==================================
@@ -1738,6 +1772,12 @@ New Features
(Contributed by Eddie Elizondo in :gh:`84436`.)
+* :pep:`684`: Added the new :c:func:`Py_NewInterpreterFromConfig`
+ function and :c:type:`PyInterpreterConfig`, which may be used
+ to create sub-interpreters with their own GILs.
+ (See :ref:`whatsnew312-pep684` for more info.)
+ (Contributed by Eric Snow in :gh:`104110`.)
+
* In the limited C API version 3.12, :c:func:`Py_INCREF` and
:c:func:`Py_DECREF` functions are now implemented as opaque function calls to
hide implementation details.
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy