c语言unit用法,CUnit的用法.doc
CUnit的用法
CUnit的用法
CUnit下载地址:?/projects/cunit/
CUnit 在线文档帮助:/doc/index.html
关于CUnit, 本文主要从介绍三方面的内容：
1.CUnit的介绍。
1.1 介绍如何使用CUnit。
CUnit是一个对C语言编写的程序进行单元测试的框架，在线文档说它作为一个静态链接库被链接到用户的测试代码中。它提供了一种简洁的框架来建立测试架构，并提供丰富的断言 Assertion 来测试通用数据类型。除此之外，它还提供了许多不同的结构来运行测试用例和报告测试结果。
1 CUnit的架构 Test Registry | | | Suite '1' . . . . Suite 'N' | | | | | | Test '11' ... Test '1M' Test 'N1' ... Test 'NM'
提到这个框架，为后面如何使用CUnit提供了基础。
先介绍这个框架，从底层往上介绍就两句话：
1 每个测试用例被包装在一个测试包 suite 中，
2 每个测试包 suite 是在有效的测试注册单元 Test Registry 中注册的。
对于CUnit来说，它是单线程运行，所以每次只能有一个有效的测试注册单元 Test Registry ，这个测试注册单元下面可以包含多个测试包 suite ，每个测试包可以拥有多个测试用例。划分测试包 suite 的规则可以自由约定，比如按照模块来划分，一个模块的测试用例集中到一个测试包中 suite 。至于测试用例，则用来测试模块内部的函数。测试用例函数通过提供的各类输入调用被测试的函数，返回执行结果，然后通过CUnit提供的断言来判断被测试的函数是否正确。
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 Interactive
第一种模式是将结果输出到XML文档中，便于生成报告。第二种模式是每一次运行结束之后在standard output中显示测试结果，不能保留测试结果数据。第三种模式是console方式的，可以人机交互；前两种模式是非交互式的。第四种只在Unix中使用。
3 测试的基本流程
1 编写单元测试函数 有必要的话要写suite的init/cleanup函数 。Write functions for tests and suite init/cleanup if necessary .?
2 调用函数CU_initialize_registry 初始化测试注册单元 Test Registry 。 Initialize the test registry - CU_initialize_registry 3 调用函数CU_add_suite 将测试包 suite 添加到测试注册单元 Test Registry 中。Add suites to the test registry - CU_add_suite 4 调用函数CU_add_test 将测试用例添加到测试包 suite 中。Add tests to the suites - CU_add_test 5 使用合适的接口来运行测试用例。Run tests using an appropriate interface, e.g. CU_console_run_tests?
6 调用函数CU_cleanup_registry清除测试注册单元 Test Registry 。Cleanup the test registry - CU_cleanup_registry
1.2 通过一个例子来说明使用方法。
先说明文件的组织结构:
1.被测试的模块：
1 文件MainModule.c，定义了一个求和函数cal_num。
2 头文件MainModule.h，声明了求和函数cal_num。
2.测试用例和测试包
1 文件TestMainModule.c，定义了测试用例。
3.单元测试运行入口
1 文件CUnitRunTest.c
各个文件的内容如下:
【1】MainModule.h
[cpp]?view plaincopy
#ifndef?__MAIN_MODULE_H__??
#define?__MAIN_MODULE_H__??
#include //计算两个数之和??
int?cal_num int?a