Skip to main content

python-discovery

PyPI Supported Python versions Downloads check Documentation Status

What is python-discovery?

python-discovery is a library for discovering Python interpreters installed on your machine. You may have multiple Python versions from system packages, pyenv, mise, asdf, uv, or the Windows registry (PEP 514). This library finds the right one for you.

Give it a requirement like python3.12 or >=3.11,<3.13, and it searches all known locations, verifies each candidate, and returns detailed metadata about the match. Results are cached to disk so repeated lookups are fast.

Usage

from pathlib import Path

from python_discovery import DiskCache, get_interpreter

cache = DiskCache(root=Path("~/.cache/python-discovery").expanduser())
result = get_interpreter("python3.12", cache=cache)
if result is not None:
    print(result.executable)  # /usr/bin/python3.12
    print(result.implementation)  # CPython
    print(result.version_info[:3])  # (3, 12, 1)

The get_interpreter() function accepts various specification formats:

  • Absolute path: /usr/bin/python3.12
  • Version: 3.12
  • Implementation prefix: cpython3.12
  • Version specifier: >=3.10, >=3.11,<3.13

Documentation

Full documentation is available at python-discovery.readthedocs.io

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python_discovery-1.5.1.tar.gz (77.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

python_discovery-1.5.1-py3-none-any.whl (35.8 kB view details)

Uploaded Python 3

File details

Details for the file python_discovery-1.5.1.tar.gz.

File metadata

  • Download URL: python_discovery-1.5.1.tar.gz
  • Upload date:
  • Size: 77.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for python_discovery-1.5.1.tar.gz
Algorithm Hash digest
SHA256 e2ea8b884cd1701f386eda8cf327b87743f1dc21b7f784470799537d95635384
MD5 21682d839f544bd3064f30ebecbbe323
BLAKE2b-256 04b71581a8103855c43567776aa34135e5ec3c597346c23bfd10c7eb5e0b10a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_discovery-1.5.1.tar.gz:

Publisher: release.yaml on tox-dev/python-discovery

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file python_discovery-1.5.1-py3-none-any.whl.

File metadata

File hashes

Hashes for python_discovery-1.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ac07f44cade589d954e9d6a1e1468539fdddd2cf676beb51da73e0f156b7c932
MD5 dc16ea510bac17ed00f3f05a23b8e226
BLAKE2b-256 6a07a89b539750a159d5101c4eb9fc84e2961f65cefbd5e0b7440b284471c0b0

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_discovery-1.5.1-py3-none-any.whl:

Publisher: release.yaml on tox-dev/python-discovery

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page