安装:
下载Google C++ Testing Framework ,解压...
VC2005:
直接打开msvc\gtest.vcproj或msvc\gtest.sln,直接编译即可。
Linux/Unix下的GCC:
传统过程:./configure make
Mingw:
BCC:
用Mingw和BCB6编译需要修改一些代码,过几天我会上传到www.cppprog.com 网站上。
使用:
首先#include <gtest/gtest.h>,当然工程的头文件路径要设置正确
1.简单测试TEST
#include <gtest/gtest.h> int Factorial( int n ) { if(n==2) return 100; //故意出个错,嘻嘻 return n<=0? 1 : n*Factorial(n - 1); } //用TEST做简单测试 TEST(TestFactorial, ZeroInput) //第一个参数是测试用例名,第二个参数是测试名:随后的测试结果将以"测试用例名.测试名"的形式给出 { EXPECT_EQ(1, Factorial(0)); //EXPECT_EQ稍候再说,现在只要知道它是测试两个数据是否相等的就行了。 } TEST(TestFactorial, OtherInput) { EXPECT_EQ(1, Factorial(1)); EXPECT_EQ(2, Factorial(2)); EXPECT_EQ(6, Factorial(3)); EXPECT_EQ(40320, Factorial(8)); } int main(int argc, char* argv[]) { testing::InitGoogleTest(&argc,argv); //用来处理Test相关的命令行开关,如果不关注也可不加 RUN_ALL_TESTS(); //看函数名就知道干啥了 std::cin.get(); //只是让它暂停而已,不然一闪就没了 return 0; }
2.多个测试场景需要相同数据配置的情况,用TEST_F
//用TEST_F做同配置的系列测试 typedef std::basic_string<TCHAR> tstring; struct FooTest : testing::Test { //这里定义要测试的东东 tstring strExe; //可以利用构造、析构来初始化一些参数 FooTest() {} virtual ~FooTest() {} //如果构造、析构还不能满足你,还有下面两个虚拟函数 virtual void SetUp() { // 在构造后调用 strExe.resize(MAX_PATH); GetModuleFileName(NULL, &strExe[0], MAX_PATH); } virtual void TearDown() { } // 在析构前调用 }; tstring getfilename(const tstring &full) //偶写的从完整路径里取出文件名的函数(路径分隔符假定为'\\') { return full.substr(full.rfind(_T('\\'))); } tstring getpath(const tstring &full) //偶写的从完整路径里取出路径名的函数(Windows路径) { return full.substr(0, full.rfind(_T('\\'))); } TEST_F(FooTest, Test_GFN) //测试getfilename函数 { EXPECT_STREQ(_T("Projectexe"), getfilename(strExe).c_str()); } TEST_F(FooTest, Test_GP) //测试getpath函数 { EXPECT_STREQ(_T("D:\\Code\\libs\\google\\gtest-1\\BCC_SPC\\bcc\\ex"), getpath(strExe).c_str()); } int main(int argc, TCHAR* argv[]) //主函数还是一样地 { testing::InitGoogleTest(&argc,argv); RUN_ALL_TESTS(); std::cin.get(); return 0; }
快速入门:
Google提供了两种断言形式,一种以ASSERT_开头,另一种以EXPECT_开头,它们的区别是ASSERT_*一旦失败立马退出,而EXPECT_还能继续下去。
断言列表:
真假条件测试:
致命断言 | 非致命断言 | 验证条件 |
ASSERT_TRUE(condition ); | EXPECT_TRUE(condition ); | condition 为真 |
ASSERT_FALSE(condition ); | EXPECT_FALSE(condition ); | condition 为假 |
数据对比测试:
致命断言 | 非致命断言 | 验证条件 |
ASSERT_EQ(期望值 , 实际值 ); | EXPECT_EQ(期望值 , 实际值 ); | 期望值 == 实际值 |
ASSERT_NE(val1 , val2 ); | EXPECT_NE(val1 , val2 ); | val1 != val2 |
ASSERT_LT(val1 , val2 ); | EXPECT_LT(val1 , val2 ); | val1 < val2 |
ASSERT_LE(val1 , val2 ); | EXPECT_LE(val1 , val2 ); | val1 <= val2 |
ASSERT_GT(val1 , val2 ); | EXPECT_GT(val1 , val2 ); | val1 > val2 |
ASSERT_GE(val1 , val2 ); | EXPECT_GE(val1 , val2 ); | val1 >= val2 |
字符串(针对C形式的字符串,即char*或wchar_t*)对比测试:
致命断言 | 非致命断言 | 验证条件 |
ASSERT_STREQ(expected_str , actual_str ); | EXPECT_STREQ(expected_str , actual_str ); | 两个C字符串有相同的内容 |
ASSERT_STRNE(str1 , str2 ); | EXPECT_STRNE(str1 , str2 ); | 两个C字符串有不同的内容 |
ASSERT_STRCASEEQ(expected_str , actual_str ); | EXPECT_STRCASEEQ(expected_str , actual_str ); | 两个C字符串有相同的内容,忽略大小写 |
ASSERT_STRCASENE(str1 , str2 ); | EXPECT_STRCASENE(str1 , str2 ); | 两个C字符串有不同的内容,忽略大小写 |
TEST宏:
TEST宏的作用是创建一个简单测试,它定义了一个测试函数,在这个函数里可以使用任何C++代码并使用上面提供的断言来进行检查。
TEST的第一个 参数是测试用例名,第二个 参数是测试用例中某项测试的名称。一个测试用例可以包含任意数量的独立测试。这两个参数组成了一个测试的全称。
就前面的例子来说:
我们要测试这个函数:int Factorial(int n); // 返回n的阶乘
我们的测试用例是:测试输入0的情况,测试输入其它数据的情况,于是就有了:
Google Test根据测试用例来分组收集测试结果,因此,逻辑相关的测试应该在同一测试用例中;换句话说,它们的TEST()的第一个参数应该是一样的。在上面的 例子中,我们有两个测试,ZeroInput和OtherInput,它们都属于同一个测试用例TestFactorial。
TEST_F宏:
TEST_F宏用于在多个测试中使用同样的数据配置,所以它又叫:测试夹具(Test Fixtures)
如果我们的多个测试要使用相同的数据(如前例中,我们的Test_GFN和Test_GP都使用程序自身的完整文件名来测试),就可以采用一个测试夹具。
要创建测试固件,只需:
当我们要使用固件时,使用TEST_F()替换掉TEST(),它允许我们存取测试固件中的对象和子程序:
TEST_F(test_case_name, test_name) {
... test body ...
}
与TEST()一样,第一个参数是测试用例的名称,但对TEST_F()来说,这个名称必须与测试夹具类的名称一样。
对于TEST_F()中定义的每个 测试,Google Test将会:
注意,同一测试用例中,不同的测试拥有不同的测试夹具。Google Test不会对多个测试重用一个测试夹具,测试对测试夹具的改动并不会影响到其他测试。
调用测试
TEST()和TEST_F()向Google Test隐式注册它们的测试。因此,与很多其他的C++测试框架不同,你不需要为了运行你定义的测试而将它们全部再列出来一次。
在定义好测试后,你可以通过RUN_ALL_TESTS()来运行它们,如果所有测试成功,该函数返回0,否则会返回1.注意RUN_ALL_TESTS()会运行你链接到的所有测试——它们可以来自不同的测试用例,甚至是来自不同的文件。
当被调用时,RUN_ALL_TESTS()宏会:
此外,如果第二步时,测试夹具的构造函数产生一个致命错误,继续执行3至5部显然没有必要,所以它们会被跳过。与之相似,如果第3部产生致命错误,第4部也会被跳过。
重要:你不能忽略掉RUN_ALL_TESTS()的返回值,否则gcc会报一个编译错误。这样设计的理由是自动化测试服务会根据测试退出返回码来 决定一个测试是否通过,而不是根据其stdout/stderr输出;因此你的main()函数必须返回RUN_ALL_TESTS()的值。
而且,你应该只调用RUN_ALL_TESTS()一次。多次调用该函数会与Google Test的一些高阶特性(如线程安全死亡测试thread-safe death tests)冲突,因而是不被支持的。
编写 main() 函数
你可以从下面这个模板开始:
testing::InitGoogleTest() 函数负责解析命令行传入的Google Test标志,并删除所有它可以处理的标志。这使得用户可以通过各种不同的标志控制一个测试程序的行为。关于这一点我们会在GTestAdvanced中 讲到。你必须在调用RUN_ALL_TESTS()之前调用该函数,否则就无法正确地初始化标示。
在Windows上InitGoogleTest()可以支持宽字符串,所以它也可以被用在以UNICODE模式编译的程序中。
Google test for mingw 下载:
http://www.cppprog.com/2009/0101/26.html
Google test for bcb 下载:
http://www.cppprog.com/2009/0101/27.html