python-style

Project-wide Python conventions. Auto-apply when touching any .py file.

Linting

Ruff is the linter. Run after every modification to any Python file in any project.

ruff check <path>
ruff check --fix <path>   # auto-fix safe issues
ruff format <path>        # formatter

Don't claim a Python edit complete until Ruff passes on the changed file.

Package installation (macOS Homebrew Python)

macOS Homebrew-managed Python rejects pip install without an explicit override. Use: