C单元测试框架——CMockery简介与示例

海鸥一飞

cmockery 是google发布的用于C单元测试的一个轻量级的框架。

主要特点：

免费且开源，google提供技术支持；
轻量级的框架，使测试更加快速简单；
避免使用复杂的编译器特性，对老版本的编译器来讲，兼容性好;
并不强制要求待测代码必须依赖C99标准，这一特性对许多嵌入式系统的开发很有用；
获取源码：
直接下载：http://code.google.com/p/cmockery/downloads/list

svn地址：svn checkout http://cmockery.googlecode.com/svn/trunk/ cmockery-read-only


编译方法：
window下，
打开使用VS2003/2005/2008 提供的 命令提示窗口；
cd 到CMockery的目录的window目录
运行 nmake 命令
E:
cd E:/OpenSource/c/cMockery
cd windows
nmake

cmockery.lib文件以及一些测试代码都在 Windows目录下；

linux下，
cd 到 cMockery 源码目录

sudo ./configure

sudo make

sudo make install

库文件安装到：/usr/local/lib

头文件安装到：/usr/local/include/google

注意此时还应该加载一下CMockery库：

cd /usr/local/lib

sudo ldconfig

下一文章我们会介绍一个简单例子，更多内容请参考：CMockery Manual。



欢迎转载，请注明来自see-see ，谢谢！


示例

使用CMockery做单元测试，文中的例子从CMockery的calculator example 中剥离出来的。

首先新建一个文件夹：math_demo，此文件夹中有三个文件：

math.c            待测代码模块；
test_math.c    测试用例 和 main 函数；
Makefile          组织编译
math.c 中我们只有两个功能。加法 和减法，如下：

1. int add(int a, int b)   
   
2. {  
   
3.     return a + b;  
   
4. }  
   
5. int sub(int a, int b)   
   
6. {  
   
7.     return a - b;  
   
8. }   

复制代码

test_math.c ，对 add 和 函数的测试，以及main函数。如下：

1. #include <stdarg.h>  
   
2. #include <stddef.h>  
   
3. #include <setjmp.h>  
   
4. #include <cmockery.h>  
   
5. /* Ensure add() adds two integers correctly. */  
   
6. void test_add(void **state) {  
   
7.     assert_int_equal(add(3, 3), 6);  
   
8.     assert_int_equal(add(3, -3), 0);  
   
9. }  
   
10. /* Ensure sub() subtracts two integers correctly.*/  
    
11. void test_sub(void **state) {  
    
12.     assert_int_equal(sub(3, 3), 0);  
    
13.     assert_int_equal(sub(3, -3), 6);  
    
14. }  
    
15. int main(int argc, char *argv[])   
    
16. {  
    
17.     const UnitTest tests[] = {  
    
18.         unit_test(test_add),  
    
19.         unit_test(test_sub),  
    
20.     };  
    
21.     return run_tests(tests);  
    
22. }  

复制代码

在windows下可以直接新建一个空项目、加入 math.c test_math.c   cmockery.h 以及 cmockery.lib文
件直接编译运行即可。cmockery.lib文件在上次文章 中已经产生。



在linux下需要使用 Makefile 编译，其源码为：

1. INC=-I/usr/local/include/google  
   
2. LIB=-L/usr/local/lib  
   
3. all: math.c test_math.c  
   
4.     gcc -o math_test_run $(INC) $(L

复制代码

要确保CMockery环境已经安装成功。详见上次文章 。



执行make后，运行 math_test_run 结果如下：



sw2@grady:~/code/unit_test/cmockery/demo/test_math$ make
gcc -o math_test_run -I/usr/local/include/google -L/usr/local/lib -lcmockery math.c test_math.c
sw2@grady:~/code/unit_test/cmockery/demo/test_math$ ./math_test_run
test_add: Starting test
test_add: Test completed successfully.
test_sub: Starting test
test_sub: Test completed successfully.
All 2 tests passed

嘻嘻嘻果冻