Cmockery是一个由google开发的轻量级C单元测试框架,代码仅有2000行不到,安装使用也十分简单。但麻雀虽小、五脏俱全,Cmockery基本可满足日常的单元测试需求。
安装Cmockery
Cmockery的源码托管在Google Project上:https://code.google.com/p/cmockery/下载后编译安装即可
安装后的头文件在/usr/local/include/google/cmockery.h
,链接库在/usr/local/lib/
下。
使用Cmockery
我们首先通过一个完整的例子观察如何使用Cmockery进行单元测试,这个例子中基本展示了Cmockery的所有功能特性,稍后将解释其中的细节。
建立如下两个文件,其中calc.c是源文件,calc_test.c是测试文件
文件内容如下
编译
运行
运行测试
Cmockery添加一个测试用例有以下两种方式,区别在于第二个函数可以在运行测试函数前后分别添加初始化函数和释放函数,这样使得一些初始化代码得以复用,可以用NULL表示空函数。
Cmockery通过测试组的形式来运行测试,将多个测试放到UnitTest数组中作为一组测试,最后调用run_tests来运行这一组测试
断言
Cmockery支持以下断言,函数名都很直接明了,就不再赘述。
例中的test_add使用了断言来测试函数返回结果是否符合预期。
内存测试
Cmockery支持内存泄漏和动态内存越界的检测,不过需要使用Cmockery提供的内存分配函数,可以使用以下三个宏在测试环境中替换系统的内存分配函数。
例中test_sub测试的sub函数故意使用了malloc的空间来存储结果造成内存泄漏,Cmockery可以正确检查到这一没有回收的内存。
Mock
虽然Cmockery提供了Mock的功能,但由于C的限制,用起来还是没有那么方便。通过expect_value和check_expected可以判断传入函数的值是不是期望的值,而will_return和mock则是对应的关系,will_return会将值放入到队列中,而每次调用mock都会取到队列前端的值。
本文主要介绍了如何安装和使用Cmockery。
原文地址:C单元测试框架之Cmockery, 感谢原作者分享。 擒龙要下海,打虎要上山。