Gerbil Scheme

Testing

Gerbil comes with a testing library and a testing tool that can be used to run your tests in the command line.

Running tests with gxtest

Test files by convention have the -test.ss suffix and are generally not compiled. Each test file is a module that should export one or more test suites, with a name that ends in -test. See below for definition of test suites and test cases.

Tests can also optionally export test-setup! and test-cleanup! thunks:

  • test-setup! will be executed before any test-suite in the file has run.
  • test-cleanup! will be executed (with unwind protection) when all the test suites in the file have run.

Once your tests are in place, you can run them using gerbil test or just gxtest. If you invoke it without arguments it will run all the test files in the current directory. You can also explicitly pass files or directories to be run, and if you want to run tests in a directory recursively you can append /... in the directory.

For instance, the following will recursively run all tests in the current directory:

gerbil test ./...

Test suites

A test suite is created using the test-suite special form from :std/test and contains one or more test cases created with the test-case special form.

Test cases contain code executed by the test runner, and in general contain one or more checks with the check family of special forms which perform assertions.

Example

Here is a small example for unit testing a trivial module:

$ cat gerbil.pkg
(package: tmp)

$ cat mylib.ss
(export myadd)

(def (myadd x y)
 (+ x y))

$ cat mylib-test.ss
(import :std/test
        ./mylib)
(export mylib-test test-setup! test-cleanup!)

(def (test-setup!)
  (displayln "setting up..."))

(def (test-cleanup!)
  (displayln "cleaning up..."))

(def mylib-test
  (test-suite "test mylib"
    (test-case "test myadd"
      (check (myadd 1 2) => 3))))

$ gxc -O mylib.ss
$ gerbil test
=== ./mylib-test.ss
>>> setup
setting up...
>>> run mylib-test
Test suite: test mylib
Test case: test myadd
... 1 checks OK
... All tests OK
>>> cleanup
cleaning up...
OK
$ echo $?
0

The standard testing library

See :std/test for the api of the testing library.

← Debugging→