Single-file unit-testing library for C

• Single header file, no other library dependencies
• Simple ANSI C. The library should work with virtually every C(++) compiler on virtually any playform
• Reporting of assertion failures, including the expression and location of the failure
• Stops test on first failed assertion
• ANSI color output for maximum visibility
• Easily embeddable in applications for runtime tests or separate testing applications

• Disable assertions on definition, to allow production build without source modifications

#include "finwo/assert.h"
#include "mylib.h"

void test_sheep() {
  ASSERT("Sheep are cool", are_sheep_cool());
  ASSERT_EQUALS(4, sheep.legs);
}

void test_cheese() {
  ASSERT("Cheese is tangy", cheese.tanginess > 0);
  ASSERT_STRING_EQUALS("Wensleydale", cheese.name);
}

int main() {
  RUN(test_sheep);
  RUN(test_cheese);
  return TEST_REPORT();
}

To run the tests, compile the tests as a binary and run it.

#define ASSERT(msg, expression) if (!tap_assert(__FILE__, __LINE__, (msg), (#expression), (expression) ? 1 : 0)) return

/* Convenient assertion methods */
/* TODO: Generate readable error messages for assert_equals or assert_str_equals */
#define ASSERT_EQUALS(expected, actual) ASSERT((#actual), (expected) == (actual))

#define ASSERT_STRING_EQUALS(expected, actual) ASSERT((#actual), strcmp((expected),(actual)) == 0)

#define RUN(test_function) tap_execute((#test_function), (test_function))

#define TEST_REPORT() tap_report()

If you want to disable color during the assertions, because you want to interpret the output for example (it is "tap" format after all), you can define NO_COLOR during compilation to disable color output.

cc -D NO_COLOR source.c -o test

You can also fully disable output for assertions by defining the ASSERT_SILENT macro. This will fully disable the printf performed after the assertion is performed.

cc -D ASSERT_SILENT source.c -o test

If you do not want the report to be displayed at the end, you can define the REPORT_SILENT macro. This will disable the printf during reporting and only keep the return code.

cc -D REPORT_SILENT source.c -o test

This library was heavily based on the tinytest library by Joe Walnes. A license reference to his library could not be found, which is why this reference is in this file. Should I be contacted about licensing issues, I'll investigate further.