crab stage
Use DVC-compatible helpers to edit and inspect workflow stages in crab.yaml.
Synopsis
crab stage [OPTIONS] <COMMAND>| Command | Purpose |
|---|---|
crab stage add | Create or update a workflow stage |
crab stage list | List stages declared in workflow files |
crab stage list
crab stage add --helpRun crab run after changing a stage.
Author and verify a stage
crab stage add updates the workflow declaration; it does not execute the
command. Use its subcommand help to select command, dependency, output,
parameter, metric, and plot fields supported by the installed binary. Review
the resulting YAML before running it.
crab stage add --help
crab stage list
git diff -- crab.yaml
crab run <stage-name>crab stage list is read-only and includes stages discovered from workflow
files. The Git diff is the boundary check: it shows the command and tracked
inputs that will contribute to future runs. After crab run, inspect the
workflow lockfile and declared outputs before committing them.
For complex definitions, editing crab.yaml directly may be clearer than a
long command line. The stage helper and handwritten YAML share the same parser,
so keep one canonical declaration and validate it with crab stage list.