configuring-python-stack

Configures Python stacks with uv, ruff, mypy, pytest, enforcing quality gates including 96% coverage threshold and Justfile workflow.

1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/bryonjacob/aug --skill configuring-python-stack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-python-stack
Source: https://github.com/bryonjacob/aug/tree/main/aug-dev/skills/configuring-python-stack
Command: npx skills add https://github.com/bryonjacob/aug --skill configuring-python-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Projects often struggle to establish a consistent Python development environment with enforced quality gates. This Skill provides a blueprint to configure uv, ruff, mypy, and pytest to deliver reliable builds and measurable coverage.

Core Features & Use Cases

  • Deterministic environments: Create isolated virtual environments and reproducible setups.
  • Quality gates: Enforce code style, type checking, and test coverage with configured thresholds.
  • Use Case: A team onboarding a new Python project can apply this stack to ensure immediate alignment with guidelines and automated checks.

Quick Start

uv venv .venv uv pip install -e ".[dev]" uv run ruff format . uv run ruff check --fix . --select C90 --complexity-max 10 uv run mypy src uv run pytest -m "not integration" --durations=10 uv run pytest -m "not integration" --cov=src --cov-fail-under=96

Frequently Asked Questions about configuring-python-stack

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a Python stack with strict quality gates using uv, ruff, and mypy?

Configure a Python stack with strict quality gates by setting up uv for deterministic environments, ruff for style enforcement, mypy for strict type checking, and pytest with a 96% coverage threshold. This ensures reliable builds and measurable coverage across your codebase.

What is the best way to enforce a 96% test coverage threshold in a Python project?

Enforce a 96% test coverage threshold by running pytest with coverage flags targeting your source directory. Configure the stack to use `--cov=src --cov-fail-under=96` so automated checks fail when unit test coverage drops below the required limit.

Can I use a Justfile workflow to manage Python local development setup and automated testing?

Yes, you can use a Justfile-based workflow to manage Python local development setup and automated testing. This integrates the toolchain commands for uv, ruff, mypy, and pytest into reproducible workflows for small to large Python codebases.

How do I set up deterministic builds and reproducible environments for Python?

Set up deterministic builds and reproducible environments by using uv to create isolated virtual environments. This approach ensures consistent dependency resolution and reliable builds across small to large Python projects requiring strict toolchain integration.

Does ruff support complexity checks for Python code style enforcement?

Yes, ruff supports complexity checks for Python code style enforcement. You can configure ruff to check complexity by selecting rule C90 and setting a maximum complexity threshold, such as `--complexity-max 10`, to enforce quality gates.