python-discovery 1.4.3__tar.gz → 1.5.0__tar.gz

python_discovery-1.5.0/.github/FUNDING.yaml

@@ -0,0 +1,2 @@
+github: gaborbernat
+thanks_dev: u/gh/gaborbernat

{python_discovery-1.4.3 → python_discovery-1.5.0}/.github/workflows/check.yaml

@@ -7,14 +7,11 @@ on:
   pull_request:
   schedule:
     - cron: "0 8 * * *"
-
 concurrency:
   group: check-${{ github.ref }}
   cancel-in-progress: true
-
 permissions:
   contents: read
-
 jobs:
   test:
     runs-on: ubuntu-latest
@@ -22,6 +19,8 @@ jobs:
       fail-fast: false
       matrix:
         env:
+          - "3.15"
+          - "3.15t"
           - "3.14"
           - "3.13"
           - "3.12"
@@ -39,7 +38,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
         with:
           enable-cache: false
           cache-dependency-glob: "pyproject.toml"

{python_discovery-1.4.3 → python_discovery-1.5.0}/.github/workflows/prepare-release.yaml

@@ -12,13 +12,10 @@ on:
           - minor
           - patch
         default: auto
-
 permissions:
   contents: read
-
 env:
   FORCE_COLOR: 1
-
 jobs:
   prepare-release:
     runs-on: ubuntu-24.04
@@ -31,19 +28,16 @@ jobs:
           fetch-depth: 0
           token: ${{ secrets.RELEASE_PAT }}
           persist-credentials: true
-
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
         with:
           enable-cache: true
           cache-dependency-glob: "pyproject.toml"
           github-token: ${{ secrets.GITHUB_TOKEN }}
-
       - name: Configure git
         run: |
           git config user.name "${GITHUB_ACTOR}"
           git config user.email "${GITHUB_ACTOR}@users.noreply.github.com"
-
       - name: Calculate next version
         id: version
         env:
@@ -84,16 +78,13 @@ jobs:
 
           echo "Next version: $next"
           echo "version=$next" >> $GITHUB_OUTPUT
-
       - name: Install tox
         run: uv tool install --python-preference only-managed --python 3.14 tox@latest --with tox-uv
-
       - name: Run release process
         run: tox run -e release -- ${STEPS_VERSION_OUTPUTS_VERSION}
         env:
           GH_TOKEN: ${{ secrets.RELEASE_PAT }}
           STEPS_VERSION_OUTPUTS_VERSION: ${{ steps.version.outputs.version }}
-
       - name: Display completion message
         run: echo "Release ${STEPS_VERSION_OUTPUTS_VERSION} prepared and pushed successfully!"
         env:

{python_discovery-1.4.3 → python_discovery-1.5.0}/.github/workflows/release.yaml

@@ -2,13 +2,10 @@ name: Release to PyPI
 on:
   push:
     tags: ["*"]
-
 permissions:
   contents: read
-
 env:
   dists-artifact-name: python-package-distributions
-
 jobs:
   build:
     runs-on: ubuntu-latest
@@ -18,7 +15,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
         with:
           enable-cache: false
           cache-dependency-glob: "pyproject.toml"
