00_repo_tooling.mdc

---
description: Project-wide tooling, env, and command conventions
globs: "**/*"
alwaysApply: true
---

Use uv for Python dependency management and workflows. Prefer these commands:

- Setup env: `./scripts/bootstrap` or `uv sync --all-groups`
- Run tests: `uv run pytest` or `./scripts/test`
- Run a specific test: `uv run pytest path/to/test_file.py::TestClass::test_method -v`
- Format: `uv run ruff format` or `./scripts/format`
- Lint: `uv run ruff check .` or `./scripts/lint`
- Type check: `uv run pyright`
- Build: `uv build`

Environment requirements:

- Python 3.12+ is required
- A mock server auto-starts for tests on port 4010

Notes:

- Tutorial folders have their own virtualenv (managed by a tutorial specific pyproject.toml inside the relevant tutorial folder). Use `uv run` within those folders.