Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

gh-107954: Document PEP 741 in What's New 3.14 (#127056)

This commit is contained in:
Victor Stinner 2024-11-25 15:24:33 +01:00 committed by GitHub
parent c7f1e3e150
commit d9331f1b16
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 40 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Doc/c-api/init_config.rst
View File

@ -6,6 +6,8 @@
Python Initialization Configuration Python Initialization Configuration
*********************************** ***********************************
.. _pyconfig_api:
PyConfig C API PyConfig C API
============== ==============
@ -1592,6 +1594,8 @@ The ``__PYVENV_LAUNCHER__`` environment variable is used to set
:c:member:`PyConfig.base_executable`. :c:member:`PyConfig.base_executable`.
.. _pyinitconfig_api:
PyInitConfig C API PyInitConfig C API
================== ==================

36
Doc/whatsnew/3.14.rst
View File

@ -65,6 +65,8 @@ Summary -- release highlights
.. PEP-sized items next. .. PEP-sized items next.
* :ref:`PEP 649: deferred evaluation of annotations <whatsnew314-pep649>`
* :ref:`PEP 741: Python Configuration C API <whatsnew314-pep741>`
New features New features
@ -172,6 +174,40 @@ Improved error messages
ValueError: too many values to unpack (expected 3, got 4) ValueError: too many values to unpack (expected 3, got 4)
.. _whatsnew314-pep741:
PEP 741: Python Configuration C API
-----------------------------------
Add a :ref:`PyInitConfig C API <pyinitconfig_api>` to configure the Python
initialization without relying on C structures and the ability to make
ABI-compatible changes in the future.
Complete the :pep:`587` :ref:`PyConfig C API <pyconfig_api>` by adding
:c:func:`PyInitConfig_AddModule` which can be used to add a built-in extension
module; feature previously referred to as the “inittab”.
Add :c:func:`PyConfig_Get` and :c:func:`PyConfig_Set` functions to get and set
the current runtime configuration.
PEP 587 “Python Initialization Configuration” unified all the ways to configure
the Python initialization. This PEP unifies also the configuration of the
Python preinitialization and the Python initialization in a single API.
Moreover, this PEP only provides a single choice to embed Python, instead of
having two “Python” and “Isolated” choices (PEP 587), to simplify the API
further.
The lower level PEP 587 PyConfig API remains available for use cases with an
intentionally higher level of coupling to CPython implementation details (such
as emulating the full functionality of CPython’s CLI, including its
configuration mechanisms).
(Contributed by Victor Stinner in :gh:`107954`.)
.. seealso::
:pep:`741`.
Other language changes Other language changes
====================== ======================