Skip to main content

A library for abi3 and other CPython API information

Project description

abi3info

CI PyPI version

abi3info exposes information about CPython's "limited API" (including the stable ABI, called abi3) as a Python library.

Installation

abi3info is available via pip:

$ pip install abi3info

Usage

abi3info exposes limited API and stable ABI information in the form of a set of top-level dictionaries, namely:

import abi3info

abi3info.FEATURE_MACROS
abi3info.MACROS
abi3info.STRUCTS
abi3info.TYPEDEFS
abi3info.FUNCTIONS
abi3info.DATAS

Each of these is a mapping of a name (either as str or Symbol) to a data model describing the kind of item (e.g. FeatureMacro or Function).

See the generated documentation for more details, including comprehensive type hints and explanations of each data model.

See also the stable_abi.toml file, taken from the CPython sources, which describes each model and their semantics.

Examples

Get information about a particular function:

from abi3info import FUNCTIONS
from abi3info.models import Symbol

func = FUNCTIONS[Symbol("_Py_NegativeRefcount")]
print(func.symbol, func.added, func.ifdef, func.abi_only)

Get information about the feature macros that control the limited API:

from abi3info import FEATURE_MACROS

print(fm for fm in FEATURE_MACROS.values())

Licensing

abi3info is licensed under the MIT license.

abi3info is partially generated from metadata retrieved from the CPython sources, which is licensed under the PSF license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

abi3info-2025.4.29.tar.gz (20.1 kB view details)

Uploaded Source

Built Distribution

abi3info-2025.4.29-py3-none-any.whl (19.5 kB view details)

Uploaded Python 3

File details

Details for the file abi3info-2025.4.29.tar.gz.

File metadata

  • Download URL: abi3info-2025.4.29.tar.gz
  • Upload date:
  • Size: 20.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for abi3info-2025.4.29.tar.gz
Algorithm Hash digest
SHA256 00733a73532cbf6f41e78549dc959a2110fce6e33d207a31c1ec653fa4be3b20
MD5 0a17e7701a562e7bfcf3df8a758f7b2a
BLAKE2b-256 da48ec0cb606d072dbefd7d83930030f8ee499927bd11df213e53c76655b0367

See more details on using hashes here.

Provenance

The following attestation bundles were made for abi3info-2025.4.29.tar.gz:

Publisher: release.yml on woodruffw/abi3info

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file abi3info-2025.4.29-py3-none-any.whl.

File metadata

  • Download URL: abi3info-2025.4.29-py3-none-any.whl
  • Upload date:
  • Size: 19.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for abi3info-2025.4.29-py3-none-any.whl
Algorithm Hash digest
SHA256 fb9463207d96a3cb995f6f5612892eceec2205a9ec9764f34808612d18080c69
MD5 c7cf47ae5f409c5f6c84fff1a0bf99d5
BLAKE2b-256 5ef752a54953fc542dcea543bb92f59be8bdd3637b1a93014b2b58eb045daccd

See more details on using hashes here.

Provenance

The following attestation bundles were made for abi3info-2025.4.29-py3-none-any.whl:

Publisher: release.yml on woodruffw/abi3info

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page