test-generator

test-generator 技能是一种专门的代理程序实用工具，旨在简化 Python 软件项目的质量保证流程。此技能专为在 pydantic-deep 生态系统中工作的开发人员设计，通过分析函数定义、方法签名和类结构，自动建立完整的 pytest 测试套件。它作为专家助理，将代码需求转化为强大的验证逻辑，确保软件通过严格的测试实践维持高水平的可靠性和稳定性。此工具非常适合开发人员在绿地项目和旧代码重构中快速扩展测试覆盖率，解决手动撰写测试耗时的问题。

• 自动生成结构化的 pytest 代码，使用标准模式，包括类测试和具描述性的测试命名规范。

• 实现全面的测试类别覆盖，通过建立快乐路径测试、边界情况验证、错误条件处理和集成测试场景。

• 提供关于最佳实践的智能指导，例如利用 fixture 进行设置、应用 parametrize 装饰器进行高效的批量输入测试，以及模拟外部依赖项以确保测试隔离。

• 支持高级 Python 功能，包括通过 pytest-asyncio 测试异步函数，以及验证如空输入、空指针和整数限制等边界值。

• 使用 pytest.raises 促进错误条件测试，以确保应用程序堆栈中的稳健异常处理。

• 用户应提供预计测试的具体模块或函数片段，以获得最精确的代码生成结果。

• 优先为每个测试保持单一断言原则，以维持清晰度并简化测试失败时的调试过程。

• 始终审查生成的断言，确认其符合项目特定的商业逻辑和预期的输出限制。

• 测试复杂系统时，请确保正确识别外部依赖项，以便工具能提供适当的模拟策略。

• 虽然工具生成符合习惯的 pytest 代码，建议在 CI 流水线中审查覆盖率结果，以确保函数内的所有分支逻辑皆已充分执行。