CUnit例子

关于CUnit的安装请自行百度

我的系统：fedora22 64bit

我的CUnit的头文件在：/usr/include/CUnit/

库文件在：/usr/lib64/

文件：

[laolang@laolang mycunittest]$ tree
.
├── cal.c
├── cal.h
├── Makefile
├── test.c
└── testcal.c

0 directories, 5 files
[laolang@laolang mycunittest]$

代码：

cal.h

[laolang@laolang mycunittest]$ cat cal.h
#ifndef _CAL_H_
#define _CAL_H_

int add(int a, int b );

int minus( int a, int b);
#endif
[laolang@laolang mycunittest]$

cal.c

[laolang@laolang mycunittest]$ cat cal.c
#include"cal.h"

int add(int a, int b ){
	return a + b;
}

int minus( int a, int b){
	return a - b;
}
[laolang@laolang mycunittest]$

testcal.c

[laolang@laolang mycunittest]$ cat testcal.c 
#include <stdio.h>
#include <assert.h>
#include <CUnit/Console.h>
#include "cal.h"

int InitSuite()
{
	return 0;
} 

int EndSuite()
{
	return 0;
}

int test_add(int a, int b, int real)
{
	int result;

	result = add(a, b);
	if(result == real)
	{
		return 1;
	}
	return 0;
}

int test_minus(int a, int b, int real)
{
	int result;

	result = minus(a, b);
	if(result == real)
	{
		return 1;
	}
	return 0;
}

void TestAdd()
{
//	CU_ASSERT(test_add(3, 4, 7));
  int result = add(3, 4);
  int real = 7;
	CU_ASSERT_EQUAL(result,real);
}

void TestMinus()
{
  //	CU_ASSERT(test_minus(4, 5, -1));
  int result = minus(3, 4);
  int real = -1;
	CU_ASSERT_EQUAL(result,real);
}

/*0 表示成功，1表示失败*/
int AddTestCalModule()
{
	CU_pSuite pSuite = NULL;

	/***************
	* 1. CU_add_suite 增加一个Suite 
	* 2. Suite名字 : testSuite
	* 3. InitSuite EndSuite：分别是测试单元初始和释放函数，如不需要则NULL传递
	****************/
	pSuite = CU_add_suite("cal模块", InitSuite, EndSuite);  

	//检测注册Suite情况
	if(NULL == pSuite)
	{
		//return 1;
	}
	
	/***************
	* 1. 注册当前Suite下的测试用例　
	* 2. pSuite：用例指针
	* 3. "Test1"： 测试单元名称 
	* 4. Test1：测试函数
	***************/
	if( NULL == CU_add_test(pSuite, "add(加)", TestAdd) ||
		NULL == CU_add_test(pSuite, "minus(减)", TestMinus))
	{
		return 1;
	}
	
	/***另外一种测试方式***************/
	/*
	CU_TestInfo testcases[] = {
        {"Test1:", Test1},
        {"Test2:", Test2},
        CU_TEST_INFO_NULL
	};

	CU_SuiteInfo suites[] = {
		{"Testing the function cal_num:", InitSuite, EndSuite, testcases},
        CU_SUITE_INFO_NULL
	};

	if(CUE_SUCCESS != CU_register_suites(suites))
	{
		return 1;
	}
	*/
	/************************************/

	return 0;
}
[laolang@laolang mycunittest]$

test.c

[laolang@laolang mycunittest]$ cat test.c
#include <stdio.h>
#include <assert.h>
#include <CUnit/Console.h>

extern int AddTestCalModule();

int main()
{
   
	//CU_initialize_registry 注册函数注册一个用例返回CUE_系列异常值
	if( CUE_SUCCESS != CU_initialize_registry())
	{
		return CU_get_error();
	}

	//CU_get_registry 返回注册到用例指针 
	assert(NULL != CU_get_registry());
	
	//检测是否在执行 
	assert(!CU_is_test_running()); 

	//调用测试模块完成测试用例
	if (0 != AddTestCalModule())
	{
		CU_cleanup_registry();
		return CU_get_error();
	}

	//使用console控制交互界面的函数入口 
	CU_console_run_tests();

	/***使用自动产生XML文件的模式********
	CU_set_output_filename("TestMax");
    CU_list_tests_to_file();
	CU_automated_run_tests();
	***********************************/
	
	//调用完毕清除注册信息 
	CU_cleanup_registry();
	
	return 0;
}
[laolang@laolang mycunittest]$

Makefile

laolang@laolang mycunittest]$ cat Makefile 
INC=-I/usr/include/CUnit/
LIB=-L/usr/lib64/
#gcc -o test -I /usr/include/CUnit/ -L /usr/lib64/ -lcunit *.c
all: cal.c testcal.c test.c
	gcc $^ -o hello $(INC) $(LIB) -lcunit
clean:
	rm -rf hello
[laolang@laolang mycunittest]$

运行：

[laolang@laolang mycunittest]$ make
gcc cal.c testcal.c test.c -o hello -I/usr/include/CUnit/ -L/usr/lib64/ -lcunit
[laolang@laolang mycunittest]$ ./hello 


     CUnit - A Unit testing framework for C - Version 2.1-3
             http://cunit.sourceforge.net/


