googletest （gtest）的使用方法
最近在项目中， 碰到一些问题， 发现无法从集成测试来覆盖， 比较合适的办法就是通过单元测试， 就顺便研究了一下Google test的使用方法。
Google test是一种比较方便的C++测试框架， 它能够帮助我们比较方便的进行测试代码的编写, 以及输出尽可能详细的失败信息。能够大大缩短我们测试代码的编写效率， 而且该框架的使用方法也比较简单， 能够降低我们学习新框架的负担。
编译、安装
$ git clone https://github.com/google/googletest.git
$ cd googletest
$ mkdir mybuild
$ cd mybuild
$ cmake -Dgtest_build_tests=on -DCMAKE_INSTALL_PREFIX=. ..
$ make; make install经过编译之后， 在mybuild目录下面， 产生了lib 和include目录， 有我们需要的头文件：include/gtest/gtest.h 以及静态库： lib/libgtest.a。
断言/宏测试
Google Test采用一系列的断言（assertion）来进行代码测试，这些宏有点类似于函数调用。
当断言失败时Google Test将会打印出assertion时的源文件和出错行的位置，以及附加的失败信息，
用户可以直接通过“<<”在这些断言宏后面跟上自己希望在断言命中时的输出信息。
测试宏可以分为两大类：ASSERT_*和EXPECT_*，这些成对的断言功能相同，但效果不同。其中ASSERT_*将会在失败时产生致命错误并中止当前调用它的函数执行。EXPECT_*版本的会生成非致命错误，不会中止当前函数，而是继续执行当前函数。通常情况应该首选使用EXPECT_*，因为ASSERT_*在报告完错误后不会进行清理工作，有可能导致内容泄露问题。
基本断言
| Fatal assertion | Nonfatal assertion | Verifies |
|---|---|---|
| ASSERT_TRUE(condition); | EXPECT_TRUE(condition); | condition is true |
| ASSERT_FALSE(condition); | EXPECT_FALSE(condition); | condition is false |
二值比较
| Fatal assertion | Nonfatal assertion | Verifies |
|---|---|---|
| ASSERT_EQ(val1,val2); | EXPECT_EQ(val1,val2); | val1 == val2 |
| 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 |
字符串比较
| Fatal assertion | Nonfatal assertion | Verifies |
|---|---|---|
| ASSERT_STREQ(str1,str2); | EXPECT_STREQ(str1,str2); | the two C strings have the same content |
| ASSERT_STRNE(str1,str2); | EXPECT_STRNE(str1,str2); | the two C strings have different content |
| ASSERT_STRCASEEQ(str1,str2); | EXPECT_STRCASEEQ(str1,str2); | the two C strings have the same content, ignoring case |
| ASSERT_STRCASENE(str1,str2); | EXPECT_STRCASENE(str1,str2); | the two C strings have different content, ignoring case |
TEST测试用例
TEST是基本的测试方式， 我们传进测试函数的名字， 调用ASSERT_XX或者EXPECT_XX来测试函数的执行结构和我们预期的是否一致。
#include "util.h"
#include "gtest/gtest.h"
TEST(Int2Str, testInt2Str)
{
std::string intstr = Int2Str(100);
std::string handrud = "100";
ASSERT_STREQ(intstr.c_str(), handrud.c_str());
}
这里， 我们要测试的函数Int2Str， 定义在 util.h里面， 它接收一个int参数， 并把int整数转换为一个字符串。在上面的例子里面， 我们传入整数100， 预期转换以后的结构是“100”， 然后调用ASSERT_STREQ来判断。
TEST_F测试用例
有时候我们希望传入的参数是一个class的对象， 并且该对象在传入之前进行了一定的出配置， 并且有好几个函数的测试都需要用到相同的配置， 为了避免重复， Googletest 提供了TEST_F 的测试方式。
#include "log.h"
#include "gtest/gtest.h"
class LogTest : public ::testing::Test {
public:
std::string GetLevelStr() {
return mlog::GetLevelStr();
}
protected:
virtual void SetUp()
{
log_ptr = new mlog::Log(mlog::kInfo);
}
virtual void TearDown()
{
delete log_ptr;
}
private:
mlog::Log* log_ptr;
};
TEST_F(LogTest, TestLog)
{
std::string levelStr = GetLevelStr();
std::string expected = "Info";
ASSERT_STRCASEEQ(levelStr.c_str(), expected.c_str());
}
这里， 我们在测试之前先产生一个LogTest对象， 它是一个mlog::Log对象的代理类， 在这里我们先创建一个Infolevel的Log对象， 然后在后面的测试中进行校验。