| name | python-testing |
| description | Use when writing tests, setting up pytest, implementing TDD, creating fixtures, or mocking dependencies. Do NOT use for general patterns (use python-patterns) or style config (use python-code-style). |
| paths | **/*.py, **/pyproject.toml, **/pytest.ini, **/conftest.py |
Python Testing Patterns
실수 잦은 지점과 프로젝트 컨벤션만 담는다. pytest API 일반 지식은 모델에 이미 있음.
CRITICAL Rules
- Test behavior, not implementation — 내부 구현이 아닌 입출력/부수효과 검증
- Mock at boundaries only — 외부 시스템(DB, API, filesystem)만 mock, 내부 로직은 실제 실행
- Patch where you USE, not where you define —
patch("myapp.service.requests.get") NOT patch("requests.get")
- ALWAYS
autospec=True on mocks — API 불일치 조기 발견
- PREFER
pytest.raises(match=...) — 예외 타입 + 메시지 함께 검증
- NEVER test third-party code — 라이브러리가 동작하는지 테스트하지 마라
- 80%+ coverage, critical paths 100% —
pytest --cov --cov-fail-under=80
pytest Configuration (프로젝트 컨벤션)
[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = ["--strict-markers", "--cov=src", "--cov-report=term-missing", "--cov-fail-under=80", "-x", "--tb=short"]
markers = ["slow: marks tests as slow", "integration: integration tests"]
[tool.coverage.report]
exclude_lines = ["pragma: no cover", "if TYPE_CHECKING:", "raise NotImplementedError", "@abstractmethod"]
테스트 네이밍: test_{method}_{scenario}_{expected_result} — 예: test_create_user_duplicate_email_raises_conflict
Gotchas
- ❌
patch('module.Class') (정의 위치) → patch('consumer_module.Class') (사용 위치)
- ❌
autospec=True 누락 → 존재하지 않는 메서드 호출해도 통과
- ❌
assert mock.called → mock.assert_called_once_with(expected) 사용
- ❌ session-scope fixture에 mutable state → 테스트 간 오염, 간헐적 실패
- ❌ async test가 조용히 skip됨 → pytest-asyncio
mode = "auto" 설정 누락
- ❌ 간헐적 실패 원인 추적 →
pytest-randomly로 순서 무작위화 후 재현
Cross-References
| Topic | Skill |
|---|
| Python 패턴, 타입 힌트, 동시성 | python-patterns |
| Ruff, mypy, formatting, naming | python-code-style |
| TDD methodology (general) | test-driven-development superpowers |
