Thanks for your interest in contributing!
- Be respectful and follow our Code of Conduct.
- Discuss sizeable changes in an issue before opening a PR.
- Keep changes focused and small where possible.
-
Fork the repo and create your branch from
main. -
Set up your environment:
python -m venv .venv && source .venv/bin/activate pip install -U pip && pip install -e ".[dev]" pre-commit install
-
Run the checks:
ruff check . black --check . mypy src pytest -q
- New/changed behavior is covered by tests.
-
ruff,black,mypy, andpytestall pass locally. - Docs/README updated where relevant.
- For user-visible changes, add an entry to
CHANGELOG.mdunder "Unreleased".
- Conventional Commits are encouraged (e.g.,
feat:,fix:,docs:). - Keep commit messages imperative and descriptive.