Skip to content

oxo-flow dry-run#

Simulate execution without running any commands. Shows the execution plan, rule order, and expanded shell commands.

Usage#

oxo-flow dry-run <WORKFLOW>

Arguments#

Argument Description
<WORKFLOW> Path to the .oxoflow workflow file

Options#

Option Short Description
--verbose -v Enable debug-level logging

Examples#

Preview a workflow#

oxo-flow dry-run pipeline.oxoflow

With verbose output#

oxo-flow dry-run pipeline.oxoflow -v

Output#

oxo-flow 0.1.0 — Bioinformatics Pipeline Engine
Dry-run: 3 rules would execute:
  1. trim_reads [threads=4, env=conda]
     $ fastp --in1 raw/sample1_R1.fastq.gz --in2 raw/sample1_R2.fastq.gz --out1
  2. align [threads=16, env=docker]
     $ bwa mem -t 16 /data/ref/hg38.fa trimmed/sample1_R1.fastq.gz | samtools so
  3. sort_bam [threads=4, env=conda]
     $ samtools sort -@ 4 -o sorted/sample1.bam aligned/sample1.bam

Notes#

  • No shell commands are executed — the dry-run is read-only
  • Shell command previews are truncated to 80 characters
  • The environment type (conda, docker, etc.) is shown for each rule
  • Thread and resource settings are displayed per rule
  • Use dry-run to verify your workflow before committing compute resources