Pytest代码审查指南：异步测试、夹具参数化与Mock最佳实践

pytest-code-review by existential-birds/beagle

94 周安装量

46 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/existential-birds/beagle --skill pytest-code-review

Python Web框架代码质量测试

🇨🇳中文介绍

Pytest 代码审查

快速参考

问题类型	参考
async def test_*、AsyncMock、await 模式	references/async-testing.md
conftest.py、工厂夹具、作用域、清理	references/fixtures.md
@pytest.mark.parametrize、DRY 模式	references/parametrize.md
AsyncMock 跟踪、patch 模式、何时使用模拟	references/mocking.md

审查清单

对于被测试的异步代码，测试函数应为 async def test_*
对异步依赖使用 AsyncMock，而非 Mock
所有异步模拟对象和协程都已被等待（awaited）

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

何时查阅参考文档

审查异步测试函数时 → async-testing.md
审查夹具或 conftest.py 时 → fixtures.md
审查相似测试用例时 → parametrize.md
审查模拟和补丁时 → mocking.md

是否所有异步函数都使用 async def test_* 进行测试？
夹具的作用域是否恰当，并配有适当的清理操作？
相似的测试用例是否可以通过参数化来减少重复？
模拟对象是否跟踪了调用，并且使用位置是否正确？

🇺🇸English

Pytest Code Review

Quick Reference

Issue Type	Reference
async def test_*, AsyncMock, await patterns	references/async-testing.md
conftest.py, factory fixtures, scope, cleanup	references/fixtures.md
@pytest.mark.parametrize, DRY patterns	references/parametrize.md
AsyncMock tracking, patch patterns, when to mock	references/mocking.md

Review Checklist

Test functions are async def test_* for async code under test
AsyncMock used for async dependencies, not Mock
All async mocks and coroutines are awaited
Fixtures in conftest.py for shared setup
Fixture scope appropriate (function, class, module, session)
Yield fixtures have proper cleanup in finally block
@pytest.mark.parametrize for similar test cases
No duplicated test logic across multiple test functions
Mocks track calls properly (assert_called_once_with)
patch() targets correct location (where used, not defined)
No mocking of internals that should be tested
Test isolation (no shared mutable state between tests)

When to Load References

Reviewing async test functions → async-testing.md
Reviewing fixtures or conftest.py → fixtures.md
Reviewing similar test cases → parametrize.md
Reviewing mocks and patches → mocking.md

Review Questions

Are all async functions tested with async def test_*?
Are fixtures properly scoped with appropriate cleanup?
Can similar test cases be parametrized to reduce duplication?
Are mocks tracking calls and used at the right locations?

Weekly Installs

Repository

existential-birds/beagle

GitHub Stars

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli71

opencode71

codex70

cursor65

claude-code64

github-copilot64

Vue 3 调试指南：解决响应式、计算属性与监听器常见错误

11,900 周安装