pytest-selective 1.1.0__tar.gz → 1.1.2__tar.gz

pytest_selective-1.1.2/.github/validation-inputs.json

@@ -0,0 +1,26 @@
+{
+  "tests": [
+    ".github",
+    "src",
+    "tests",
+    "scripts",
+    "actions",
+    "action.yml",
+    "pyproject.toml",
+    "uv.lock",
+    ".pre-commit-config.yaml"
+  ],
+  "contracts": [
+    ".github",
+    "src",
+    "contracts",
+    "tests/testing/git_repo.py",
+    "scripts",
+    "actions",
+    "action.yml",
+    "pyproject.toml",
+    "uv.lock",
+    ".pre-commit-config.yaml",
+    "README.md"
+  ]
+}

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/.github/workflows/ci.yml

@@ -29,8 +29,10 @@ jobs:
         "py311-macos":"tests (3.11, macos-latest)","py314-ubuntu":"tests (3.14, ubuntu-latest)",
         "py314-windows":"tests (3.14, windows-latest)","py314-macos":"tests (3.14, macos-latest)",
         "minimum":"pytest-minimum"}
+      # The contracts lane's one job. It reads README.md, so it keeps its own inputs and receipt.
+      CONTRACT_LANE_JOBS: '{"selection":"Selection contract (Quint)"}'
     outputs:
-      # Planned lanes after reuse: the tests lane is false only when every one of its jobs is proven by a receipt.
+      # Planned lanes after reuse: a reusing lane is false only when every one of its jobs is proven by a receipt.
       lanes: ${{ steps.admit.outputs.lanes }}
       # The plan before reuse, for steps that follow changed runtime inputs rather than test execution.
       planned: ${{ steps.plan.outputs.lanes }}
@@ -38,6 +40,7 @@ jobs:
       files: ${{ steps.files.outputs.test_roots_json }}
       receipt: ${{ steps.evidence.outputs.receipt }}
       reused: ${{ steps.evidence.outputs.reused }}
+      contract-receipt: ${{ steps.contract-evidence.outputs.receipt }}
     steps:
       - uses: actions/checkout@v7
         with:
@@ -62,9 +65,11 @@ jobs:
         with:
           config: ${{ runner.temp }}/test-impact.json
           full-roots: tests
-      # Everything the tests lane executes or reads, bound into each receipt.
+      # Everything each reusing lane executes or reads, bound into its receipts.
       - id: inputs
-        run: echo "paths=$(jq -c . .github/validation-inputs.json)" >> "$GITHUB_OUTPUT"
+        run: |
+          echo "tests=$(jq -c .tests .github/validation-inputs.json)" >> "$GITHUB_OUTPUT"
+          echo "contracts=$(jq -c .contracts .github/validation-inputs.json)" >> "$GITHUB_OUTPUT"
       # CI-esta reuses a passing first attempt of the same job when its inputs and selected files are identical:
       # after a squash merge, on a version-only release PR, and on a PR push that changes nothing the tests read.
       # Release (workflow_call), schedules, manual runs and the test:full label always execute.
@@ -76,17 +81,34 @@ jobs:
         with:
           lanes: ${{ env.TEST_LANE_JOBS }}
           execution-context: ${{ steps.files.outputs.mode }} ${{ steps.files.outputs.test_roots_json }}
-          input-paths: ${{ steps.inputs.outputs.paths }}
+          input-paths: ${{ steps.inputs.outputs.tests }}
+          reuse-after-merge: 'true'
+          reuse-version-only-release: 'true'
+      - id: contract-evidence
+        if: >-
+          ${{ (github.event_name == 'pull_request' || github.event_name == 'push') &&
+              !contains(github.event.pull_request.labels.*.name, 'test:full') }}
+        uses: gigaverse-app/ci-esta/actions/resolve-lane-evidence@v1
+        with:
+          lanes: ${{ env.CONTRACT_LANE_JOBS }}
+          execution-context: selection contract
+          input-paths: ${{ steps.inputs.outputs.contracts }}
           reuse-after-merge: 'true'
           reuse-version-only-release: 'true'
       - id: admit
-        name: Admit the tests lane unless every job is proven
+        name: Admit each reusing lane unless every job is proven
         env:
           PLANNED_LANES: ${{ steps.plan.outputs.lanes }}
           REUSED: ${{ steps.evidence.outputs.reused || '{}' }}
+          CONTRACT_REUSED: ${{ steps.contract-evidence.outputs.reused || '{}' }}
         run: |
