python-discovery 1.0.0__tar.gz

python_discovery-1.0.0/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

python_discovery-1.0.0/.github/release.yml

@@ -0,0 +1,5 @@
+changelog:
+  exclude:
+    authors:
+      - dependabot
+      - pre-commit-ci

python_discovery-1.0.0/.github/workflows/check.yaml

@@ -0,0 +1,54 @@
+name: check
+on:
+  workflow_dispatch:
+  push:
+    branches: ["main"]
+    tags-ignore: ["**"]
+  pull_request:
+  schedule:
+    - cron: "0 8 * * *"
+
+concurrency:
+  group: check-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        env:
+          - "3.14"
+          - "3.13"
+          - "3.12"
+          - "3.11"
+          - "3.10"
+          - "3.9"
+          - "3.8"
+          - type-3.8
+          - type-3.14
+          - dev
+          - pkg_meta
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Install tox
+        run: uv tool install --python-preference only-managed --python 3.14 tox --with tox-uv
+      - name: Install Python
+        if: startsWith(matrix.env, '3.') && matrix.env != '3.14'
+        run: uv python install --python-preference only-managed ${{ matrix.env }}
+      - name: Setup test suite
+        run: tox run -vv --notest --skip-missing-interpreters false -e ${{ matrix.env }}
+      - name: Run test suite
+        run: tox run --skip-pkg-install -e ${{ matrix.env }}
+        env:
+          PYTEST_ADDOPTS: "-vv --durations=20"
+          DIFF_AGAINST: HEAD

python_discovery-1.0.0/.github/workflows/release.yaml

