Love life, love sports, love to learn, & love...

MinUnit – 最小的 C 语言单元测试框架

单元测试的本质是对测试单元进行正确性测试，因此关键在于测试而不是测试框架（或者测试模板），拘泥于复杂的测试框架中往往造成本末倒置。因此应该将重点放在单元测试的思想和方法上面。下面介绍一个极其简单的 C 语言单元测试框架——MinUnit。

源代码

编辑头文件，主要是定义宏和变量：

/* file: minunit.h */
 #define mu_assert(message, test) do { if (!(test)) return message; } while (0)
 #define mu_run_test(test) do { char *message = test(); tests_run++; \
                            if (message) return message; } while (0)
 extern int tests_run;

建立测试案例

一个 MinUnit 测试实例仅仅是一个函数，当测试案例通过时此函数返回 0（NULL）。如果测试失败，这个函数返回一些描述测试失败的字符串。mu_assert 是一个当表达式失败时返回字符串的宏。而宏 mu_runtest 重复调用测试案例直到测试实例失败。这就是 MinUnit 的全部内容。

实例

以下实例测试两个案例，一个案例能够正确通过，而另一个则失败。

/* file minunit_example.c */

#include <stdio.h>
#include "minunit.h"

int tests_run = 0;

int foo = 7;
int bar = 4;

static char * test_foo() {
    mu_assert("error, foo != 7", foo == 7);
    return 0;
}

static char * test_bar() {
    mu_assert("error, bar != 5", bar == 5);
    return 0;
}

static char * all_tests() {
    mu_run_test(test_foo);
    mu_run_test(test_bar);
    return 0;
}

int main(int argc, char **argv) {
    char *result = all_tests();
    if (result != 0) {
        printf("%s\n", result);
    }
    else {
        printf("ALL TESTS PASSED\n");
    }
    printf("Tests run: %d\n", tests_run);

    return result != 0;
}