@@ -30,7 +27,6 @@ jobs:
         with:
           name: ${{ env.dists-artifact-name }}
           path: dist/*
-
   release:
     needs:
       - build

{python_discovery-1.4.3 → python_discovery-1.5.0}/.pre-commit-config.yaml

@@ -5,34 +5,41 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.37.3
+    rev: 0.37.4
     hooks:
       - id: check-github-workflows
         args: ["--verbose"]
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.4.2
+    rev: v2.4.3
     hooks:
       - id: codespell
         additional_dependencies: ["tomli>=2.4"]
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: "v2.25.1"
+    rev: "v2.25.3"
     hooks:
       - id: pyproject-fmt
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.15.20"
+    rev: "v0.15.22"
     hooks:
       - id: ruff-format
       - id: ruff
         args: ["--fix", "--unsafe-fixes", "--exit-non-zero-on-fix"]
-  - repo: https://github.com/rbubley/mirrors-prettier
-    rev: "v3.9.1"
+  - repo: https://github.com/google/yamlfmt
+    rev: "v0.21.0"
     hooks:
-      - id: prettier
+      - id: yamlfmt
+  - repo: local
+    hooks:
+      - id: mdformat
+        name: mdformat
+        entry: mdformat --wrap 120
+        language: python
+        types: [markdown]
         additional_dependencies:
-          - prettier@3.8.1
-          - "@prettier/plugin-xml@3.4.2"
+          - mdformat-gfm>=1
+          - mdformat-ruff>=0.1.3
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.26.1
+    rev: v1.27.0
     hooks:
       - id: zizmor
   - repo: meta

{python_discovery-1.4.3 → python_discovery-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-discovery
-Version: 1.4.3
+Version: 1.5.0
 Summary: Python interpreter discovery
 Project-URL: Changelog, https://github.com/tox-dev/python-discovery/releases
 Project-URL: Documentation, https://python-discovery.readthedocs.io
@@ -42,25 +42,13 @@ 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 :: 3.15
 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'
-Requires-Dist: sphinxcontrib-towncrier>=0.4; extra == 'docs'
-Requires-Dist: towncrier>=25.8; 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/)

{python_discovery-1.4.3 → python_discovery-1.5.0}/docs/changelog.rst

@@ -6,6 +6,25 @@
 
 .. towncrier release notes start
 
+********************
+ v1.5.0 (2026-07-21)
+********************
+
+Packaging updates and notes for downstreams - 1.5.0
+===================================================
+- Declare support for Python 3.15 and run the test suite against it, currently in beta. (:issue:`104`)
+
+********************
+ v1.4.4 (2026-07-08)
+********************
+
+Bug fixes - 1.4.4
+=================
+- Parse the debug build flag in interpreter specs - ``python3.13d`` and Debian's ``python3.13-dbg`` /
+  ``python3.13-debug`` now select a ``Py_DEBUG`` interpreter instead of being misread as an ISA named ``dbg``.
+  Resolving a virtualenv to its base interpreter also checks the free-threaded and debug ABI flags, so a debug or
+  free-threaded environment no longer resolves to a release build of the same version - by :user:`gaborbernat`. (:issue:`96`)
+
 ********************
  v1.4.3 (2026-07-03)
 ********************

{python_discovery-1.4.3 → python_discovery-1.5.0}/docs/conf.py

@@ -11,7 +11,7 @@ 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
+copyright = f"2026-{datetime.now(tz=timezone.utc).year}, {company}"  # ruff:ignore[builtin-variable-shadowing]
 
 extensions = [
     "sphinx.ext.autodoc",

{python_discovery-1.4.3 → python_discovery-1.5.0}/docs/explanation.rst

@@ -213,7 +213,7 @@ when encountering problematic interpreters.
 Spec format reference
 -----------------------
 
-A spec string follows the pattern ``[impl][version][t][-arch][-machine]``. Every part is optional.
+A spec string follows the pattern ``[impl][version][t][d][-arch][-machine]``. Every part is optional.
 
 .. mermaid::
 
@@ -221,12 +221,14 @@ A spec string follows the pattern ``[impl][version][t][-arch][-machine]``. Every
         Spec["Spec string"] --> Impl["impl<br>(optional)"]
         Impl --> Version["version<br>(optional)"]
         Version --> T["t<br>(optional)"]
-        T --> Arch["-arch<br>(optional)"]
+        T --> D["d / -dbg / -debug<br>(optional)"]
+        D --> 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 D fill:#4ad9c4,stroke:#2a8f7f,color:#fff
         style Arch fill:#d94a4a,stroke:#8f2a2a,color:#fff
         style Machine fill:#904ad9,stroke:#5f2a8f,color:#fff
 
@@ -237,9 +239,17 @@ A spec string follows the pattern ``[impl][version][t][-arch][-machine]``. Every
 - **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.
+- **d** -- require a debug (``Py_DEBUG``) build. Written as ``d`` right after the version (the ABI flag
+  form, as in ``python3.13d``) or as Debian's ``-dbg`` / ``-debug`` suffix (``python3.13-dbg``). When
+  omitted the build type is unconstrained.
 - **-arch** -- ``-32`` or ``-64`` for 32-bit or 64-bit interpreters.
 - **-machine** -- the CPU instruction set: ``-arm64``, ``-x86_64``, ``-aarch64``, ``-riscv64``, etc.
 
+Order matters: the parts appear in the sequence shown above. Combine the ABI flags as ``python3.13td``
+(free-threaded then debug, the order CPython uses in ``sys.abiflags``), and keep ``-arch`` before
+``-machine`` as in ``python3.13d-64-arm64``. Mixing ``d`` with ``-dbg`` in one spec, or swapping the arch
+and machine segments, leaves the string unrecognized, so it falls back to a literal executable-name match.
+
 **Full examples:**
 
 .. list-table::
@@ -258,6 +268,10 @@ A spec string follows the pattern ``[impl][version][t][-arch][-machine]``. Every
      - PyPy 3.9
    * - ``python3.13t``
      - Free-threaded (no-GIL) CPython 3.13
+   * - ``python3.13-dbg``
+     - Debug (``Py_DEBUG``) CPython 3.13 (``python3.13d`` also works)
+   * - ``python3.13td``
+     - Free-threaded debug CPython 3.13
    * - ``python3.12-64``
      - 64-bit CPython 3.12
    * - ``python3.12-64-arm64``

{python_discovery-1.4.3 → python_discovery-1.5.0}/docs/how-to/standalone-usage.rst

@@ -16,6 +16,25 @@ standard locations.
    if info is not None:
        print(info.executable)
 
+Select a debug build
+----------------------
+
+To require a debug (``Py_DEBUG``) interpreter, add the debug marker to the spec. Both the ABI-flag form
+``python3.13d`` and the Debian package name ``python3.13-dbg`` work, and each resolves to the same
+interpreter (Debian ships ``/usr/bin/python3.13d`` and ``/usr/bin/python3.13-dbg`` side by side). A spec with no
+marker keeps matching either build, so reach for the marker only when you need the debug build.
+
+.. code-block:: python
+
+   from python_discovery import get_interpreter
+
+   info = get_interpreter("python3.13-dbg")
+   if info is not None:
+       assert info.debug_build
+
+Combine the marker with the free-threaded ``t`` flag to select a free-threaded debug build, written
+``python3.13td`` (ABI-flag order is ``t`` then ``d``) or ``python3.13t-dbg``.
+
 Restrict the search environment
 ---------------------------------
 
@@ -135,6 +154,7 @@ Once you have a :class:`~python_discovery.PythonInfo`, you can inspect everythin
             +sysconfig_paths: dict
             +machine: str
             +free_threaded: bool
+            +debug_build: bool
         }
 
 .. code-block:: python
@@ -154,6 +174,7 @@ Once you have a :class:`~python_discovery.PythonInfo`, you can inspect everythin
    info.platform             # sys.platform value ("linux", "darwin", "win32").
    info.machine              # ISA: "arm64", "x86_64", etc.
    info.free_threaded        # True if this is a no-GIL build.
+   info.debug_build          # True if this is a Py_DEBUG build.
    info.sysconfig_vars       # All sysconfig.get_config_vars() values.
    info.sysconfig_paths      # All sysconfig.get_paths() values.
 

{python_discovery-1.4.3 → python_discovery-1.5.0}/docs/tutorial/getting-started.rst

@@ -142,12 +142,14 @@ You can add more constraints to narrow the search.
         Spec["Spec string"] --> Impl["impl<br>(optional)"]
         Impl --> Version["version<br>(optional)"]
         Version --> T["t<br>(optional)"]
-        T --> Arch["-arch<br>(optional)"]
+        T --> D["d / -dbg / -debug<br>(optional)"]
+        D --> 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 D fill:#4ad9c4,stroke:#2a8f7f,color:#fff
         style Arch fill:#d94a4a,stroke:#8f2a2a,color:#fff
         style Machine fill:#904ad9,stroke:#5f2a8f,color:#fff
 
@@ -167,6 +169,8 @@ Common examples:
      - PyPy 3.9
    * - ``python3.13t``
      - Free-threaded (no-GIL) CPython 3.13
+   * - ``python3.13-dbg``
+     - Debug (``Py_DEBUG``) CPython 3.13 (``python3.13d`` also works)
    * - ``python3.12-64``
      - 64-bit CPython 3.12
    * - ``python3.12-64-arm64``
@@ -188,11 +192,12 @@ inspecting what a spec means or for building tools on top of python-discovery.
 .. mermaid::
 
     flowchart TD
-        Input["cpython3.12t-64-arm64"] --> Parse["PythonSpec.from_string_spec()"]
+        Input["cpython3.13td-64-arm64"] --> Parse["PythonSpec.from_string_spec()"]
         Parse --> Spec["PythonSpec"]
         Spec --> impl["implementation: cpython"]
-        Spec --> ver["major: 3, minor: 12"]
+        Spec --> ver["major: 3, minor: 13"]
         Spec --> ft["free_threaded: True"]
+        Spec --> dbg["debug: True"]
         Spec --> arch["architecture: 64"]
         Spec --> mach["machine: arm64"]
 
@@ -203,11 +208,12 @@ inspecting what a spec means or for building tools on top of python-discovery.
 
    from python_discovery import PythonSpec
 
-   spec = PythonSpec.from_string_spec("cpython3.12t-64-arm64")
+   spec = PythonSpec.from_string_spec("cpython3.13td-64-arm64")
    spec.implementation   # "cpython"
    spec.major            # 3
-   spec.minor            # 12
+   spec.minor            # 13
    spec.free_threaded    # True
+   spec.debug            # True
    spec.architecture     # 64
    spec.machine          # "arm64"
 

{python_discovery-1.4.3 → python_discovery-1.5.0}/pyproject.toml

@@ -35,6 +35,7 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.15",
   "Programming Language :: Python :: Implementation :: CPython",
   "Topic :: Software Development :: Libraries",
   "Topic :: Utilities",
@@ -46,21 +47,6 @@ dependencies = [
   "filelock>=3.15.4",
   "platformdirs<5,>=4.3.6",
 ]
-optional-dependencies.docs = [
-  "furo>=2025.12.19",
-  "sphinx>=9.1",
-  "sphinx-autodoc-typehints>=3.6.3",
-  "sphinxcontrib-mermaid>=2",
-  "sphinxcontrib-towncrier>=0.4",
-  "towncrier>=25.8",
-]
-optional-dependencies.testing = [
-  "covdefaults>=2.3",
-  "coverage>=7.5.4",
-  "pytest>=8.3.5",
-  "pytest-mock>=3.14",
-  "setuptools>=75.1",
-]
 urls.Changelog = "https://github.com/tox-dev/python-discovery/releases"
 urls.Documentation = "https://python-discovery.readthedocs.io"
 urls.Homepage = "https://github.com/tox-dev/python-discovery"
@@ -68,6 +54,21 @@ urls.Source = "https://github.com/tox-dev/python-discovery"
 urls.Tracker = "https://github.com/tox-dev/python-discovery/issues"
 
 [dependency-groups]
+test = [
+  "covdefaults>=2.3",
+  "coverage>=7.5.4",
+  "pytest>=8.3.5",
+  "pytest-mock>=3.14",
+  "setuptools>=75.1",
+]
+docs = [
+  "furo>=2025.12.19",
+  "sphinx>=9.1",
+  "sphinx-autodoc-typehints>=3.6.3",
+  "sphinxcontrib-mermaid>=2",
+  "sphinxcontrib-towncrier>=0.4",
+  "towncrier>=25.8",
+]
 release = [
   "gitpython>=3.1.46",
   "packaging>=26",
@@ -145,7 +146,7 @@ write-changes = true
 count = true
 
 [tool.pyproject-fmt]
-max_supported_python = "3.14"
+max_supported_python = "3.15"
 
 [tool.ty]
 src.exclude = [ "tests/windows/winreg_mock_values.py" ]

{python_discovery-1.4.3 → python_discovery-1.5.0}/src/python_discovery/_cache.py

@@ -104,7 +104,7 @@ class DiskContentStore:
 
     @contextmanager
     def locked(self) -> Generator[None]:
-        from filelock import FileLock  # noqa: PLC0415
+        from filelock import FileLock  # ruff:ignore[import-outside-top-level]
 
         lock_path = self._folder / f"{self._key}.lock"
         lock_path.parent.mkdir(parents=True, exist_ok=True)
@@ -148,10 +148,10 @@ class DiskCache:
 class NoOpContentStore(ContentStore):
     """Content store that does nothing -- implements ContentStore protocol."""
 
-    def exists(self) -> bool:  # noqa: PLR6301
+    def exists(self) -> bool:  # ruff:ignore[no-self-use]
         return False
 
-    def read(self) -> dict | None:  # noqa: PLR6301
+    def read(self) -> dict | None:  # ruff:ignore[no-self-use]
         return None
 
     def write(self, content: dict) -> None:
@@ -161,14 +161,14 @@ class NoOpContentStore(ContentStore):
         pass
 
     @contextmanager
-    def locked(self) -> Generator[None]:  # noqa: PLR6301
+    def locked(self) -> Generator[None]:  # ruff:ignore[no-self-use]
         yield
 
 
 class NoOpCache(PyInfoCache):
     """Cache that does nothing -- implements PyInfoCache protocol."""
 
-    def py_info(self, path: Path) -> NoOpContentStore:  # noqa: ARG002, PLR6301
+    def py_info(self, path: Path) -> NoOpContentStore:  # ruff:ignore[unused-method-argument, no-self-use]
         return NoOpContentStore()
 
     def py_info_clear(self) -> None:

{python_discovery-1.4.3 → python_discovery-1.5.0}/src/python_discovery/_cached_py_info.py

@@ -8,14 +8,14 @@ import logging
 import os
 import pkgutil
 import secrets
-import subprocess  # noqa: S404
+import subprocess  # ruff:ignore[suspicious-subprocess-import]
 import sys
 import tempfile
 from collections import OrderedDict
 from contextlib import contextmanager
 from pathlib import Path
 from shlex import quote
-from subprocess import Popen, TimeoutExpired  # noqa: S404
+from subprocess import Popen, TimeoutExpired  # ruff:ignore[suspicious-subprocess-import]
 from typing import TYPE_CHECKING, Final
 
 from ._cache import NoOpCache
@@ -32,7 +32,7 @@ _CACHE[Path(sys.executable)] = PythonInfo()
 _LOGGER: Final[logging.Logger] = logging.getLogger(__name__)
 
 
-def from_exe(  # noqa: PLR0913
+def from_exe(  # ruff:ignore[too-many-arguments]
     cls: type[PythonInfo],
     cache: PyInfoCache | None,
     exe: str,
@@ -197,7 +197,7 @@ def _run_subprocess(
         env["PYTHONUTF8"] = "1"
         _LOGGER.debug("get interpreter info via cmd: %s", LogCmd(cmd))
         try:
-            process = Popen(  # noqa: S603
+            process = Popen(  # ruff:ignore[subprocess-without-shell-equals-true]
                 cmd,
                 universal_newlines=True,
                 stdin=subprocess.PIPE,

{python_discovery-1.4.3 → python_discovery-1.5.0}/src/python_discovery/_discovery.py

@@ -89,7 +89,7 @@ def iter_interpreters(
         yield from _iter_for_spec(spec_str, first_with, cache, env_map, predicate, seen)
 
 
-def _iter_for_spec(  # noqa: PLR0913, PLR0917
+def _iter_for_spec(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     spec_str: str | None,
     try_first_with: tuple[str, ...],
     cache: PyInfoCache | None,
@@ -231,7 +231,7 @@ def _propose_current_and_windows(
         yield current_python, True
 
     if IS_WIN:  # pragma: win32 cover
-        from ._windows import propose_interpreters as win_propose  # noqa: PLC0415
+        from ._windows import propose_interpreters as win_propose  # ruff:ignore[import-outside-top-level]
 
         for interpreter in win_propose(spec, cache, env):
             if _is_new_exe(str(interpreter.executable), tested_exes):