TLDR

These are my defaults for a new project. Each one links to the page that explains it.

• Toolchain: uv for dependencies, interpreters, tools, scripts and builds.
• Project: all configuration in pyproject.toml, development tools in [dependency-groups], a src/ layout, and the lockfile committed.
• Linting and formatting: ruff for both.
• Type checking: ty for type checker and language server.
• Data models: Pydantic, dataclasses or attrs, and pydantic-settings for configuration.
• Errors: one base exception per package, with third-party exceptions wrapped where they enter, using raise ... from.
• Logging: Loguru or structlog, configured once at the application entry point and never inside a library.
• Testing: Hypothesis or pytest with fixtures and parametrization.
• CLIs: Typer or Cyclopts.
• Documentation: Sphinx or MkDocs with Material and mkdocstrings.
• CI: uv sync --locked first, actions pinned to commit SHAs, and a read-only token.
• Publishing: trusted publishing to PyPI.