c语言测试工具 掌握CUnit

1.继Junit CppUnit的成功后, c语言环境下也出现了开发源码的白盒测试用例CUnit。
  暂时CUnit只是在SourceForge上还再不断改进中,虽然不是很完善,但是能用。
  下面介绍一下CUnit结构框架和具体使用
 
2.结构框架：
  在CUnit的主页上可以看到对他结构简单描述

                      Test Registry
                            |
             ------------------------------
             |                            |
          Suite '1'      . . . .       Suite 'N'
             |                            |
       ---------------             ---------------
       |             |             |             |
    Test '11' ... Test '1M'     Test 'N1' ... Test 'NM'

  CUnit的测试是单线程启动,只能注册一个测试用例Test Registry,我认为这和结构设计和需求有关
单线程数据结构是多重链表(对Suite,Test)组织起来,除非对测试用例再进行链表组织那样管理层次上
已经多达到3层嵌套实现麻烦,并且用户需求和习惯也就是能接受一个作为一个独立用例一次测试。
所以没有必要再费精力。
  继续结构分析一个起始测试下辖多个Suite(可以认为程序中各个独立模块),一个Suite管理多个Test
(可以认为具体到模块内部函数实现)。
整体测试流程就是这样:
  注册一个测试用例(如果已经注册了你可以cleanup掉然后重新注册使用)然后CU_add_suite增加你的模块
然后CU_add_test再在你的模块下挂载你的模块内的测试函数。所有的挂载完毕后,调用你想使用的界面进行
测试。
下面是四种测试模式:
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

注意12是没有交互功能的,4的Unix下的我是windows用户 选择第三个介绍console
而且console是可以人机交互的。

3.具体使用
  1.没有CUnit源码去http://sourceforge.net/projects/cunit/
    去down一份,这里是CUnit-2.0-2的例子。
  2.新建console工程 把自己要测试的代码文件加载进去,独立建一个main文件
  3.
  #include <stdio.h>
  #include "console.h"
  #include <assert.h>
  
  /*
   * Function:模块测试初始化工作,对模块内部Test函数需要用到的资源初始化
               如当前里例子中则对Test1,Test2中使用的到的资源初始化
   *  Input:  None
   *  Return: 0:Succeed, or False
   *  Remark: 如果成功才进测试函数的测试运行否则此Suite下挂载的Test均不运行
   * 
   */
  int InitSuite()
  {
   return 0;
  } 
  /*
   * Function:模块测试销毁工作,对模块内部Test函数需要用到的资源进行销毁
               如当前里例子中则对Test1,Test2中使用的到的资源释放
   *  Input:  None
   *  Return: 0:Succeed, or False
   *  Remark: 不影响Test的运行，失败会报suite运行错误
   * 
   */
  int EndSuite()
  {
   return 1;
  }
  
  /*
   * 自己定义的函数过程形式不限制 可以extern近来或者包含,h近来供测试
   */
  int MyTest1()
  {
   return 1;
  }
  BOOL MyTest2()
  {
   return FALSE;
  }
  
  /*
   * Function: 单元测试例子也内部装载自己的函数过程
   *  Input:   ignore
   *  Return: true:Succeed, or False
   *  Remark: 失败回记录Test失败,内部可以使用CU_ASSERT检测最终会有检测结果
   *          CU_ASSERT中检测到的才是真正意义上的用户函数
   * 
   */
  
  int Test1()
  {
   CU_ASSERT(MyTest1());
   return 1;
  }
  
  BOOL Test2()
  {
   CU_ASSERT(MyTest2());
   return FALSE;
  }
  
  /*
   * 使用过程
   */
  int main()
  {
   CU_pSuite pSuite = NULL;
   
   //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()); 
   //CU_add_suite 增加一个Suite
   //"mySuite": Suite名字 
   //InitSuite EndSuite:分别是测试单元初始和释放函数,如不需要则NULL传递
   pSuite = CU_add_suite("mySuite",InitSuite, EndSuite);
   
   //检测注册suite情况　
   if(NULL == pSuite)
   {
    CU_cleanup_registry();
    return CU_get_error();
   }
  
   //注册当前Suite下的测试用例　
   //pSuite:用例指针
   //"Test1": 测试单元名称
   //Test1:测试函数
   if( NULL == CU_add_test(pSuite, "Test1", Test1) ||
    NULL == CU_add_test(pSuite, "Test2", Test2) )
   {
    CU_cleanup_registry();
    return CU_get_error();
   }
   //使用console控制交互界面的函数入口
    CU_console_run_tests();
    //调用完毕清除注册信息
       CU_cleanup_registry();
  }
 
4:使用中可能出现的情况
  a: 找不到某些函数 加载CUnit.lib 在CUnit目录下,不行你就搜索吧
  b: #include "console.h" 找不到的话就inclue的console目录进来
  c: 注意使用不同模式测试可能需要平台不同 小心不要搞出问题了console是标准的