python-discovery 1.6.3__tar.gz → 1.6.4__tar.gz

{python_discovery-1.6.3 → python_discovery-1.6.4}/.github/dependabot.yaml

@@ -2,6 +2,10 @@ version: 2
 updates:
   - package-ecosystem: "github-actions"
     directory: "/"
+    labels:
+      - dependencies
+      - github_actions
+      - skip news
     schedule:
       interval: "weekly"
       day: "tuesday"

{python_discovery-1.6.3 → python_discovery-1.6.4}/.github/workflows/check.yaml

@@ -5,6 +5,7 @@ on:
     branches: ["main"]
     tags-ignore: ["**"]
   pull_request:
+    types: [opened, synchronize, reopened, labeled, unlabeled]
   schedule:
     - cron: "0 8 * * *"
 concurrency:
@@ -37,7 +38,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
         with:
           python-version: "3.15"
           enable-cache: false
@@ -63,7 +64,7 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
         with:
           python-version: "3.15"
           enable-cache: false
@@ -80,3 +81,32 @@ jobs:
             run: tasks/old_target_check.sh 3.5 rejected
           - name: Reject Python 2.7
             run: tasks/old_target_check.sh 2.7 rejected
+  changelog:
+    if: github.event_name == 'pull_request' && !contains(github.event.pull_request.labels.*.name, 'skip news')
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
+        with:
+          python-version: "3.15"
+          enable-cache: false
+      - run: uvx towncrier check --compare-with "origin/${GITHUB_BASE_REF}"
+  gate:
+    name: Required checks pass
+    if: always()
+    needs: [test, old-target, changelog]
+    runs-on: ubuntu-24.04
+    steps:
+      - env:
+          NEEDS_JSON: ${{ toJSON(needs) }}
+        run: |
+          jq -e '
+            all(
+              to_entries[];
+              .value.result == "success" or
+              (.key == "changelog" and .value.result == "skipped")
+            )
+          ' <<< "$NEEDS_JSON"

python_discovery-1.6.4/.github/workflows/prepare-release.yaml

