33 lines
1.0 KiB
Markdown
33 lines
1.0 KiB
Markdown
---
|
|
name: python-test-strategy
|
|
description: Python testing patterns with organized test file structure, coverage goals, and public API testing
|
|
---
|
|
|
|
# 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:**
|
|
```bash
|
|
python scripts/locate_test_file.py /path/to/source/file.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 in `tests/test_api.py`
|
|
|
|
## References
|
|
|
|
- 🎯 [Naming & File Location](./reference/naming.md)
|
|
- 📊 [Coverage Setup](./reference/coverage.md)
|
|
- 🔌 [Public API Testing](./reference/public-api.md)
|