Версионирование API и ABI¶API and ABI Versioning

CPython предоставляет номер своей версии в следующих макросах. Обратите внимание, что они соответствуют версии, с которой код был собран, а не обязательно той версии, которая используется во время выполнения.

См. Стабильность C API для обсуждения стабильности API и ABI в разных версиях.

PY_MAJOR_VERSION¶: 3 в 3.4.1a2.

PY_MINOR_VERSION¶: 4 в 3.4.1a2.

PY_MICRO_VERSION¶: 1 в 3.4.1a2.

PY_RELEASE_LEVEL¶: a в 3.4.1a2. Может быть 0xA для альфа, 0xB для бета, 0xC для кандидата релиза или 0xF для финальной.

PY_RELEASE_SERIAL¶: 2 в 3.4.1a2. Ноль для финальных релизов.

PY_VERSION_HEX¶

Номер версии Python, закодированный в одном целочисленном значении.

Основную информацию о версии можно получить, интерпретируя его как 32-битное число следующим образом:

Байты	Биты (порядок big endian)	Значение	Значение для `3.4.1a2`
1	1-8	`PY_MAJOR_VERSION`	`0x03`
2	9-16	`PY_MINOR_VERSION`	`0x04`
3	17-24	`PY_MICRO_VERSION`	`0x01`
4	25-28	`PY_RELEASE_LEVEL`	`0xA`
4	29-32	`PY_RELEASE_SERIAL`	`0x2`

Таким образом, 3.4.1a2 – это hexversion 0x030401a2, а 3.10.0 – это hexversion 0x030a00f0.

Используется для численных сравнений, например #if PY_VERSION_HEX >= ....

Эта версия также доступна через символ Py_Version.

const unsigned long Py_Version¶: Часть Stable ABI начиная с версии 3.11.
Номер версии среды выполнения Python, закодированный в одной целочисленной константе, с тем же форматом, что и макрос PY_VERSION_HEX. Он содержит версию Python, используемую во время выполнения.

Новое в версии 3.11.

Все приведенные макросы определены в файле Include/patchlevel.h.