DOKK / manpages / debian 10 / clitest / clitest.1.en
clitest(1) performs automatic testing in command lines clitest(1)

clitest - performs automatic testing in command lines

clitest [options] <file ...>

Clitest is a portable POSIX shell script that performs automatic testing in Unix command lines. This script was carefully coded to be portable between POSIX shells

It's the same concept as in Python's doctest module: you document both the commands and their expected output, using the familiar interactive prompt format, and a specialized tool tests them.

The clitest command searches for pieces of text that look like interactive Unix command lines, and then executes those command lines to verify that they work exactly as shown.

-1, --first
Stop execution upon first failed test
List all the tests (no execution)
List all the tests with OK/FAIL status
Run specific tests, by number (1,2,4-7)
Skip specific tests, by number (1,2,4-7)
Quiet operation, no output shown
Show program version and exit
Set progress indicator: test, number, dot, none
Execute command before running the first test
Execute command after running the last test
Set when to use colors: auto, always, never
Set diff command options (default: '-u')
Set inline output prefix (default: '#→ ')
Set command line prefix (default: '')
Set prompt string (default: '$ ')

The CLITEST was written by Aurelio Jargas <>.

This manual page was written by Giovani Augusto Ferreira <> for the Debian project (but may be used by others).

Oct 2015 CLITEST 0.0