- Fork and clone the repository
- Install dependencies:
poetry install - Run tests:
poetry run pytest
- Create a branch from
main - Make your changes
- Add or update tests
- Run the full check suite:
poetry run ruff check . && poetry run mypy src - Commit using Conventional Commits (
feat:,fix:,docs:, etc.) - Open a pull request
This project uses ruff for linting and ruff format for formatting. Run poetry run ruff check . before committing.
- Unit tests are required for all new functionality
- Integration tests run in CI when credentials are available
- Run tests locally:
poetry run pytest
- Keep PRs focused on a single change
- Update
CHANGELOG.mdunder[Unreleased] - Ensure CI passes before requesting review