Skip to content

pipeline

Synopsis

Run a sequence of commands defined in a YAML pipeline file.

USAGE

kmhelpers pipeline [OPTIONS] PIPELINE_FILE
Argument Description
PIPELINE_FILE YAML pipeline definition file (required)

I/O

Input: YAML pipeline definition file
Output: depends on pipeline steps

Advanced Options

Option Description
-x KEY VALUE Override a parameter for all steps (repeatable)

Description

pipeline executes a series of kmhelpers commands in order, as defined in a YAML file. Steps run sequentially. Use -x to override parameters for all steps at runtime.

Priority - global config (-C) < pipeline YAML < -x overrides.

Pipeline File Formats

Dict format (simple, no repeated commands)

compose:
  workdir: /path/to/workdir
  input_files: [samples.yaml]
apply:
  workdir: /path/to/workdir
  threads: 8

List format (allows repeating the same command)

- apply:
    workdir: /path/a
    input_files: [a.yaml]
- apply:
    workdir: /path/b
    input_files: [b.yaml]

Examples

# Run a pipeline
kmhelpers pipeline my_pipeline.yaml

# Override workdir and threads for all steps
kmhelpers pipeline my_pipeline.yaml -x workdir /tmp -x threads 16