[boost] : test库
最小化的测试套件minimal_test
test库提供一个最小化的测试套件minimal_test, 类似lightweight_test适合入门级测试.
需要包含文件文#include <boost/test/minimal_test.hpp>
minimal_test内部实现了main(), 因此无需自己编写main()函数, 只要实现test_main()即可, 它是minimal_test的真正功能函数. 注意test_main()必须返回一个整数.
minimal_test提供四个测试断言宏
| BOOST_CHECK(e) | 断言测试通过, 如不通过不影响程序执行 |
| BOOST_REQUIRE(e) | 要求断言必须通过, 否则程序停止执行 |
| BOOST_ERROR(e1, e2) | 给出错误信息, 程序继续执行 |
| BOOST_FAIL(e1, e2) | 给出错误信息, 程序运行停止 |
// Copyright (c) 2015
// Author: Chrono Law
#include <iostream>
using namespace std;
#include <boost/format.hpp>
#include <boost/test/minimal.hpp> // 最小化测试头文件
int test_main( int argc, char* argv[] )
{
using namespace boost;
format fmt("%d-%d");
BOOST_CHECK(fmt.size() != 0); // 断言测试通过, 如不通过不影响程序执行
fmt % 12 % 34;
BOOST_REQUIRE(fmt.str() == "12-34"); // 要求断言必须通过, 否则程序停止执行
BOOST_ERROR("演示一条错误消息"); // 给出错误信息, 程序继续执行
fmt.clear();
fmt % 12;
try
{
std::cout << fmt; // 输入参数不完整, 抛出异常
}
catch (...)
{
BOOST_FAIL("致命错误，测试终止"); // 给出错误信息, 程序运行停止
}
return 0; // 必须返回值
}
运行输出
minimal_test.cpp(18): 演示一条错误消息 in function: 'int test_main(int, char**)'
minimal_test.cpp(28): 致命错误，测试终止 in function: 'int test_main(int, char**)'
minimal_test与lightweight_test区别:
- 测试断言有CHECK/REQUIRE/ERROR/FAIL级别
- 不支持捕获异常的测试
- 必须实现test_main()函数作为测试入口
- 自动输出测试报告
单元测试框架UTF
Boost test库提供了一个用于单元测试的基于命令行界面的测试套件UTF: Unit Test Framework，具有单元测试、检测内存泄露、监控程序运行的功能。
UTF测试断言
UTF中的测试断言：BOOST_LEVEL_ITEM
| | |
|-------------|------------|-------------------------------|
| LEVEL | WARN | 警告级,不增加错误数量,不影响程序运行|
| | CHECK | 检查级别,增加错误数量,不影响程序运行|
| | REQUIRE | 最高级别,增加错误数量,程序终止运行 |
| ITEM | EQUAL/CLOSE| 测试相等性 |
| | GE/GT/LT/LE/NE | 测试不等性 |
| | (NO_)THROW | 是否抛出异常 |
| | MESSAGE | 测试信息 |
测试用例与测试套件
test库将测试程序定义为一个测试模块，由测试安装，测试主体，测试清理和测试运行器四个部分组成。测试主体是测试模块的实际运行部分，由测试用例和测试套件组织成测试树的形式。
测试用例是一个包含多个测试断言的函数, 是可以被独立执行测试的最小单元, 各个测试用例之间是无关的, 发生的错误不会影响其他测试用例.
测试套件是测试用例的容器，可以嵌套，包含一个或多个测试用例，将多个测试用例分组管理，共享安装/清理代码, 更好的组织测试用例。
主测试套件, 任何UTF单元测试程序必须存在唯一一个主测试套件, 它是整个测试树的根节点, 其他测试套件都是它的子节点. 主测试套件的定义可以使用宏BOOST_TEST_MAIN或者
BOOST_TEST_MODULE, 它们必须出现在<boost/test/unit_test.hpp>之前.
// Copyright (c) 2015
// Author: Chrono Law
//#define BOOST_TEST_MAIN
#define BOOST_TEST_MODULE // 主测试套件
#include <boost/test/unit_test.hpp> // test库头文件
#include <boost/smart_ptr.hpp>
using namespace boost;
BOOST_AUTO_TEST_SUITE(s_smart_ptr) // 测试套件开始
BOOST_AUTO_TEST_CASE(t_scoped_ptr) // 测试用例1
{
scoped_ptr<int> p(new int(874));
BOOST_CHECK(p);
BOOST_CHECK_EQUAL(*p , 874);
p.reset();
BOOST_CHECK(p == 0);
}
BOOST_AUTO_TEST_CASE(t_shared_ptr) // 测试用例2
{
shared_ptr<int> p(new int(100));
BOOST_CHECK(p);
BOOST_CHECK_EQUAL(*p , 100);
BOOST_CHECK_EQUAL(p.use_count(), 1);
shared_ptr<int> p2 = p;
BOOST_CHECK_EQUAL(p, p2);
BOOST_CHECK_EQUAL(p2.use_count(), 2);
*p2 = 255;
BOOST_CHECK_EQUAL(*p, 255);
BOOST_CHECK_GT(*p, 200);
}
BOOST_AUTO_TEST_SUITE_END() // 测试套件结束
输出结果
Running 2 test cases...
*** No errors detected
测试夹具: 测试安装和测试清理好比c++中的构造函数和析构函数，“测试夹具”实现了自动的测试安装和测试清理。基本形式为:
struct test_fixture_name // 测试夹具类, 通常是struct, 将被UTF继承
{
test_fixture_name(){} // 测试安装工作
~test_fixture_name(){} // 测试清理工作
};
测试夹具类需要使用以下两个宏指定测试用例和测试套件
#define BOOST_FIXTURE_TEST_SUITE(suite_name, F)
#define BOOST_FIXTURE_TEST_CASE(test_name, F)
// Copyright (c) 2015
// Author: Chrono Law
#include <iostream>
#include <vector>
using namespace std;
#define BOOST_TEST_MAIN
#include <boost/test/unit_test.hpp>
#include <boost/assign.hpp>
using namespace boost;
struct global_fixture // 全局测试夹具类
{
global_fixture(){cout << ("global setup\n");}
~global_fixture(){cout << ("global teardown\n");}
};
// 该宏定义的夹具类被应用于整个测试用例的所有测试套件, 包括主测试套件
BOOST_GLOBAL_FIXTURE(global_fixture);
struct assign_fixture // 测试套件夹具类
{
assign_fixture()
{cout << ("suit setup\n");}
~assign_fixture()
{cout << ("suit teardown\n");}
vector<int> v; // 所有测试用例都可以用的成员变量
};
// 定义测试套件级别的夹具
BOOST_FIXTURE_TEST_SUITE(s_assign, assign_fixture)
BOOST_AUTO_TEST_CASE(t_assign1) // 测试用例1, 测试+=操作符
{
using namespace boost::assign;
v += 1,2,3,4;
BOOST_CHECK_EQUAL(v.size(), 4);
BOOST_CHECK_EQUAL(v[2], 3);
}
BOOST_AUTO_TEST_CASE(t_assign2) // 测试用例2, 测试push_back函数
{
using namespace boost::assign;
push_back(v)(10)(20)(30);
BOOST_CHECK_EQUAL(v.empty(), false);
BOOST_CHECK_LT(v[0], v[1]);
}
BOOST_AUTO_TEST_SUITE_END() // 测试套件结束
输出结果为:
global setup
Running 2 test cases...
suit setup
suit teardown
suit setup
suit teardown
global teardown
*** No errors detected
