Project Setup: UV Package Manager

This project uses uv as the package manager for all Python operations.

Running Commands

Always prefix Python commands with uv run:

# Run tests
uv run pytest

# Run linting
uv run pre-commit run --all-files

# Install dependencies
uv sync --group dev

Key Commands

• Install: uv venv --allow-existing && uv sync --group dev
• Test: uv run pytest
• Lint: uv run pre-commit run --all-files
• Format: Automatically handled by pre-commit hooks

Make Commands

The project has a Makefile with convenient shortcuts:

• make install - Set up environment
• make test - Run tests
• make lint - Run linters
• make clean - Clean build artifacts

All Makefile commands use uv internally.

Git Commits

When committing code, pre-commit hooks will automatically run via uv. The hooks include:

• Ruff for linting and formatting
• Trailing whitespace fixes
• End of file fixes

Make sure all linting and formatting passes before committing.