AI Agent Hub
Back to plugins
⚙️

dsh-api-testgen

Workflow Updated 2026.08.25

Run the following command in DeepSeek Harness:

dsh plugin install uckkk/dsh-api-testgen

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install uckkk/dsh-api-testgen in DeepSeek Harness to install this plugin; the source is at https://github.com/uckkk/dsh-api-testgen

About this plugin

When hand-writing API tests, the scenarios most often missed are the boundary ones: a required path parameter silently dropped, an enum field receiving a value that does not exist. dsh-api-testgen was built for exactly this. It reads your OpenAPI 3.x spec (JSON or YAML) and generates a set of well-scoped test skeletons for every endpoint, so you no longer rely on memory to figure out what has not been covered.

The core capability is focused: after parsing the spec, each endpoint yields one success (2xx) case, one missing-required-path-param case per required parameter, and one invalid-enum-value case per enum parameter. Output can be Python (pytest + requests) or TypeScript (vitest + fetch). The entire parse-and-generate pipeline runs in pure Node with no network calls and no external services.

The generated files are skeletons they assert status codes, and you fill in business-specific assertions as needed before flipping BASE_URL and running. Paired with dsh-api-contract (client) and dsh-api-mock (mock server), it forms an API development toolkit of three. It is a good fit for developers or small teams that maintain a solid OpenAPI spec but still patch test coverage by hand.

Use Cases

  • Generate full-endpoint test skeletons from an OpenAPI 3.x spec in one pass
  • Auto-fill boundary cases for required path parameters and enum fields on every endpoint
  • Switch between Python and TypeScript output to match the project test stack

Best For

  • Developers who maintain an OpenAPI spec but still patch test coverage by hand
  • Small and mid-size teams needing a quick minimum test baseline for new endpoints
  • Mixed projects running both Python and TypeScript toolchains