# Hyperwork Python

> Python tooling for impl tasks — pytest patterns, uv toolchain, mypy, fixtures. Compose with hyperwork-tdd skill for methodology.

- Skill: `samrom3/hyperwork-python` (Agent Skill)
- Install (CLI): `npx skillmds@latest add samrom3/hyperwork-python`
- Raw SKILL.md: https://api.skillmd.com/api/skills/samrom3/hyperwork-python/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: samrom3 (https://skillmd.com/u/samrom3)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/samrom3/hyperwork-python

---


# Python

**Use:** Python impl tasks. Load with `hyperwork-tdd` skill: `skills: [hyperwork-tdd, hyperwork-python]`.

## Toolchain

- Run tests: `uv run pytest` (not bare `pytest`).
- Lint/format: `uv run pre-commit run --all-files` before commit.
- Types: `uv run mypy <module>` if mypy configured. Required on public API.

## Patterns

- Test name: `test_<what>_<condition>`.
- One assert per concept (multiple asserts OK if same concept).
- Fixtures in `conftest.py` — no repeated setup across test files.
- Mock at boundary only (external I/O, network, DB). Don't mock internals.
- `pytest.raises` for expected exceptions — never bare `try/except` in tests.

## Do / Don't

- DON'T: use `unittest.TestCase` unless repo already does — prefer plain functions + pytest.
- DON'T: test private methods directly — refactor if tempted.
- DON'T: use bare `pytest` — always `uv run pytest`.