1、cmockery库源码的编译链接

下载链接：

下载需要FQ，没有条件的可以直接在github上找一篇比较完整的版本。

$ ./configure$ make clean && make$ make install prefix=~/share/code/cmockery$ tree ~/share/code/cmockeryinstall├── include│   └── google│       └── cmockery.h├── lib│   ├── libcmockery.a│   ├── libcmockery.la│   ├── libcmockery.so -> libcmockery.so.0.0.0│   ├── libcmockery.so.0 -> libcmockery.so.0.0.0│   └── libcmockery.so.0.0.0└── share    └── doc        └── cmockery-0.11            ├── AUTHORS            ├── ChangeLog            ├── COPYING            ├── index.html            ├── INSTALL            ├── NEWS            └── README 6 directories, 13 files

安装后的目录树如上所示，包括头文件，同时提供了静态库和动态库， 和头文件，还有一些使用手册。

 2、cmockery库的使用

cmockery使用不到2000行的代码，实现了对代码的单元测试框架。

首先来浏览一下官方提供的example，总结一下cmockery库的功能：

（1）运行测试 —— 参阅 run_tests.c calculator_test.c

cmockery提供了两种方式添加一个测试用例：

unit_test(f)    unit_test_setup_teardown(test, setup, teardown)

使用unit_test_setup_teardown的方式可以分别添加setup函数和teardown函数，可以在test之前进行初始化，测试结束之后释放资源，可以使用NULL表示空函数。

测试框架流程：

const UnitTest tests[] = {        unit_test(f),        unit_test_setup_teardown(test, setup, teardown),    };    run_tests(tests);

测试结果显示如下：

test_func: Starting test

test_func: Test completed successfully.

All 1 tests passed

 

（2）断言测试 —— 参阅 assert_module_test.c assert_macro_test.c

使用cmockery提供的assert函数：

// If unit testing is enabled override assert with mock_assert().#if UNIT_TESTINGextern void mock_assert(const int result, const char* const expression,const char * const file, const int line);#undef assert#define assert(expression) \    mock_assert((int)(expression), #expression, __FILE__, __LINE__);#endif // UNIT_TESTING

cmockery库提供了以下断言函数：

assert_true(c) assert_false(c)assert_int_equal(a, b) assert_int_not_equal(a, b) assert_string_equal(a, b) assert_string_not_equal(a, b) assert_memory_equal(a, b, size) assert_memory_not_equal(a, b, size) assert_in_range(value, minimum, maximum) assert_not_in_range(value, minimum, maximum) assert_in_set(value, values, number_of_values) assert_not_in_set(value, values, number_of_values)

在测试代码时，可以适当且大量的使用断言以确保代码的可靠性。

断言出错，将打印出错误提示，如下实例：

get_status_code_string_test: Starting test

"Connection dropped" != "Connection timed out"

ERROR: src/example/assert_macro_test.c:29 Failure!

get_status_code_string_test: Test failed.

string_to_status_code_test: Starting test

2 != 1

 

（3）内存申请和释放测试 —— 参阅 allocate_module.c allocate_module_test.c

同样需要使用cmockery提供的malloc、calloc和free函数

#if UNIT_TESTINGextern void* _test_malloc(const size_t size, const char* file, const int line);extern void* _test_calloc(const size_t number_of_elements, const size_t size,const char* file, const int line);extern void _test_free(void* const ptr, const char* file, const int line);#define malloc(size) _test_malloc(size, __FILE__, __LINE__)#define calloc(num, size) _test_calloc(num, size, __FILE__, __LINE__)#define free(ptr) _test_free(ptr, __FILE__, __LINE__)#endif // UNIT_TESTING

当内存操作不当或者malloc错误会打印出错误信息，如下实例所示：

buffer_overflow_test: Starting test

Guard block of 0x088e90e8 size=4 allocated by src/example/allocate_module.c:41 at 0x088e90ec is corrupt

ERROR: src/example/allocate_module.c:43 Failure!

buffer_overflow_test: Test failed.

1 out of 1 tests failed!

    buffer_overflow_test

Blocks allocated...

  0x088e90b0 : src/example/allocate_module.c:41

Guard block of 0x088e90e8 size=4 allocated by src/example/allocate_module.c:41 at 0x088e90ec is corrupt

ERROR: src/cmockery.c:1463 Failure!

 

（4）模拟测试 —— 参阅 product_database_test.c customer_database_test.c

通过expect_value和check_expected可以判断传入函数的值是不是期望的值，而will_return和mock则是对应的关系，will_return会将值放入到队列中，而每次调用mock都会取到队列前端的值。

int test(int value, char *string){    check_expected(value);    check_expected(string);    return (int)mock();}void test_for_mock(void **state) {    expect_value(test, value, 1);    expect_string(test, string, "test");    will_return(test, 0x123456);    assert_int_equal(test(1, "test"), 0x123456);}