A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.
pytest-changed Plugin
A pytest plugin that uses ruff analyze graph to intelligently discover and run only the tests affected by code changes.
Overview
This plugin analyzes your git changes and uses Ruff's dependency graph analysis to determine which tests need to be run. It performs a search through the dependency graph to find all files affected by your changes, then runs only the tests that could be impacted.
Usage
Run only tests affected by changes from main branch:
pytest -p packages.pytest_changed --changed-from=main
Using uv:
uv run --python 3.12 --group test pytest -p packages.pytest_changed --changed-from=main tests/
Compare Against Different References
# Compare against HEAD (staged changes)
pytest -p packages.pytest_changed --changed-from=HEAD
# Compare against origin/main
pytest -p packages.pytest_changed --changed-from=origin/main
Preview What Would Be Run
Use --collect-only to see which tests would be selected without running them:
pytest -p packages.pytest_changed --changed-from=main --collect-only tests/
Include Unchanged Tests
Run affected tests plus all other tests:
pytest -p packages.pytest_changed --changed-from=main --include-unchanged tests/
Run Specific Test Directories
The plugin respects pytest's normal path filtering:
pytest -p packages.pytest_changed --changed-from=main tests/_runtime/
How It Works
- Find Changes: Uses
git diff --name-only <ref>to find Python files that have changed - Build Graph: Runs
ruff analyze graph --direction dependentsto build a dependency graph - Graph Traversal: Performs BFS from changed files to find all affected files
- Filter Tests: Identifies which affected files are test files
- Run Tests: Only runs pytest on the affected test files
Configuration Options
Command Line Options
--changed-from=<ref>: Git reference to compare against (required to activate plugin)--include-unchanged: Also run tests that haven't changed (optional)