CWLTEST(1)

✨ CWLTEST ✨

okay bestie, gather round, because we're talking about cwltest — that's the manual page for cwltest 2.6.20251216093331, and it's literally the Common Workflow Language testing framework 💖

---

🌸 DESCRIPTION 🌸

so, the vibe is: it's a testing framework for Common Workflow Language stuff. Here's exactly how you call it:

usage: cwltest [-h] --test TEST [--basedir BASEDIR] [--baseuri BASEURI]
       [-l]

              [-n N] [-s S] [-N N] [-S S] [--tool TOOL] [--only-tools] [--tags
              TAGS] [--exclude-tags EXCLUDE_TAGS] [--show-tags] [--junit-xml
              JUNIT_XML] [--junit-verbose] [--test-arg cache==--cache-dir] [-j
              J] [--verbose] [--classname CLASSNAME] [--timeout TIMEOUT]
              [--badgedir BADGEDIR] [--version] ...

Common Workflow Language testing framework — that's the whole point of it, periodt 🫶

🎀 positional arguments

• args — arguments to pass first to the tool runner. like, they go in before everything else, okay? 🧚

💅 options

• -h, --help — show this help message and exit. the classic. the icon. 🌈
• --test TEST — a YAML file that describes the test cases.
• --basedir BASEDIR — the basedir to use for tests.
• --baseuri BASEURI — the base URI to use for links in the report.
• -l — list the tests, then exit. window shopping, no commitment 💅
• -n N — run specific tests by number, and the format is 1,3-6,9.
• -s S — run specific tests using their short names, separated by comma.
• -N N — exclude specific tests by number, format is 1,3-6,9.
• -S S — exclude specific tests by short names separated by comma.
• --tool TOOL — the CWL runner executable to use (default 'cwl-runner').
• --only-tools — only test CommandLineTools. no cap.
• --tags TAGS — tags to be tested.
• --exclude-tags EXCLUDE_TAGS — tags not to be tested. it's giving boundaries ✋
• --show-tags — show all Tags.
• --junit-xml JUNIT_XML — path to the JUnit xml file.
• --junit-verbose — store more verbose output to the JUnit XML file by not passing '--quiet' to the CWL runner. more lore, more output.
• --test-arg cache==--cache-dir — an additional argument given in test cases, and the required prefix for the tool runner. (yes, that's the literal option name, don't @ me 🙈)
• -j J — specifies the number of tests to run simultaneously (defaults to one). parallel besties, go 🏃♀️🏃♀️
• --verbose — more verbose output during the test run. we love a yapper.
• --classname CLASSNAME — specify the classname for the Test Suite.
• --timeout TIMEOUT — time of execution in seconds after which the test will be skipped. defaults to 600 seconds (10.0 minutes). so if it's taking longer than that, it's getting skipped, sorry babe 💀
• --badgedir BADGEDIR — create JSON badges, one for each tag (plus a computed 'all' tag) and store them in this directory. cute little trophies for every tag 👑
• --version — show the program's version number and exit.

⚠️ heads up: if you're wondering what the ... at the end of the usage line is, it's just there in the usage string — this page doesn't say more about it, so I'm not gonna make stuff up 💖

---

and that's the whole page, bestie ✨

This was cwltest 2.6.20251216093331, from January 2026, and yeah — it's the CWLTEST(1) manual. stan a well-documented test framework 🎀🦋⭐