loom-python

# Python Language Expertise ## Overview Idiomatic, production-grade Python: modern typing, async, packaging, and the web/data/ML ecosystem. Assumes competence — the value is in what is easy to get wrong (interning, mutable defaults, blocking the event loop, GIL, dataclass/Pydantic boundaries), not syntax tutorials. ## Tooling (uv / ruff / mypy) Ruff is a strong default for linting and formatting. `uv` is a capable project and environment manager, but preserve the repository's existing package manager and lockfile unless a migration is explicitly requested. **`uv`** — a single tool for project environments, locking, Python installation, and pip-compatible workflows. Use it for new work or repositories that already use it; do not treat it as an implicit replacement for Poetry or another established workflow. | Task | Command | | --- | --- | | New project | `uv init` (writes `pyproject.toml`) | | Add / remove dep | `uv add httpx` / `uv remove httpx` (updates `pyproject.toml` + `uv.lock`) | | Add dev dep | `uv add --dev pytest` | | Sync env from lock | `uv sync` (creates `.venv`, exact/reproducible) | | Run in project env | `uv run pytest` (auto-syncs first; no manual activate) | | Install a Python | `uv python install 3.12` | | Ephemeral tool | `uvx ruff check` (= `uv tool run`) | | pip shim | `uv pip install ...` (drop-in, no project file) | - In a uv-managed project, use `uv add`/`uv remove` so the manifest and `uv.lock` stay in sync; use `uv sync --frozen` in CI to fai...