python-env

# Python Environment Fast Python environment management with uv. Prefer the uv **project** workflow (`uv add` / `uv sync` / `uv run`) over the `uv pip` compatibility layer — it manages `pyproject.toml` + a lockfile for you and is reproducible. ## Quick Commands | Task | Command | |------|---------| | Start a project | `uv init <name>` (app) · `uv init --package <name>` (installable, `src/` layout) | | Add dependency | `uv add httpx` | | Add dev dependency | `uv add --dev pytest ruff` | | Remove dependency | `uv remove httpx` | | Sync env from lockfile | `uv sync` | | Run in project env | `uv run pytest` | | Update lockfile | `uv lock` | | Install a CLI tool | `uv tool install ruff` · one-shot: `uvx ruff` | | Install a Python | `uv python install 3.12` | ## Start a Project ```bash # Application (flat layout, no package build) uv init myapp # Installable package (src/ layout — separate tests/ that import by name) uv init --package wordtools # → src/wordtools/__init__.py, pyproject.toml with build-system ``` `uv init` creates `pyproject.toml`, pins a Python version, and prepares the project for `uv add` / `uv sync`. The `--package` (src) layout is preferred for anything with a test suite or that you intend to ship. ## Manage Dependencies ```bash # Add runtime deps (writes to [project.dependencies] + updates the lockfile) uv add "httpx>=0.25" pydantic # Add dev-only deps (writes to the dev dependency-group) uv add --dev pytest ruff mypy # Add with extras uv add "fastap...