test-c

A robust and minimal unit testing framework for C.

Shut up and [test some C]

Why?

• Because every other testing framework for C is a pain.

Installing

curl -sk https://raw.githubusercontent.com/kogosoftwarellc/test-c/master/install.bash | bash

Once that completes, you'll have ~/.test-c/test-c available in your PATH.

Goals

• Make C Unit Testing fast, easy, and fun.
• Reduce boilerplate.
• Keep tests focused on testing, not setup.
• Do the simplest thing possible.
• Avoid root priveleges.

Project Layout

test-c assumes a project layout similar to the following:

.
├── .testcrc
├── include
├── README.md
├── src
│   ├── add.c
│   └── add.h
└── tests
    └── test_add.c

Starting from scratch? Let test-c --init-project get you up and running quickly.

Sample Test

Here's what tests/test_add.c looks like in our project layout:

#include <test-c.h>
#include <add.h>

TEST_C_START(it_works)
  int sum = add(5, 6);
  TEST_C_ASSERT_INT_EQUAL(sum, 11);
TEST_C_END

Now when we run test-c at the root of our project, we see this:

Running

test-c [OPTIONS] [FILES]

See test-c --help for the full list of options.

.testcrc

You can add a .testcrc file to the root of your project. This file will be sourced by test-c. You can export environment variables as follows:

• export TESTC_LD_OPTIONS="-lssl"

LICENSE

MIT