Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-31 04:23:37 +00:00
Code Issues Projects Releases Packages Wiki Activity

gh-133143: Add sys.abi_info (GH-137476)

Browse source 
This makes information about the interpreter ABI more accessible.

Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
This commit is contained in:
Klaus Zimmermann 2025-09-08 16:35:44 +02:00 • committed by GitHub
parent c006a623e7
commit 1acb718ea2
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 137 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

45
Doc/library/sys.rst
View file

@ -11,6 +11,51 @@ interpreter and to functions that interact strongly with the interpreter. It is
always available. Unless explicitly noted otherwise, all variables are read-only.
.. data:: abi_info
.. versionadded:: next
An object containing information about the ABI of the currently running
Python interpreter.
It should include information that affect the CPython ABI in ways that
require a specific build of the interpreter chosen from variants that can
co-exist on a single machine.
For example, it does not encode the base OS (Linux or Windows), but does
include pointer size since some systems support both 32- and 64-bit builds.
The available entries are the same on all platforms;
e.g. *pointer_size* is available even on 64-bit-only architectures.
The following attributes are available:
.. attribute:: abi_info.pointer_bits
The width of pointers in bits, as an integer,
equivalent to ``8 * sizeof(void *)``.
Usually, this is ``32`` or ``64``.
.. attribute:: abi_info.free_threaded
A Boolean indicating whether the interpreter was built with
:term:`free threading` support.
This reflects either the presence of the :option:`--disable-gil`
:file:`configure` option (on Unix)
or setting the ``DisableGil`` property (on Windows).
.. attribute:: abi_info.debug
A Boolean indicating whether the interpreter was built in
:ref:`debug mode <debug-build>`.
This reflects either the presence of the :option:`--with-pydebug`
:file:`configure` option (on Unix)
or the ``Debug`` configuration (on Windows).
.. attribute:: abi_info.byteorder
A string indicating the native byte order,
either ``'big'`` or ``'little'``.
This is the same as the :data:`byteorder` attribute.
.. data:: abiflags
On POSIX systems where Python was built with the standard ``configure``

7
Doc/whatsnew/3.15.rst
View file

@ -460,6 +460,13 @@ ssl
(Contributed by Ron Frederick in :gh:`138252`.)
sys
---
* Add :data:`sys.abi_info` namespace to improve access to ABI information.
(Contributed by Klaus Zimmermann in :gh:`137476`.)
tarfile
-------