Python 测试模式
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/rmyndharis-antigravity-skills-python-testing-patterns。
技能介绍
要解决什么问题
Python 项目在迭代中很容易留下「能跑但没护栏」的代码:改一行引发连锁失败、外部 API 或数据库一挂测试就红一片、异步逻辑在本地难复现。没有一致的 fixture 组织、mock 边界和参数化用例,团队往往在补测试和修 flaky test 之间来回耗时间。
技能如何帮你落地
本技能围绕 pytest 生态 里的常见工程做法,而不是泛泛讲「要写测试」。它会引导你先厘清 目标、约束和输入,再按场景选用合适模式:
- 单元与集成:为模块、API 与服务层设计用例分层,区分快速反馈与端到端验证
- Fixture 与测试基础设施:复用数据库会话、客户端、临时目录等上下文,避免每个文件重复造轮子
- Mock 与隔离:对外部依赖、网络调用和服务边界做替身,让测试稳定、可离线运行
- 参数化与属性测试:用
@pytest.mark.parametrize和 property-based 思路覆盖边界组合 - 异步与并发:针对
async代码和并发行为设计可重复的断言方式 - CI/CD 持续测试:把套件挂进流水线,让失败用例成为可操作的信号
需要更细的代码形态时,技能会指向 implementation-playbook.md 中的 implementation patterns 与示例,便于对照项目结构直接改。
适用边界
任务若与 Python 测试模式 无关,或你必须用本技能范围外的语言/工具栈(例如纯前端 E2E 框架、非 Python 运行时),不应强行套用。数据库、消息队列等场景仍在范围内,但核心假设是你能在 Python 侧编写并执行 pytest 套件。
使用场景
- 为新写的业务模块搭 pytest 套件,并划分单元用例与调用真实 HTTP 的集成用例
- 在 CI 流水线里接入测试阶段,需要把 flaky 用例和外部依赖隔离掉再合并主分支
- 重构数据库访问层时,用 fixture 提供可回滚的会话并在用例里 mock 第三方支付接口
- 为 asyncio 服务补回归测试,覆盖并发请求下的状态变更与超时分支
适合人员
- 维护单体或微服务 Python 后端、每次发版前要补回归用例的后端工程师
- 负责把 pytest 挂进 GitHub Actions/Jenkins、并想让失败日志可读的平台或 DevOps 工程师
- 在团队内推行 TDD、需要统一 fixture 与 mock 边界的 Tech Lead
- 写完 REST 客户端封装后、要对外部 API 做替身测试避免消耗配额的集成开发者