Public | Automated Build

Last pushed: a year ago
Short Description
Run clitest in a lightweight Alpine Linux Docker image (13 MB)
Full Description

clitest Docker image

This is a clitest Docker image based on the lightweight Alpine Linux image.

Get it

docker pull aureliojargas/clitest

Initial run

For the available clitest options, just run the image with no arguments:

$ docker run --rm aureliojargas/clitest
Usage: clitest [options] <file ...>

  -1, --first                 Stop execution upon first failed test
  -l, --list                  List all the tests (no execution)
  -L, --list-run              List all the tests with OK/FAIL status
  -t, --test RANGE            Run specific tests, by number (1,2,4-7)
  -s, --skip RANGE            Skip specific tests, by number (1,2,4-7)
      --pre-flight COMMAND    Execute command before running the first test
      --post-flight COMMAND   Execute command after running the last test
  -q, --quiet                 Quiet operation, no output shown
  -V, --version               Show program version and exit

Customization options:
  -P, --progress TYPE         Set progress indicator: test, number, dot, none
      --color WHEN            Set when to use colors: auto, always, never
      --diff-options OPTIONS  Set diff command options (default: '-u')
      --inline-prefix PREFIX  Set inline output prefix (default: '#=> ')
      --prefix PREFIX         Set command line prefix (default: '')
      --prompt STRING         Set prompt string (default: '$ ')

Test your own files

To run clitest on your own test files, map their directory with -v. For example, mapping the current directory to container's /src and testing the file:

docker run --rm -v "$PWD:/src/" aureliojargas/clitest clitest /src/

Same as before, but this time using -w to set the current directory to /src, making sure the execution happens inside your directory:

docker run --rm -v "$PWD:/src/" -w /src aureliojargas/clitest clitest

If you don't have any test files right now, you can see clitest in action by running its own test suite:

$ docker run --rm -w /clitest aureliojargas/clitest clitest
#1    test -f ./clitest; echo $?
#2    test -d ./test/; echo $?
#3    COLUMNS=80
#4    export COLUMNS
#5    echo $COLUMNS
#260  ./clitest test/
#261  ./clitest test/
#262  ./clitest test/
#263  ./clitest test/
#264  ./clitest test/
#265  ./clitest --color yes --first test/
OK: 265 of 265 tests passed


To build this image, go to clitest repository root and run:

docker build -t aureliojargas/clitest .

About clitest

Clitest is a portable POSIX shell script that performs automatic testing in Unix command lines.

It's the same concept as in Python's doctest module. You save the commands and their expected output in a text file:

$ echo "Hello World"
Hello World
$ cd /tmp
$ pwd
$ cd "$OLDPWD"

and then use clitest to run those commands and compare their output:

$ clitest examples/intro.txt
#1      echo "Hello World"
#2      cd /tmp
#3      pwd
#4      cd "$OLDPWD"
OK: 4 of 4 tests passed

That's it!

  • There's no syntax to learn, just copy/paste the command line history into a text file.
  • Useful for automated testing and testable documentation (Markdown file with commands).

See examples and instructions in the GitHub repository.

Docker Pull Command
Source Repository