1
CUnit Framework介绍
继Junit CppUnit的成功后， c语言环境下也出现了开发源码的白盒测试用例CUnit。CUnit以静态库的形式提供给用户使用，用户编写程序的时候直接链接此静态库就可以了。它提供了一个简单的单元测试框架，并且为常用的数据类型提供了丰富的断言语句支持。下面介绍一下CUnit结构框架和具体使用：
1.1 结构框架
在CUnit的主页上可以看到对他结构简单描述
Test Registry
|
------------------------------
| |
Suite '1' . Suite 'N'
| |
--------------- ---------------
| | | |
Test '11' ... Test '1M' Test 'N1' ... Test 'NM'
CUnit的测试是单线程启动，只能注册一个测试用例Test Registry， 一次测试（Test
Registry）可以运行多个测试包（Test Suite），而每个测试包可以包括多个测试用例（Test Case），每个测试用例又包含一个或者多个断言类的语句。具体到程序的结构上，一次测试下辖多个Test
Suite，它对应于程序中各个独立模块；一个Suite管理多个Test Case，它对应于模块内部函数实现。每个Suite可以含有setup和teardown函数，分别在执行suite的前后调用。
注册一个测试用例(如果已经注册了你可以cleanup掉然后重新注册使用)然后CU_add_suite增加你的模块然后CU_add_test再在你的模块下挂载你的模块内的测试函数。所有的挂载完毕后，调用你想使用的界面进行测试。
1.2 测试模式
下面是四种测试模式：
1 Automated Output to xml file Non-interactive
2 Basic Flexible programming interface Non-interactive
3 Console Console interface (ansi C) Interactive
4 Curses Graphical interface (Unix) Interact
注意1，2是没有交互功能的，4的Unix下的我是windows用户， 选择第3个介绍console而且console是可以人机交互的。
1.3 测试基本流程
使用CUnit进行测试的基本流程如下所示：
1．书写代测试的函数（如果必要，需要写suite的init/cleanup函数）
2．初始化Test Registry - CU_initialize_registry()
3．把测试包（Test Suites）加入到Test Registry - CU_add_suite()
4．加入测试用例（Test Case）到测试包当中 - CU_add_test()
5．使用适当的接口来运行测试测试程序，例如 CU_console_run_tests()
6．清除Test Registry - CU_cleanup_registry()
1.4 TestCase的构成
一个ＣUnit TestCase的构成有以下文件：test.c、testcase.c、Ｍain.c 与 Makefile构成。即一个测试范例由①被测函数，②测试函数（定义策识用例和测试包），③运行测试函数及④Makefile四部分构成。
2 CUnit Framework的安装
2.1 CUnit Framework的下载
Cunit Framework的当前版本为：CUnit-2.1-0-src.tar.gz。
2.2 CUnit Framework的安装
CUnit的Framework的安装环境为Fedora 5。安装命令如下：
(1)解包
#tar xzvf CUnit-2.1-0-src.tar.gz
(２)编译与安装
#cd CUnit-2.1-0
#aclocal (if necessary)
#autoconf (if necessary)
#automake (if necessary)
#chmod u+x configure (if necessary)
#./configure --prefix <Your choice of directory for installation>
#make
#make install
(3)加载CUnit的库(only one time)
#cd /usr/local/lib
#ldconfig
3 CUnit TestCase构成
3.1 CUnit TestCase的构成
一个ＣUnit TestCase的构成有以下文件：test.c、testcase.c、Ｍain.c 与 Makefile构成。
3.2 CUnit TestCase主要构成函数说明
以下以一个简单的testcase为例说明。
我要测试的是整数求最大值的函数maxi，我使用如下文件组织结构：
１．test.c：被测函数（定义maxi()函数）
２．testcase.c：测试函数（定义测试用例和测试包）
３．Ｍain.c：运行测试函数（调用CUnit的Automated接口运行测试）
４．Makefile ：生成测试程序。
（1）被测函数test.c
/**
*file： test.c
**/
int maxi(int i，int j)
{
return i>j?i：j;
} |
（2）测试函数（定义策识用例和测试包）testcase.c
#include <stdio.h>
#include <stdlib.h>
#include <assert.h>
#include <CUnit/CUnit.h>
#include <CUnit/Automated.h>
#include <CUnit/TestDB.h>
/**//*---- functions to be tested ------*/
extern int maxi(int i， int j);
/**//*---- test cases ------------------*/
void testIQJ()
{
CU_ASSERT_EQUAL(maxi(1，1)，1);
CU_ASSERT_EQUAL(maxi(0，-0)，0);
}
void testIGJ()
{
CU_ASSERT_EQUAL(maxi(2，1)，2);
CU_ASSERT_EQUAL(maxi(0，-1)，0);
CU_ASSERT_EQUAL(maxi(-1，-2)，-1);
}
void testILJ()
{
CU_ASSERT_EQUAL(maxi(1，2)，2);
CU_ASSERT_EQUAL(maxi(-1，0)，0);
CU_ASSERT_EQUAL(maxi(-2，-1)，-1);
}
CU_TestInfo testcases[] = {
{"Testing i equals j："， testIQJ}，
{"Testing i greater than j："， testIGJ}，
{"Testing i less than j："， testILJ}，
CU_TEST_INFO_NULL
};
/**//*---- test suites ------------------*/
int suite_success_init(void)
{ return 0; }
int suite_success_clean(void)
{ return 0; }
CU_SuiteInfo suites[] = {
{"Testing the function maxi："， suite_success_init，
suite_success_clean， testcases}，
CU_SUITE_INFO_NULL
};
/**//*---- setting enviroment -----------*/
void AddTests(void)
{
assert(NULL != CU_get_registry());
assert(!CU_is_test_running());
/**//* shortcut regitry */
if(CUE_SUCCESS != CU_register_suites(suites)){
fprintf(stderr， "Register suites failed - %s "，
CU_get_error_msg());
exit(EXIT_FAILURE);
}
} |
（３）运行测试函数 Ｍain.c
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>
#include "Basic.h"
int main(int argc， char* argv[])
{
CU_BasicRunMode mode = CU_BRM_VERBOSE;
CU_ErrorAction error_action = CUEA_IGNORE;
int i;
setvbuf(stdout， NULL， _IONBF， 0);
for (i=1 ; i<argc ; i++) {
if (!strcmp("-i"， argv[i])) {
error_action = CUEA_IGNORE;
}
else if (!strcmp("-f"， argv[i])) {
error_action = CUEA_FAIL;
}
else if (!strcmp("-A"， argv[i])) {
error_action = CUEA_ABORT;
}
else if (!strcmp("-s"， argv[i])) {
mode = CU_BRM_SILENT;
}
else if (!strcmp("-n"， argv[i])) {
mode = CU_BRM_NORMAL;
}
else if (!strcmp("-v"， argv[i])) {
mode = CU_BRM_VERBOSE;
}
else if (!strcmp("-e"， argv[i])) {
return 0;
}
else {
printf("\nUsage： BasicTest [options]\n\n"
"Options： -i ignore framework errors [default].\n"
" -f fail on framework error.\n"
" -A abort on framework error.\n\n"
" -s silent mode - no output to screen.\n"
" -n normal mode - standard output to screen.\n"
" -v verbose mode - max output to screen [default].\n\n"
" -e print expected test results and exit.\n"
" -h print this message and exit.\n\n");
return 0;
}
}
if (CU_initialize_registry()) {
printf("\nInitialization of Test Registry failed.");
}
else {
AddTests();
CU_basic_set_mode(mode);
CU_set_error_action(error_action);
printf("\nTests completed with return value %d.\n"，
CU_basic_run_tests());
CU_cleanup_registry();
}
return 0;
} |
（４）Makefile
INC=-I/usr/local/include/CUnit
LIB=-L/usr/local/lib/
all： func.c test_func.c run_test.c
#gcc -o test $(INC) $(LIB) -lcunit $^
gcc -o test $(INC) $(LIB) -lcunit $^
clean：
-rm -rf *.o test |
3.3 测试报告
CUnit - A Unit testing
framework for C - Version 2.1-0
http：//cunit.sourceforge.net/
Suite： suite_success_both
Test： testSuccess1 ... passed
Test： testSuccess2 ... passed
Test： testSuccess3 ... passed
Suite： suite_success_init
Test： testSuccess1 ... passed
Test： testSuccess2 ... passed
Test： testSuccess3 ... passed
Suite： suite_success_clean
Test： testSuccess1 ... passed
Test： testSuccess2 ... passed
Test： testSuccess3 ... passed
Suite： test_failure
Test： testFailure1 ... FAILED
1. ExampleTests.c：52 - 0
Test： testFailure2 ... FAILED
1. ExampleTests.c：53 - 0
Test： testFailure3 ... FAILED
1. ExampleTests.c：54 - 0
WARNING - Suite initialization failed for suite_failure_both.
WARNING - Suite initialization failed for suite_failure_init.
Suite： suite_success_but_failure_clean
Test： testSuiteFailure1 ... FAILED
1. ExampleTests.c：49 - 0
Test： testSuiteFailure2 ... passed
WARNING - Suite cleanup failed for suite_success_but_failure_clean.
Suite： TestSimpleAssert
Test： testSimpleAssert ... FAILED
1. ExampleTests.c：63 - 0
2. ExampleTests.c：64 - !1
3. ExampleTests.c：65 - 0
Test： testFail ... FAILED
1. ExampleTests.c：70 - CU_FAIL("This is a failure.")
2. ExampleTests.c：71 - CU_FAIL("This is another failure.")
Suite： TestBooleanAssert
Test： testAssertTrue ... FAILED
1. ExampleTests.c：79 - CU_ASSERT_TRUE(!CU_TRUE)
2. ExampleTests.c：80 - CU_ASSERT_TRUE(CU_FALSE)
Test： testAssertFalse ... FAILED
1. ExampleTests.c：88 - CU_ASSERT_FALSE(!CU_FALSE)
2. ExampleTests.c：89 - CU_ASSERT_FALSE(CU_TRUE)
Suite： TestEqualityAssert
Test： testAssertEqual ... FAILED
1. ExampleTests.c：99 - CU_ASSERT_EQUAL(10，11)
2. ExampleTests.c：100 - CU_ASSERT_EQUAL(0，1)
3. ExampleTests.c：101 - CU_ASSERT_EQUAL(0，-1)
4. ExampleTests.c：102 - CU_ASSERT_EQUAL(-12，12)
Test： testAssertNotEqual ... FAILED
1. ExampleTests.c：111 - CU_ASSERT_NOT_EQUAL(10，10)
2. ExampleTests.c：112 - CU_ASSERT_NOT_EQUAL(0，-0)
3. ExampleTests.c：113 - CU_ASSERT_NOT_EQUAL(0，0)
4. ExampleTests.c：114 - CU_ASSERT_NOT_EQUAL(-12，-12)
Suite： TestPointerAssert
Test： testAssertPtrEqual ... FAILED
1. ExampleTests.c：121 - CU_ASSERT_PTR_EQUAL((void*)0x100，(void*)0x101)
Test： testAssertPtrNotEqual ... FAILED
1. ExampleTests.c：128 - CU_ASSERT_PTR_NOT_EQUAL((void*)0x100，(void*)0x100)
Suite： TestNullnessAssert
Test： testAssertPtrNull ... FAILED
1. ExampleTests.c：136 - CU_ASSERT_PTR_NULL((void*)0x23)
Test： testAssertPtrNotNull ... FAILED
1. ExampleTests.c：143 - CU_ASSERT_PTR_NOT_NULL(NULL)
2. ExampleTests.c：144 - CU_ASSERT_PTR_NOT_NULL((void*)0x0)
Suite： TestStringAssert
Test： testAssertStringEqual ... FAILED
1. ExampleTests.c：155 - CU_ASSERT_STRING_EQUAL(str1，str3)
2. ExampleTests.c：156 - CU_ASSERT_STRING_EQUAL(str3，str2)
Test： testAssertStringNotEqual ... FAILED
1. ExampleTests.c：168 - CU_ASSERT_STRING_NOT_EQUAL(str1，str2)
Suite： TestNStringAssert
Test： testAssertNStringEqual ... FAILED
1. ExampleTests.c：181 - CU_ASSERT_NSTRING_EQUAL(str2，str3，4)
2. ExampleTests.c：182 - CU_ASSERT_NSTRING_EQUAL(str1，str3，strlen(str1))
Test： testAssertNStringNotEqual ... FAILED
1. ExampleTests.c：194 - CU_ASSERT_NSTRING_NOT_EQUAL(str1，str2，2)
2. ExampleTests.c：195 - CU_ASSERT_NSTRING_NOT_EQUAL(str2，str3，2)
Suite： TestDoubleAssert
Test： testAssertDoubleEqual ... FAILED
1. ExampleTests.c：205 - CU_ASSERT_DOUBLE_EQUAL(10，10.0001，0.00001)
2. ExampleTests.c：206 - CU_ASSERT_DOUBLE_EQUAL(10，10.0001，-0.00001)
3. ExampleTests.c：207 - CU_ASSERT_DOUBLE_EQUAL(-10，-10.0001，0.00001)
4. ExampleTests.c：208 - CU_ASSERT_DOUBLE_EQUAL(-10，-10.0001，-0.00001)
Test： testAssertDoubleNotEqual ... FAILED
1. ExampleTests.c：218 - CU_ASSERT_DOUBLE_NOT_EQUAL(10，10.001，0.01)
2. ExampleTests.c：219 - CU_ASSERT_DOUBLE_NOT_EQUAL(10，10.001，-0.01)
3. ExampleTests.c：220 - CU_ASSERT_DOUBLE_NOT_EQUAL(-10，-10.001，0.01)
4. ExampleTests.c：221 - CU_ASSERT_DOUBLE_NOT_EQUAL(-10，-10.001，-0.01)
Suite： TestFatal
Test： testFatal ... FAILED
1. ExampleTests.c：227 - CU_FALSE
--Run Summary： Type Total Ran Passed Failed
suites 16 14 n/a 3
tests 35 31 10 21
asserts 89 89 47 42
Tests completed with return value 22. |
4 项目中CUnit TestCase的作成
4.1 项目中TestCase作成的指导思想
CUnit的TestCase作成的指导思想：TestCase和项目代码分开，作成的TestCase独立地放在其它目录中。
|