Tooling Onboarding Guide
Dependency Management
- Use
uvfor all dependency management and tool invocation. - Always call tools with
uv runfor portability and reproducibility, e.g.: - Do not use
piporpython -mdirectly for running tools/scripts.
Testing
- The test suite uses:
- pytest for running tests
- syrupy for snapshot testing
- coverage.py for code coverage
- Example commands:
- For snapshot tests, see the
tests/__snapshots__/directory.
Summary
- Always use
uv runfor all Python tooling. - Tests: pytest + syrupy + coverage.py
- This ensures consistent, portable, and reproducible development workflows.
This file is intended for onboarding AI agents and developers working with project tooling in this codebase.