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.38.0 and catalog SHA-256 cd13c658f65af295f9df3c6db86dc045ac06e9e040afc1f5f5b27c3184ab653d. Hidden implementation commands are omitted.
evidencectl source mock generate [OPTIONS] [PROJECT]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 --seed <SEED> cannot be used together. |
| Command invocation | --config <CONFIG> and [PROJECT] cannot be used together. |
| Command invocation | --openapi <OPENAPI> and [PROJECT] cannot be used together. |
Arguments
Section titled “Arguments”| Argument | Always required | Default | Values | Environment | Description |
|---|---|---|---|---|---|
[PROJECT] | 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. |
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 |
--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 | n/a | Select human-readable output; this command provides no JSON report |
-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.