extatic.org :: exotic

Exotic - test Infrastructure for C/C++

Exotic is a minimalistic tool for unit testing C or C++ code. Exotic consists of two parts, a tool generating wrapper code for the tests, and a C library.

Exotic can also generate standalone code which does not require the C library, which is ideal for source code distributions.

Download

Download the latest source code here.

Directives

EXO_TEST(test_name, { /* test block */ });

Notes

• You can add as many tests as you like, but each test_name must be unique and limited to a valid C function name.
• The test block must return either true (non-zero) or false (zero).

C Example

Create a test file to test the function "magic()", the test is considered success if the return value is non-zero (true):

#include "magic.h"

EXO_TEST(test_function_magic_1, {
	int n = magic();
	return n == 42;
});

EXO_TEST(test_function_magic_2, {
	int n = magic();
	return n != 42;
});

Place this test in a file, such as test_magic.tcc

Now, all you need to do is run the exotic tool to create the source code for a runnable executable:

exotic test_magic.tcc > autotest.c

Exotic have now created a C file which can be compiled to a runnable binary. The generated file will also ensure that all found test cases are registered and run when. In this case test_function_magic_1 and test_function_magic_2 will be run.

This can be compiled as:

cc -o autotest autotest.c -lexotic

The tests can be performed by running autotest, use autotest -h for help.

Notes

• When compiling the test binary, make sure you add the libraries needed by the code you are testing.
• Invoking the exotic binary with the --standalone argument will create source code that do not depend on the exotic library.
• When testing C++ code, you must compile the autogenerated source code file with a C++ compiler.
• This can easily be incorporated into a makefile that will automatically build and run the tests

Copyright © 2001-2008 Jan Vidar Krey