evidencectl source mock generate command reference
Materialize or extend editable mock cases from OpenAPI.
Contract status
Section titled “Contract status”This page is generated from the public Clap command tree for Registry Stack source version 0.34.0 and catalog SHA-256 521175a69262e60df96745886392348e5bb8d82e63cdd24bdf4baa80d46e5ff4. Hidden implementation commands are omitted.
evidencectl source mock generate [OPTIONS]Constraints
Section titled “Constraints”| Condition | Requirement |
|---|---|
--output <OUTPUT> is present | --openapi <OPENAPI> is required. |
--case <CASE> is present | --operation <OPERATION> is required. |
--path-parameter <PATH_PARAMETERS> is present | --operation <OPERATION> is required. |
| Command invocation | --as-of <AS_OF> and --config <CONFIG> cannot be used together. |
| Command invocation | --config <CONFIG> and --openapi <OPENAPI> cannot be used together. |
| Command invocation | --config <CONFIG> and --output <OUTPUT> cannot be used together. |
| Command invocation | --config <CONFIG> and --project <PROJECT> cannot be used together. |
| Command invocation | --config <CONFIG> and --seed <SEED> cannot be used together. |
| Command invocation | --openapi <OPENAPI> and --project <PROJECT> cannot be used together. |
Options
Section titled “Options”| Option | Always required | Repeatable | Default | Values | Environment | Description |
|---|---|---|---|---|---|---|
--openapi <OPENAPI> | No | No | n/a | n/a | n/a | OpenAPI document for initial standalone materialization |
--config <CONFIG> | No | No | n/a | n/a | n/a | Existing editable configuration to complete or extend |
--output <OUTPUT> | No | No | n/a | n/a | n/a | Initial configuration path. Defaults to mocks/source.yaml |
--project <PROJECT> | No | No | n/a | n/a | n/a | Evidence project directory; defaults to the current directory. This command needs an editable project: one holding questions/ and sources/ beside evidence-project.yaml. |
--operation <OPERATION> | No | No | n/a | n/a | n/a | Select one METHOD /path/template operation |
--case <CASE> | No | No | n/a | n/a | n/a | Starter or appended case name for the selected operation |
--path-parameter <PATH_PARAMETERS> | No | Yes | n/a | n/a | n/a | Concrete selected-operation path parameter as NAME=VALUE; repeat as needed |
--seed <SEED> | No | No | n/a | n/a | n/a | Deterministic unsigned generation seed for a new plan. Defaults to zero |
--as-of <AS_OF> | No | No | n/a | n/a | n/a | Calendar date used only by explicit or inferred age generation |
--explain | No | No | n/a | n/a | n/a | Explain generator choices without printing generated or authored values |
--format <output_format> | No | No | human | human, json | n/a | Select human-readable or machine-readable output |
-h, --help | No | No | n/a | n/a | n/a | Print help (see a summary with ‘-h’) |
Generation contract
Section titled “Generation contract”Run npm run generate from docs/site after changing a public command, argument, option, default, environment binding, or help description.