当前位置: 首页 > 工具软件 > GoogleTest > 使用案例 >

googletest (gtest)的使用方法

吉玉宸
2023-12-01

最近在项目中, 碰到一些问题, 发现无法从集成测试来覆盖, 比较合适的办法就是通过单元测试, 就顺便研究了一下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 assertionNonfatal assertionVerifies
ASSERT_TRUE(condition);EXPECT_TRUE(condition);condition is true
ASSERT_FALSE(condition);EXPECT_FALSE(condition);condition is false

二值比较

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

 类似资料: