python-dev

# Python Development Setup Opinionated, production-ready Python development stack. No choices to make - just use this. ## When to Use - Starting a new Python project - Modernizing an existing project (migrating from pip/poetry/mypy/black/flake8) - Setting up linting, formatting, type checking, or testing - Creating a Justfile for project commands - Configuring pyproject.toml as the single source of truth ## The Stack | Tool | Role | Replaces | |------|------|----------| | [uv](https://docs.astral.sh/uv/) 0.11+ | Package manager, Python versions, runner | pip, poetry, pyenv, virtualenv | | [ty](https://docs.astral.sh/ty/) (beta) | Type checker (Astral, Rust) | mypy, pyright | | [ruff](https://docs.astral.sh/ruff/) | Linter + formatter | flake8, black, isort, pyupgrade | | [pytest](https://docs.pytest.org/) | Testing | unittest | | [just](https://just.systems/) | Command runner | make | > **Note on ty**: ty is in beta (0.0.x). It's fast and improving rapidly, but still missing features and may produce false positives on heavy-typing libraries (Pydantic, Django, SQLAlchemy). For projects that need rock-solid type checking today, swap `ty` for `pyright` and keep the rest of the stack unchanged. ## Quick Start: New Project ```bash # 1. Create project with src layout uv init --package my-project cd my-project # 2. Pin Python version uv python pin 3.13 # 3. Add dev dependencies uv add --dev ruff ty pytest pytest-asyncio pre-commit # 4. Create Justfile (see template below)...