The shelltestrunner package

[Tags:gpl, program]

Run a given program through shell tests specifed by one or more test files, each of which can specify: command-line arguments, input, expected output, expected stderr output, and expected exit code. This was extracted from the hledger project, inspired by the tests in John Wiegley's ledger project, and uses test-framework's test runner.


 shelltestrunner [opts] executable testfile1 [testfile2 ...] [-- <test-framework runner opts>]

You can pass options through to test-framework's runner; they must go after -- at the end. You may be able to get a big speedup by running tests in parallel: try -- -j8.

Test file format:

 # 0 or more comment lines beginning with #
 -opt1 -opt2 arg1 arg2 # command line args, executable will be prepended
 0 or more lines of input
 >>> [/regexp/]
 [..or 0 or more lines of expected output]
 >>>2 [/regexp/]
 [..or 0 or more lines of expected error output]
 >>>= [/regexp/]
 [..or expected numeric exit code]

The expected fields can also have a regular expression match expression following the delimiter on the same line, with no other data lines, in which case the test passes if the output is matched by the regexp. The regexp is enclosed in forward slashess. A ! preceding the expression negates the match. For example, to check that stdout does not contain axe:

 >>> !/axe/

Apart from the command line, all fields are optional. Only fields specified in the test will be tested, unless you use the -i/--implicit-tests flag, which will test for empty stdout, empty stderr, or 0 exit code whenever fields are omitted.




Versions 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0, 1.1, 1.2, 1.2.1, 1.3, 1.3.1, 1.3.2, 1.3.3, 1.3.4, 1.3.5
Dependencies base (>=3 && <5), HUnit, parseargs (==0.1.*), parsec, process, regexpr (>=0.5.1), test-framework, test-framework-hunit (==0.2.*) [details]
License GPL
Author Simon Michael <>
Maintainer Simon Michael <>
Category Testing
Home page
Uploaded Tue Jul 14 23:44:58 UTC 2009 by SimonMichael
Distributions Debian:1.3.5, NixOS:1.3.5
Downloads 5235 total (104 in the last 30 days)
0 []
Status Docs not available [build log]
All reported builds failed as of 2016-12-31 [all 7 reports]
Hackage Matrix CI


Maintainer's Corner

For package maintainers and hackage trustees