pythoncapi_compat(1)

PYTHONCAPI_COMPAT(1)

pythoncapi_compat

PYTHONCAPI_COMPAT(1)

NAME

pythoncapi_compat - pythoncapi_compat

The pythoncapi-compat project can be used to write a C or C++ extension supporting a wide range of Python versions with a single code base. It is made of the pythoncapi_compat.h header file.

Homepage: GitHub pythoncapi-compat project <https://github.com/python/pythoncapi-compat>.
Documentation <https://pythoncapi-compat.readthedocs.io/en/latest/>

Documentation:

PYTHONCAPI_COMPAT.H API

The pythoncapi_compat.h header file provides implementations of around 150 recent functions for old Python versions.

Supported Python versions:

Python 3.6 - 3.16
PyPy 3.6 - 3.12

The limited C API is only supported on CPython.

A C11 subset (without optional features) is required, like static inline functions: see PEP 7 <https://www.python.org/dev/peps/pep-0007/>.

C++03 and C++11 are supported on Python 3.6 and newer.

Private functions (name starting with _Py) are not supported.

Latest version of the header file: pythoncapi_compat.h <https://raw.githubusercontent.com/python/pythoncapi-compat/main/pythoncapi_compat.h>.

Python 3.15

PyBytesWriter *PyBytesWriter_Create(Py_ssize_t size)

void *PyBytesWriter_GetData(PyBytesWriter *writer)

Py_ssize_t PyBytesWriter_GetSize(PyBytesWriter *writer)

PyObject *PyBytesWriter_FinishWithSize(PyBytesWriter *writer, Py_ssize_t size)

PyObject *PyBytesWriter_Finish(PyBytesWriter *writer)

PyObject *PyBytesWriter_FinishWithPointer(PyBytesWriter *writer, void *buf)

void PyBytesWriter_Discard(PyBytesWriter *writer)

int PyBytesWriter_Resize(PyBytesWriter *writer, Py_ssize_t size)

int PyBytesWriter_Grow(PyBytesWriter *writer, Py_ssize_t size)

void *PyBytesWriter_GrowAndUpdatePointer(PyBytesWriter *writer, Py_ssize_t size, void *buf)

int PyBytesWriter_WriteBytes(PyBytesWriter *writer, const void *bytes, Py_ssize_t size)

int PyBytesWriter_Format(PyBytesWriter *writer, const char *format, ...): See PyBytesWriter documentation <https://docs.python.org/dev/c-api/bytes.html#pybyteswriter>.
Not available on the limited C API.

PyObject *PySys_GetAttr(const char *name): See PySys_GetAttr() documentation <https://docs.python.org/dev/c-api/sys.html#c.PySys_GetAttr>.

PyObject *PySys_GetAttrString(const char *name): See PySys_GetAttrString() documentation <https://docs.python.org/dev/c-api/sys.html#c.PySys_GetAttrString>.

PyObject *PySys_GetOptionalAttr(const char *name): See PySys_GetOptionalAttr() documentation <https://docs.python.org/dev/c-api/sys.html#c.PySys_GetOptionalAttr>.

PyObject *PySys_GetOptionalAttrString(const char *name): See PySys_GetOptionalAttrString() documentation <https://docs.python.org/dev/c-api/sys.html#c.PySys_GetOptionalAttrString>.

PyObject *PyTuple_FromArray(PyObject *const *array, Py_ssize_t size): See PyTuple_FromArray() documentation <https://docs.python.org/dev/c-api/tuple.html#c.PyTuple_FromArray>.

Py_hash_t PyUnstable_Unicode_GET_CACHED_HASH(PyObject *op)

See PyUnstable_Unicode_GET_CACHED_HASH() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnstable_Unicode_GET_CACHED_HASH>.

On PyPy, always returns -1.

Not available on the limited C API.

int PyUnstable_SetImmortal(PyObject *op)

See PyUnstable_SetImmortal() documentation <https://docs.python.org/dev/c-api/object.html#c.PyUnstable_SetImmortal>.

Availability: Python 3.13 and newer.

Not available on PyPy, and not on the limited C API.

Not supported:

PyABIInfo_Check()
PyAnyDict_Check()
PyAnyDict_CheckExact()
PyArg_ParseArray()
PyArg_ParseArrayAndKeywords()
PyFrozenDict_Check()
PyFrozenDict_CheckExact()
PyFrozenDict_New()
PyImport_CreateModuleFromInitfunc()
PyModule_FromSlotsAndSpec()
PyModule_GetState_DuringGC()
PyModule_GetToken_DuringGC()
PyObject_CallFinalizerFromDealloc()
PyObject_Dump()
PyObject_GetItemData_DuringGC()
PyObject_GetTypeData_DuringGC()
PyType_FromSlots()
PyType_GetBaseByToken_DuringGC()
PyType_GetModuleByToken_DuringGC()
PyType_GetModuleState_DuringGC()
PyType_GetModule_DuringGC()
PyUnstable_DumpTraceback()
PyUnstable_DumpTracebackThreads()
PyUnstable_ThreadState_ResetStackProtection()
PyUnstable_ThreadState_SetStackProtection()

Python 3.14

struct PyLongLayout: See PyLongLayout documentation <https://docs.python.org/dev/c-api/long.html#c.PyLongLayout>.
Not available on the limited C API.

const PyLongLayout <#c.PyLongLayout> *PyLong_GetNativeLayout(void): See PyLong_GetNativeLayout() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_GetNativeLayout>.
Not available on the limited C API.

struct PyLongExport: See PyLongExport documentation <https://docs.python.org/dev/c-api/long.html#c.PyLongExport>.
Not available on the limited C API.

