feat: add pytest-testmon

Author: Really Him

.gitignore

@@ -31,6 +31,7 @@ venv.bak/
 .coverage
 .coverage.*
 .cache
+.testmondata*
 nosetests.xml
 coverage.xml
 *.cover

Makefile

@@ -17,7 +17,7 @@ else
 	VENV_ACTIVATE := $(VENV_DIR)/bin/activate
 endif
 
-.PHONY: help venv install install-dev install-prod format lint type-check test test-cov check clean clean-venv clean-cov build build-check version-show version-bump-patch version-bump-minor version-bump-major release-test release release-check release-dry-run gh-release gh-release-draft gh-release-test gh-check-cli release-patch release-minor release-major release-dry-patch release-dry-minor release-dry-major gh-release-dry release-doctor release-safety-check gh-release-safe release-patch-safe release-minor-safe release-major-safe
+.PHONY: help venv install install-dev install-prod format lint type-check test test-fast test-fast-clean test-cov check clean clean-venv clean-cov build build-check version-show version-bump-patch version-bump-minor version-bump-major release-test release release-check release-dry-run gh-release gh-release-draft gh-release-test gh-check-cli release-patch release-minor release-major release-dry-patch release-dry-minor release-dry-major gh-release-dry release-doctor release-safety-check gh-release-safe release-patch-safe release-minor-safe release-major-safe
 
 help:  ## Show this help message
 	@echo "Usage: make [target]"
@@ -56,6 +56,13 @@ type-check: install-dev  ## Run type checking with mypy
 test: install-dev  ## Run tests with pytest
 	$(VENV_DIR)/bin/pytest --no-cov
 
+test-fast: install-dev  ## Run targeted tests with pytest-testmon
+	@mkdir -p .cache
+	TESTMON_DATAFILE=.cache/testmon.sqlite $(VENV_DIR)/bin/pytest --testmon
+
+test-fast-clean:  ## Remove cached testmon data to force a full run
+	rm -f .cache/testmon.sqlite .cache/testmon.sqlite-shm .cache/testmon.sqlite-wal .testmondata*
+
 test-cov: install-dev  ## Run tests with coverage report
 	# Clean up any existing coverage data
 	@rm -rf .coverage htmlcov

README.md

@@ -519,13 +519,21 @@ CYCLOMATIC COMPLEXITY STATISTICS:
 # Run all tests
 make test
 
+# Run only tests affected by your recent changes (requires initial baseline run)
+make test-fast
+
+# Clear pytest-testmon cache to force a full recalculation
+make test-fast-clean
+
 # Run with coverage
 make test-coverage
 
 # Run specific test file
 pytest tests/unit/test_config.py -v
 ```
 
+The `make test-fast` target automatically stores its SQLite cache under `.cache/testmon.sqlite` via the `TESTMON_DATAFILE` environment variable so the repository root stays clean. If the cache ever gets out of date (for example after switching branches), run `make test-fast-clean` to remove the `.cache/testmon.sqlite*` files and trigger a fresh baseline on the next `make test-fast`.
+
 ### Code Quality
 
 ```bash

pyproject.toml

@@ -41,6 +41,7 @@ dependencies = [
 dev = [
     "pytest>=7.4.0",
     "pytest-cov>=4.1.0",
+    "pytest-testmon>=2.0.20",
     "ruff>=0.1.0",
     "black>=23.0.0",
     "mypy>=1.7.0",