# API e Versionamento de ABI

O CPython expõe seu número de versão nas seguintes macros. Note que estes correspondem com o código da versão que está construída, não necessariamente a versão usada no run time.

Veja Estabilidade da API C para uma discussão da estabilidade da API e ABI através das versões.

PY_MAJOR_VERSION

  O `3` em `3.4.1a2`.

PY_MINOR_VERSION

  O `4` em `3.4.1a2`.

PY_MICRO_VERSION

  O `1` em `3.4.1a2`.

PY_RELEASE_LEVEL

  O `a` em `3.4.1a2`. Isto pode ser `0xA` para alfa, `0xB` para beta, `0xC` para o candidato a lançamento ou `0xF` para final.

PY_RELEASE_SERIAL

  O `2` em `3.4.1a2`. Zero para os lançamentos finais.

PY_VERSION_HEX

  O número da versão do Python codificado em um único inteiro.

  As informações da versão subjacente podem ser achadas tratando-as como um número de 32 bits da seguinte maneira:

  Bytes | Bits (big endian order) | Significado | Valor para `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`

  Assim `3.4.1a2` é a versão hex `0x030401a2` e `3.10.0` é a versãos hex `0x030a00f0`.

  Use isso para comparações numéricas como, por exemplo, `#if PY_VERSION_HEX >= ...`.

  Esta versão também está disponível através do símbolo `Py_Version`.

const unsigned long Py_Version
  Parte da ABI Estável desde a versão 3.11.

  O número da versão do runtime do Python codificado em um único inteiro constante, com o mesmo formato da macro `PY_VERSION_HEX`. Ele contém a versão do Python usada em tempo de execução.

  Adicionado na versão 3.11.

Todas as macros dadas estão definidas em Include/patchlevel.h.