使用 Google Test 测试框架 | Senlin's Blog

如何安装

$ git clone https://github.com/google/googletest.git
$ cd googletest
$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install

安装 gtest 之后，要怎样在 CMake 中使用 gtest 呢？让我们用一个简单的例子演示一下，首先编写项目的 CMakeLists.txt 文件：

cmake_minimum_required (VERSION 2.8)
project(code-for-blog)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -std=c++11 -Wall")
find_package(GTest REQUIRED)
find_package(Threads REQUIRED)
include_directories(${GTEST_INCLUDE_DIRS})
add_executable(MyTests test.cpp)
target_link_libraries(MyTests ${GTEST_BOTH_LIBRARIES})
target_link_libraries(MyTests ${CMAKE_THREAD_LIBS_INIT})
add_test(Test MyTests)
enable_testing()

接着编写一个简单的单元测试文件 test.cpp：

#include <gtest/gtest.h>
#include <numeric>
#include <vector>
// 测试集为 MyTest，测试案例为 Sum
TEST(MyTest, Sum)
{
    std::vector<int> vec{1, 2, 3, 4, 5};
    int sum = std::accumulate(vec.begin(), vec.end(), 0);
    EXPECT_EQ(sum, 15);
}
int main(int argc, char *argv[])
{
    ::testing::InitGoogleTest(&argc, argv);
    return RUN_ALL_TESTS();
}

编译好项目之后，使用命令 make test 就可以执行单元测试了：

$ make test
Running tests...
Test project /Users/senlin/my-test/build
    Start 1: Test
1/1 Test #1: Test .............................   Passed    0.01 sec
100% tests passed, 0 tests failed out of 1
Total Test time (real) =   0.01 sec

简单的测试

gtest 提供了 TEST() 宏，用来定义测试函数：

TEST(test_suite_name, test_case_name) 
{
    // test body ...
}

在测试函数中，gtest 提供了 EXPECT_* 和 ASSERT_* 这两种风格的断言：

TEST(MyTest, Add) 
{
    EXPECT_EQ(1 + 1, 2);
    ASSERT_EQ(1 + 1, 2);
}

那么这两种断言有什么区别呢？如果 ASSERT_* 执行失败了，会导致当前的测试函数立即返回。而 EXPECT_* 如果执行失败了，并不会导致测试函数返回。
gtest 提供了 8 个 ASSERT_* 断言，分别是 ASSERT_TRUE() 、 ASSERT_FALSE() 、 ASSERT_EQ() 、 ASSERT_NE() 、 ASSERT_LT() 、 ASSERT_LE() 、 ASSERT_GT() 和 ASSERT_GE() 。
EXPECT_* 的断言同样也有 8 个，分别是 ASSERT_TRUE() 、 ASSERT_FALSE() 、 EXPECT_EQ() 、 EXPECT_NE() 、 EXPECT_LT() 、 EXPECT_LE() 、 EXPECT_GT() 和 EXPECT_GE() 。

在测试函数之间共享数据

有时候，我们不可避免地会在多个测试函数中操作相同的数据，例如：

TEST(MyTest, Sum)
{
    std::vector<int> vec;
    vec.push_back(1);
    vec.push_back(2);
    EXPECT_EQ(3, std::accumulate(vec.begin(), vec.end(), 0));
}
TEST(MyTest, Size)
{
    std::vector<int> vec;
    vec.push_back(1);
    vec.push_back(2);
    EXPECT_EQ(2, vec.size());
}

一种更好的做法，是将初始化数据在多个测试函数之间共享，并且每个测试函数都拥有这些数据的一份副本，也就是说，在一个测试函数中修改数据，并不会影响到其它测试函数。例如，下面我们定义一个 VectorTest 类，它的数据成员 vec 可以在多个测试函数之间共享：

#include <gtest/gtest.h>
#include <vector>
class VectorTest : public testing::Test
{
protected:
    virtual void SetUp() override
    {
        vec.push_back(1);
        vec.push_back(2);
        vec.push_back(3);
    }
    std::vector<int> vec;
};
// 注意这里使用 TEST_F，而不是 TEST
TEST_F(VectorTest, PushBack)
{
    // 虽然这里修改了 vec，但对其它测试函数来说是不可见的
    vec.push_back(4);
    EXPECT_EQ(vec.size(), 4);
    EXPECT_EQ(vec.back(), 4);
}
TEST_F(VectorTest, Size)
{
    EXPECT_EQ(vec.size(), 3);
}
int main(int argc, char *argv[])
{
    ::testing::InitGoogleTest(&argc, argv);
    return RUN_ALL_TESTS();
}

可以看到，我们用 SetUp() 来初始化资源，如果有必要，还可以使用 TearDown() 来释放资源：

class SomeTest : public ::testing::Test 
{
protected:
    virtual void SetUp() override 
    {
        // ...
    }
	
    virtual void TearDown() override 
    {	
        // ...	
    }	
};

Introduction: Why Google C++ Testing Framework?