int PyLong_Export(PyObject *obj, PyLongExport <#c.PyLongExport> *export_long): See PyLong_Export() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_Export>.
Not available on the limited C API.

void PyLong_FreeExport(PyLongExport <#c.PyLongExport> *export_long): See PyLong_FreeExport() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_FreeExport>.
Not available on the limited C API.

struct PyLongWriter: See PyLongWriter documentation <https://docs.python.org/dev/c-api/long.html#c.PyLongWriter>.
Not available on the limited C API.

PyLongWriter <#c.PyLongWriter> *PyLongWriter_Create(int negative, Py_ssize_t ndigits, void **digits): See PyLongWriter_Create() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLongWriter_Create>.
Not available on the limited C API.

PyObject *PyLongWriter_Finish(PyLongWriter <#c.PyLongWriter> *writer): See PyLongWriter_Finish() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLongWriter_Finish>.
Not available on the limited C API.

void PyLongWriter_Discard(PyLongWriter <#c.PyLongWriter> *writer): See PyLongWriter_Discard() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLongWriter_Discard>.
Not available on the limited C API.

int PyLong_IsPositive(PyObject *obj): See PyLong_IsPositive() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_IsPositive>.

int PyLong_IsNegative(PyObject *obj): See PyLong_IsNegative() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_IsNegative>.

int PyLong_IsZero(PyObject *obj): See PyLong_IsZero() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_IsZero>.

int PyLong_GetSign(PyObject *obj, int *sign): See PyLong_GetSign() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_GetSign>.

PyObject *PyIter_NextItem(PyObject *sep, PyObject *iterable): See PyIter_NextItem() documentation <https://docs.python.org/dev/c-api/iter.html#c.PyIter_NextItem>.
Not available on limited C API 3.9 and older.

PyObject *PyBytes_Join(PyObject *sep, PyObject *iterable): See PyBytes_Join() documentation <https://docs.python.org/dev/c-api/bytes.html#c.PyBytes_Join>.

Py_hash_t Py_HashBuffer(const void *ptr, Py_ssize_t len): See Py_HashBuffer() documentation <https://docs.python.org/dev/c-api/hash.html#c.Py_HashBuffer>.

int PyUnicode_Equal(PyObject *str1, PyObject *str2): See PyUnicode_Equal() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicode_Equal>.

PyUnicodeWriter *PyUnicodeWriter_Create(Py_ssize_t length): See PyUnicodeWriter_Create() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_Create>.
Not available on the limited C API.

PyObject *PyUnicodeWriter_Finish(PyUnicodeWriter *writer): See PyUnicodeWriter_Finish() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_Finish>.
Not available on the limited C API.

void PyUnicodeWriter_Discard(PyUnicodeWriter *writer): See PyUnicodeWriter_Discard() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_Discard>.
Not available on the limited C API.

int PyUnicodeWriter_WriteChar(PyUnicodeWriter *writer, Py_UCS4 ch): See PyUnicodeWriter_WriteChar() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_WriteChar>.
Not available on the limited C API.

int PyUnicodeWriter_WriteUCS4(PyUnicodeWriter *writer, const Py_UCS4 *ucs4, Py_ssize_t size): See PyUnicodeWriter_WriteUCS4() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_WriteUCS4>.
Not available on the limited C API.

int PyUnicodeWriter_WriteUTF8(PyUnicodeWriter *writer, const char *str, Py_ssize_t size): See PyUnicodeWriter_WriteUTF8() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_WriteUTF8>.
Not available on the limited C API.

int PyUnicodeWriter_WriteASCII(PyUnicodeWriter *writer, const char *str, Py_ssize_t size): See PyUnicodeWriter_WriteASCII() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_WriteASCII>.
Not available on the limited C API.

int PyUnicodeWriter_WriteWideChar(PyUnicodeWriter *writer, const wchar_t *str, Py_ssize_t size): See PyUnicodeWriter_WriteWideChar() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_WriteWideChar>.
Not available on the limited C API.

int PyUnicodeWriter_WriteStr(PyUnicodeWriter *writer, PyObject *obj): See PyUnicodeWriter_WriteStr() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_WriteStr>.
Not available on the limited C API.

int PyUnicodeWriter_WriteRepr(PyUnicodeWriter *writer, PyObject *obj): See PyUnicodeWriter_WriteRepr() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_WriteRepr>.
Not available on the limited C API.

int PyUnicodeWriter_WriteSubstring(PyUnicodeWriter *writer, PyObject *str, Py_ssize_t start, Py_ssize_t end): See PyUnicodeWriter_WriteSubstring() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_WriteSubstring>.
Not available on the limited C API.

int PyUnicodeWriter_Format(PyUnicodeWriter *writer, const char *format, ...): See PyUnicodeWriter_Format() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicodeWriter_Format>.
Not available on the limited C API.

int PyLong_AsInt32(PyObject *obj, int32_t *pvalue): See PyLong_AsInt32() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_AsInt32>.

int PyLong_AsInt64(PyObject *obj, int64_t *pvalue): See PyLong_AsInt64() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_AsInt64>.

int PyLong_AsUInt32(PyObject *obj, uint32_t *pvalue): See PyLong_AsUInt32() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_AsUInt32>.

int PyLong_AsUInt64(PyObject *obj, uint64_t *pvalue): See PyLong_AsUInt64() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_AsUInt64>.

PyObject *PyLong_FromInt32(int32_t value): See PyLong_FromInt32() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_FromInt32>.

PyObject *PyLong_FromInt64(int64_t value): See PyLong_FromInt64() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_FromInt64>.

PyObject *PyLong_FromUInt32(uint32_t value): See PyLong_FromUInt32() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_FromUInt32>.

PyObject *PyLong_FromUInt64(uint64_t value): See PyLong_FromUInt64() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_FromUInt64>.

FILE *Py_fopen(PyObject *path, const char *mode): See Py_fopen() documentation <https://docs.python.org/dev/c-api/sys.html#c.Py_fopen>.

int Py_fclose(FILE *file): See Py_fclose() documentation <https://docs.python.org/dev/c-api/sys.html#c.Py_fclose>.

PyObject *PyConfig_Get(const char *name)

See PyConfig_Get() documentation <https://docs.python.org/dev/c-api/init_config.html#c.PyConfig_Get>.

Availability: Python 3.9 and newer.

Not available on PyPy and not on the limited C API.

int PyConfig_GetInt(const char *name, int *value)

See PyConfig_GetInt() documentation <https://docs.python.org/dev/c-api/init_config.html#c.PyConfig_GetInt>.

Availability: Python 3.9 and newer.

Not available on PyPy and not on the limited C API.

int PyUnstable_Object_IsUniquelyReferenced(PyObject *op)

See PyUnstable_Object_IsUniquelyReferenced() documentation <https://docs.python.org/dev/c-api/object.html#c.PyUnstable_Object_IsUniquelyReferenced>.

Not available on PyPy. Py_REFCNT() semantics is different on PyPy.

Not available on the limited C API.

int PyUnstable_TryIncRef(PyObject *op): See PyUnstable_TryIncRef() documentation <https://docs.python.org/dev/c-api/object.html#c.PyUnstable_TryIncRef>.
Not available on PyPy. Py_REFCNT() semantics is different on PyPy.

void PyUnstable_EnableTryIncRef(PyObject *op): See PyUnstable_EnableTryIncRef() documentation <https://docs.python.org/dev/c-api/object.html#c.PyUnstable_EnableTryIncRef>.
Not available on PyPy. Py_REFCNT() semantics is different on PyPy.

PyObject *PyImport_ImportModuleAttr(PyObject *mod_name, PyObject *attr_name): See PyImport_ImportModuleAttr() documentation <https://docs.python.org/dev/c-api/import.html#c.PyImport_ImportModuleAttr>.

PyObject *PyImport_ImportModuleAttrString(const char *mod_name, const char *attr_name): See PyImport_ImportModuleAttrString() documentation <https://docs.python.org/dev/c-api/import.html#c.PyImport_ImportModuleAttrString>.

uint32_t Py_PACK_FULL_VERSION(int major, int minor, int micro, int release_level, int release_serial): See Py_PACK_FULL_VERSION() documentation <https://docs.python.org/dev/c-api/apiabiversion.html#c.Py_PACK_FULL_VERSION>.

uint32_t Py_PACK_VERSION(int major, int minor): See Py_PACK_VERSION() documentation <https://docs.python.org/dev/c-api/apiabiversion.html#c.Py_PACK_VERSION>.

Not supported:

PyConfig_Names()
PyConfig_Set()
PyInitConfig_AddModule()
PyInitConfig_Create()
PyInitConfig_Free()
PyInitConfig_FreeStrList()
PyInitConfig_GetError()
PyInitConfig_GetExitCode()
PyInitConfig_GetInt()
PyInitConfig_GetStr()
PyInitConfig_GetStrList()
PyInitConfig_HasOption()
PyInitConfig_SetInt()
PyInitConfig_SetStr()
PyInitConfig_SetStrList()
PyMonitoring_FireBranchLeftEvent()
PyMonitoring_FireBranchRightEvent()
PyType_Freeze()
PyType_GetBaseByToken()
PyUnicodeWriter_DecodeUTF8Stateful()
PyUnstable_IsImmortal()
PyUnstable_Object_EnableDeferredRefcount()
PyUnstable_Object_IsUniqueReferencedTemporary()
Py_InitializeFromInitConfig()

Python 3.13

PyObject *Py_GetConstant(unsigned int constant_id): See Py_GetConstant() documentation <https://docs.python.org/dev/c-api/object.html#c.Py_GetConstant>.

int PyDict_GetItemRef(PyObject *p, PyObject *key, PyObject **result): See PyDict_GetItemRef() documentation <https://docs.python.org/dev/c-api/dict.html#c.PyDict_GetItemRef>.

int PyDict_GetItemStringRef(PyObject *p, const char *key, PyObject **result): See PyDict_GetItemStringRef() documentation <https://docs.python.org/dev/c-api/dict.html#c.PyDict_GetItemStringRef>.

PyObject *PyImport_AddModuleRef(const char *name): See PyImport_AddModuleRef() documentation <https://docs.python.org/dev/c-api/import.html#c.PyImport_AddModuleRef>.

int PyObject_GetOptionalAttr(PyObject *obj, PyObject *attr_name, PyObject **result): See PyObject_GetOptionalAttr() documentation <https://docs.python.org/dev/c-api/object.html#c.PyObject_GetOptionalAttr>.

int PyObject_GetOptionalAttrString(PyObject *obj, const char *attr_name, PyObject **result): See PyObject_GetOptionalAttrString() documentation <https://docs.python.org/dev/c-api/object.html#c.PyObject_GetOptionalAttrString>.

int PyObject_HasAttrWithError(PyObject *obj, PyObject *attr_name): See PyObject_HasAttrWithError() documentation <https://docs.python.org/dev/c-api/object.html#c.PyObject_HasAttrWithError>.

int PyObject_HasAttrStringWithError(PyObject *obj, const char *attr_name): See PyObject_HasAttrStringWithError() documentation <https://docs.python.org/dev/c-api/object.html#c.PyObject_HasAttrStringWithError>.

int PyMapping_GetOptionalItem(PyObject *obj, PyObject *key, PyObject **result): See PyMapping_GetOptionalItem() documentation <https://docs.python.org/dev/c-api/mapping.html#c.PyMapping_GetOptionalItem>.

int PyMapping_GetOptionalItemString(PyObject *obj, const char *key, PyObject **result): See PyMapping_GetOptionalItemString() documentation <https://docs.python.org/dev/c-api/mapping.html#c.PyMapping_GetOptionalItemString>.

int PyMapping_HasKeyWithError(PyObject *obj, PyObject *key): See PyMapping_HasKeyWithError() documentation <https://docs.python.org/dev/c-api/mapping.html#c.PyMapping_HasKeyWithError>.

int PyMapping_HasKeyStringWithError(PyObject *obj, const char *key): See PyMapping_HasKeyStringWithError() documentation <https://docs.python.org/dev/c-api/mapping.html#c.PyMapping_HasKeyStringWithError>.

int PyModule_Add(PyObject *module, const char *name, PyObject *value): See PyModule_Add() documentation <https://docs.python.org/dev/c-api/module.html#c.PyModule_Add>.

int PyWeakref_GetRef(PyObject *ref, PyObject **pobj): See PyWeakref_GetRef() documentation <https://docs.python.org/dev/c-api/weakref.html#c.PyWeakref_GetRef>.

int Py_IsFinalizing()

Return non-zero if the Python interpreter is shutting down, return 0 otherwise.

Availability: Python 3.3 and newer, PyPy 7.3 and newer, limited C API 3.13.

See Py_IsFinalizing() documentation <https://docs.python.org/dev/c-api/init.html#c.Py_IsFinalizing>.

int PyDict_ContainsString(PyObject *p, const char *key): See PyDict_ContainsString() documentation <https://docs.python.org/dev/c-api/dict.html#c.PyDict_ContainsString>.

int PyLong_AsInt(PyObject *obj): See PyLong_AsInt() documentation <https://docs.python.org/dev/c-api/long.html#c.PyLong_AsInt>.

int PyObject_VisitManagedDict(PyObject *obj, visitproc visit, void *arg)

See PyObject_VisitManagedDict() documentation <https://docs.python.org/dev/c-api/object.html#c.PyObject_VisitManagedDict>.

Availability: Python 3.11 and newer.

Not available on the limited C API.

void PyObject_ClearManagedDict(PyObject *obj)

See PyObject_ClearManagedDict() documentation <https://docs.python.org/dev/c-api/object.html#c.PyObject_ClearManagedDict>.

Availability: Python 3.11 and newer.

Not available on the limited C API.

PyThreadState *PyThreadState_GetUnchecked(void): See PyThreadState_GetUnchecked() documentation <https://docs.python.org/dev/c-api/init.html#c.PyThreadState_GetUnchecked>.
Available on Python 3.5.2 and newer. Not available on the limited C API.

int PyUnicode_EqualToUTF8(PyObject *unicode, const char *str): See PyUnicode_EqualToUTF8() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicode_EqualToUTF8>.

int PyUnicode_EqualToUTF8AndSize(PyObject *unicode, const char *str, Py_ssize_t size): See PyUnicode_EqualToUTF8AndSize() documentation <https://docs.python.org/dev/c-api/unicode.html#c.PyUnicode_EqualToUTF8AndSize>.

int PyList_Extend(PyObject *list, PyObject *iterable): See PyList_Extend() documentation <https://docs.python.org/dev/c-api/list.html#c.PyList_Extend>.

int PyList_Clear(PyObject *list): See PyList_Clear() documentation <https://docs.python.org/dev/c-api/list.html#c.PyList_Clear>.

int PyDict_Pop(PyObject *dict, PyObject *key, PyObject **result): See PyDict_Pop() documentation <https://docs.python.org/dev/c-api/dict.html#c.PyDict_Pop>.

int PyDict_PopString(PyObject *dict, const char *key, PyObject **result): See PyDict_PopString() documentation <https://docs.python.org/dev/c-api/dict.html#c.PyDict_PopString>.

Py_hash_t Py_HashPointer(const void *ptr): See Py_HashPointer() documentation <https://docs.python.org/dev/c-api/hash.html#c.Py_HashPointer>.

Py_hash_t PyObject_GenericHash(PyObject *obj): See PyObject_GenericHash() documentation <https://docs.python.org/dev/c-api/hash.html#c.PyObject_GenericHash>.

type PyTime_t: A timestamp or duration in nanoseconds, represented as a signed 64-bit integer.
Not available on the limited C API.

PyTime_t <#c.PyTime_t> PyTime_MIN: Minimum value of PyTime_t.
Not available on the limited C API.

PyTime_t <#c.PyTime_t> PyTime_MAX: Maximum value of PyTime_t.
Not available on the limited C API.

double PyTime_AsSecondsDouble(PyTime_t <#c.PyTime_t> t): See PyTime_AsSecondsDouble() documentation <https://docs.python.org/dev/c-api/time.html#c.PyTime_AsSecondsDouble>.
Not available on the limited C API.

int PyTime_Monotonic(PyTime_t <#c.PyTime_t> *result): See PyTime_Monotonic() documentation <https://docs.python.org/dev/c-api/time.html#c.PyTime_Monotonic>.
Not available on the limited C API.

int PyTime_Time(PyTime_t <#c.PyTime_t> *result): See PyTime_Time() documentation <https://docs.python.org/dev/c-api/time.html#c.PyTime_Time>.
Not available on the limited C API.

int PyTime_PerfCounter(PyTime_t <#c.PyTime_t> *result): See PyTime_PerfCounter() documentation <https://docs.python.org/dev/c-api/time.html#c.PyTime_PerfCounter>.
Not available on the limited C API.

PyObject *PyList_GetItemRef(PyObject *op, Py_ssize_t index): See PyList_GetItemRef() documentation <https://docs.python.org/dev/c-api/list.html#c.PyList_GetItemRef>.

int PyDict_SetDefaultRef(PyObject *d, PyObject *key, PyObject *default_value, PyObject **result): See PyDict_SetDefaultRef() documentation <https://docs.python.org/dev/c-api/dict.html#c.PyDict_SetDefaultRef>.

PyObject *PyType_GetModuleName(PyTypeObject *type): See PyType_GetModuleName() documentation <https://docs.python.org/dev/c-api/type.html#c.PyType_GetModuleName>.

PyObject *PyType_GetFullyQualifiedName(PyTypeObject *type): See PyType_GetFullyQualifiedName() documentation <https://docs.python.org/dev/c-api/type.html#c.PyType_GetFullyQualifiedName>.

PyObject *PyEval_GetFrameLocals(void): See PyEval_GetFrameLocals() documentation <https://docs.python.org/dev/c-api/reflection.html#c.PyEval_GetFrameLocals>.

PyObject *PyEval_GetFrameGlobals(void): See PyEval_GetFrameGlobals() documentation <https://docs.python.org/dev/c-api/reflection.html#c.PyEval_GetFrameGlobals>.

PyObject *PyEval_GetFrameBuiltins(void): See PyEval_GetFrameBuiltins() documentation <https://docs.python.org/dev/c-api/reflection.html#c.PyEval_GetFrameBuiltins>.

Py_BEGIN_CRITICAL_SECTION(op)

Py_END_CRITICAL_SECTION()

Py_BEGIN_CRITICAL_SECTION2(a, b)

Py_END_CRITICAL_SECTION2(): See Py_BEGIN_CRITICAL_SECTION() documentation <https://docs.python.org/dev/c-api/synchronization.html#c.Py_BEGIN_CRITICAL_SECTION>.

Not supported:

PyErr_FormatUnraisable().
PyLong_AsNativeBytes()
PyLong_FromNativeBytes()
PyLong_FromUnsignedNativeBytes()
PyMonitoring_EnterScope()
PyMonitoring_ExitScope()
PyMonitoring_FireCRaiseEvent()
PyMonitoring_FireCReturnEvent()
PyMonitoring_FireCallEvent()
PyMonitoring_FireExceptionHandledEvent()
PyMonitoring_FireJumpEvent()
PyMonitoring_FireLineEvent()
PyMonitoring_FirePyResumeEvent()
PyMonitoring_FirePyReturnEvent()
PyMonitoring_FirePyStartEvent()
PyMonitoring_FirePyThrowEvent()
PyMonitoring_FirePyUnwindEvent()
PyMonitoring_FirePyYieldEvent()
PyMonitoring_FireRaiseEvent()
PyMonitoring_FireReraiseEvent()
PyMonitoring_FireStopIterationEvent()
PyMutex_Lock()
PyMutex_Unlock()
PyRefTracer_GetTracer()
PyRefTracer_SetTracer()
PySys_Audit()
PySys_AuditTuple()
PyTime_MonotonicRaw()
PyTime_PerfCounterRaw()
PyTime_TimeRaw()

Python 3.12

PyObject *PyFrame_GetVar(PyFrameObject *frame, PyObject *name): See PyFrame_GetVar() documentation <https://docs.python.org/dev/c-api/frame.html#c.PyFrame_GetVar>.
Not available on PyPy nor with the limited C API.

PyObject *PyFrame_GetVarString(PyFrameObject *frame, const char *name): See PyFrame_GetVarString() documentation <https://docs.python.org/dev/c-api/frame.html#c.PyFrame_GetVarString>.
Not available on PyPy nor with the limited C API.

PyObject *Py_GetConstantBorrowed(unsigned int constant_id): See Py_GetConstantBorrowed() documentation <https://docs.python.org/dev/c-api/object.html#c.Py_GetConstantBorrowed>.

Not supported:

PyCode_AddWatcher()
PyCode_ClearWatcher()
PyDict_AddWatcher()
PyDict_Watch()
PyErr_DisplayException()
PyErr_GetRaisedException()
PyErr_SetRaisedException()
PyEval_SetProfileAllThreads()
PyEval_SetTraceAllThreads()
PyException_GetArgs()
PyException_SetArgs()
PyFunction_SetVectorcall()
PyObject_GetTypeData()
PyType_AddWatcher()
PyType_FromMetaclass() (implementation too big to be backported)
PyType_Watch()
PyUnstable_Code_GetExtra()
PyUnstable_Code_New()
PyUnstable_Code_NewWithPosOnlyArgs()
PyUnstable_Code_SetExtra()
PyUnstable_Eval_RequestCodeExtraIndex()
PyVectorcall_Call()
Py_NewInterpreterFromConfig()

Python 3.11

PyObject *PyCode_GetCellvars(PyCodeObject *code): See PyCode_GetCellvars() documentation <https://docs.python.org/dev/c-api/code.html#c.PyCode_GetCellvars>.
Not available on PyPy nor on limited C API 3.10 and older.

PyObject *PyCode_GetCode(PyCodeObject *code): See PyCode_GetCode() documentation <https://docs.python.org/dev/c-api/code.html#c.PyCode_GetCode>.
Not available on PyPy nor on limited C API 3.10 and older.

PyObject *PyCode_GetFreevars(PyCodeObject *code): See PyCode_GetFreevars() documentation <https://docs.python.org/dev/c-api/code.html#c.PyCode_GetFreevars>.
Not available on PyPy nor on limited C API 3.10 and older.

PyObject *PyCode_GetVarnames(PyCodeObject *code): See PyCode_GetVarnames() documentation <https://docs.python.org/dev/c-api/code.html#c.PyCode_GetVarnames>.
Not available on PyPy nor on limited C API 3.10 and older.

PyObject *PyFrame_GetBuiltins(PyFrameObject *frame): See PyFrame_GetBuiltins() documentation <https://docs.python.org/dev/c-api/frame.html#c.PyFrame_GetBuiltins>.
Not available on PyPy nor on limited C API 3.10 and older.

PyObject *PyFrame_GetGlobals(PyFrameObject *frame): See PyFrame_GetGlobals() documentation <https://docs.python.org/dev/c-api/frame.html#c.PyFrame_GetGlobals>.
Not available on PyPy.

int PyFrame_GetLasti(PyFrameObject *frame): See PyFrame_GetLasti() documentation <https://docs.python.org/dev/c-api/frame.html#c.PyFrame_GetLasti>.
Not available on PyPy nor on limited C API 3.10 and older.

PyObject *PyFrame_GetLocals(PyFrameObject *frame): See PyFrame_GetLocals() documentation <https://docs.python.org/dev/c-api/frame.html#c.PyFrame_GetLocals>.
Not available on PyPy nor on limited C API 3.10 and older.

void PyThreadState_EnterTracing(PyThreadState *tstate): See PyThreadState_EnterTracing() documentation <https://docs.python.org/dev/c-api/init.html#c.PyThreadState_EnterTracing>.
Not available on PyPy nor on limited C API 3.10 and older.

void PyThreadState_LeaveTracing(PyThreadState *tstate): See PyThreadState_LeaveTracing() documentation <https://docs.python.org/dev/c-api/init.html#c.PyThreadState_LeaveTracing>.
Not available on PyPy nor on limited C API 3.10 and older.

int PyFloat_Pack2(double x, unsigned char *p, int le)

Pack a C double as the IEEE 754 binary16 half-precision format.

Availability: Python 3.6 and newer.

Not available on PyPy nor on limited C API.

int PyFloat_Pack4(double x, unsigned char *p, int le): Pack a C double as the IEEE 754 binary32 single precision format.
Not available on PyPy nor on limited C API.

int PyFloat_Pack8(double x, unsigned char *p, int le): Pack a C double as the IEEE 754 binary64 double precision format.
Not available on PyPy nor on limited C API.

double PyFloat_Unpack2(const unsigned char *p, int le)

Unpack the IEEE 754 binary16 half-precision format as a C double.

Availability: Python 3.6 and newer.

Not available on PyPy nor on limited C API.

double PyFloat_Unpack4(const unsigned char *p, int le): Unpack the IEEE 754 binary32 single precision format as a C double.
Not available on PyPy nor on limited C API.

double PyFloat_Unpack8(const unsigned char *p, int le): Unpack the IEEE 754 binary64 double precision format as a C double.
Not available on PyPy nor on limited C API.

PyObject *PyType_GetName(PyTypeObject *type): See PyType_GetName() documentation <https://docs.python.org/dev/c-api/type.html#c.PyType_GetName>.

PyObject *PyType_GetQualName(PyTypeObject *type): See PyType_GetQualName() documentation <https://docs.python.org/dev/c-api/type.html#c.PyType_GetQualName>.

Not supported:

PyErr_GetHandledException()
PyErr_SetHandledException()
PyFrame_GetGenerator()
PyType_GetModuleByDef()
Py_Version constant

Python 3.10

PyObject *Py_NewRef(PyObject *obj): See Py_NewRef() documentation <https://docs.python.org/dev/c-api/refcounting.html#c.Py_NewRef>.

PyObject *Py_XNewRef(PyObject *obj): See Py_XNewRef() documentation <https://docs.python.org/dev/c-api/refcounting.html#c.Py_XNewRef>.

int Py_Is(PyObject *x, PyObject *y): See Py_Is() documentation <https://docs.python.org/dev/c-api/structures.html#c.Py_Is>.

int Py_IsNone(PyObject *x): See Py_IsNone() documentation <https://docs.python.org/dev/c-api/structures.html#c.Py_IsNone>.

int Py_IsTrue(PyObject *x): See Py_IsTrue() documentation <https://docs.python.org/dev/c-api/structures.html#c.Py_IsTrue>.

int Py_IsFalse(PyObject *x): See Py_IsFalse() documentation <https://docs.python.org/dev/c-api/structures.html#c.Py_IsFalse>.

int PyModule_AddObjectRef(PyObject *module, const char *name, PyObject *value): See PyModule_AddObjectRef() documentation <https://docs.python.org/dev/c-api/module.html#c.PyModule_AddObjectRef>.

Not supported:

PyCodec_Unregister()
PyDateTime_DATE_GET_TZINFO()
PyDateTime_TIME_GET_TZINFO()
PyErr_SetInterruptEx()
PyGC_Disable()
PyGC_Enable()
PyGC_IsEnabled()
PyIter_Send()
PySet_CheckExact()
Py_TPFLAGS_DISALLOW_INSTANTIATION constant
Py_TPFLAGS_IMMUTABLETYPE constant

Python 3.9

PyObject

void Py_SET_REFCNT(PyObject *ob, Py_ssize_t refcnt): See Py_SET_REFCNT() documentation <https://docs.python.org/dev/c-api/structures.html#c.Py_SET_REFCNT>.

void Py_SET_TYPE(PyObject *ob, PyTypeObject *type): See Py_SET_TYPE() documentation <https://docs.python.org/dev/c-api/structures.html#c.Py_SET_TYPE>.

void Py_SET_SIZE(PyVarObject *ob, Py_ssize_t size): See Py_SET_SIZE() documentation <https://docs.python.org/dev/c-api/structures.html#c.Py_SET_SIZE>.

int Py_IS_TYPE(const PyObject *ob, const PyTypeObject *type): See Py_IS_TYPE() documentation <https://docs.python.org/dev/c-api/structures.html#c.Py_IS_TYPE>.

PyObject *PyObject_CallNoArgs(PyObject *func): See PyObject_CallNoArgs() documentation <https://docs.python.org/dev/c-api/call.html#c.PyObject_CallNoArgs>.

PyObject *PyObject_CallOneArg(PyObject *func, PyObject *arg): See PyObject_CallOneArg() documentation <https://docs.python.org/dev/c-api/call.html#c.PyObject_CallOneArg>.

PyObject *PyObject_Vectorcall(PyObject *callable, PyObject *const *args, size_t nargsf, PyObject *kwnames): See PyObject_Vectorcall() documentation <https://docs.python.org/dev/c-api/call.html#c.PyObject_Vectorcall>.

Py_ssize_t PyVectorcall_NARGS(size_t nargsf): See PyVectorcall_NARGS() documentation <https://docs.python.org/dev/c-api/call.html#c.PyVectorcall_NARGS>.

PY_VECTORCALL_ARGUMENTS_OFFSET: See PY_VECTORCALL_ARGUMENTS_OFFSET documentation <https://docs.python.org/dev/c-api/call.html#PY_VECTORCALL_ARGUMENTS_OFFSET>.

PyFrameObject

PyCodeObject *PyFrame_GetCode(PyFrameObject *frame): See PyFrame_GetCode() documentation <https://docs.python.org/dev/c-api/reflection.html#c.PyFrame_GetCode>.
Not available on limited C API 3.8 and older.

PyFrameObject *PyFrame_GetBack(PyFrameObject *frame): See PyFrame_GetBack() documentation <https://docs.python.org/dev/c-api/reflection.html#c.PyFrame_GetBack>.
Not available on PyPy nor with the limited C API.

PyThreadState

PyFrameObject *PyThreadState_GetFrame(PyThreadState *tstate): See PyThreadState_GetFrame() documentation <https://docs.python.org/dev/c-api/init.html#c.PyThreadState_GetFrame>.
Availability: PyPy 3.11 and newer, and limited C API 3.9.

PyInterpreterState *PyThreadState_GetInterpreter(PyThreadState *tstate): See PyThreadState_GetInterpreter() documentation <https://docs.python.org/dev/c-api/init.html#c.PyThreadState_GetInterpreter>.
Not available on limited C API 3.8 and older.

uint64_t PyThreadState_GetID(PyThreadState *tstate)

See PyThreadState_GetID() documentation <https://docs.python.org/dev/c-api/init.html#c.PyThreadState_GetID>.

Availability: Python 3.7.

Not available on PyPy nor on limited C API 3.8 and older.

PyInterpreterState

PyInterpreterState *PyInterpreterState_Get(void)

See PyInterpreterState_Get() documentation <https://docs.python.org/dev/c-api/init.html#c.PyInterpreterState_Get>.

Not available on limited C API 3.8 and older on Unix.

Not available in stable ABI 3.9 and older on Windows.

GC protocol

int PyObject_GC_IsTracked(PyObject *obj): See PyObject_GC_IsTracked() documentation <https://docs.python.org/dev/c-api/gcsupport.html#c.PyObject_GC_IsTracked>.
Not available on PyPy nor on limited C API 3.9 and older.

int PyObject_GC_IsFinalized(PyObject *obj): See PyObject_GC_IsFinalized() documentation <https://docs.python.org/dev/c-api/gcsupport.html#c.PyObject_GC_IsFinalized>.
Availability: Python 3.4. Not available on PyPy nor on limited C API 3.9 and older.

Module helper

int PyModule_AddType(PyObject *module, PyTypeObject *type): See PyModule_AddType() documentation <https://docs.python.org/dev/c-api/module.html#c.PyModule_AddType>.

Not supported

PyObject_VectorcallMethod()
PyType_FromModuleAndSpec()
PyType_GetModule()
PyType_GetModuleState()
PyVectorcall_CallMethod()

Python 3.8

Not supported:

•: PyCode_NewWithPosOnlyArgs().

Python 3.7

Not supported:

PyContextToken_CheckExact()
PyContextToken_CheckExact()
PyContextVar_CheckExact()
PyContextVar_Get()
PyContextVar_New()
PyContextVar_Reset()
PyContextVar_Set()
PyContext_AddWatcher()
PyContext_CheckExact()
PyContext_ClearWatcher()
PyContext_Copy()
PyContext_CopyCurrent()
PyContext_Enter()
PyContext_Exit()
PyContext_New()
PyImport_GetModule()
PyInterpreterState_GetID()
PyOS_AfterFork_Child()
PyOS_AfterFork_Parent()
PyOS_BeforeFork()
PySlice_AdjustIndices()
PySlice_Unpack()
PyThread_tss_alloc()
PyThread_tss_create()
PyThread_tss_delete()
PyThread_tss_free()
PyThread_tss_get()
PyThread_tss_is_created()
PyThread_tss_set()
PyTimeZone_FromOffset()
PyTimeZone_FromOffsetAndName()
PyTraceMalloc_Track()
PyTraceMalloc_Untrack()
Py_RETURN_RICHCOMPARE()
Py_UNREACHABLE macro

Python 3.6

Not supported:

PyErr_ResourceWarning().
PyErr_SetImportErrorSubclass().
PyOS_FSPath().
Py_FinalizeEx().

Python 3.5

Py_SETREF(op, op2)

Py_XSETREF(op, op2)

Not supported:

PyCodec_NameReplaceErrors()
PyErr_FormatV()
PyExc_RecursionError
PyMem_Calloc()
PyMem_RawCalloc()
PyModule_ExecDef()
PyModule_FromDefAndSpec()
PyModule_FromDefAndSpec2()
PyNumber_InPlaceMatrixMultiply()
PyNumber_MatrixMultiply()
PyObject_Calloc()
Py_DecodeLocale()
Py_EncodeLocale()

Python 3.4

Py_UNUSED(name): See Py_UNUSED() documentation <https://docs.python.org/dev/c-api/intro.html#c.Py_UNUSED>.

Not supported:

PyObject_LengthHint()
PyStructSequence_InitType2()
PyType_GetSlot()
Py_SetStandardStreamEncoding()

Python 3.3

Not supported:

PyMemoryView_FromMemory()
PyUnicode_AsUCS4()
PyUnicode_AsUCS4Copy()
PyUnicode_CopyCharacters()
PyUnicode_FindChar()
PyUnicode_FromKindAndData()
PyUnicode_GET_LENGTH()
PyUnicode_GetLength()
PyUnicode_New()
PyUnicode_ReadChar()
PyUnicode_Substring()
PyUnicode_WriteChar()

Python 3.2

Not supported:

Py_VA_COPY.
PySys_SetArgvEx().
PyLong_AsLongLongAndOverflow().
PyErr_NewExceptionWithDoc().

Python 3.1

Not supported:

PyCapsule_CheckExact()
PyCapsule_GetContext()
PyCapsule_GetDestructor()
PyCapsule_GetName()
PyCapsule_GetPointer()
PyCapsule_Import()
PyCapsule_IsValid()
PyCapsule_New()
PyCapsule_SetContext()
PyCapsule_SetDestructor()
PyCapsule_SetName()
PyCapsule_SetPointer()
PyOS_string_to_double()

bitarray <https://github.com/ilanschnell/bitarray/>: bitarray/_bitarray.c uses Py_SET_SIZE() (pythoncapi_compat.h copy <https://github.com/ilanschnell/bitarray/blob/master/bitarray/pythoncapi_compat.h>)
datatable <https://github.com/h2oai/datatable> (commit <https://github.com/h2oai/datatable/commit/02f13114828ed4567e4410f5bac579895e20355a>)
guppy3 <https://github.com/zhuyifei1999/guppy3/> (commit <https://github.com/zhuyifei1999/guppy3/commit/4cb9fcb5d75327544a6875b6caabfdffb70a7e29>)
immutables <https://github.com/MagicStack/immutables/>: immutables/_map.c uses Py_SET_SIZE() (pythoncapi_compat.h copy <https://github.com/MagicStack/immutables/blob/master/immutables/pythoncapi_compat.h>)
Mercurial (hg) <https://www.mercurial-scm.org/> uses Py_SET_TYPE() (commit <https://www.mercurial-scm.org/repo/hg/rev/e92ca942ddca>, pythoncapi_compat.h copy <https://www.mercurial-scm.org/repo/hg/file/tip/mercurial/pythoncapi_compat.h>)
mypy <https://github.com/python/mypy> (mypyc, commit <https://github.com/python/mypy/commit/2b7e2df923f7e4a3a199915b3c8563f45bc69dfa>)
numpy <https://numpy.org/>: pythoncapi-compat Git submodule <https://github.com/numpy/numpy/blob/main/.gitmodules>
pybluez <https://github.com/pybluez/pybluez> (commit <https://github.com/pybluez/pybluez/commit/5096047f90a1f6a74ceb250aef6243e144170f92>)
python-snappy <https://github.com/andrix/python-snappy/> (commit <https://github.com/andrix/python-snappy/commit/1a539d71d5b1ceaf9a2291f21f686cf53a46d707>)
python-zstandard <https://github.com/indygreg/python-zstandard/> uses Py_SET_TYPE() and Py_SET_SIZE() (commit <https://github.com/indygreg/python-zstandard/commit/e5a3baf61b65f3075f250f504ddad9f8612bfedf>): Mercurial extension.
python-zstd <https://github.com/sergey-dryabzhinsky/python-zstd/> (commit <https://github.com/sergey-dryabzhinsky/python-zstd/commit/8aa6d7a4b250e1f0a4e27b4107c39dc516c87f96>)
hollerith <https://github.com/pyansys/hollerith/> src/writer.c uses PyObject_CallOneArg() and other Python 3.9 apis (pythoncapi_compat.h copy <https://github.com/pyansys/hollerith/blob/main/src/pythoncapi_compat.h>)
PyTorch <https://github.com/pytorch/pytorch/> (pythoncapi_compat.h copy <https://github.com/pytorch/pytorch/blob/main/torch/csrc/utils/pythoncapi_compat.h>)
PyGObject <https://gitlab.gnome.org/GNOME/pygobject/> (commit <https://gitlab.gnome.org/GNOME/pygobject/-/commit/074c0348417b87d3003dbb409e6fc26b61121de3>, pythoncapi-compat Meson subproject <https://gitlab.gnome.org/GNOME/pygobject/-/blob/main/subprojects/pythoncapi-compat.wrap?ref_type=heads>)
Pillow <https://github.com/python-pillow/Pillow/> (src/thirdparty/pythoncapi_compat.h <https://github.com/python-pillow/Pillow/blob/main/src/thirdparty/pythoncapi_compat.h>)
watchdog <https://github.com/gorakhargosh/watchdog/> (src/pythoncapi_compat.h <https://github.com/gorakhargosh/watchdog/blob/master/src/pythoncapi_compat.h>)

Projects not using pythoncapi_compat.h

Projects not using pythoncapi_compat.h:

•: Cython doesn't use pythoncapi_compat.h: see Cython issue #3934 <https://github.com/cython/cython/issues/3934>. For example, ModuleSetupCode.c <https://github.com/cython/cython/blob/0.29.x/Cython/Utility/ModuleSetupCode.c> provides functions like __Pyx_SET_REFCNT().

Project with a strict contributor agreement:

•: zodbpickle <https://github.com/zopefoundation/zodbpickle/pull/64>

RUN TESTS

To run pythoncapi-compat tests, type:

python3 runtests.py

To only test the current Python version, use the -c or the --current option:

python3 runtests.py --current

Verbose mode (-v, --verbose):

python3 runtests.py --verbose

See tests in the tests/ subdirectory.

CHANGELOG

•: 2026-10-12: Add functions:

PyEval_GetFrameBuiltins()
PyEval_GetFrameGlobals()
PyEval_GetFrameLocals()

2026-10-12: Delete 5 Borrow functions which were specific to pythoncapi-compat and only used by the removed script upgrade_pythoncapi.py: _Py_StealRef() _Py_XStealRef() _PyThreadState_GetFrameBorrow() _PyFrame_GetCodeBorrow() and _PyFrame_GetBackBorrow().
2026-10-11: Remove the upgrade_pythoncapi.py script.
2026-10-10: Add PyObject_GenericHash() and PyUnicodeWriter_WriteUCS4() functions. runtests.py now runs tests in parallel.
2026-10-08: Add support for the limited C API 3.2.
2026-10-08: Add functions:

PyImport_ImportModuleAttr()
PyImport_ImportModuleAttrString()
PyType_GetFullyQualifiedName()
PyType_GetModuleName()
PyType_GetName()
PyType_GetQualName()

2026-10-04: Add support for the limited C API (Py_LIMITED_API).
2026-09-23: PyUnstable_Object_IsUniquelyReferenced(), PyUnstable_TryIncRef() and PyUnstable_EnableTryIncRef() are no longer available on PyPy. Py_REFCNT() semantics is different on PyPy.
2026-09-22: Add support for PyPy3.12 v8.0.0, which provides PyFrame_GetCode() and PyInterpreterState_Get().
2026-09-07: Remove code to support Python 2.7, Python 3.5 and PyPy for Python 2.7 ("pypy2"). Python 2.7 was no longer supported since August 2023. Python 3.5 was no longer supported since October 2024.
2026-02-12: Add functions:

•: PyUnstable_SetImmortal()

•: 2025-10-14: Add functions:

PyTuple_FromArray()
PyUnstable_Unicode_GET_CACHED_HASH()

•: 2025-09-18: Add PEP 782 functions:

PyBytesWriter_Create()
PyBytesWriter_Discard()
PyBytesWriter_Finish()
PyBytesWriter_FinishWithPointer()
PyBytesWriter_FinishWithSize()
PyBytesWriter_Format()
PyBytesWriter_GetData()
PyBytesWriter_GetSize()
PyBytesWriter_Grow()
PyBytesWriter_GrowAndUpdatePointer()
PyBytesWriter_Resize()
PyBytesWriter_WriteBytes()

2025-09-01: Add PyUnstable_Object_IsUniquelyReferenced() function.
2025-06-09: Add PyUnicodeWriter_WriteASCII() function.
2025-06-03: Add functions:

PySys_GetAttr()
PySys_GetAttrString()
PySys_GetOptionalAttr()
PySys_GetOptionalAttrString()

2025-01-19: Add PyConfig_Get() functions.
2025-01-06: Add Py_fopen() and Py_fclose() functions.
2024-12-16: Add structmember.h constants:

Py_T_BOOL
Py_T_BYTE
Py_T_CHAR
Py_T_DOUBLE
Py_T_FLOAT
Py_T_INT
Py_T_LONGLONG
Py_T_LONG
Py_T_OBJECT_EX
Py_T_PYSSIZET
Py_T_SHORT
Py_T_STRING_INPLACE
Py_T_STRING
Py_T_UBYTE
Py_T_UINT
Py_T_ULONGLONG
Py_T_ULONG
Py_T_USHORT
_Py_T_NONE
_Py_T_OBJECT
Py_AUDIT_READ
Py_READONLY
_Py_WRITE_RESTRICTED

•: 2024-12-13: Add functions and structs:

PyLongLayout
PyLong_GetNativeLayout()
PyLongExport
PyLong_Export()
PyLong_FreeExport()
PyLongWriter
PyLongWriter_Create()
PyLongWriter_Finish()
PyLongWriter_Discard()

•: 2024-11-12: Add functions:

PyLong_IsPositive()
PyLong_IsNegative()
PyLong_IsZero()

•: 2024-10-09: Add functions:

PyBytes_Join()
PyIter_NextItem()
PyLong_AsInt32()
PyLong_AsInt64()
PyLong_AsUInt32()
PyLong_AsUInt64()
PyLong_FromInt32()
PyLong_FromInt64()
PyLong_FromUInt32()
PyLong_FromUInt64()
PyUnicode_Equal()
Py_HashBuffer()

•: 2024-07-18: Add functions:

PyUnicodeWriter_Create()
PyUnicodeWriter_Discard()
PyUnicodeWriter_Finish()
PyUnicodeWriter_WriteChar()
PyUnicodeWriter_WriteUTF8()
PyUnicodeWriter_WriteStr()
PyUnicodeWriter_WriteRepr()
PyUnicodeWriter_WriteSubstring()
PyUnicodeWriter_WriteWideChar()
PyUnicodeWriter_Format()

2024-06-03: Add PyLong_GetSign().
2024-04-23: Drop Python 3.5 support. It cannot be tested anymore (pip fails).
2024-04-02: Add PyDict_SetDefaultRef() function.
2024-03-29: Add PyList_GetItemRef() function.
2024-03-21: Add functions:

Py_GetConstant()
Py_GetConstantBorrowed()

•: 2024-03-09: Add hash constants:

PyHASH_BITS
PyHASH_IMAG
PyHASH_INF
PyHASH_MODULUS

•: 2024-02-20: Add PyTime API:

PyTime_t type
PyTime_MIN and PyTime_MAX constants
PyTime_AsSecondsDouble()
PyTime_Monotonic()
PyTime_PerfCounter()
PyTime_Time()

2023-12-15: Add function Py_HashPointer().
2023-11-14: Add functions:

PyDict_Pop()
PyDict_PopString()

•: 2023-11-13: Add functions:

PyList_Extend()
PyList_Clear()

•: 2023-10-04: Add functions:

PyUnicode_EqualToUTF8()
PyUnicode_EqualToUTF8AndSize()

•: 2023-10-03: Add functions:

PyObject_VisitManagedDict()
PyObject_ClearManagedDict()
PyThreadState_GetUnchecked()

•: 2023-09-29: Add functions:

PyMapping_HasKeyWithError()
PyMapping_HasKeyStringWithError()
PyObject_HasAttrWithError()
PyObject_HasAttrStringWithError()

2023-08-25: Add PyDict_ContainsString() and PyLong_AsInt() functions.
2023-08-21: Remove support for Python 2.7, Python 3.4 and older.
2023-08-16: Add Py_IsFinalizing() function.
2023-07-21: Add PyDict_GetItemRef() function.
2023-07-18: Add PyModule_Add() function.
2023-07-12: Add functions:

PyObject_GetOptionalAttr()
PyObject_GetOptionalAttrString()
PyMapping_GetOptionalItem()
PyMapping_GetOptionalItemString()

2023-07-05: Add PyObject_Vectorcall() function.
2023-06-21: Add PyWeakref_GetRef() function.
2023-06-20: Add PyImport_AddModuleRef() function.
2022-11-15: Add experimental operations to the upgrade_pythoncapi.py script: Py_NewRef, Py_CLEAR and Py_SETREF.
2022-11-09: Fix Py_SETREF() and Py_XSETREF() macros for gh-98724 <https://github.com/python/cpython/issues/98724>.
2022-11-04: Add PyFrame_GetVar() and PyFrame_GetVarString() functions.
2022-08-04: Add PyCode_GetVarnames(), PyCode_GetFreevars() and PyCode_GetCellvars() functions.
2022-06-14: Fix compatibility with C++ older than C++11.
2022-05-03: Add PyCode_GetCode() function.
2022-04-26: Rename the project from pythoncapi_compat to pythoncapi-compat: replace the underscore separator with a dash.
2022-04-08: Add functions PyFrame_GetLocals(), PyFrame_GetGlobals() PyFrame_GetBuiltins(), and PyFrame_GetLasti().
2022-03-12: Add functions PyFloat_Pack2(), PyFloat_Pack4(), PyFloat_Pack8(), PyFloat_Unpack2(), PyFloat_Unpack4() and PyFloat_Unpack8().
2022-03-03: The project moved to <https://github.com/python/pythoncapi-compat>
2022-02-11: The project license changes from the MIT license to the Zero Clause BSD (0BSD) license. Projects copying pythoncapi_compat.h no longer have to include the MIT license and the copyright notice.
2022-02-08: Add documentation.
2022-02-09: pythoncapi_compat.h now supports C++ on Python 3.6 and newer: use nullptr and reinterpret_cast<type> cast on C++, and use NULL and (type) cast on C.
2021-10-15: Add PyThreadState_EnterTracing() and PyThreadState_LeaveTracing().
2021-04-09: Add Py_Is(), Py_IsNone(), Py_IsTrue(), Py_IsFalse() functions.
2021-04-01:

Add Py_SETREF(), Py_XSETREF() and Py_UNUSED().
Add PyPy support.

2021-01-27: Fix compatibility with Visual Studio 2008 for Python 2.7.
2020-11-30: Creation of the upgrade_pythoncapi.py script.
2020-06-04: Creation of the pythoncapi_compat.h header file.

LINKS

Python/C API Reference Manual <https://docs.python.org/dev/c-api/>
HPy: a better API for Python <https://hpy.readthedocs.io/>
Cython: C-extensions for Python <https://cython.org/>
Old 2to3c project <https://github.com/davidmalcolm/2to3c> by David Malcolm which uses Coccinelle <https://coccinelle.gitlabpages.inria.fr/website/> to ease migration of C extensions from Python 2 to Python 3. See also 2to3c: an implementation of Python's 2to3 for C code <https://dmalcolm.livejournal.com/3935.html> article (2009).
PEPs related to the C API:

PEP 620 -- Hide implementation details from the C API <https://www.python.org/dev/peps/pep-0620/>
PEP 670 -- Convert macros to functions in the Python C API <https://www.python.org/dev/peps/pep-0670/>
PEP 674 -- Disallow using macros as l-values <https://www.python.org/dev/peps/pep-0674/>

•: Make structures opaque

bpo-39573: PyObject <https://bugs.python.org/issue39573>
bpo-40170: PyTypeObject <https://bugs.python.org/issue40170>
bpo-39947: PyThreadState <https://bugs.python.org/issue39947>
bpo-40421: PyFrameObject <https://bugs.python.org/issue40421>
bpo-47241: PyCodeObject <https://bugs.python.org/issue47241>

This project is distributed under the Zero Clause BSD (0BSD) license <https://opensource.org/licenses/0BSD> and is covered by the PSF Code of Conduct <https://www.python.org/psf/codeofconduct/>.

Author

Victor Stinner

Copyright

2022, Victor Stinner

October 20, 2026

pythoncapi-compat 0_git20261020-r0 · enterprise-packages · ingested 2026-10-20

NAME

PYTHONCAPI_COMPAT.H API

Python 3.15

Python 3.14

Python 3.13

Python 3.12

Python 3.11

Python 3.10

Python 3.9

PyObject

PyFrameObject

PyThreadState

PyInterpreterState

GC protocol

Module helper

Not supported

Python 3.8

Python 3.7

Python 3.6

Python 3.5

Python 3.4

Python 3.3

Python 3.2

Python 3.1

Python 3.0

PYTHONCAPI-COMPAT USERS

Examples of projects using pythoncapi_compat.h

Projects not using pythoncapi_compat.h

RUN TESTS

CHANGELOG

LINKS

Author

Copyright