Версионирование API и ABI

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

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

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-битное число следующим образом:

Байты	Биты (в порядке от старшего к младшему)	Значение	Значение для 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
	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

Входит в стабильный ABI начиная с версии 3.11.

Номер версии среды выполнения Python, закодированный одним целым числом-константой в том же формате, что и макрос PY_VERSION_HEX. Содержит версию Python, используемую во время выполнения.

Добавлено в версии 3.11.

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