Code Quality

Format and validate your code before committing

Run formatting and validation before pushing changes to ensure code quality.

Format

Format the codebase using ruff:

Script

./scripts/format.sh

ruff format .

Validate

Lint and type-check using ruff and mypy:

Script

./scripts/validate.sh

ruff check .

mypy .

Configuration is in pyproject.toml. Run both scripts before every commit.

Pre-commit Workflow

# 1. Format
./scripts/format.sh

# 2. Validate
./scripts/validate.sh

# 3. If both pass, commit
git add .
git commit -m "your message"

Common Issues

Issue	Solution
ruff not found	Run uv pip install ruff
mypy not found	Run uv pip install mypy
Type errors	Fix the types or add # type: ignore comment
Import sorting	Run ruff check --fix . to auto-fix