CONTRIBUTING.md

Development

Environment

For local development, you need Python 3.10 or later installed. We use uv for project and environment management, and just as our command runner.

Dependencies

To install this package and its development dependencies, run:

just sync

or

uv sync --group dev

Code checking

To execute all code checking tools together, run:

just check

Linting

We utilize ruff for linting, which analyzes code for potential issues and enforces consistent style. Refer to pyproject.toml for configuration details.

To run linting:

just lint

Formatting

ruff is also used for code formatting. Refer to pyproject.toml for configuration details.

To run formatting:

just format

Testing

We use pytest for testing. The default Python version is configured in .python-version; the local test matrix is configured in .python-versions.

# Run tests on the default Python version
uv run pytest -v

# Run tests across all supported Python versions
just test

Pre-commit Hooks

We use pre-commit to run quality checks automatically:

# Install pre-commit hooks
uv tool install pre-commit
pre-commit install

# Run hooks manually on all files
pre-commit run --all-files

Documentation

We follow the Google docstring format for code documentation. All user-facing classes and functions must be documented with docstrings and type hints.

Release Process

New versions are automatically published to PyPI when a GitHub release is created.