用途:该技能面向 Semantic Link Labs 项目,指导如何为 Python 逻辑编写单元测试,适用于为新函数写测试、为既有代码补充覆盖率、测试错误处理与边界情况,以及验证输入解析和数据转换。
主要能力:使用 pytest 作为测试框架,测试文件放在 tests/ 目录,采用标准 pytest 断言。文档覆盖基础函数测试、参数化测试、预期异常与异常信息匹配、夹具(fixture)与参数化夹具、使用 unittest.mock 模拟 API 调用与 Fabric 客户端、DataFrame 结果的列名与类型校验、空结果处理,以及按功能分组的测试类组织方式。
命名规范:测试文件为 test_*.py 或 *test.py;测试函数为 test<function_name>_<scenario>;测试类为 Test<ClassName>。
使用方式:运行单个测试可执行 pytest -sv tests/ -k my_new_test。文档建议在提交前本地运行测试、多次运行确认结果稳定、检查新代码覆盖率,并保证测试之间相互独立。
限制与注意:资料明确要求不要在单元测试中依赖外部服务,不要使用硬编码密钥或凭据,不要编写依赖执行顺序的测试,也不要忽略不稳定测试。关于安装命令、具体依赖版本、收费或授权信息,资料暂未提供。