***************** CUNIT CONSOLE - MAIN MENU ******************************
(R)un  (S)elect  (L)ist  (A)ctivate  (F)ailures  (O)ptions  (H)elp  (Q)uit
Enter command: r

Running Suite : cal模块
     Running Test : add(加)
     Running Test : minus(减)

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites      1      1    n/a      0        0
               tests      2      2      2      0        0
             asserts      2      2      2      0      n/a

Elapsed time =    0.000 seconds


***************** CUNIT CONSOLE - MAIN MENU ******************************
(R)un  (S)elect  (L)ist  (A)ctivate  (F)ailures  (O)ptions  (H)elp  (Q)uit
Enter command: l

--------------------- Registered Suites -----------------------------
 #  Suite Name                         Init? Cleanup? #Tests Active?

 1. cal模块                           Yes      Yes      2     Yes
---------------------------------------------------------------------
Total Number of Suites : 1


***************** CUNIT CONSOLE - MAIN MENU ******************************
(R)un  (S)elect  (L)ist  (A)ctivate  (F)ailures  (O)ptions  (H)elp  (Q)uit
Enter command: s

--------------------- Registered Suites -----------------------------
 #  Suite Name                         Init? Cleanup? #Tests Active?

 1. cal模块                           Yes      Yes      2     Yes
---------------------------------------------------------------------
Total Number of Suites : 1

Enter number of suite to select (1-1) : 1-1
Suite 'cal模块' selected.

***************** CUNIT CONSOLE - SUITE MENU ***************************
(R)un (S)elect (L)ist (A)ctivate (F)ailures (U)p (O)ptions (H)elp (Q)uit
Enter command: r

Running Suite : cal模块
     Running Test : add(加)
     Running Test : minus(减)

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites      1      1    n/a      0        0
               tests      2      2      2      0        0
             asserts      2      2      2      0      n/a

Elapsed time =    0.000 seconds

***************** CUNIT CONSOLE - SUITE MENU ***************************
(R)un (S)elect (L)ist (A)ctivate (F)ailures (U)p (O)ptions (H)elp (Q)uit
Enter command: u


***************** CUNIT CONSOLE - MAIN MENU ******************************
(R)un  (S)elect  (L)ist  (A)ctivate  (F)ailures  (O)ptions  (H)elp  (Q)uit
Enter command: q
[laolang@laolang mycunittest]$

解释：

这个例子参考自：http://blog.csdn.net/scucj/article/details/4385630/

原文用的方法是我注释的那一部分，即写一个test_add方法，再写一个TestAdd方法。不过我觉得这种不如直接在TestAdd方法中调用需要测试的方法

关于CUnit解释的比较好的例子：http://www.cnblogs.com/linux-sir/archive/2012/08/25/2654557.html

然后这个是不能运行的，提示是testcase类型有问题，但是这篇博文的解释还是很好的

我的总结：

１、写你的模块，比如cal

2、每一个模块写一个测试文件，如testcal.c

3、写一个总的测试文件，在此文件中包含需要测试的模块对应的测试文件

现在我把其中的数据修改一下：

void TestMinus()
{
  //	CU_ASSERT(test_minus(4, 5, -1));
  int result = minus(3, 4);
  int real = 1;//这里由－１修改为１
  CU_ASSERT_EQUAL(result,real);
}

运行效果：

[laolang@laolang mycunittest]$ make
gcc cal.c testcal.c test.c -o hello -I/usr/include/CUnit/ -L/usr/lib64/ -lcunit
[laolang@laolang mycunittest]$ ./hello 


     CUnit - A Unit testing framework for C - Version 2.1-3
             http://cunit.sourceforge.net/


***************** CUNIT CONSOLE - MAIN MENU ******************************
(R)un  (S)elect  (L)ist  (A)ctivate  (F)ailures  (O)ptions  (H)elp  (Q)uit
Enter command: r

Running Suite : cal模块
     Running Test : add(加)
     Running Test : minus(减)

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites      1      1    n/a      0        0
               tests      2      2      1      1        0
             asserts      2      2      1      1      n/a

Elapsed time =    0.000 seconds


***************** CUNIT CONSOLE - MAIN MENU ******************************
(R)un  (S)elect  (L)ist  (A)ctivate  (F)ailures  (O)ptions  (H)elp  (Q)uit
Enter command: f

--------------- Test Run Failures -------------------------
   src_file:line# : (suite:test) : failure_condition

1. testcal.c:53 : (cal模块 : minus(减)) : CU_ASSERT_EQUAL(result,real)
-----------------------------------------------------------
Total Number of Failures : 1


***************** CUNIT CONSOLE - MAIN MENU ******************************
(R)un  (S)elect  (L)ist  (A)ctivate  (F)ailures  (O)ptions  (H)elp  (Q)uit
Enter command: q
[laolang@laolang mycunittest]$

可以看到如果测试未通过，按F可以看出来是那个测试模块的哪个测试出问题了，还提示了在哪一行，哪一个断言