cwltool - Refefence executor for Common Workflow Language
usage: cwltool [-h] [--basedir BASEDIR] [--outdir OUTDIR]
[--parallel]
- [--preserve-environment ENVVAR | --preserve-entire-environment]
[--rm-container | --leave-container] [--cidfile-dir CIDFILE_DIR]
[--cidfile-prefix CIDFILE_PREFIX] [--tmpdir-prefix TMPDIR_PREFIX]
[--tmp-outdir-prefix TMP_OUTDIR_PREFIX | --cachedir CACHEDIR]
[--rm-tmpdir | --leave-tmpdir] [--move-outputs |
--leave-outputs | --copy-outputs] [--enable-pull |
--disable-pull] [--rdf-serializer RDF_SERIALIZER] [--eval-timeout
EVAL_TIMEOUT] [--print-rdf | --print-dot | --print-pre |
--print-deps | --print-input-deps | --pack |
--version | --validate | --print-supported-versions |
--print-subgraph | --print-targets] [--strict |
--non-strict] [--skip-schemas] [--no-doc-cache |
--doc-cache] [--verbose | --quiet | --debug]
[--strict-memory-limit] [--timestamps] [--js-console]
[--disable-js-validation] [--js-hint-options-file JS_HINT_OPTIONS_FILE]
[--user-space-docker-cmd CMD | --udocker | --singularity |
--no-container] [--tool-help] [--relative-deps {primary,cwd}]
[--enable-dev] [--enable-ext] [--enable-color | --disable-color]
[--default-container DEFAULT_CONTAINER] [--no-match-user] [--custom-net
CUSTOM_NET] [--enable-ga4gh-tool-registry |
--disable-ga4gh-tool-registry] [--add-ga4gh-tool-registry
GA4GH_TOOL_REGISTRIES] [--on-error {stop,continue}] [--compute-checksum]
[--no-compute-checksum] [--relax-path-checks] [--make-template]
[--force-docker-pull] [--no-read-only] [--overrides OVERRIDES] [--target
TARGET] [--mpi-config-file MPI_CONFIG_FILE] [cwl_document] ...
Reference executor for Common Workflow Language standards. Not for
production use.
- cwl_document
- path or URL to a CWL Workflow, CommandLineTool, or ExpressionTool. If the
`inputs_object` has a `cwl:tool` field indicating the path or URL to the
cwl_document, then the `cwl_document` argument is optional.
- inputs_object
- path or URL to a YAML or JSON formatted description of the required input
values for the given `cwl_document`.
- -h, --help
- show this help message and exit
--basedir BASEDIR
- --outdir
OUTDIR
- Output directory. The default is the current directory.
- --parallel
- [experimental] Run jobs in parallel.
- --preserve-environment
ENVVAR
- Preserve specific environment variable when running CommandLineTools
without a software container. May be provided multiple times. The default
is to preserve only the PATH.
- --preserve-entire-environment
- Preserve all environment variables when running CommandLineTools without a
software container.
- --rm-container
- Delete Docker container used by jobs after they exit (default)
- --leave-container
- Do not delete Docker container used by jobs after they exit
- --tmpdir-prefix
TMPDIR_PREFIX
- Path prefix for temporary directories. If --tmpdirprefix is not
provided, then the prefix for temporary directories is influenced by the
value of the TMPDIR, TEMP, or TMP environment variables. Taking those into
consideration, the current default is /tmp/.
- --tmp-outdir-prefix
TMP_OUTDIR_PREFIX
- Path prefix for intermediate output directories. Defaults to the value of
--tmpdir-prefix.
- --cachedir
CACHEDIR
- Directory to cache intermediate workflow outputs to avoid recomputing
steps. Can be very helpful in the development and troubleshooting of CWL
documents.
- --rm-tmpdir
- Delete intermediate temporary directories (default)
- --leave-tmpdir
- Do not delete intermediate temporary directories
- --move-outputs
- Move output files to the workflow output directory and delete intermediate
output directories (default).
- --leave-outputs
- Leave output files in intermediate output directories.
- --copy-outputs
- Copy output files to the workflow output directory and don't delete
intermediate output directories.
- --enable-pull
- Try to pull Docker images
- --disable-pull
- Do not try to pull Docker images
- --rdf-serializer
RDF_SERIALIZER
- Output RDF serialization format used by --print-rdf (one of turtle
(default), n3, nt, xml)
- --eval-timeout
EVAL_TIMEOUT
- Time to wait for a Javascript expression to evaluate before giving an
error, default 20s.
- --print-rdf
- Print corresponding RDF graph for workflow and exit
- --print-dot
- Print workflow visualization in graphviz format and exit
- --print-pre
- Print CWL document after preprocessing.
- --print-deps
- Print CWL document dependencies.
- --print-input-deps
- Print input object document dependencies.
- --pack
- Combine components into single document and print.
- --version
- Print version and exit
- --validate
- Validate CWL document only.
- --print-supported-versions
- Print supported CWL specs.
- --print-subgraph
- Print workflow subgraph that will execute. Can combined with
--target.
- --print-targets
- Print targets (output parameters)
- --strict
- Strict validation (unrecognized or out of place fields are error)
- --non-strict
- Lenient validation (ignore unrecognized fields)
- --skip-schemas
- Skip loading of schemas
- --no-doc-cache
- Disable disk cache for documents loaded over HTTP
- --doc-cache
- Enable disk cache for documents loaded over HTTP
- --verbose
- Default logging
- --quiet
- Only print warnings and errors.
- --debug
- Print even more logging
- --strict-memory-limit
- When running with software containers and the Docker engine, pass either
the calculated memory allocation from ResourceRequirements or the default
of 1 gigabyte to Docker's --memory option.
- --timestamps
- Add timestamps to the errors, warnings, and notifications.
- --js-console
- Enable javascript console output
- --disable-js-validation
- Disable javascript validation.
- --js-hint-options-file
JS_HINT_OPTIONS_FILE
- File of options to pass to jshint. This includes the added option
"includewarnings".
- --user-space-docker-cmd
CMD
- (Linux/OS X only) Specify the path to udocker. Implies
--udocker
- --udocker
- (Linux/OS X only) Use the udocker runtime for running containers
(equivalent to --user-space-dockercmd=udocker).
- --singularity
- [experimental] Use Singularity runtime for running containers. Requires
Singularity v2.6.1+ and Linux with kernel version v3.18+ or with overlayfs
support backported.
- --no-container
- Do not execute jobs in a Docker container, even when `DockerRequirement`
is specified under `hints`.
- --tool-help
- Print command line help for tool
- --relative-deps
{primary,cwd}
- When using --print-deps, print paths relative to primary file or
current working directory.
- --enable-dev
- Enable loading and running unofficial development versions of the CWL
standards.
- --enable-ext
- Enable loading and running 'cwltool:' extensions to the CWL
standards.
- --enable-color
- Enable logging color (default enabled)
- --disable-color
- Disable colored logging (default false)
- --default-container
DEFAULT_CONTAINER
- Specify a default software container to use for any CommandLineTool
without a DockerRequirement.
- --no-match-user
- Disable passing the current uid to `docker run --user`
- --custom-net
CUSTOM_NET
- Passed to `docker run` as the '--net' parameter when NetworkAccess is
true, which is its default setting.
- --enable-ga4gh-tool-registry
- Enable tool resolution using GA4GH tool registry API
- --disable-ga4gh-tool-registry
- Disable tool resolution using GA4GH tool registry API
- --add-ga4gh-tool-registry
GA4GH_TOOL_REGISTRIES
- Add a GA4GH tool registry endpoint to use for resolution, default
['https://dockstore.org/api']
- --on-error
{stop,continue}
- Desired workflow behavior when a step fails. One of 'stop' (do not submit
any more steps) or 'continue' (may submit other steps that are not
downstream from the error). Default is 'stop'.
- --compute-checksum
- Compute checksum of contents while collecting outputs
- --no-compute-checksum
- Do not compute checksum of contents while collecting outputs
- --relax-path-checks
- Relax requirements on path names to permit spaces and hash
characters.
- --make-template
- Generate a template input object
- --force-docker-pull
- Pull latest software container image even if it is locally present
- --no-read-only
- Do not set root directory in the container as readonly
- --overrides
OVERRIDES
- Read process requirement overrides from file.
- --target TARGET,
-t TARGET
- Only execute steps that contribute to listed targets (can be provided more
than once).
- --mpi-config-file
MPI_CONFIG_FILE
- Platform specific configuration for MPI (parallel launcher, its flag etc).
See README section 'Running MPI-based tools' for details of the
format.
http://commonwl.org
http://wiki.debian.org/CommonWorkflowLanguage