modern-python-substrate

Setting up a modern Python toolchain with uv and ruff involves bootstrapping a project that includes uv for venv management, ruff for linting, ty for type checking, and pytest, all unified within a single pyproject.toml file.

The standard way to structure a Python project using uv is implementing a canonical src/ layout, where pyproject.toml serves as the single source of truth for dependencies, formatting rules, and testing configurations.

You can migrate legacy Python projects to a uv-based workflow by transitioning dependency management and virtual environment creation to uv, while standardizing the configuration under a unified pyproject.toml to maintain existing dependencies.

The uv and ruff Python toolchain primarily targets Python 3.11+ on Linux and macOS, but it maintains Windows parity where relevant, ensuring cross-platform compatibility for development workflows.

Configuring pytest and Hypothesis for property-based testing is handled by bootstrapping the project with a standard pyproject.toml, which integrates both testing frameworks into the modern Python workflow automatically.

You should evaluate not using uv for Python dependency management if your project requires legacy Python versions below 3.11, or if your team environment cannot adopt a unified pyproject.toml configuration approach.