SuperAPI AI 工具集

test-harness

测试与质量

查看项目

更新于 10-16 00:20

技能介绍

用途:将源代码转化为可运行、覆盖全面的 pytest 测试文件。它分析函数签名、依赖图与复杂度热点,生成覆盖正常路径、边界条件、错误状态和异步流程的测试,并配合作用域正确的 fixture 与聚焦的 mock。

主要能力:分五阶段工作。侦察阶段识别测试范围、读取签名、梳理依赖、定位复杂热点、查看已有测试与项目约定;用例枚举阶段按正常、边界、错误、状态四类列出具体输入与预期;fixture 设计阶段提取共享设置并选择 function/class/module/session 作用域,必要时用 yield 做清理;mock 策略阶段只对外部依赖(网络、文件系统、时间、随机行为)打桩,在导入边界打补丁并添加调用断言;输出阶段按固定结构生成测试文件。支持 quick、standard、comprehensive 三种范围模式。内置四份参考文件,分别覆盖 pytest 模式、mock 策略、异步测试与 fixture 设计。

使用方式:要求 pytest >= 7.0、Python >= 3.10;异步测试需要 pytest-asyncio,可选 pytest-mock。输出路径形如 tests/test_{module}.py,先写导入、常量与测试数据,再按 session > module > class > function 顺序排列 fixture,然后按目标函数分组测试类,能参数化的用 @pytest.mark.parametrize 合并。当目标无测试基础设施时,会额外生成最小 conftest.py。

适用场景:为已有 Python 函数、类或模块补充单元与集成测试,或在 TDD 迭代中快速生成测试骨架。

限制:只生成单元与集成测试,不做 UI/E2E 测试;不针对自动生成的代码(protobuf、OpenAPI 客户端、ORM 模型)或第三方库本身生成测试;目标无法导入、无可测行为或代码不可测时会指出问题而不强行生成。具体触发命令与安装细节资料未提供。