contributing_tldr.md

Feel free to send a PR to update this file if you find anything useful. 🙇

Environment

• Python >=3.10
• Poetry >=2.0.0

Useful commands

Please check the pyproject.toml for a comprehensive list of commands.

Code Changes

# Ensure you have the correct dependencies, for nix user's see below
poetry install

# Make ruff happy
poetry format

# Check if ruff and mypy are happy
poetry lint

# Check if mypy is happy in python 3.10
mypy --python-version 3.10

# Run tests in parallel.
pytest -n auto # This may take a while.
pytest -n auto <test_suite>

Documentation Changes

# Build the documentation locally and check for broken links
poetry doc

Nix Users

If you are using Nix, you can install poetry locally by running:

python -m venv .venv
. .venv/bin/activate
pip install -U pip && pip install poetry
poetry install