深入理解gtest C/C++單元測(cè)試經(jīng)驗(yàn)談
原創(chuàng)Google C++ Testing Framework(簡(jiǎn)稱gtest,http://code.google.com/p/googletest/)是Google公司發(fā)布的一個(gè)開(kāi)源C/C++單元測(cè)試框架,已被應(yīng)用于多個(gè)開(kāi)源項(xiàng)目及Google內(nèi)部項(xiàng)目中,知名的例子包括Chrome Web瀏覽器、LLVM編譯器架構(gòu)、Protocol Buffers數(shù)據(jù)交換格式及工具等。
優(yōu)秀的C/C++單元測(cè)試框架并不算少,相比之下gtest仍具有明顯優(yōu)勢(shì)。與CppUnit比,gtest需要使用的頭文件和函數(shù)宏更集中,并支持測(cè)試用例的自動(dòng)注冊(cè)。與CxxUnit比,gtest不要求Python等外部工具的存在。與Boost.Test比,gtest更簡(jiǎn)潔容易上手,實(shí)用性也并不遜色。Wikipedia給出了各種編程語(yǔ)言的單元測(cè)試框架列表(http://en.wikipedia.org/wiki/List_of_unit_testing_frameworks)。
一、基本用法
gtest當(dāng)前的版本是1.5.0,如果使用Visual C++編譯,要求編譯器版本不低于7.1(Visual C++ 2003)。如下圖所示,它的msvc文件夾包含Visual C++工程和項(xiàng)目文件,samples文件夾包含10個(gè)使用范例。
一般情況下,我們的單元測(cè)試代碼只需要包含頭文件gtest.h。gtest中常用的所有結(jié)構(gòu)體、類、函數(shù)、常量等,都通過(guò)命名空間testing訪問(wèn),不過(guò)gtest已經(jīng)把最簡(jiǎn)單常用的單元測(cè)試功能包裝成了一些帶參數(shù)宏,因此在簡(jiǎn)單的測(cè)試中常??梢院雎悦臻g的存在。
ASSERT宏
|
EXPECT宏
|
功能
|
ASSERT_TRUE
|
EXPECT_TRUE
|
判真
|
ASSERT_FALSE
|
EXPECT_FALSE
|
判假
|
ASSERT_EQ
|
EXPECT_EQ
|
相等
|
ASSERT_NE
|
EXPECT_NE
|
不等
|
ASSERT_GT
|
EXPECT_GT
|
大于
|
ASSERT_LT
|
EXPECT_LT
|
小于
|
ASSERT_GE
|
EXPECT_GE
|
大于或等于
|
ASSERT_LE
|
EXPECT_LE
|
小于或等于
|
ASSERT_FLOAT_EQ
|
EXPECT_FLOAT_EQ
|
單精度浮點(diǎn)值相等
|
ASSERT_DOUBLE_EQ
|
EXPECT_DOUBLE_EQ
|
雙精度浮點(diǎn)值相等
|
ASSERT_NEAR
|
EXPECT_NEAR
|
浮點(diǎn)值接近(第3個(gè)參數(shù)為誤差閾值)
|
ASSERT_STREQ
|
EXPECT_STREQ
|
C字符串相等
|
ASSERT_STRNE
|
EXPECT_STRNE
|
C字符串不等
|
ASSERT_STRCASEEQ
|
EXPECT_STRCASEEQ
|
C字符串相等(忽略大小寫(xiě))
|
ASSERT_STRCASENE
|
EXPECT_STRCASENE
|
C字符串不等(忽略大小寫(xiě))
|
ASSERT_PRED1
|
EXPECT_PRED1
|
自定義謂詞函數(shù),(pred, arg1)(還有_PRED2, ..., _PRED5)
|
- // add.h
- #pragma once
- inline int Add(int i, int j) { return i+j; }
- // add_unittest.cpp
- #include "add.h"
- #include <gtest/gtest.h>
- TEST(Add, 負(fù)數(shù)) {
- EXPECT_EQ(Add(-1,-2), -3);
- EXPECT_GT(Add(-4,-5), -6); // 故意的
- }
- TEST(Add, 正數(shù)) {
- EXPECT_EQ(Add(1,2), 3);
- EXPECT_GT(Add(4,5), 6);
- }
- ASSERT_EQ(M[i], N[j]) << "i = " << i << ", j = " << j;
- // gtest-main.cc
- int main(int argc, char **argv) {
- std::cout << "Running main() from gtest_main.cc\n";
- testing::InitGoogleTest(&argc, argv);
- return RUN_ALL_TESTS();
- }
- // add_unittest2.cpp
- #include "add.h"
- #include <stdio.h>
- #include <gtest/gtest.h>
- class AddTest: public testing::Test
- {
- public:
- virtual void SetUp() { puts("SetUp()"); }
- virtual void TearDown() { puts("TearDown()"); }
- };
- TEST_F(AddTest, 正數(shù)) {
- ASSERT_GT(Add(1,2), 3); // 故意的
- ASSERT_EQ(Add(4,5), 6); // 也是故意的
- }
- class Environment {
- public:
- virtual ~Environment() {}
- virtual void SetUp() {}
- virtual void TearDown() {}
- };
- Environment* AddGlobalTestEnvironment(Environment* env);
ASSERT宏
|
EXPECT宏
|
功能
|
ASSERT_NO_THROW
|
EXPECT_NO_THROW
|
不拋出異常,參數(shù)為(statement)
|
ASSERT_ANY_THROW
|
EXPECT_ANY_THROW
|
拋出異常,參數(shù)為(statement)
|
ASSERT_THROW
|
EXPECT_THROW
|
拋出特定類型的異常,參數(shù)為(statement, type)
|
- // divide.h
- #pragma once
- #include <stdexcept>
- int divide(int dividend, int divisor) {
- if(!divisor) {
- throw std::length_error("can't be divided by 0"); // 故意的
- }
- return dividend / divisor;
- }
- // divide-unittest.cpp
- #include <gtest/gtest.h>
- #include "./divide.h"
- TEST(Divide, ByZero) {
- EXPECT_NO_THROW(divide(-1, 2));
- EXPECT_ANY_THROW({
- int k = 0;
- divide(k, k);
- });
- EXPECT_THROW(divide(100000, 0), std::invalid_argument);
- }
- try {
- statement;
- }
- catch(type const&) {
- // throw
- }
- catch(...) {
- // any throw
- }
- // no throw
參數(shù)值序列生成函數(shù)
|
含義
|
Bool()
|
生成序列{false, true}
|
Range(begin, end[, step])
|
生成序列{begin, begin+step, begin+2*step, ...} (不含end),step默認(rèn)為1
|
Values(v1, v2, ..., vN)
|
生成序列{v1, v2, ..., vN}
|
ValuesIn(container), ValuesIn(iter1, iter2)
|
枚舉STL container,或枚舉迭代器范圍[iter1, iter2)
|
Combine(g1, g2, ..., gN)
|
生成g1, g2, ..., gN的笛卡爾積,其中g1, g2, ..., gN均為參數(shù)值序列生成函數(shù)(要求C++0x的<tr1/tuple>)
|
- // addupto.h
- #pragma once
- inline unsigned NaiveAddUpTo(unsigned n) {
- unsigned sum = 0;
- for(unsigned i = 1; i <= n; ++i) sum += i;
- return sum;
- }
- inline unsigned FastAddUpTo(unsigned n) {
- return n*(n+1)/2;
- }
- // addupto_test.cpp
- #include <gtest/gtest.h>
- #include "addupto.h"
- class AddUpToTest : public testing::TestWithParam<unsigned>
- {
- public:
- AddUpToTest() { n_ = GetParam(); }
- protected:
- unsigned n_;
- };
- TEST_P(AddUpToTest, Calibration) {
- EXPECT_EQ(NaiveAddUpTo(n_), FastAddUpTo(n_));
- }
- INSTANTIATE_TEST_CASE_P(
- NaiveAndFast, // prefix
- AddUpToTest, // test case name
- testing::Range(1u, 1000u) // parameters
- );