Swagger API 测试用例生成器

问题

API 规格通常以 Swagger/OpenAPI 形式存在，但真正落到测试时仍要人工整理用例字段、边界条件、登录态、请求参数、断言和测试数据。规格只描述 接口长什么样，不会自动说明 哪些用例值得测、失败后如何定位、结果如何报告。尤其对多环境服务，base_url、token、数据库连接、敏感信息脱敏、重试和报告分发都容易散落各脚本里。

工作方式

swagger-to-testcases 从 Swagger/OpenAPI 2.0/3.x 规格文件生成两类输出：

• Excel 用例表：26 列用例结构，适合评审、排期和执行记录。
• pytest 测试框架文件：可直接运行，并内置 framework/ 目录。

框架包含五个核心模块：

• config.py：多环境配置，优先级为 环境变量 > 环境 YAML > default.yaml。
• logger.py：结构化日志，支持 request()、response()、assertion()，并自动脱敏 token、cookie、password。
• http_client.py：统一请求入口，支持超时、重试、状态码断言、JSONPath 断言、变量提取和 {{variable}} 参数化。
• fixtures.py：管理登录、初始化、清理任务，覆盖 DB 和 HTTP 清理。
• reporter.py：生成 Allure 报告，可降级为文件记录，并支持 SMTP 邮件发送。

适用边界

适合已有较稳定 OpenAPI 规格、希望把 API 测试从手写脚本迁移到可执行框架的项目。对依赖复杂状态、消息队列、WebSocket、文件上传或外部服务的接口，仍需补充人工用例。邮件和 Allure 报告依赖本地依赖与 SMTP 配置，CI 中需要处理密钥注入和报告产物。