基于gtest、mockcpp写C++LLT测试入门级教程

一、googletest

下载地址：https://github.com/google/googletest

编译googletest:
在根目录下执行
cmake .
make

编译出的libgtest.a后面用
注意：有可能编译会失败，是gtest需要C++11以上 可以在顶级的CMakeList.txt里加入 set(CMAKE_CXX_STANDARD 11)

二、mockcpp

googletest中也有gmock，但是gmock其实只能用于对对象函数的mocker，不能对C代码中的一般函数进行mcoker，因此用了mockcpp
下载地址：https://code.google.com/archive/p/mockcpp/downloads
官方手册：https://code.google.com/p/mockcpp
中文手册：https://blog.csdn.net/tony_wong/article/details/38752355
编译mockcpp：
cmake .
make install

可以看到上图编译完成后生成了一个libmockcpp.a

三、写测试用例

①第一个gtest程序
frame.h

#ifndef __FRAME_H__
#define __FRAME_H__

namespace Frameuitl {
int add(int a, int b);
}
#endif

frame.cpp

#include "frame.h"

namespace Frameuitl {
int add(int a, int b)
{
	return a + b;
}
}

main.cpp

#include <iostream>
#include "gtest/gtest.h"
#include "frame/frame.h"

TEST(TestAdd, TestCase1)
{
    EXPECT_EQ(5, Frameuitl::add(2, 3));
}

TEST(TestAdd, TestCase2)
{
    EXPECT_EQ(6, Frameuitl::add(2, 3));
}

int main(int argc, char **argv)
{
	std::cout << "gtest begin.." << std::endl;
	testing::InitGoogleTest(&argc, argv);
	return RUN_ALL_TESTS();
}

上面是测试代码，TEST(TestAdd, TestCase1)定义了一个测试用例，EXPECT_EQ 第一个入参表示预期结果，第二个入参是要测试的接口。
目录结构如下LLT_demon_1/third_party用来放gtest、mockcpp的头文件及静态库；LLT_demon_1/common是需要测试的公共接口，LLT_demon_1/src/test是gtest测试代码

LLT_demon_1
├── bin
│   ├── main
│   └── test_main
├── build
├── CMakeLists.txt
├── common
│   ├── CMakeLists.txt
│   └── frame
│       ├── frame.cpp
│       └── frame.h
├── libs
│   └── libframe.a
├── README.md
├── src
│   ├── CMakeLists.txt
│   ├── main
│   │   ├── CMakeLists.txt
│   │   └── main.cpp
│   └── test
│       ├── CMakeLists.txt
│       └── main.cpp
└── third_party
    ├── googletest
    │   └── include
    │       └── gtest
    ├── libs
    │   ├── libgtest.a
    │   └── libmockcpp.a
    └── mockcpp
        └── include
            └── mockcpp

经过编译测试代码生成test_main,执行后运行结果如下：

可以看到main.cpp中两个测试用例 TestCase1通过 ，TestCase2失败

②第一个mockcpp程序
因为接口中可能会调用到其他接口，所以需要自定义接口模拟下其他接口的行为。
场景如：你的接口中调用了一个查询数据库的接口或者发消息给另外一个进程获取某些资源

1、mockcpp编译需要依赖boost，环境需要安装boost
命令：sudo apt-get install libboost-dev
2、mockcpp编译需要依赖python2
如果是其他版本python会有语法报错 如：mockcpp/src/get_long_opt.py", line 29 print sys.argv[0], getUsageString(longOpts)
3、mockcpp定义了static_assert，而C++11引入了static_assert，重定义了，编译会报错
mockcpp/mockcpp.h:59:8: error: expected identifier before ‘static_assert’
解决办法：注释掉mockcpp.h中的static_assert
#if __cplusplus < 199711L
…
struct static_assert
…
#endif

func.cpp

#include "frame.h"

namespace Frameuitl {
	
int add(int a, int b)
{
    sleep(10);
	return a + b;
}

}

main.cpp

#include <iostream>

#include "gtest/gtest.h"
#include <mockcpp/mockcpp.hpp>
#include "frame/frame.h"

inline unsigned int mok_sleep(unsigned int seconds) {
    std::cout << "running mok_sleep" << std::endl;
}

TEST(TestAdd, TestCase1)
{
    EXPECT_EQ(5, Frameuitl::add(2, 3));
}

TEST(TestAdd, TestCase2)
{
    MOCKER(sleep).stubs().will(invoke(mok_sleep));
    EXPECT_EQ(5, Frameuitl::add(2, 3));
    GlobalMockObject::verify(); // 用来清理case中的Mock函数，如果不调用，这个Mock函数在整个cpp中都生效
}

int main(int argc, char **argv)
{
	std::cout << "gtest begin.." << std::endl;
	testing::InitGoogleTest(&argc, argv);
	return RUN_ALL_TESTS();
}

上面的例子，我们在TestCase2测试用例执行将add中调用的标准库函数sleep mock成日志打印，TestCase1用例没有mock，因此sleep了10秒，运行结果如下：

可能会有接口需要共用一个Mock函数，可以用下面的写法，所有的Mock函数都可以放在SetUp()中,这种方法减少了mock次数，通过内存换时间，提升LL速度：

#include <iostream>

#include "gtest/gtest.h"
#include <mockcpp/mockcpp.hpp>
#include "frame/frame.h"

inline unsigned int mok_sleep(unsigned int seconds) {
    std::cout << "running mok_sleep" << std::endl;
}

class FooEnvironment : public testing::Environment
{
public:
    void SetUp() override {
        MOCKER(sleep).stubs().will(invoke(mok_sleep));
    }

    void TearDown() {
    }
};

TEST(TestAdd, TestCase1)
{
    EXPECT_EQ(5, Frameuitl::add(2, 3));
}

TEST(TestAdd, TestCase2)
{
    EXPECT_EQ(5, Frameuitl::add(2, 3));
}

int main(int argc, char **argv)
{
	std::cout << "gtest begin.." << std::endl;
    testing::AddGlobalTestEnvironment(new FooEnvironment());
	testing::InitGoogleTest(&argc, argv);
	return RUN_ALL_TESTS();
}

• 通过gcov+lcov查看代码覆盖率

参考资料：
https://blog.csdn.net/xueyong4712816/article/details/34086649
http://www.voidcn.com/article/p-yxgtonll-gn.html
http://t.zoukankan.com/heimianshusheng-p-13530672.html
https://cloud.tencent.com/developer/article/1552518?from=information.detail.mockcpp
https://www.cnblogs.com/coderzh/archive/2009/04/06/1430364.html
https://blog.csdn.net/russell_tao/article/details/7333226