-
Notifications
You must be signed in to change notification settings - Fork 2
InvokingTrut
- {{{ $ trut [trutfiles...] }}}
If you run trut
without specifying any filenames, it will search all directories under the current one for files named TRUT
, and execute the tests contained therein.
To run trut
with only a specific set of TRUT
files, specify these on the command line.
The exit code of trut
is 0 if all the tests succeed, or non-0 on any failure.
trut -h
or trut --help
will print a short help text.
This is akin to the -j
option of GNU make. On a multi-core machine, you can specify, e.g., -j4
to run up to 4 tests in parallel.
This controls the amount of messages sent to the console. The default level is 21, meaning messages of level <=21 are printed. Message levels are hierarchical, as follows:
- level 0: errors from the overall run.
trut -v0
will be completely silent, unless something fails. - level 1: status of the overall run. An "OK" message will be printed at the end, but nothing else.
- level 10: errors from individual TRUT files.
- level 11: status of individual TRUT files. "OK" will be printed for each TRUT file.
- level 20: errors from individual tests within TRUT files.
- level 21: status of individual tests.
Note that nested tests will be supported soon (e.g. TDL jobs nested within TDL scripts), with corresponding levels of 30, 31, etc.
This controls the amount of messages sent to the brief log, Trut.log
(and trut.log
). The default is 41. Note that the full log always contains ALL messages.
By default, testing is non-persistent --- trut
stops as soon as it encounters an error. Sometimes you may want it to continue running through all possible tests, regardless of intermediate failures. This can be achieved by increasing the persistence level:
- -p0: no persistence (default), stop on any error
-
-p1: abandon current
TRUT
file on any error, but go on with remainingTRUT
files. -
-p2: persist with top-level tests in each
TRUT
file regardless of error - -p3: persist with sub-tests
- etc. Since test specifications are hierarchical (see ./WritingTrutFiles), so are persistence levels.
You can use the standard -d
option to get verbose messages from various debugging contexts (you do use this feature, right?)