-          admitted=$(jq -c --argjson jobs "$TEST_LANE_JOBS" --argjson reused "$REUSED" 'if [$jobs | keys[] | $reused[.] == true] | all then .tests = false else . end' <<<"$PLANNED_LANES")
-          echo "reused=$REUSED"
+          admitted=$(jq -c \
+            --argjson tests "$TEST_LANE_JOBS" --argjson reused "$REUSED" \
+            --argjson contracts "$CONTRACT_LANE_JOBS" --argjson contract_reused "$CONTRACT_REUSED" '
+              def proven($jobs; $proof): [$jobs | keys[] | $proof[.] == true] | all;
+              (if proven($tests; $reused) then .tests = false else . end)
+              | (if proven($contracts; $contract_reused) then .contracts = false else . end)' <<<"$PLANNED_LANES")
+          echo "reused=$REUSED contracts=$CONTRACT_REUSED"
           echo "lanes=$admitted" | tee -a "$GITHUB_OUTPUT"
   quality:
     runs-on: ubuntu-latest
@@ -231,6 +253,9 @@ jobs:
         if: ${{ always() }}
         with:
           readme-mode: 'off'
+      - name: ${{ needs.select-tests.outputs.contract-receipt || 'No execution receipt' }}
+        if: ${{ needs.select-tests.result == 'success' && needs.select-tests.outputs.contract-receipt != '' }}
+        run: echo 'Recording a completed contract run for this tested tree.'
 
   validation-gate:
     name: Validation gate

pytest_selective-1.1.2/.github/workflows/dry-lint-audit.yml

@@ -0,0 +1,23 @@
+name: dry-lint audit
+# Weekly, or dispatched after merging a cleanup: dry-lint's own audit workflow sweeps the repository against the
+# accepted backlog and opens or updates one dry-lint/ratchet pull request recording what was cleaned. Its steps ship
+# with dry-lint releases; this file only says when it runs and with which credentials.
+on:
+  schedule:
+    - cron: '23 6 * * 1'
+  workflow_dispatch:
+  # dry-lint.yml calls this file on a manual dispatch, to exercise the audit with the rest of the checks.
+  workflow_call:
+permissions:
+  contents: read
+jobs:
+  audit:
+    uses: gigaverse-app/dry-lint/.github/workflows/audit.yml@v1
+    with:
+      python-version: '3.13'
+      budget-usd: '5'
+      plugins: anthropic==2.4.0
+    secrets:
+      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+      # The organization credential makes the ratchet pull request run ordinary CI.
+      DRY_LINT_RATCHET_TOKEN: ${{ secrets.GV_CI_CROSS_REPO_TOKEN }}

pytest_selective-1.1.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.1.2"
+}

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.1.2](https://github.com/gigaverse-app/pytest-selective/compare/v1.1.1...v1.1.2) (2026-11-09)
+
+
+### Bug fixes
+
+* agent setup round 2, from a second adoption trial ([#114](https://github.com/gigaverse-app/pytest-selective/issues/114)) ([45d4afe](https://github.com/gigaverse-app/pytest-selective/commit/45d4afe76cde9f6093519d97000244c6c06b157d))
+
+## [1.1.1](https://github.com/gigaverse-app/pytest-selective/compare/v1.1.0...v1.1.1) (2026-11-09)
+
+
+### Bug fixes
+
+* **selection:** follow file reads that name a tracked file by literal path ([#106](https://github.com/gigaverse-app/pytest-selective/issues/106)) ([5c534c4](https://github.com/gigaverse-app/pytest-selective/commit/5c534c48d3d098fb0e659973e2e40b410198af19))
+
 ## [1.1.0](https://github.com/gigaverse-app/pytest-selective/compare/v1.0.0...v1.1.0) (2026-11-09)
 
 

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/CONTRIBUTING.md

@@ -203,6 +203,10 @@ pytest. `tests/test_tutorial.py` owns the end-to-end tutorial execution and foll
 that plan; there is no second tutorial invocation in each matrix job. JUnit retains
 its test result and timing, and full plans also upload whole-suite coverage.
 
+To run a complete checkpoint after a CI change, select **CI** in GitHub Actions
+and choose **Run workflow**. Retrying an ordinary PR run preserves its selection;
+use the manual checkpoint when you need full-suite coverage evidence.
+
 ## Duplication
 
 `uv run pre-commit install` installs both the staged dry-lint check and the

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pytest-selective
-Version: 1.1.0
+Version: 1.1.2
 Summary: Explainable Python test impact analysis: select affected pytest files from Git changes
 Project-URL: Homepage, https://github.com/gigaverse-app/pytest-selective
 Project-URL: Documentation, https://pytest-selective.readthedocs.io/en/latest/
@@ -60,9 +60,9 @@ the affected test files, and explains the result. Use it directly as a pytest
 plugin, or plan before collection and service startup with the CLI and CI actions.
 
 Built from the selector used in Gigaverse's backend, AI, and shared Python
-infrastructure. Pin the actions and the package to the same release: `@vX.Y.Z`
-(or its commit SHA) and `pytest-selective==X.Y.Z`. The moving `@v1` tag follows
-the newest release.
+infrastructure. Use the actions at the moving `@v1` tag, which follows the newest
+release, and the package at `pytest-selective>=X.Y.Z,<2`. Where your tooling rejects
+tags, pin both to one release instead: `@<sha> # vX.Y.Z` and `pytest-selective==X.Y.Z`.
 [Provenance and extraction scope](https://github.com/gigaverse-app/pytest-selective/blob/main/PROVENANCE.md).
 
 [Quick tutorial](https://github.com/gigaverse-app/pytest-selective/blob/main/docs/tutorial.md) ·
@@ -279,17 +279,18 @@ change that runs the contract.
 <!-- pytest-quint-connect:contracts selection -->
 <a href="https://github.com/gigaverse-app/pytest-quint-connect#impact"><picture><source media="(prefers-color-scheme: dark)" srcset="https://pytest-quint-connect-counter.gigaverse-oss.workers.dev/v1/sign.svg?key=f8e41d50ca4018845c305f2f0dbd1cfd6d9b281e53b352490af53154a54e6265&amp;name=gigaverse-app%2Fpytest-selective&amp;theme=dark"><img alt="What pytest-quint-connect&#x27;s contracts caught in gigaverse-app/pytest-selective&#x27;s pull requests" src="https://pytest-quint-connect-counter.gigaverse-oss.workers.dev/v1/sign.svg?key=f8e41d50ca4018845c305f2f0dbd1cfd6d9b281e53b352490af53154a54e6265&amp;name=gigaverse-app%2Fpytest-selective" width="100%"></picture></a>
 
-<a href="https://github.com/gigaverse-app/pytest-quint-connect" title="Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug"><img alt="Quint contracts: 1 contract passed · 48 histories · 13/13 planted bugs caught" src="https://img.shields.io/badge/Quint_contracts-1_contract_passed_%C2%B7_48_histories_%C2%B7_13%2F13_planted_bugs_caught-brightgreen"></a>
+<a href="https://github.com/gigaverse-app/pytest-quint-connect" title="Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug"><img alt="Quint contracts: 1 contract passed · 49 histories · 14/14 planted bugs caught" src="https://img.shields.io/badge/Quint_contracts-1_contract_passed_%C2%B7_49_histories_%C2%B7_14%2F14_planted_bugs_caught-brightgreen"></a>
 
 | | Contract | Cases passed | [Planted bugs caught](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") |
 | :-: | :-- | --: | --: |
-| ✅ | `selection` `test_selection_contract.py::test_selection`<br><sub>48 histories (24 witnesses, 24 samples, seed 11) · every action covered · Quint 0.33.1</sub> | 62/62 | 13/13 |
+| ✅ | `selection` `test_selection_contract.py::test_selection`<br><sub>49 histories (25 witnesses, 24 samples, seed 11) · every action covered · Quint 0.33.1</sub> | 64/64 | 14/14 |
 
 **Bugs this contract found**
 
-1. **A test that does `from pkg import *` was not selected when a submodule pkg lists in __all__ changed.** Fixed in #94 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness starImportFollowsAllTest · regression test `tests/testing/test_impact_graph.py::test_star_import_reaches_the_submodules_its_package_lists_in_all`. 1 of 48 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `star-exports-ignored` (Reintroduces the star-import bug: from pkg import * no longer reaches the submodules pkg lists in __all__) reintroduces it; first caught by `witness-starImportFollowsAllTest` at state 2, after `edit(file='alpha', target='')`.
-1. **Editing a plugin loaded by `addopts = -p NAME` selected no test, though it is loaded into every session.** Fixed in #95 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness commandLinePluginSelectsEveryTestTest and random histories · regression test `tests/testing/test_impact_graph.py::test_command_line_plugin_in_addopts_reaches_every_test`. 3 of 48 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `addopts-plugins-ignored` (Reintroduces the plugin bug: a plugin named by -p in addopts is no longer a dependency of every test) reintroduces it; first caught by `witness-commandLinePluginSelectsEveryTestTest` at state 1, after `edit(file='plugin', target='')`.
-1. **A bare `import helpers` resolved by pytest's default import mode was not followed, so editing tests/helpers.py selected nothing.** Fixed in #96 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness bareTestImportFollowsPrependModeTest · regression test `tests/testing/test_impact_graph.py::test_bare_import_resolves_from_the_importers_prepend_mode_base_directory`. 1 of 48 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `prepend-roots-ignored` (Reintroduces the import-mode bug: imports no longer resolve from the directories pytest prepends to sys.path) reintroduces it; first caught by `witness-bareTestImportFollowsPrependModeTest` at state 2, after `edit(file='helper', target='')`.
+1. **A test that does `from pkg import *` was not selected when a submodule pkg lists in __all__ changed.** Fixed in #94 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness starImportFollowsAllTest · regression test `tests/testing/test_impact_graph.py::test_star_import_reaches_the_submodules_its_package_lists_in_all`. 1 of 49 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `star-exports-ignored` (Reintroduces the star-import bug: from pkg import * no longer reaches the submodules pkg lists in __all__) reintroduces it; first caught by `witness-starImportFollowsAllTest` at state 2, after `edit(file='alpha', target='')`.
+1. **Editing a plugin loaded by `addopts = -p NAME` selected no test, though it is loaded into every session.** Fixed in #95 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness commandLinePluginSelectsEveryTestTest and random histories · regression test `tests/testing/test_impact_graph.py::test_command_line_plugin_in_addopts_reaches_every_test`. 2 of 49 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `addopts-plugins-ignored` (Reintroduces the plugin bug: a plugin named by -p in addopts is no longer a dependency of every test) reintroduces it; first caught by `witness-commandLinePluginSelectsEveryTestTest` at state 1, after `edit(file='plugin', target='')`.
+1. **A bare `import helpers` resolved by pytest's default import mode was not followed, so editing tests/helpers.py selected nothing.** Fixed in #96 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness bareTestImportFollowsPrependModeTest · regression test `tests/testing/test_impact_graph.py::test_bare_import_resolves_from_the_importers_prepend_mode_base_directory`. 1 of 49 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `prepend-roots-ignored` (Reintroduces the import-mode bug: imports no longer resolve from the directories pytest prepends to sys.path) reintroduces it; first caught by `witness-bareTestImportFollowsPrependModeTest` at state 2, after `edit(file='helper', target='')`.
+1. **A test that read a tracked file with open() and a literal path was not selected when that file changed.** Fixed in #106 · found by the runtime check (pytest opened the changed file, the planner skipped the test), after an adversarial review reported it; witness literalPathReadTest · regression test `tests/testing/test_impact_graph.py::test_reading_a_tracked_file_by_literal_path_selects_the_reader`. 1 of 49 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `literal-reads-ignored` (Reintroduces the literal-read bug: open('data/table.json') no longer makes the reader depend on that file) reintroduces it; first caught by `witness-literalPathReadTest` at state 2, after `edit(file='table', target='')`.
 
 **[Planted bugs](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") this contract catches**
 
@@ -369,5 +370,14 @@ records progress against the accepted backlog. [Setup and cleanup workflow](CONT
 <!-- dry-lint-progress:start -->
 <a href="https://github.com/gigaverse-app/dry-lint"><picture><source media="(prefers-color-scheme: dark)" srcset="https://dry-lint-counter.gigaverse-oss.workers.dev/v1/sign.svg?theme=dark&amp;key=f8e41d50ca4018845c305f2f0dbd1cfd6d9b281e53b352490af53154a54e6265&amp;name=gigaverse-app%2Fpytest-selective&amp;cleaned=9&amp;remaining=0&amp;dismissed=0"><img alt="dry-lint in gigaverse-app/pytest-selective: new duplicates kept out of its pull requests, 9 old duplicates cleaned up, 0 remaining" src="https://dry-lint-counter.gigaverse-oss.workers.dev/v1/sign.svg?key=f8e41d50ca4018845c305f2f0dbd1cfd6d9b281e53b352490af53154a54e6265&amp;name=gigaverse-app%2Fpytest-selective&amp;cleaned=9&amp;remaining=0&amp;dismissed=0" width="100%"></picture></a>
 
+**Reviewed duplication debt** · Counts from the committed baselines.
+
+| Accepted pairs | Remaining | Retired | Dismissed |
+| :-- | --: | --: | --: |
+| Functions | 0 | 9 | 0 |
+| Models | Not initialized | — | — |
+
 [Accepted backlog](.dry-lint/baseline.json) · [Weekly audit](https://github.com/gigaverse-app/pytest-selective/actions/workflows/dry-lint-audit.yml)
+
+Retired means a side was removed, or (functions only) the judge now finds the pair separate. It is not a count of refactors. Dismissals stay separate; an uninitialized model baseline is unknown.
 <!-- dry-lint-progress:end -->

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/README.md

@@ -29,9 +29,9 @@ the affected test files, and explains the result. Use it directly as a pytest
 plugin, or plan before collection and service startup with the CLI and CI actions.
 
 Built from the selector used in Gigaverse's backend, AI, and shared Python
-infrastructure. Pin the actions and the package to the same release: `@vX.Y.Z`
-(or its commit SHA) and `pytest-selective==X.Y.Z`. The moving `@v1` tag follows
-the newest release.
+infrastructure. Use the actions at the moving `@v1` tag, which follows the newest
+release, and the package at `pytest-selective>=X.Y.Z,<2`. Where your tooling rejects
+tags, pin both to one release instead: `@<sha> # vX.Y.Z` and `pytest-selective==X.Y.Z`.
 [Provenance and extraction scope](https://github.com/gigaverse-app/pytest-selective/blob/main/PROVENANCE.md).
 
 [Quick tutorial](https://github.com/gigaverse-app/pytest-selective/blob/main/docs/tutorial.md) ·
@@ -248,17 +248,18 @@ change that runs the contract.
 <!-- pytest-quint-connect:contracts selection -->
 <a href="https://github.com/gigaverse-app/pytest-quint-connect#impact"><picture><source media="(prefers-color-scheme: dark)" srcset="https://pytest-quint-connect-counter.gigaverse-oss.workers.dev/v1/sign.svg?key=f8e41d50ca4018845c305f2f0dbd1cfd6d9b281e53b352490af53154a54e6265&amp;name=gigaverse-app%2Fpytest-selective&amp;theme=dark"><img alt="What pytest-quint-connect&#x27;s contracts caught in gigaverse-app/pytest-selective&#x27;s pull requests" src="https://pytest-quint-connect-counter.gigaverse-oss.workers.dev/v1/sign.svg?key=f8e41d50ca4018845c305f2f0dbd1cfd6d9b281e53b352490af53154a54e6265&amp;name=gigaverse-app%2Fpytest-selective" width="100%"></picture></a>
 
-<a href="https://github.com/gigaverse-app/pytest-quint-connect" title="Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug"><img alt="Quint contracts: 1 contract passed · 48 histories · 13/13 planted bugs caught" src="https://img.shields.io/badge/Quint_contracts-1_contract_passed_%C2%B7_48_histories_%C2%B7_13%2F13_planted_bugs_caught-brightgreen"></a>
+<a href="https://github.com/gigaverse-app/pytest-quint-connect" title="Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug"><img alt="Quint contracts: 1 contract passed · 49 histories · 14/14 planted bugs caught" src="https://img.shields.io/badge/Quint_contracts-1_contract_passed_%C2%B7_49_histories_%C2%B7_14%2F14_planted_bugs_caught-brightgreen"></a>
 
 | | Contract | Cases passed | [Planted bugs caught](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") |
 | :-: | :-- | --: | --: |
-| ✅ | `selection` `test_selection_contract.py::test_selection`<br><sub>48 histories (24 witnesses, 24 samples, seed 11) · every action covered · Quint 0.33.1</sub> | 62/62 | 13/13 |
+| ✅ | `selection` `test_selection_contract.py::test_selection`<br><sub>49 histories (25 witnesses, 24 samples, seed 11) · every action covered · Quint 0.33.1</sub> | 64/64 | 14/14 |
 
 **Bugs this contract found**
 
-1. **A test that does `from pkg import *` was not selected when a submodule pkg lists in __all__ changed.** Fixed in #94 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness starImportFollowsAllTest · regression test `tests/testing/test_impact_graph.py::test_star_import_reaches_the_submodules_its_package_lists_in_all`. 1 of 48 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `star-exports-ignored` (Reintroduces the star-import bug: from pkg import * no longer reaches the submodules pkg lists in __all__) reintroduces it; first caught by `witness-starImportFollowsAllTest` at state 2, after `edit(file='alpha', target='')`.
-1. **Editing a plugin loaded by `addopts = -p NAME` selected no test, though it is loaded into every session.** Fixed in #95 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness commandLinePluginSelectsEveryTestTest and random histories · regression test `tests/testing/test_impact_graph.py::test_command_line_plugin_in_addopts_reaches_every_test`. 3 of 48 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `addopts-plugins-ignored` (Reintroduces the plugin bug: a plugin named by -p in addopts is no longer a dependency of every test) reintroduces it; first caught by `witness-commandLinePluginSelectsEveryTestTest` at state 1, after `edit(file='plugin', target='')`.
-1. **A bare `import helpers` resolved by pytest's default import mode was not followed, so editing tests/helpers.py selected nothing.** Fixed in #96 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness bareTestImportFollowsPrependModeTest · regression test `tests/testing/test_impact_graph.py::test_bare_import_resolves_from_the_importers_prepend_mode_base_directory`. 1 of 48 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `prepend-roots-ignored` (Reintroduces the import-mode bug: imports no longer resolve from the directories pytest prepends to sys.path) reintroduces it; first caught by `witness-bareTestImportFollowsPrependModeTest` at state 2, after `edit(file='helper', target='')`.
+1. **A test that does `from pkg import *` was not selected when a submodule pkg lists in __all__ changed.** Fixed in #94 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness starImportFollowsAllTest · regression test `tests/testing/test_impact_graph.py::test_star_import_reaches_the_submodules_its_package_lists_in_all`. 1 of 49 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `star-exports-ignored` (Reintroduces the star-import bug: from pkg import * no longer reaches the submodules pkg lists in __all__) reintroduces it; first caught by `witness-starImportFollowsAllTest` at state 2, after `edit(file='alpha', target='')`.
+1. **Editing a plugin loaded by `addopts = -p NAME` selected no test, though it is loaded into every session.** Fixed in #95 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness commandLinePluginSelectsEveryTestTest and random histories · regression test `tests/testing/test_impact_graph.py::test_command_line_plugin_in_addopts_reaches_every_test`. 2 of 49 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `addopts-plugins-ignored` (Reintroduces the plugin bug: a plugin named by -p in addopts is no longer a dependency of every test) reintroduces it; first caught by `witness-commandLinePluginSelectsEveryTestTest` at state 1, after `edit(file='plugin', target='')`.
+1. **A bare `import helpers` resolved by pytest's default import mode was not followed, so editing tests/helpers.py selected nothing.** Fixed in #96 · found by the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness bareTestImportFollowsPrependModeTest · regression test `tests/testing/test_impact_graph.py::test_bare_import_resolves_from_the_importers_prepend_mode_base_directory`. 1 of 49 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `prepend-roots-ignored` (Reintroduces the import-mode bug: imports no longer resolve from the directories pytest prepends to sys.path) reintroduces it; first caught by `witness-bareTestImportFollowsPrependModeTest` at state 2, after `edit(file='helper', target='')`.
+1. **A test that read a tracked file with open() and a literal path was not selected when that file changed.** Fixed in #106 · found by the runtime check (pytest opened the changed file, the planner skipped the test), after an adversarial review reported it; witness literalPathReadTest · regression test `tests/testing/test_impact_graph.py::test_reading_a_tracked_file_by_literal_path_selects_the_reader`. 1 of 49 histories diverge when [planted bug](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") `literal-reads-ignored` (Reintroduces the literal-read bug: open('data/table.json') no longer makes the reader depend on that file) reintroduces it; first caught by `witness-literalPathReadTest` at state 2, after `edit(file='table', target='')`.
 
 **[Planted bugs](https://github.com/gigaverse-app/pytest-quint-connect/blob/main/docs/why.md#proof-that-the-tests-can-fail "Mutants: deliberately broken copies of the code. Each must make some history diverge, proving the contract would notice that kind of bug") this contract catches**
 
@@ -338,5 +339,14 @@ records progress against the accepted backlog. [Setup and cleanup workflow](CONT
 <!-- dry-lint-progress:start -->
 <a href="https://github.com/gigaverse-app/dry-lint"><picture><source media="(prefers-color-scheme: dark)" srcset="https://dry-lint-counter.gigaverse-oss.workers.dev/v1/sign.svg?theme=dark&amp;key=f8e41d50ca4018845c305f2f0dbd1cfd6d9b281e53b352490af53154a54e6265&amp;name=gigaverse-app%2Fpytest-selective&amp;cleaned=9&amp;remaining=0&amp;dismissed=0"><img alt="dry-lint in gigaverse-app/pytest-selective: new duplicates kept out of its pull requests, 9 old duplicates cleaned up, 0 remaining" src="https://dry-lint-counter.gigaverse-oss.workers.dev/v1/sign.svg?key=f8e41d50ca4018845c305f2f0dbd1cfd6d9b281e53b352490af53154a54e6265&amp;name=gigaverse-app%2Fpytest-selective&amp;cleaned=9&amp;remaining=0&amp;dismissed=0" width="100%"></picture></a>
 
+**Reviewed duplication debt** · Counts from the committed baselines.
+
+| Accepted pairs | Remaining | Retired | Dismissed |
+| :-- | --: | --: | --: |
+| Functions | 0 | 9 | 0 |
+| Models | Not initialized | — | — |
+
 [Accepted backlog](.dry-lint/baseline.json) · [Weekly audit](https://github.com/gigaverse-app/pytest-selective/actions/workflows/dry-lint-audit.yml)
+
+Retired means a side was removed, or (functions only) the judge now finds the pair separate. It is not a count of refactors. Dismissals stay separate; an uninitialized model baseline is unknown.
 <!-- dry-lint-progress:end -->

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/actions/plan-lanes/action.yml

@@ -12,8 +12,10 @@ inputs:
     default: auto
   artifact-name:
     description: >
-      Upload the lane plan under this name, where CI-esta's report renders it as
-      the sticky's lane section. Empty skips the upload.
+      Upload the lane plan (test-lanes.json) as an artifact under this name, where
+      CI-esta's report renders it as the sticky's lane section. Give each planner job
+      in one workflow run its own name. Empty skips the upload; planning and the
+      outputs are unchanged.
     default: test-lane-selection
 outputs:
   lanes:

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/contracts/selection/conftest.py

@@ -193,6 +193,9 @@ MUTANTS: dict[str, Callable[[], list[tuple[str, object]]]] = {
     ],
     "addopts-plugins-ignored": lambda: [("pytest_selective.impact_graph.command_line_plugins", lambda policies: set())],
     "prepend-roots-ignored": lambda: [("pytest_selective.impact_graph.prepend_roots", lambda python_files, config: [])],
+    "literal-reads-ignored": lambda: [
+        ("pytest_selective.impact_graph.literal_read_targets", lambda reader, literal, files: set())
+    ],
 }
 
 
@@ -210,6 +213,7 @@ class RepositoryDriver(SelectionDriver):
         self.imports: dict[str, set[str]] = {}
         self.declared: dict[str, set[str]] = {}
         self.broken: set[str] = set()
+        self.reads: set[str] = set()
         self.versions = dict.fromkeys(PATHS, 0)
         self.requirements = 0
         self.config = CONFIG
@@ -231,6 +235,8 @@ class RepositoryDriver(SelectionDriver):
         lines += [f"# gv:test-dependency: {PATHS[target]}" for target in sorted(self.declared.get(name, ()))]
         lines += [IMPORT_LINES[target] for target in sorted(self.imports.get(name, ()))]
         lines.append(f"VERSION = {version}")
+        if name in self.reads:
+            lines.append(f'TABLE = open("{PATHS["table"]}", encoding="utf-8").read()')
         if name in self.broken:
             lines.append("def broken(:")
         write(self.root, PATHS[name], "\n".join(lines) + "\n")
@@ -334,6 +340,7 @@ class RepositoryDriver(SelectionDriver):
         self.imports.pop(file, None)
         self.declared.pop(file, None)
         self.broken.discard(file)
+        self.reads.discard(file)
         (self.root / PATHS[file]).unlink()
         if file in CONTENT_SIDECARS:
             (self.root / CONTENT_SIDECARS[file][0]).unlink()
@@ -360,6 +367,10 @@ class RepositoryDriver(SelectionDriver):
         self.broken.discard(file)
         self._commit(file)
 
+    def read_table(self, file: str) -> None:
+        self.reads.add(file)
+        self._commit(file)
+
     def touch_global(self) -> None:
         self.requirements += 1
         self._write_requirements()

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/contracts/selection/quint-connect.json

@@ -20,6 +20,7 @@
     "toggleConfig": "flip test_roots between tests and tests/sub, or add/remove data/table.json as a global input, then plan the last commit again",
     "restart": "close the graph cache (it prunes on close), reopen it, then plan the last commit again",
     "corrupt": "empty every stored graph's edges without updating its checksum, then plan the last commit again",
+    "readTable": "make a test read data/table.json with open() and a literal path at import time, commit, then select",
     "inspect": "read the last selections without committing"
   },
   "witnesses": [
@@ -46,6 +47,7 @@
     "commandLinePluginSelectsEveryTestTest",
     "bareTestImportFollowsPrependModeTest",
     "packageInitEditSelectsItsImportersTest",
+    "literalPathReadTest",
     "sinceStartSpansCommitsTest"
   ],
   "mutants": [
@@ -100,6 +102,10 @@
     {
       "name": "prepend-roots-ignored",
       "description": "Reintroduces the import-mode bug: imports no longer resolve from the directories pytest prepends to sys.path."
+    },
+    {
+      "name": "literal-reads-ignored",
+      "description": "Reintroduces the literal-read bug: open('data/table.json') no longer makes the reader depend on that file."
     }
   ],
   "bounds": {"seed": 11, "max_samples": 800, "max_steps": 8, "n_traces": 24},
@@ -116,7 +122,7 @@
   },
   "limits": [
     "One repository: three modules and their package initializer (with __all__), a test-root helper, a command-line plugin loaded by addopts -p, a root and a nested conftest, three tests, one data file and one content-kind sidecar; at most 8 operations per sampled history.",
-    "Import spellings are import pkg.x, import tests.helpers, from pkg import * and a prepend-mode bare import helpers. Other forms (relative and dynamic imports, module strings, undeclared file reads, symlinks) are not generated.",
+    "Import spellings are import pkg.x, import tests.helpers, from pkg import * and a prepend-mode bare import helpers. Tests may also read data/table.json with open() and a literal repository path. Other forms (relative and dynamic imports, module strings, computed paths, symlinks) are not generated.",
     "The runtime check records imports and opened files during pytest's collection of each test file, with plugin autoloading off and the default prepend import mode. It is a lower bound: a test that loads a changed file must be selected, but selecting more is not a failure. It is skipped for mutant cases, which the model comparison judges.",
     "First-party pins, name-scoped modules, deferred strings and Django URLconf policy are outside the model. The graph cache is exercised through configuration edits, restarts and damaged entries; only answers are compared.",
     "Each step is a real Git commit or a re-plan of the last one, selected by affected() through one GraphCache per history; the driver's mapping of paths to file names is trusted."
@@ -142,6 +148,13 @@
       "found_by": "the runtime check (pytest loaded the changed file, the planner skipped the test), after an adversarial review reported it; witness bareTestImportFollowsPrependModeTest",
       "regression_test": "tests/testing/test_impact_graph.py::test_bare_import_resolves_from_the_importers_prepend_mode_base_directory",
       "mutant": "prepend-roots-ignored"
+    },
+    {
+      "summary": "A test that read a tracked file with open() and a literal path was not selected when that file changed.",
+      "fixed_in": "#106",
+      "found_by": "the runtime check (pytest opened the changed file, the planner skipped the test), after an adversarial review reported it; witness literalPathReadTest",
+      "regression_test": "tests/testing/test_impact_graph.py::test_reading_a_tracked_file_by_literal_path_selects_the_reader",
+      "mutant": "literal-reads-ignored"
     }
   ]
 }

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/contracts/selection/selection.qnt

@@ -25,8 +25,17 @@ module selection {
     versions: str -> int,
     broken: Set[str],
     requirements: int,
+    // Tests that read data/table.json with open() and a literal path, at import time.
+    reads: Set[str],
+  }
+  type Content = {
+    present: bool,
+    imports: Set[(str, str)],
+    declared: Set[(str, str)],
+    version: int,
+    broken: bool,
+    reads: bool,
   }
-  type Content = { present: bool, imports: Set[(str, str)], declared: Set[(str, str)], version: int, broken: bool }
   // narrow: test_roots is tests/sub instead of tests. tableGlobal: data/table.json is a global input.
   type Config = { narrow: bool, tableGlobal: bool }
 
@@ -83,8 +92,9 @@ module selection {
         declared: t.declared.filter(d => d._1 == f),
         version: t.versions.get(f),
         broken: t.broken.contains(f),
+        reads: t.reads.contains(f),
       }
-    else { present: false, imports: Set(), declared: Set(), version: 0, broken: false }
+    else { present: false, imports: Set(), declared: Set(), version: 0, broken: false, reads: false }
 
   // The files collected as tests under a configuration.
   pure def testsOf(c: Config): Set[str] = if (c.narrow) Set("test_sub") else TESTS
@@ -113,7 +123,9 @@ module selection {
       val changed = FILES.filter(f => content(before, f) != content(after, f))
       val global = before.requirements != after.requirements or (c.tableGlobal and changed.contains("table"))
       val tests = testsOf(c).intersect(after.present)
-      val readers = CONTENT_READS
+      // A literal path read is a content read, like a kind: content sidecar.
+      val literal = before.reads.union(after.reads).map(f => (f, "table"))
+      val readers = CONTENT_READS.union(literal)
         .filter(r => changed.contains(r._2) and (before.present.contains(r._1) or after.present.contains(r._1)))
         .map(r => r._1)
       val chosen = if (global) tests
@@ -167,6 +179,7 @@ module selection {
     versions: FILES.mapBy(_ => 0),
     broken: Set(),
     requirements: 0,
+    reads: Set(),
   }
 
   action init = all {
@@ -212,6 +225,7 @@ module selection {
       present: tree.present.exclude(Set(file)),
       declared: tree.declared.filter(d => d._1 != file),
       broken: tree.broken.exclude(Set(file)),
+      reads: tree.reads.exclude(Set(file)),
     }),
   }
 
@@ -248,6 +262,14 @@ module selection {
     commit("repair", file, "", { ...tree, broken: tree.broken.exclude(Set(file)) }),
   }
 
+  // Make a test read data/table.json with open() and a literal path, without declaring it.
+  action readTable(file: str): bool = all {
+    TESTS.contains(file),
+    tree.present.contains(file),
+    not(tree.reads.contains(file)),
+    commit("readTable", file, "", { ...tree, reads: tree.reads.union(Set(file)) }),
+  }
+
   action touchGlobal = commit("touchGlobal", "", "", { ...tree, requirements: tree.requirements + 1 })
 
   // Flip one configuration option, then plan the last commit again.
@@ -288,6 +310,7 @@ module selection {
       undeclare(file, target),
       breakSyntax(file),
       repair(file),
+      readTable(file),
       touchGlobal,
       toggleConfig(option),
       restart,
@@ -380,6 +403,10 @@ module selection {
   run packageInitEditSelectsItsImportersTest = init.then(edit(INIT))
     .then(all { assert(observed == view("scoped", Set("test_one", "test_two"))), inspect })
 
+  // test_one now reads the table by literal path; the other two already depended on it.
+  run literalPathReadTest = init.then(readTable("test_one")).then(edit("table"))
+    .then(all { assert(observed == view("full", TESTS)), inspect })
+
   run sinceStartSpansCommitsTest = init.then(edit("beta")).then(edit("table"))
     .then(all {
       assert(observed == { mode: "scoped", selected: Set("test_two", "test_sub"), sinceStart: { mode: "full", selected: TESTS }, missed: Set() }),

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/contracts/selection/selection_driver.py

@@ -28,7 +28,7 @@ class SelectionDriver(ActionDriver):
     """Subclass this, implement each action against the real code, and read state back in observe()."""
 
     __quint_contract__ = "selection"
-    __quint_fingerprint__ = "85c02aff975baca4fd485a40a46b4b0d540998166173c5afb04a810ed92c5788"
+    __quint_fingerprint__ = "40f9e4a52a1f7fce52f35f086d3825648232670ff6aca12e7d8001fa80cb91a2"
     __quint_codegen_command__ = "pytest-quint-connect codegen quint-connect.json -o selection_driver.py"
     __quint_actions__ = {
         "init": ("init", ()),
@@ -45,6 +45,7 @@ class SelectionDriver(ActionDriver):
         "toggleConfig": ("toggle_config", (("option", "file"),)),
         "restart": ("restart", ()),
         "corrupt": ("corrupt", ()),
+        "readTable": ("read_table", (("file", "file"),)),
         "inspect": ("inspect", ()),
     }
 
@@ -104,6 +105,10 @@ class SelectionDriver(ActionDriver):
     def corrupt(self) -> None:
         """empty every stored graph's edges without updating its checksum, then plan the last commit again"""
 
+    @abstractmethod
+    def read_table(self, file: str) -> None:
+        """make a test read data/table.json with open() and a literal path at import time, commit, then select"""
+
     @abstractmethod
     def inspect(self) -> None:
         """read the last selections without committing"""

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/docs/actions.md

@@ -28,6 +28,10 @@ supported on GitHub.com with runner 2.336.0 or newer. Individual `actions/NAME`
 entry points call the implementations directly and do not require that syntax.
 [GitHub reference documentation](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax).
 
+`plan-lanes` uploads its plan as the `test-lane-selection` artifact by default. Set
+`artifact-name` to rename it, which a second planner job in the same workflow run needs, or to
+`''` to skip the upload.
+
 ## Action reference
 
 Each link below is the public action's complete input/output contract.

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/docs/ci.md

@@ -253,11 +253,10 @@ job per workflow the required check and run
 gated job to its lanes. It fails unless each prerequisite succeeded or was skipped while
 the planner succeeded and every mapped lane is `false`; a failed planner fails it.
 
-Do not gate a job that a publish or deploy job `needs:` on pull-request-only logic:
-skipping it skips publishing. Keep it running on other events
-(`github.event_name != 'pull_request' || ...`), or plan inside the job with
+Never gate a job that a publish or deploy job `needs:`, directly or transitively:
+skipping it skips publishing. Leave it ungated, or plan inside the job with
 `continue-on-error: true` and admit only its expensive steps, as the `distributions`
-job in this repository's CI does. A branch's first push has no previous commit, so
+job in this repository's CI does. Gate every other job that installs, builds or tests. A branch's first push has no previous commit, so
 `on: push` for every branch runs every lane once per new branch; prefer pull-request
 triggers plus pushes to the default branch.
 The default event policy handles manual/release checkpoints, schedules and

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/docs/configuration.md

@@ -24,9 +24,10 @@ select. The default filenames are `test_*.py`, `*_test.py`, `*_tests.py`, and
 
 ## Review and record collection policy
 
-If your repository has `pyproject.toml`, `pytest.ini`, `tox.ini`, or `setup.cfg`,
-record its committed pytest-policy fingerprints. Even a discovered configuration
-file with no pytest settings can have a fingerprint. This review prevents a new
+If your repository has `pyproject.toml`, `pytest.ini`, a `tox.ini` with a `[pytest]`
+section, or a `setup.cfg` with a `[tool:pytest]` section, record its committed
+pytest-policy fingerprints. A `pyproject.toml` or `pytest.ini` with no pytest settings
+still has a fingerprint, because pytest can still choose it. This review prevents a new
 collection rule from silently invalidating the inventory.
 
 ```bash
@@ -58,7 +59,9 @@ runs the complete configured roots.
 Start with the [sidecar tutorial](tutorials/sidecar-dependencies.md) for a runnable
 fixture example, directory manifests, dependency comments, and dynamic Python inputs.
 
-For a test that reads a tracked JSON fixture, add a reader-owned comment:
+A read that names a tracked file by literal path, such as `open("data/prices.json")` or
+`(Path(__file__).parent / "prices.json").read_text()`, is followed automatically as a content read.
+For a path that is computed, or built from several parts, add a reader-owned comment:
 
 ```python
 # gv:test-dependency: tests/data/prices.json
@@ -133,7 +136,11 @@ Unsupported checker patterns retain the full-check fallback.
 
 The policy fingerprints cover conventional pytest configuration names, including
 `pytest.toml`, `.pytest.toml`, `.pytest.ini` and nested candidates. Empty candidates
-are included because their presence can change pytest's root and precedence.
+are included because their presence can change pytest's root and precedence. A
+`tox.ini` without `[pytest]` and a `setup.cfg` without `[tool:pytest]` are not: pytest
+skips them. Adding that section later changes the fingerprints and needs a review.
+Releases up to 1.1.1 recorded such a file as the hash of an empty policy; that entry
+is still accepted and needs no refresh.
 Changes require reviewing and refreshing `pytest_policy`; until then planning
 fails safely and the CI action runs the complete configured roots.
 

{pytest_selective-1.1.0 → pytest_selective-1.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pytest-selective"
-version = "1.1.0"
+version = "1.1.2"
 description = "Explainable Python test impact analysis: select affected pytest files from Git changes"
 readme = "README.md"
 requires-python = ">=3.11"