python-test-strategy
Organized testing strategy for Python projects: test file naming, coverage goals (95%+), and public API testing.
Quick Start
Find test location for any source file:
When being asked to write tests for a specific source file, use the following command to determine the correct test file path based on established naming conventions:
uvx --from shai-py==0.1.1 shai-py test-path /path/to/my_package/subpackage/module.py
Run tests:
- Individual file:
.venv/bin/python tests/subpackage/test_*.py - Package:
.venv/bin/python tests/subpackage/all.py - All:
.venv/bin/python tests/all.py
Key Patterns
- Test files mirror source:
source/<pkg>/<module>.pyβtests/<pkg>/test_<pkg>_<module>.py - Coverage goal: 95%+ for all implementation files
- Public API: Export all public interfaces in
api.py, test intests/test_api.py
References
- π― Naming & File Location
- π Coverage Setup
- π Public API Testing