ihct

'I Hate C Testing': a minimal testing framework for C

Olle Lögdahl, 13 December 2020

ihct is a minimal C unit-testing framework. Intended for light unit testing, and focusing on development speed. Looking for more features, so please give any suggestions.

Installation & Usage

See documentation

To use this framework, simply include

ihct.h

#include 

IHCT_TEST(arithmetic_basic) {
    int a = 13;
    IHCT_ASSERT(a + 2 == 15);
    IHCT_ASSERT(a * 2 == 26);
}
IHCT_TEST(string_basic) {
    char *s1 = "abba";
    IHCT_ASSERT_STR(s1, "abba");
}
int main(int argc, char **argv) {
    return IHCT_RUN(argc, argv);
}
</ihct.h>

To fully install the library, run:

bash
mkdir build
cd build
cmake .. && make -j4
sudo make install

See

ex.c

ex.c

bash
mkdir build
cd build
cmake .. && make -j4
./example

Why?

I have for a long time been stuck at unit testing in plain C. Many modern solutions use C++ as a test environment for C, but I wanted something more lightweight, that i can quickly get up to speed with. I decided to write my own test framework with two things in mind: development speed and minimalism. To improve development speed, all test functions are automatically included into the runner, and the library interface is kept minimal. It requires no dependencies other than a POSIX compliant OS, and compiles on all GNU C99 POSIX compatible compilers. The library also implements some safety to tests, catching fatal signals and hung functions.

Features

• Basic test units
• Basic asserts
• Automatic test loader
• Catching fatal signals (SEGFAULTS etc.) in tests (no line number, but sets them as failed).
• Catching hung tests (again, no line number).

Self tests can be run along with own tests by adding compiler flag

-DIHCT_SELF_TEST

all macros (

IHCT_TEST

IHCT_ASSERT

IHCT

IHCT_SHORT

Compatability notes

• Since it requires

  __attribute__((constructor))

  it is not compilable with MSVC.
• Since it uses pthreads and signals, it is POSIX (again, not sure it works with Windows).

Links

• Repository
• For reporting errors, visit Issue Tracker!
• Related Projects:
  • cheat by Guillermo "Tordek" Freschi and Sampsa "Tuplanolla" Kiiskinen

Licensing

This project, and all code it contains, is licensed under the MIT License and can be read here.