@@ -0,0 +1,48 @@
+name: Release to PyPI
+on:
+  push:
+    tags: ["*"]
+
+env:
+  dists-artifact-name: python-package-distributions
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Build package
+        run: uv build --python 3.14 --python-preference only-managed --sdist --wheel . --out-dir dist
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v6
+        with:
+          name: ${{ env.dists-artifact-name }}
+          path: dist/*
+
+  release:
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    environment:
+      name: release
+      url: https://pypi.org/project/python-discovery/${{ github.ref_name }}
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v7
+        with:
+          name: ${{ env.dists-artifact-name }}
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.13.0
+        with:
+          attestations: true

python_discovery-1.0.0/.gitignore

@@ -0,0 +1,5 @@
+*.pyc
+*.egg-info
+dist/
+.tox/
+/src/python_discovery/_version.py

python_discovery-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,37 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.36.1
+    hooks:
+      - id: check-github-workflows
+        args: ["--verbose"]
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+      - id: codespell
+        additional_dependencies: ["tomli>=2.4"]
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: "v2.11.1"
+    hooks:
+      - id: pyproject-fmt
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: "v0.14.14"
+    hooks:
+      - id: ruff-format
+      - id: ruff
+        args: ["--fix", "--unsafe-fixes", "--exit-non-zero-on-fix"]
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: "v3.8.1"
+    hooks:
+      - id: prettier
+        additional_dependencies:
+          - prettier@3.8.1
+          - "@prettier/plugin-xml@3.4.2"
+  - repo: meta
+    hooks:
+      - id: check-hooks-apply
+      - id: check-useless-excludes

python_discovery-1.0.0/.readthedocs.yaml

@@ -0,0 +1,8 @@
+version: 2
+build:
+  os: ubuntu-lts-latest
+  tools: {}
+  commands:
+    - curl -LsSf https://astral.sh/uv/install.sh | sh
+    - ~/.local/bin/uv tool install tox --with tox-uv -p 3.14 --managed-python
+    - ~/.local/bin/tox run -e docs --

python_discovery-1.0.0/.readthedocs.yml

@@ -0,0 +1,8 @@
+version: 2
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+  commands:
+    - pip install tox
+    - tox r -e docs -- "${READTHEDOCS_OUTPUT}"/html

python_discovery-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,60 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making
+participation in our project and our community a harassment-free experience for everyone, regardless of age, body size,
+disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race,
+religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+- The use of sexualized language or imagery and unwelcome sexual attention or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take
+appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits,
+issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any
+contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the
+project or its community. Examples of representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed representative at an online or offline
+event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at
+tox-dev@python.org. The project team will review and investigate all complaints, and will respond in a way that it deems
+appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter
+of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent
+repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at
+[https://www.contributor-covenant.org/version/1/4/code-of-conduct.html][version]
+
+[homepage]: https://www.contributor-covenant.org/
+[version]: https://www.contributor-covenant.org/version/1/4/

python_discovery-1.0.0/LICENSE

@@ -0,0 +1,18 @@
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

python_discovery-1.0.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: python-discovery
+Version: 1.0.0
+Summary: Python interpreter discovery
+Project-URL: Changelog, https://github.com/tox-dev/python-discovery/releases
+Project-URL: Documentation, https://python-discovery.readthedocs.io
+Project-URL: Homepage, https://github.com/tox-dev/python-discovery
+Project-URL: Source, https://github.com/tox-dev/python-discovery
+Project-URL: Tracker, https://github.com/tox-dev/python-discovery/issues
+Maintainer-email: Bernát Gábor <gaborjbernat@gmail.com>
+License: Permission is hereby granted, free of charge, to any person obtaining a
+        copy of this software and associated documentation files (the
+        "Software"), to deal in the Software without restriction, including
+        without limitation the rights to use, copy, modify, merge, publish,
+        distribute, sublicense, and/or sell copies of the Software, and to
+        permit persons to whom the Software is furnished to do so, subject to
+        the following conditions:
+        
+        The above copyright notice and this permission notice shall be included
+        in all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+        OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+        CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+        TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+License-File: LICENSE
+Keywords: discovery,interpreter,python
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Requires-Dist: filelock>=3.15.4
+Requires-Dist: platformdirs<5,>=4.3.6
+Provides-Extra: docs
+Requires-Dist: furo>=2025.12.19; extra == 'docs'
+Requires-Dist: sphinx-autodoc-typehints>=3.6.3; extra == 'docs'
+Requires-Dist: sphinx>=9.1; extra == 'docs'
+Requires-Dist: sphinxcontrib-mermaid>=2; extra == 'docs'
+Provides-Extra: testing
+Requires-Dist: covdefaults>=2.3; extra == 'testing'
+Requires-Dist: coverage>=7.5.4; extra == 'testing'
+Requires-Dist: pytest-mock>=3.14; extra == 'testing'
+Requires-Dist: pytest>=8.3.5; extra == 'testing'
+Requires-Dist: setuptools>=75.1; extra == 'testing'
+Description-Content-Type: text/markdown
+
+# [`python-discovery`](https://python-discovery.readthedocs.io/en/latest/)
+
+[![PyPI](https://img.shields.io/pypi/v/python-discovery?style=flat-square)](https://pypi.org/project/python-discovery/)
+[![Supported Python
+versions](https://img.shields.io/pypi/pyversions/python-discovery.svg)](https://pypi.org/project/python-discovery/)
+[![Downloads](https://static.pepy.tech/badge/python-discovery/month)](https://pepy.tech/project/python-discovery)
+[![check](https://github.com/tox-dev/python-discovery/actions/workflows/check.yml/badge.svg)](https://github.com/tox-dev/python-discovery/actions/workflows/check.yml)
+[![Documentation Status](https://readthedocs.org/projects/python-discovery/badge/?version=latest)](https://python-discovery.readthedocs.io/en/latest/?badge=latest)

python_discovery-1.0.0/README.md

@@ -0,0 +1,8 @@
+# [`python-discovery`](https://python-discovery.readthedocs.io/en/latest/)
+
+[![PyPI](https://img.shields.io/pypi/v/python-discovery?style=flat-square)](https://pypi.org/project/python-discovery/)
+[![Supported Python
+versions](https://img.shields.io/pypi/pyversions/python-discovery.svg)](https://pypi.org/project/python-discovery/)
+[![Downloads](https://static.pepy.tech/badge/python-discovery/month)](https://pepy.tech/project/python-discovery)
+[![check](https://github.com/tox-dev/python-discovery/actions/workflows/check.yml/badge.svg)](https://github.com/tox-dev/python-discovery/actions/workflows/check.yml)
+[![Documentation Status](https://readthedocs.org/projects/python-discovery/badge/?version=latest)](https://python-discovery.readthedocs.io/en/latest/?badge=latest)

python_discovery-1.0.0/docs/_static/custom.css

@@ -0,0 +1,4 @@
+.sidebar-logo img {
+  max-width: 100%;
+  width: 100%;
+}

python_discovery-1.0.0/docs/_static/logo.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 24 24" fill="none" stroke-linecap="round" stroke-linejoin="round">
+
+  <!-- Magnifying glass (Python blue) -->
+  <circle cx="10.5" cy="10.5" r="6.5" stroke="#3776AB" stroke-width="2"></circle>
+  <path d="M15.7 15.7L21 21" stroke="#3776AB" stroke-width="2"></path>
+
+  <!-- "<>" (Python yellow) -->
+  <path d="M9.3 8.9L7.7 10.5L9.3 12.1" stroke="#FFD43B" stroke-width="2"></path>
+  <path d="M11.7 8.9L13.3 10.5L11.7 12.1" stroke="#FFD43B" stroke-width="2"></path>
+
+</svg>

python_discovery-1.0.0/docs/conf.py

@@ -0,0 +1,48 @@
+"""Sphinx configuration for python-discovery documentation."""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+from python_discovery import __version__
+
+company = "tox-dev"
+name = "python-discovery"
+version = ".".join(__version__.split(".")[:2])
+release = __version__
+copyright = f"2026-{datetime.now(tz=timezone.utc).year}, {company}"  # noqa: A001
+
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosectionlabel",
+    "sphinx.ext.extlinks",
+    "sphinx.ext.intersphinx",
+    "sphinx_autodoc_typehints",
+    "sphinxcontrib.mermaid",
+]
+
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3", None),
+}
+
+templates_path = []
+source_suffix = ".rst"
+exclude_patterns = ["_build"]
+
+main_doc = "index"
+pygments_style = "default"
+always_document_param_types = True
+project = name
+
+html_theme = "furo"
+html_title = project
+html_last_updated_fmt = datetime.now(tz=timezone.utc).isoformat()
+pygments_dark_style = "monokai"
+html_show_sourcelink = False
+html_static_path = ["_static"]
+html_theme_options = {
+    "light_logo": "logo.svg",
+    "dark_logo": "logo.svg",
+    "sidebar_hide_name": True,
+}
+html_css_files = ["custom.css"]

python_discovery-1.0.0/docs/explanation.rst

@@ -0,0 +1,153 @@
+How it works
+============
+
+Where does python-discovery look?
+-------------------------------
+
+When you call :func:`~python_discovery.get_interpreter`, the library checks several locations in
+order. It stops as soon as it finds an interpreter that matches your spec.
+
+.. mermaid::
+
+    flowchart TD
+        Start["get_interpreter()"] --> AbsPath{"Is spec an<br>absolute path?"}
+        AbsPath -->|Yes| TryAbs["Use path directly"]
+        AbsPath -->|No| TryFirst["try_first_with paths"]
+        TryFirst --> RelPath{"Is spec a<br>relative path?"}
+        RelPath -->|Yes| TryRel["Resolve relative to cwd"]
+        RelPath -->|No| Current["Current interpreter"]
+        Current --> Win{"Windows?"}
+        Win -->|Yes| PEP514["PEP 514 registry"]
+        Win -->|No| PATH
+        PEP514 --> PATH["PATH search"]
+        PATH --> Shims["Version-manager shims<br>(pyenv / mise / asdf)"]
+        Shims --> UV["uv-managed Pythons"]
+
+        TryAbs --> Verify
+        TryRel --> Verify
+        UV --> Verify
+
+        Verify{{"Verify candidate<br>(subprocess call)"}}
+        Verify -->|Matches spec| Cache["Cache and return"]
+        Verify -->|No match| Next["Try next candidate"]
+
+        style Start fill:#4a90d9,stroke:#2a5f8f,color:#fff
+        style Verify fill:#d9904a,stroke:#8f5f2a,color:#fff
+        style Cache fill:#4a9f4a,stroke:#2a6f2a,color:#fff
+        style Next fill:#d94a4a,stroke:#8f2a2a,color:#fff
+
+Each candidate is verified by running it as a subprocess and collecting its metadata (version,
+architecture, platform, sysconfig values, etc.). This subprocess call is the expensive part, which
+is why results are cached.
+
+How version-manager shims are handled
+-----------------------------------------
+
+Version managers like `pyenv <https://github.com/pyenv/pyenv>`_ install thin wrapper scripts called
+**shims** (e.g., ``~/.pyenv/shims/python3.12``) that redirect to the real interpreter. python-discovery
+detects these shims and resolves them to the actual binary.
+
+.. mermaid::
+
+    flowchart TD
+        Shim["Shim detected"] --> EnvVar{"PYENV_VERSION<br>set?"}
+        EnvVar -->|Yes| Use["Use that version"]
+        EnvVar -->|No| File{".python-version<br>file exists?"}
+        File -->|Yes| Use
+        File -->|No| Global{"pyenv global<br>version exists?"}
+        Global -->|Yes| Use
+        Global -->|No| Skip["Skip shim"]
+
+        style Shim fill:#4a90d9,stroke:#2a5f8f,color:#fff
+        style Use fill:#4a9f4a,stroke:#2a6f2a,color:#fff
+        style Skip fill:#d94a4a,stroke:#8f2a2a,color:#fff
+
+`mise <https://mise.jdx.dev/>`_ and `asdf <https://asdf-vm.com/>`_ work similarly, using the
+``MISE_DATA_DIR`` and ``ASDF_DATA_DIR`` environment variables to locate their installations.
+
+How caching works
+-------------------
+
+Querying an interpreter requires a subprocess call, which is slow. The cache avoids repeating this
+work by storing the result as a JSON file keyed by the interpreter's path.
+
+.. mermaid::
+
+    flowchart TD
+        Lookup["py_info(path)"] --> Exists{"Cache hit?"}
+        Exists -->|Yes| Read["Read JSON"]
+        Exists -->|No| Run["Run subprocess"]
+        Run --> Write["Write JSON<br>(with filelock)"]
+        Write --> Return["Return PythonInfo"]
+        Read --> Return
+
+        style Lookup fill:#4a90d9,stroke:#2a5f8f,color:#fff
+        style Return fill:#4a9f4a,stroke:#2a6f2a,color:#fff
+        style Run fill:#d9904a,stroke:#8f5f2a,color:#fff
+
+The built-in :class:`~python_discovery.DiskCache` stores files under ``<root>/py_info/4/<sha256>.json``
+with `filelock <https://py-filelock.readthedocs.io/>`_-based locking for safe concurrent access. You
+can also pass ``cache=None`` to disable caching, or implement your own backend (see
+:doc:`/how-to/standalone-usage`).
+
+Spec format reference
+-----------------------
+
+A spec string follows the pattern ``[impl][version][t][-arch][-machine]``. Every part is optional.
+
+.. mermaid::
+
+    flowchart TD
+        Spec["Spec string"] --> Impl["impl<br>(optional)"]
+        Impl --> Version["version<br>(optional)"]
+        Version --> T["t<br>(optional)"]
+        T --> Arch["-arch<br>(optional)"]
+        Arch --> Machine["-machine<br>(optional)"]
+
+        style Impl fill:#4a90d9,stroke:#2a5f8f,color:#fff
+        style Version fill:#4a9f4a,stroke:#2a6f2a,color:#fff
+        style T fill:#d9904a,stroke:#8f5f2a,color:#fff
+        style Arch fill:#d94a4a,stroke:#8f2a2a,color:#fff
+        style Machine fill:#904ad9,stroke:#5f2a8f,color:#fff
+
+**Parts explained:**
+
+- **impl** -- the Python implementation name. ``python`` and ``py`` both mean "any implementation"
+  (usually CPython). Use ``cpython``, ``pypy``, or ``graalpy`` to be explicit.
+- **version** -- dotted version number (``3``, ``3.12``, or ``3.12.1``). You can also write
+  ``312`` as shorthand for ``3.12``.
+- **t** -- appended directly after the version. Matches free-threaded (no-GIL) builds only.
+- **-arch** -- ``-32`` or ``-64`` for 32-bit or 64-bit interpreters.
+- **-machine** -- the CPU instruction set: ``-arm64``, ``-x86_64``, ``-aarch64``, ``-riscv64``, etc.
+
+**Full examples:**
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 70
+
+   * - Spec
+     - Meaning
+   * - ``3.12``
+     - Any Python 3.12
+   * - ``python3.12``
+     - CPython 3.12
+   * - ``cpython3.12``
+     - Explicitly CPython 3.12
+   * - ``pypy3.9``
+     - PyPy 3.9
+   * - ``python3.13t``
+     - Free-threaded (no-GIL) CPython 3.13
+   * - ``python3.12-64``
+     - 64-bit CPython 3.12
+   * - ``python3.12-64-arm64``
+     - 64-bit CPython 3.12 on ARM64
+   * - ``/usr/bin/python3``
+     - Absolute path, used directly (no search)
+   * - ``>=3.11,<3.13``
+     - :pep:`440` version specifier (any Python in range)
+   * - ``cpython>=3.11``
+     - :pep:`440` specifier restricted to CPython
+
+:pep:`440` specifiers (``>=``, ``<=``, ``~=``, ``!=``, ``==``, ``===``) are supported. Multiple
+specifiers can be comma-separated, for example ``>=3.11,<3.13``.