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