Python Directory and Configuration

Python project setup involves creating a directory structure with src/, tests/, and configuration files, then initializing a virtual environment using pyenv or venv, and managing dependencies through Poetry or uv. This ensures consistent builds across machines and team members.

Use pyenv to manage Python versions and venv or Poetry/uv to create isolated environments with locked dependencies defined in pyproject.toml. This prevents version conflicts and makes projects reproducible across different machines.

Define tool configurations in pyproject.toml to specify linting (Ruff), formatting (Black), type checking (Mypy), and testing (Pytest) rules. This centralizes tooling settings and enables CI-ready automation from project initialization.

Both Poetry and uv manage dependencies through pyproject.toml and create reproducible environments, but uv offers faster dependency resolution. Choose based on your team's preference and performance needs; both integrate with standard Python tooling.

You need Python installed via pyenv or system package manager, pip or poetry/uv available for dependency installation, and basic shell access. The skill handles the rest: scaffolding directories, initializing virtual environments, and configuring toolchains.

Structured layouts with src/ and tests/ directories, combined with pyproject.toml configuration, reduce errors, improve team onboarding, enable dependency locking, and make CI integration straightforward. This standardization speeds project setup and maintenance.