Expand description
Pipeline management commands and data structures
This contains CLI structs for xvc pipeline subcommands, init function to
run during xvc init for pipeline related initialization, cmd_pipeline
and [handle_step_cli] functions to dispatch the options to subcommands.
Modules§
Structs§
- Command
Process  - Used for encapsulating a process and its outputs. This is used to associate steps with running processes.
 - PipelineCLI
 - Pipeline management commands
 - RunCLI
 - Run a pipeline
 - XvcPipeline
 - A pipeline is a collection of steps that are run in a specific order. This struct defines the name of it.
 - XvcPipeline
RunDir  - A pipeline run directory where the pipeline is run. It should be within the workspace to be portable across systems.
 - XvcPipeline
Schema  - Defines the user editable pipeline schema used in 
xvc pipeline exportandxvc pipeline importcommands. - XvcStep
 - A step (stage) in a pipeline.
 - XvcStep
Command  - Command to run for an XvcStep.
 - XvcStep
Schema  - User editable pipeline step schema used in 
xvc pipeline exportandxvc pipeline importcommands. 
Enums§
- Pipeline
SubCommand  - Pipeline management subcommands
 - XvcDependency
 - Represents variety of dependencies Xvc supports. This is to unify all dependencies without dynamic dispatch and having compile time errors when we miss something about dependencies.
 - XvcMetrics
Format  - Possible formats for recognized metrics formats. Metrics files are where the pipeline writes its output in a structured format. We can read these files and use them to generate reports
 - XvcOutput
 - Possible outputs for the pipeline.
 - XvcParam
Format  - Parsable formats of a parameter file
 
Functions§
- cmd_dag
 - Entry point for 
xvc pipeline dagcommand. Create a graph of the pipeline and output it in the specified format. - cmd_
delete  - Entry point for 
xvc pipeline deletecommand. It deletes the pipeline with the given name. It is not possible to delete the default pipeline. - cmd_
export  - Entry point for 
xvc pipeline exportcommand. Export the pipeline and all its steps to a file. The file format is determined by theformatparameter. Iffileis None, prints to stdout. Ifnameis None, uses the default pipeline name from the config. Ifformatis None, uses the default format from [XvcSchemaSerializationFormat::default()] - cmd_
import  - Entry point for 
xvc pipeline importcommand. Reads a pipeline definition in JSON or YAML formats and creates/updates it. Ifnameis None, uses the pipeline name from the file. Iffileis None, reads from stdin. Ifformatis None, uses the file extension to determine the format. Ifoverwriteis true, overwrites the pipeline if it already exists. - cmd_
list  - Entry point for 
xvc pipeline listcommand. Lists all pipelines and their run directories. - cmd_new
 - Entry point for 
xvc pipeline newcommand. It creates a new pipeline with the given name. Ifworkdiris None, uses the default workdir. - cmd_
pipeline  - Run 
xvc pipelinecommand. This is the entry point for the pipeline subcommand. It dispatches to the subcommands using PipelineCLI argument. - cmd_run
 - Entry point for 
xvc pipeline runcommand. - cmd_
step_ dependency  - Entry point for 
xvc pipeline step dependencycommand. Add a set of new dependencies to the given step in the pipeline. - cmd_
step_ new  - Creates a new step
 - cmd_
step_ output  - Entry point for 
xvc pipeline step outputcommand. - cmd_
step_ show  - Entry point for 
xvc pipeline step showcommand. - cmd_
step_ update  - Entry point for 
xvc pipeline step updatecommand. Updates the command and invalidation strategy (whento run) of the given step. - cmd_
update  - Entry point for 
xvc pipeline updatecommand. Can rename the pipeline, change the working directory or set the pipeline as default. - init
 - Initialize pipeline stores and save them.