pytest-testing-assistant
编写独立的函数作为专注的 pytest 测试(每个函数一个测试),避免使用测试类。
📖 中文导读:编写独立的函数作为专注的 pytest 测试(每个函数一个测试),避免使用测试类。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: pytest-testing-assistant description: Write focused pytest tests as standalone functions (one test per function), avoiding test classes.
Pytest Testing Assistant
Quick start
- Write tests as plain functions; do not use test classes. Aim for one focused test per function/behavior.
- Use clear names:
test_<function>_<behavior>; keep AAA (arrange/act/assert) obvious. - Prefer one primary assertion per test; add minimal supporting checks when necessary.
- Use fixtures sparingly to keep tests readable; favor in-test setup when simple.
- Run with
pytestorpytest path/to/test_file.pyto scope runs. - See
references/pytest_rules.mdfor detailed guidelines and examples.
Workflow
Identify behavior
- Target a single function/behavior per test. Name the test after the behavior being validated.
Write the test
- Use a standalone function
def test_<thing>():(no classes). - Keep a clear arrange/act/assert structure; avoid hidden work in fixtures unless it improves clarity.
- Use parametrization for small input/output matrices instead of loops.
- Use a standalone function
Assertions
- Prefer one main assertion; add secondary checks only when they clarify the outcome.
- Include helpful assertion messages or use expressive matchers for readability.
Run and iterate
- Run
pytest(optionally narrow with paths or-kexpressions). - Refine names and setup for readability and isolation.
- Run
Reference
references/pytest_rules.md: structure rules, naming patterns, and usage tips.