Testing Guide

Testing Guide

Main Commands

Run the full suite:

python -m pytest

Run the custom test runner:

python tests/run_tests.py

Useful variants:

python tests/run_tests.py --imports
python tests/run_tests.py --quick
python tests/run_tests.py --no-pytest

Current Coverage Areas

The test suite covers:

• photo discovery and pairing
• patent batch packaging
• fallback patent PDF lookup
• non-mutating staging and production behavior
• validation and reconciliation logic
• global recovery behavior

CI Notes

GitHub Actions currently runs:

• full pytest suite
• targeted regression checks
• import checks
• validation module checks

The active workflow file is:

• .github/workflows/ci.yml

Before Pushing

Recommended local checks:

git diff --check
python -m py_compile src/main.py src/validation.py tests/test_main.py tests/test_validation.py tests/test_global_recovery.py
python -m pytest

Last updated: April 6, 2026