Python Workflow

Use this skill when working on Python projects or adding Python support.

Tooling baseline

• •Use uv for environments, dependency management, and running commands.
• •Prefer Astral tooling for quality gates: ruff for lint/format and ty for type checking.
• •Favor strict typing everywhere; avoid Any unless the boundary truly requires it.

Typing and schemas

• •Type every function signature (params + return) and keep types narrow.
• •Use Pydantic models for inputs, outputs, and configuration schemas.
• •Prefer typed collections and typing_extensions for newer typing features.

Testing

• •Write tests with pytest and property tests with hypothesis when behavior is stateful or rule-based.
• •Add coverage checks (e.g., pytest-cov) and keep coverage green for new code paths.

Packaging

• •Structure the code as a releasable PyPI package.
• •Use a pyproject.toml with build metadata, versioning, and a src/ layout.
• •Ensure imports and entrypoints work when installed from a wheel.

Quality gates

• •For pre-commit hooks, run formatting last so lint fixes land before formatting.
• •Keep linting, type checking, and tests passing before closing work.