@@ -0,0 +1,156 @@
+name: Prepare Release
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: "Version bump type"
+        required: true
+        type: choice
+        options:
+          - auto
+          - major
+          - minor
+          - patch
+        default: auto
+permissions:
+  contents: read
+env:
+  FORCE_COLOR: 1
+jobs:
+  assemble:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0 # The next version comes from the tags.
+          persist-credentials: false
+      - name: Install uv
+        uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
+        with:
+          python-version: "3.15"
+          enable-cache: false
+      - name: Require a news fragment
+        run: |
+          if ! compgen -G 'docs/changelog/*.*.rst' > /dev/null; then
+            echo '::error::add a docs/changelog/*.rst fragment before preparing a release'
+            exit 1
+          fi
+      - name: Set up remote tracking
+        run: |
+          git remote -v
+          git fetch origin
+          git branch -a
+      - name: Calculate next version
+        id: version
+        env:
+          BUMP: ${{ inputs.bump }}
+        run: |
+          current=$(git describe --tags --abbrev=0 2>/dev/null || echo "0.0.0")
+          echo "Current version: $current"
+
+          IFS='.' read -r major minor patch <<< "$current"
+
+          bump_type="$BUMP"
+          if [ "$bump_type" = "auto" ]; then
+            feature_count=$(find docs/changelog -name "*.feature.rst" 2>/dev/null | wc -l)
+            breaking_count=$(find docs/changelog -name "*.breaking.rst" 2>/dev/null | wc -l)
+            if [ "$breaking_count" -gt 0 ]; then
+              bump_type="major"
+              echo "Auto-detected: major bump (found $breaking_count breaking changelog(s))"
+            elif [ "$feature_count" -gt 0 ]; then
+              bump_type="minor"
+              echo "Auto-detected: minor bump (found $feature_count feature changelog(s))"
+            else
+              bump_type="patch"
+              echo "Auto-detected: patch bump (no feature changelogs)"
+            fi
+          fi
+
+          case "$bump_type" in
+            major)
+              next="$((major + 1)).0.0"
+              ;;
+            minor)
+              next="$major.$((minor + 1)).0"
+              ;;
+            patch)
+              next="$major.$minor.$((patch + 1))"
+              ;;
+          esac
+
+          echo "Next version: $next"
+          echo "version=$next" >> "$GITHUB_OUTPUT"
+      - name: Build release patch
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          set -euo pipefail
+          uvx towncrier build --yes --version "$VERSION"
+          uvx --with pre-commit-uv pre-commit run --files docs/changelog.rst ||
+            uvx --with pre-commit-uv pre-commit run --files docs/changelog.rst
+          git diff HEAD --binary > "$RUNNER_TEMP/release.patch"
+          test -s "$RUNNER_TEMP/release.patch"
+      - uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: release-patch
+          path: ${{ runner.temp }}/release.patch
+          if-no-files-found: error
+  push:
+    needs: assemble
+    runs-on: ubuntu-24.04
+    environment: release-auth
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: release-patch
+          path: ${{ runner.temp }}/release-patch
+      - name: Validate release patch
+        env:
+          VERSION: ${{ needs.assemble.outputs.version }}
+        run: |
+          set -euo pipefail
+          git fetch origin main
+          git reset --hard origin/main
+          git apply --check "$RUNNER_TEMP/release-patch/release.patch"
+          git apply --index "$RUNNER_TEMP/release-patch/release.patch"
+          while IFS= read -r path; do
+            case "$path" in
+              docs/changelog.rst|docs/changelog/*.rst) ;;
+              *) echo "::error::unexpected release path: $path"; exit 1 ;;
+            esac
+          done < <(git diff --cached --name-only)
+          grep -qE "^ v${VERSION//./\\.} \(" docs/changelog.rst
+          git diff --cached --check
+      - id: token
+        uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
+        with:
+          client-id: ${{ vars.RELEASE_APP_CLIENT_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+          owner: ${{ github.repository_owner }}
+          repositories: ${{ github.event.repository.name }}
+          permission-contents: write
+      - name: Commit and tag the release
+        env:
+          VERSION: ${{ needs.assemble.outputs.version }}
+          GH_TOKEN: ${{ steps.token.outputs.token }}
+          APP_SLUG: ${{ steps.token.outputs.app-slug }}
+        run: |
+          set -euo pipefail
+          app_user_id=$(gh api "/users/${APP_SLUG}[bot]" --jq .id)
+          git config user.name "${APP_SLUG}[bot]"
+          git config user.email "${app_user_id}+${APP_SLUG}[bot]@users.noreply.github.com"
+          git commit -m "release $VERSION"
+          git tag -a "$VERSION" -m "release $VERSION"
+          gh auth setup-git --hostname github.com --force
+          git push --atomic origin HEAD:main "refs/tags/$VERSION"

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

@@ -0,0 +1,105 @@
+name: Release to PyPI
+on:
+  push:
+    tags: ["*"]
+permissions:
+  contents: read
+env:
+  dists-artifact-name: python-package-distributions
+jobs:
+  build:
+    runs-on: ubuntu-26.04
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Require a changelog section for the tag
+        env:
+          TAG: ${{ github.ref_name }}
+        run: |
+          if [[ ! "$TAG" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "::error::unexpected release tag $TAG"
+            exit 1
+          fi
+          if ! grep -qE "^ v${TAG//./\\.} \\(" docs/changelog.rst; then
+            echo "::error::docs/changelog.rst has no section for $TAG"
+            exit 1
+          fi
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
+        with:
+          python-version: "3.15"
+          enable-cache: false
+          cache-dependency-glob: "pyproject.toml"
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Build package
+        run: uv build --python 3.15 --python-preference only-managed --sdist --wheel . --out-dir dist
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: ${{ env.dists-artifact-name }}
+          path: dist/*
+  release:
+    needs:
+      - build
+    runs-on: ubuntu-26.04
+    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@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: ${{ env.dists-artifact-name }}
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          attestations: true
+  github-release:
+    needs: release
+    runs-on: ubuntu-26.04
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Publish GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          awk -v tag="$TAG" '
+            index($0, " v" tag " (") == 1 { found = 1; next }
+            found && /^ v[0-9]+\.[0-9]+\.[0-9]+ \(/ { exit }
+            found && $0 !~ /^\*+$/ { print }
+          ' docs/changelog.rst > "$RUNNER_TEMP/release-notes.md"
+          python3 - "$RUNNER_TEMP/release-notes.md" <<'PY'
+          import re
+          import sys
+          from pathlib import Path
+
+          path = Path(sys.argv[1])
+          body = path.read_text().strip()
+          if not body:
+              raise SystemExit("release notes are empty")
+          body = re.sub(r":user:`([^`]+)`", r"\1", body)
+          body = re.sub(r":(?:issue|pull):`(\d+)`", r"#\1", body)
+          body = re.sub(r":[a-z]+:`~?([^`]+)`", lambda match: f"`{match.group(1).split('.')[-1]}`", body)
+          path.write_text(body.replace("``", "`") + "\n")
+          PY
+          test -s "$RUNNER_TEMP/release-notes.md"
+          printf '\n[PyPI release](https://pypi.org/project/python-discovery/%s/)\n' "$TAG" >> "$RUNNER_TEMP/release-notes.md"
+          previous=$(git tag --list '[0-9]*' | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | awk -v tag="$TAG" '$0 == tag { print previous; exit } { previous = $0 }')
+          if [[ -n "$previous" ]]; then
+            printf '\n**Full Changelog**: https://github.com/%s/compare/%s...%s\n' "$GITHUB_REPOSITORY" "$previous" "$TAG" >> "$RUNNER_TEMP/release-notes.md"
+          else
+            printf '\n**Full Changelog**: https://github.com/%s/commits/%s\n' "$GITHUB_REPOSITORY" "$TAG" >> "$RUNNER_TEMP/release-notes.md"
+          fi
+          gh release create "$TAG" --verify-tag --title "v$TAG" --notes-file "$RUNNER_TEMP/release-notes.md"

{python_discovery-1.6.3 → python_discovery-1.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-discovery
-Version: 1.6.3
+Version: 1.6.4
 Summary: Python interpreter discovery
 Project-URL: Changelog, https://github.com/tox-dev/python-discovery/releases
 Project-URL: Documentation, https://python-discovery.readthedocs.io

{python_discovery-1.6.3 → python_discovery-1.6.4}/docs/changelog.rst

@@ -6,6 +6,26 @@
 
 .. towncrier release notes start
 
+********************
+ v1.6.4 (2026-10-19)
+********************
+
+Improved documentation - 1.6.4
+==============================
+- Clarify the executable paths accepted by ``try_first_with`` in the standalone usage example. (:issue:`150`)
+
+********************
+ v1.6.3 (2026-10-16)
+********************
+
+Bug fixes - 1.6.3
+=================
+- Treat specs with dot-only version components, such as ``python.``, as literal executable paths instead of raising
+  ``IndexError`` - by :user:`harbinresearcher`. (:issue:`147`)
+- Pass PEP 514 ``ExecutableArguments`` to registered Windows interpreters when querying them, so a registration that
+  points at a launcher such as ``py.exe -3.11`` reports the interpreter it selects - by :user:`blouirts123`.
+  (:issue:`148`)
+
 ********************
  v1.6.2 (2026-10-10)
 ********************
@@ -61,6 +81,14 @@ Improved documentation - 1.5.3
 ==============================
 - Document the version floors: runs on Python 3.8+, discovers interpreters down to 3.6 - by :user:`gaborbernat`. (:issue:`116`)
 
+********************
+ v1.5.2 (2026-08-12)
+********************
+
+Bug fixes - 1.5.2
+=================
+- Move interpreter interrogation into a Python 3.6-compatible collector. (:issue:`117`)
+
 ********************
  v1.5.1 (2026-07-31)
 ********************

{python_discovery-1.6.3 → python_discovery-1.6.4}/docs/how-to/standalone-usage.rst

@@ -1,10 +1,10 @@
 How-to guides
 =============
 
-Search specific directories first
------------------------------------
+Try specific executables first
+------------------------------
 
-If you know a likely location for the interpreter, pass it via ``try_first_with`` to check there
+If you know the path to an interpreter executable, pass it via ``try_first_with`` to check it
 before the normal search. This is useful when you have a custom Python install outside the
 standard locations.
 
@@ -12,7 +12,7 @@ standard locations.
 
    from python_discovery import get_interpreter
 
-   info = get_interpreter("python3.12", try_first_with=["/opt/python/bin"])
+   info = get_interpreter("python3.12", try_first_with=["/opt/python/bin/python3.12"])
    if info is not None:
        print(info.executable)
 

{python_discovery-1.6.3 → python_discovery-1.6.4}/pyproject.toml

@@ -228,5 +228,4 @@ type = [
   { directory = "doc", name = "Improved documentation", showcontent = true },
   { directory = "packaging", name = "Packaging updates and notes for downstreams", showcontent = true },
   { directory = "contrib", name = "Contributor-facing changes", showcontent = true },
-  { directory = "misc", name = "Miscellaneous internal changes", showcontent = true },
 ]

python_discovery-1.6.4/tasks/release.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+from pathlib import Path
+from subprocess import CalledProcessError, check_call, run
+from typing import Final
+
+from git import Commit, Remote, Repo
+from packaging.version import Version
+
+_ROOT_SRC_DIR: Final[Path] = Path(__file__).parents[1]
+
+
+def main(version_str: str) -> None:
+    version = Version(version_str)
+    repo = Repo(str(_ROOT_SRC_DIR))
+
+    if repo.is_dirty():
+        msg = "Current repository is dirty. Please commit any changes and try again."
+        raise RuntimeError(msg)
+    upstream = get_upstream(repo)
+    upstream.fetch()
+    if str(version) in {tag.name for tag in repo.tags}:
+        msg = f"release tag {version} already exists"
+        raise RuntimeError(msg)
+    repo.git.checkout("-B", f"release-{version}", upstream.refs.main)
+    release_commit = release_changelog(repo, version)
+    repo.create_tag(str(version), ref=release_commit.hexsha, message=f"release {version}")
+    repo.git.push(upstream.name, "HEAD:main")
+    repo.git.push(upstream.name, f"refs/tags/{version}")
+    create_github_release(version)
+
+
+def get_upstream(repo: Repo) -> Remote:
+    for remote in repo.remotes:
+        if any("tox-dev/python-discovery" in url for url in remote.urls):
+            return remote
+    msg = "could not find tox-dev/python-discovery remote"
+    raise RuntimeError(msg)
+
+
+def release_changelog(repo: Repo, version: Version) -> Commit:
+    print("generate release commit")  # ruff:ignore[print]
+    check_call(["towncrier", "build", "--yes", "--version", version.public], cwd=str(_ROOT_SRC_DIR))  # ruff:ignore[start-process-with-partial-path]
+    print("format changelog with pre-commit")  # ruff:ignore[print]
+    changelog_path = _ROOT_SRC_DIR / "docs" / "changelog.rst"
+    try:
+        check_call(["pre-commit", "run", "--files", str(changelog_path)], cwd=str(_ROOT_SRC_DIR))  # ruff:ignore[start-process-with-partial-path]
+    except CalledProcessError:
+        check_call(["pre-commit", "run", "--files", str(changelog_path)], cwd=str(_ROOT_SRC_DIR))  # ruff:ignore[start-process-with-partial-path]
+    repo.git.add("-A", "--", "docs/changelog.rst", "docs/changelog")
+    return repo.index.commit(f"release {version}")
+
+
+def create_github_release(version: Version) -> None:
+    print("create github release")  # ruff:ignore[print]
+    version_str = str(version)
+    try:
+        result = run(
+            ["gh", "release", "create", version_str, "--title", f"v{version_str}", "--generate-notes"],  # ruff:ignore[start-process-with-partial-path]
+            cwd=str(_ROOT_SRC_DIR),
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        if result.stdout:
+            print(result.stdout)  # ruff:ignore[print]
+    except CalledProcessError as e:
+        print(f"gh release create failed with exit code {e.returncode}")  # ruff:ignore[print]
+        if e.stdout:
+            print(f"stdout: {e.stdout}")  # ruff:ignore[print]
+        if e.stderr:
+            print(f"stderr: {e.stderr}")  # ruff:ignore[print]
+        raise
+
+
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser(prog="release")
+    parser.add_argument("--version", required=True)
+    options = parser.parse_args()
+    main(options.version)

python_discovery-1.6.3/.github/workflows/prepare-release.yaml

@@ -1,92 +0,0 @@
-name: Prepare Release
-on:
-  workflow_dispatch:
-    inputs:
-      bump:
-        description: "Version bump type"
-        required: true
-        type: choice
-        options:
-          - auto
-          - major
-          - minor
-          - patch
-        default: auto
-permissions:
-  contents: read
-env:
-  FORCE_COLOR: 1
-jobs:
-  prepare-release:
-    runs-on: ubuntu-24.04
-    environment: release-auth
-    permissions:
-      contents: write
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.RELEASE_PAT }}
-          persist-credentials: true
-      - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
-        with:
-          python-version: "3.15"
-          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:
-          BUMP: ${{ inputs.bump }}
-        run: |
-          current=$(git describe --tags --abbrev=0 2>/dev/null || echo "0.0.0")
-          echo "Current version: $current"
-
-          IFS='.' read -r major minor patch <<< "$current"
-
-          bump_type="$BUMP"
-          if [ "$bump_type" = "auto" ]; then
-            feature_count=$(find docs/changelog -name "*.feature.rst" 2>/dev/null | wc -l)
-            breaking_count=$(find docs/changelog -name "*.breaking.rst" 2>/dev/null | wc -l)
-            if [ "$breaking_count" -gt 0 ]; then
-              bump_type="major"
-              echo "Auto-detected: major bump (found $breaking_count breaking changelog(s))"
-            elif [ "$feature_count" -gt 0 ]; then
-              bump_type="minor"
-              echo "Auto-detected: minor bump (found $feature_count feature changelog(s))"
-            else
-              bump_type="patch"
-              echo "Auto-detected: patch bump (no feature changelogs)"
-            fi
-          fi
-
-          case "$bump_type" in
-            major)
-              next="$((major + 1)).0.0"
-              ;;
-            minor)
-              next="$major.$((minor + 1)).0"
-              ;;
-            patch)
-              next="$major.$minor.$((patch + 1))"
-              ;;
-          esac
-
-          echo "Next version: $next"
-          echo "version=$next" >> $GITHUB_OUTPUT
-      - name: Install tox
-        run: uv tool install --python-preference only-managed --python 3.15 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:
-          STEPS_VERSION_OUTPUTS_VERSION: ${{ steps.version.outputs.version }}

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

@@ -1,49 +0,0 @@
-name: Release to PyPI
-on:
-  push:
-    tags: ["*"]
-permissions:
-  contents: read
-env:
-  dists-artifact-name: python-package-distributions
-jobs:
-  build:
-    runs-on: ubuntu-26.04
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          fetch-depth: 0
-          persist-credentials: false
-      - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
-        with:
-          python-version: "3.15"
-          enable-cache: false
-          cache-dependency-glob: "pyproject.toml"
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-      - name: Build package
-        run: uv build --python 3.15 --python-preference only-managed --sdist --wheel . --out-dir dist
-      - name: Store the distribution packages
-        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
-        with:
-          name: ${{ env.dists-artifact-name }}
-          path: dist/*
-  release:
-    needs:
-      - build
-    runs-on: ubuntu-26.04
-    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@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
-        with:
-          name: ${{ env.dists-artifact-name }}
-          path: dist/
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
-        with:
-          attestations: true

python_discovery-1.6.3/docs/changelog/147.bugfix.rst

@@ -1,2 +0,0 @@
-Treat specs with dot-only version components, such as ``python.``, as literal executable paths instead of raising
-``IndexError`` - by :user:`harbinresearcher`.

python_discovery-1.6.3/docs/changelog/148.bugfix.rst

@@ -1,2 +0,0 @@
-Pass PEP 514 ``ExecutableArguments`` to registered Windows interpreters when querying them, so a registration that
-points at a launcher such as ``py.exe -3.11`` reports the interpreter it selects - by :user:`blouirts123`.

python_discovery-1.6.3/tasks/release.py

@@ -1,173 +0,0 @@
-"""Handles creating a release commit and tag, then publishes the GitHub release."""
-
-from __future__ import annotations
-
-from pathlib import Path
-from subprocess import CalledProcessError, check_call, run
-
-from git import Commit, Head, Remote, Repo, TagReference
-from packaging.version import Version
-
-ROOT_SRC_DIR = Path(__file__).parents[1]
-
-
-def main(version_str: str) -> None:
-    version = Version(version_str)
-    repo = Repo(str(ROOT_SRC_DIR))
-
-    if repo.is_dirty():
-        msg = "Current repository is dirty. Please commit any changes and try again."
-        raise RuntimeError(msg)
-    upstream, release_branch = create_release_branch(repo, version)
-    original_main_sha = upstream.refs.main.commit.hexsha
-    main_pushed = False
-    tag_pushed = False
-    release_created = False
-    try:
-        main_pushed, tag_pushed, release_created = push_release(repo, upstream, release_branch, version)
-        finalize_release(repo, upstream, release_branch)
-    except Exception:
-        cleanup_failed_release(
-            repo,
-            upstream,
-            version,
-            release_branch,
-            original_main_sha,
-            release_created=release_created,
-            tag_pushed=tag_pushed,
-            main_pushed=main_pushed,
-        )
-        raise
-
-
-def create_release_branch(repo: Repo, version: Version) -> tuple[Remote, Head]:
-    print("create release branch from upstream main")  # ruff:ignore[print]
-    upstream = get_upstream(repo)
-    upstream.fetch()
-    branch_name = f"release-{version}"
-    release_branch = repo.create_head(branch_name, upstream.refs.main, force=True)
-    upstream.push(refspec=f"{branch_name}:{branch_name}", force=True)
-    release_branch.set_tracking_branch(upstream.refs[branch_name])
-    release_branch.checkout()
-    return upstream, release_branch
-
-
-def get_upstream(repo: Repo) -> Remote:
-    for remote in repo.remotes:
-        if any("tox-dev/python-discovery" in url for url in remote.urls):
-            return remote
-    msg = "could not find tox-dev/python-discovery remote"
-    raise RuntimeError(msg)
-
-
-def push_release(repo: Repo, upstream: Remote, release_branch: Head, version: Version) -> tuple[bool, bool, bool]:
-    release_commit = release_changelog(repo, version)
-    tag = tag_release_commit(release_commit, repo, version)
-    print("push release commit")  # ruff:ignore[print]
-    repo.git.push(upstream.name, f"{release_branch}:main", "-f")
-    print("push release tag")  # ruff:ignore[print]
-    repo.git.push(upstream.name, tag, "-f")
-    create_github_release(version)
-    return True, True, True
-
-
-def release_changelog(repo: Repo, version: Version) -> Commit:
-    print("generate release commit")  # ruff:ignore[print]
-    check_call(["towncrier", "build", "--yes", "--version", version.public], cwd=str(ROOT_SRC_DIR))  # ruff:ignore[start-process-with-partial-path]
-    print("format changelog with pre-commit")  # ruff:ignore[print]
-    changelog_path = ROOT_SRC_DIR / "docs" / "changelog.rst"
-    try:
-        check_call(["pre-commit", "run", "--files", str(changelog_path)], cwd=str(ROOT_SRC_DIR))  # ruff:ignore[start-process-with-partial-path]
-    except CalledProcessError:
-        print("pre-commit made formatting changes, staging them")  # ruff:ignore[print]
-    repo.index.add([str(changelog_path)])
-    return repo.index.commit(f"release {version}")
-
-
-def tag_release_commit(release_commit: Commit, repo: Repo, version: Version) -> TagReference:
-    print("tag release commit")  # ruff:ignore[print]
-    version_str = str(version)
-    if version_str in {tag.name for tag in repo.tags}:
-        print(f"delete existing tag {version_str}")  # ruff:ignore[print]
-        repo.delete_tag(repo.tags[version_str])
-    print(f"create tag {version_str}")  # ruff:ignore[print]
-    return repo.create_tag(version_str, ref=release_commit.hexsha, force=True)
-
-
-def create_github_release(version: Version) -> None:
-    print("create github release")  # ruff:ignore[print]
-    version_str = str(version)
-    try:
-        result = run(
-            ["gh", "release", "create", version_str, "--title", f"v{version_str}", "--generate-notes"],  # ruff:ignore[start-process-with-partial-path]
-            cwd=str(ROOT_SRC_DIR),
-            capture_output=True,
-            text=True,
-            check=True,
-        )
-        if result.stdout:
-            print(result.stdout)  # ruff:ignore[print]
-    except CalledProcessError as e:
-        print(f"gh release create failed with exit code {e.returncode}")  # ruff:ignore[print]
-        if e.stdout:
-            print(f"stdout: {e.stdout}")  # ruff:ignore[print]
-        if e.stderr:
-            print(f"stderr: {e.stderr}")  # ruff:ignore[print]
-        raise
-
-
-def finalize_release(repo: Repo, upstream: Remote, release_branch: Head) -> None:
-    print("checkout main to new release and delete release branch")  # ruff:ignore[print]
-    repo.heads.main.checkout()
-    repo.delete_head(release_branch, force=True)
-    print("delete remote release branch")  # ruff:ignore[print]
-    repo.git.push(upstream.name, f":{release_branch}", "--no-verify")
-    upstream.fetch()
-    repo.git.reset("--hard", f"{upstream.name}/main")
-    print("All done!")  # ruff:ignore[print]
-
-
-def cleanup_failed_release(  # ruff:ignore[too-many-arguments]
-    repo: Repo,
-    upstream: Remote,
-    version: Version,
-    release_branch: Head,
-    original_main_sha: str,
-    *,
-    release_created: bool,
-    tag_pushed: bool,
-    main_pushed: bool,
-) -> None:
-    print("Release failed! Cleaning up...")  # ruff:ignore[print]
-    if release_created:
-        print(f"Deleting GitHub release {version}")  # ruff:ignore[print]
-        try:
-            check_call(["gh", "release", "delete", str(version), "--yes"], cwd=str(ROOT_SRC_DIR))  # ruff:ignore[start-process-with-partial-path]
-        except Exception as cleanup_error:  # ruff:ignore[blind-except]
-            print(f"Warning: Failed to delete GitHub release: {cleanup_error}")  # ruff:ignore[print]
-    if tag_pushed:
-        print(f"Deleting remote tag {version}")  # ruff:ignore[print]
-        try:
-            repo.git.push(upstream.name, f":refs/tags/{version}", "--no-verify")
-        except Exception as cleanup_error:  # ruff:ignore[blind-except]
-            print(f"Warning: Failed to delete remote tag: {cleanup_error}")  # ruff:ignore[print]
-    if main_pushed:
-        print(f"Reverting main to {original_main_sha[:8]}")  # ruff:ignore[print]
-        try:
-            repo.git.push(upstream.name, f"{original_main_sha}:main", "-f", "--no-verify")
-        except Exception as cleanup_error:  # ruff:ignore[blind-except]
-            print(f"Warning: Failed to revert main: {cleanup_error}")  # ruff:ignore[print]
-    print("Deleting remote release branch")  # ruff:ignore[print]
-    try:
-        repo.git.push(upstream.name, f":{release_branch}", "--no-verify")
-    except Exception as cleanup_error:  # ruff:ignore[blind-except]
-        print(f"Warning: Failed to delete remote branch: {cleanup_error}")  # ruff:ignore[print]
-
-
-if __name__ == "__main__":
-    import argparse
-
-    parser = argparse.ArgumentParser(prog="release")
-    parser.add_argument("--version", required=True)
-    options = parser.parse_args()
-    main(options.version)