Command-line tools¶
The command-line interface is included with provium. Both entry points use the
same plugin-discovered command catalog:
Discover procedures¶
List lightweight definitions without importing procedure implementations:
Show a definition, its configuration schema, typed ports, cardinalities, and a generated invocation synopsis:
Execute a procedure¶
Bindings use FIELD=PATH. Repeat --input for a repeated field and repeat
--config to apply JSON or YAML layers in order (later values override earlier
ones).
provium execute example.DetectV1 \
--config defaults.yaml \
--config production.json \
--setup-input model=model.pa \
--input image=image.pa \
--input references=reference-1.pa \
--input references=reference-2.pa \
--output detections=detections.pa
Optional inputs and outputs may be omitted. Unknown fields, bad cardinality, invalid configuration, resolution failures, and processing failures are printed to standard error and return exit status 2. Successful execution prints its provenance execution identity and returns 0.
Run provium --help or provium execute --help for the installed command
surface.
Graph provenance¶
Render an artifact's lineage or generate DOT and Mermaid source with
provium graph. See Provenance graphs for backend setup, label
options, output behavior, and Python examples.
Enable tab completion¶
Provium completes commands, options, discovered procedure and artifact identifiers, procedure binding fields, and filesystem paths inside bindings.
Enable completion for Bash or Zsh in the current shell:
Add that line to ~/.bashrc or ~/.zshrc to enable it in future shells. You can
instead activate argcomplete globally for Python applications: