python-project-conventions

name: Python project conventions description: Project conventions for install, lint, test, format, and coverage via Make

Skill: Python project conventions

Goal

Provide a consistent Python dev experience (install/lint/test/format/coverage) via Make targets.

Expected repo files

• pyproject.toml (preferred) or requirements*.txt
• Package code under src/ (preferred) or top-level package dir
• Tests under tests/

Make targets (recommended)

• make install → python -m pip install -e .
• make install-dev → install dev extras + ruff/pytest
• make lint → ruff check ...
• make format → ruff format ...
• make test → python -m pytest
• make coverage → python -m pytest --cov=... --cov-report=term-missing
• make check → make lint && make coverage

Quality Bars

• End product should be installable from the final repo URL via uv tool or pip