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对象， 然后在后面的测试中进行校验。