dsh-api-testgen

August 19, 2026 · View on GitHub

解析 OpenAPI 3.x(JSON / YAML),为每个接口生成覆盖 成功 2xx / 缺少必填路径参数 / 非法枚举值 的接口测试用例,输出 Python(pytest + requests)或 TypeScript(vitest + fetch)测试骨架。纯 Node 实现,无网络、无外部服务。

提供的工具

工具作用
gen_tests解析规范,生成接口测试文件(pytest 或 vitest)

安装

dsh plugin add dsh-api-testgen

安装后在 profile 的 package.jsondsh.profile.bundles 中加入 "dsh-api-testgen"

用法示例

根据 openapi.yaml 生成 Python 接口测试
→ 调用 gen_tests(spec="openapi.yaml", lang="python")

生成 TypeScript(vitest) 接口测试
→ 调用 gen_tests(spec="openapi.yaml", lang="typescript", outDir="./src/__tests__")

说明

  • 每个接口生成:成功用例 + 每个必填路径参数的缺参用例 + 每个枚举参数的非法值用例。
  • 生成的测试只是骨架(断言状态码),具体业务断言需按需补充;运行前改 BASE_URL
  • dsh-api-contract(客户端)、dsh-api-mock(Mock 服务器)配合,构成 API 开发三件套。

安装

dsh plugin add github:uckkk/dsh-api-testgen

安装即在本机运行第三方代码,请自行审阅源码。

安装

dsh plugin add github:uckkk/dsh-api-testgen

使用

安装后在会话中调用该插件注册的工具即可。

许可

MIT

安装即在本机运行第三方代码,请自行审阅源码。