TOOL¶

Launcheable mod for unit tests.

Usage: kink [Kink_options]... mod:kink/test/TOOL [Mod_options]... Path...

If Path is a path of a file, this is considered a test script, and tests in the file is collected.

If Path is a path of a directory, all the files recursively matching *_test.kn are considered as test scripts, and tests in the files are collected.

Mod_options:

• --help / -h :: Print the help text and exit.

• --include Regex / -i Regex :: Include tests whose addr parts contain a name which matches Regex.

• --exclude Regex / -e Regex :: Exclude tests whose addr parts contain a name which matches Regex.

• --verbose / -v :: Show progress verbosely.

Test selection:

Inclusion and exclusion is calculated for each test so that the latest rule wins. Adding to this, tests with @ignore are always excluded.

Example:

$ kink mod:kink/test/TOOL unit-test/ system-test/ --exclude '@os-.*' --include '@os-linux'

In the above example, the test with addr “@all; system-test; foo_test.kn; @os-win; windows test” is not executed because “@os-win” is excluded by “--exclude '@os-.*'”.

The test with addr “@all; system-test; foo_test.kn; @os-linux; linux test” is executed because of inclusion of “@os-linux”, which comes after exclusion of “@os-.*”.

See kink/test/SELECTOR for details of inclusion and exclusion.

3.81.1. TOOL.main(Argv)¶

Launcher of kink/test/TOOL mod.