Stale mirror of https://git.sr.ht/~akkartik/basic-test

Kartik Agaram 3b68de057a support running a single test 11 months ago
Readme.md 3b68de057a support running a single test 11 months ago
build 3b68de057a support running a single test 11 months ago
clean 3b68de057a support running a single test 11 months ago
test.c 3b68de057a support running a single test 11 months ago
test.h 3b68de057a support running a single test 11 months ago
x.c 3b68de057a support running a single test 11 months ago

Readme.md

Example project showing a simple test harness for small projects in C.

Usage

  1. Call run_tests() through main somehow, after doing your own argument parsing.

  2. Call run_single_test() through main somehow, based on your argument parsing.

  3. Put 'setup' code you want to run before each test into a function called reset().

  4. Write each test in a function whose first line has the rigid form:

void test_...(void) {

The entire prototype must fit on a single line, with the opening curly brace 'cuddled' on the same line. (This form allows us to easily autogenerate prototypes for functions, so that you can define your functions and tests in any order in any .c file.)

Read test.h for more details.

Based on the minimal build system example repo at https://notabug.org/akkartik/basic-build

Try it out

$ ./build
$ ./a.out  # run some example tests
..  # emits one dot per passing test
$ ./a.out test_2  # run a single test
.  # single dot for single test
$ ./clean  # undo ./build