Command-Line Program

pyversion-info [<global-options>] <command> [<args> ...]

pyversion-info provides a command of the same name for querying information about Python versions from the command line.

Currently, the pyversion-info command has two subcommands, list and show. By default, the commands provide information about CPython versions; to get information about PyPy versions instead, pass the --pypy option to the subcommand.

Global Options

-d <database>, --database <database>

Use the given JSON file as the version information database instead of fetching data from the default URL. <database> can be either an HTTP or HTTPS URL or a path to a local file.

pyversion-info list

pyversion-info [<global-options>] list [<options>] {major|minor|micro}

List all major, minor, or micro Python versions, one per line.

Options

-a, --all

List all known versions of the given level

--cpython

Show information about CPython versions. This is the default.

-n, --not-eol

Only list versions that have not yet reached end-of-life (i.e., all supported versions plus all unreleased versions). This may only be used when querying information about CPython versions.

--pypy

Show information about PyPy versions

-r, --released

Only list released versions. This is the default.

-s, --supported

Only list currently-supported versions

pyversion-info show

pyversion-info [<global-options>] show [<options>] <version>

Show various information about a given Python version.

Sample outputs:

$ pyversion-info show 3
Version: 3
Level: major
Release-date: 2008-12-03
Is-released: yes
Is-supported: yes
EOL-Date: UNKNOWN
Is-EOL: no
Subversions: 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9
$ pyversion-info show 3.3
Version: 3.3
Level: minor
Release-date: 2012-09-29
Is-released: yes
Is-supported: no
EOL-date: 2017-09-29
Is-EOL: yes
Subversions: 3.3.0, 3.3.1, 3.3.2, 3.3.3, 3.3.4, 3.3.5, 3.3.6, 3.3.7
$ pyversion-info show 3.9.5
Version: 3.9.5
Level: micro
Release-date: 2021-05-03
Is-released: yes
Is-supported: yes
EOL-Date: 2025-10-01
Is-EOL: no
$ pyversion-info show --pypy 7.3
Version: 7.3
Level: minor
Release-Date: 2019-12-23
Is-Released: yes
Subversions: 7.3.0, 7.3.1, 7.3.2, 7.3.3, 7.3.4, 7.3.5, 7.3.6, 7.3.7
CPython-Series: 2.7, 3.6, 3.7, 3.8
$ pyversion-info show --pypy 7.3.7
Version: 7.3.7
Level: micro
Release-Date: 2021-10-25
Is-Released: yes
CPython: 3.7.12, 3.8.12

Options

--cpython

Show information about CPython versions. This is the default.

-J, --json

Output JSON

--pypy

Show information about PyPy versions

-S, --subversions <all|not-eol|released|supported>

Which subversions to list (and, for PyPy versions, which subversions to take into account when determining supported CPython versions); the choices have the same meanings as the list options of the same name [default: released]