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的构成
一个CUnit TestCase的构成有以下文件:test.c、testcase.c、Main.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
(2)编译与安装
#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的构成
一个CUnit TestCase的构成有以下文件:test.c、testcase.c、Main.c 与 Makefile构成。
3.2 CUnit TestCase主要构成函数说明
以下以一个简单的testcase为例说明。
我要测试的是整数求大值的函数maxi,我使用如下文件组织结构:
1.test.c:被测函数(定义maxi()函数)
2.testcase.c:测试函数(定义测试用例和测试包)
3.Main.c:运行测试函数(调用CUnit的Automated接口运行测试)
4.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);
}
}