很早就接触了google C/C++自动化测试框架gtest, 现在偶然用起有时候还需要简单温习下步骤。今天在这里做下简单使用记录。
1. 使用版本
gtest-1.7.0
2. gtest 安装
./configure
make
3. 测试自带的用例
gtest工具自带的测试用例放在了目录samples下 [wln@localhost gtest-1.7.0]$ cd samples/
[wln@localhost samples]$ ll
总计 148
-rw-rw-r– 1 wln wln 887 09-25 16:57 libsamples.la
-r–r–r– 1 wln wln 4072 2013-09-19 prime_tables.h
-r–r–r– 1 wln wln 5053 2013-09-19 sample10_unittest.cc
-r–r–r– 1 wln wln 2502 2013-09-19 sample1.cc
-r–r–r– 1 wln wln 1937 2013-09-19 sample1.h
-rw-rw-r– 1 wln wln 303 09-25 16:57 sample1.lo
-rw-rw-r– 1 wln wln 3004 09-25 16:57 sample1.o
-r–r–r– 1 wln wln 5129 2013-09-19 sample1_unittest.cc
-r–r–r– 1 wln wln 2298 2013-09-19 sample2.cc
-r–r–r– 1 wln wln 3006 2013-09-19 sample2.h
-rw-rw-r– 1 wln wln 303 09-25 16:57 sample2.lo
-rw-rw-r– 1 wln wln 4236 09-25 16:57 sample2.o
-r–r–r– 1 wln wln 3926 2013-09-19 sample2_unittest.cc
-r–r–r– 1 wln wln 5365 2013-09-19 sample3-inl.h
-r–r–r– 1 wln wln 5351 2013-09-19 sample3_unittest.cc
-r–r–r– 1 wln wln 1927 2013-09-19 sample4.cc
-r–r–r– 1 wln wln 2083 2013-09-19 sample4.h
-rw-rw-r– 1 wln wln 303 09-25 16:57 sample4.lo
-rw-rw-r– 1 wln wln 5028 09-25 16:57 sample4.o
-r–r–r– 1 wln wln 1909 2013-09-19 sample4_unittest.cc
-r–r–r– 1 wln wln 6590 2013-09-19 sample5_unittest.cc
-r–r–r– 1 wln wln 8989 2013-09-19 sample6_unittest.cc
-r–r–r– 1 wln wln 5099 2013-09-19 sample7_unittest.cc
-r–r–r– 1 wln wln 6944 2013-09-19 sample8_unittest.cc
-r–r–r– 1 wln wln 5951 2013-09-19 sample9_unittest.cc
进入make目录下 [wln@localhost make]$ ll
总计 4
-r–r–r– 1 wln wln 2753 2013-09-19 Makefile
执行操作
[wln@localhost make]$ make
g++ -isystem ../include -g -Wall -Wextra -pthread -c ../samples/sample1.cc
g++ -isystem ../include -g -Wall -Wextra -pthread -c ../samples/sample1_unittest.cc
g++ -isystem ../include -I.. -g -Wall -Wextra -pthread -c \
../src/gtest-all.cc
In file included from ../src/gtest-all.cc:43:
../src/gtest.cc:370: 警告:成员‘testing::internal::MutexBase::owner_’缺少初始值设定
g++ -isystem ../include -I.. -g -Wall -Wextra -pthread -c \
../src/gtest_main.cc
ar rv gtest_main.a gtest-all.o gtest_main.o
ar: creating gtest_main.a
a – gtest-all.o
a – gtest_main.o
g++ -isystem ../include -g -Wall -Wextra -pthread -lpthread sample1.o sample1_unittest.o gtest_main.a -o sample1_unittest
[wln@localhost make]$ ll
总计 5192
-rw-rw-r– 1 wln wln 1797004 09-25 16:57 gtest-all.o
-rw-rw-r– 1 wln wln 1951104 09-25 16:57 gtest_main.a
-rw-rw-r– 1 wln wln 48284 09-25 16:57 gtest_main.o
-r–r–r– 1 wln wln 2753 2013-09-19 Makefile
-rw-rw-r– 1 wln wln 2684 09-25 16:57 sample1.o
-rwxrwxr-x 1 wln wln 1289739 09-25 16:57 sample1_unittest
-rw-rw-r– 1 wln wln 197680 09-25 16:57 sample1_unittest.o
进行测试
[wln@localhost make]$ ./sample1_unittest
Running main() from gtest_main.cc
[==========] Running 6 tests from 2 test cases.
[———-] Global test environment set-up.
[———-] 3 tests from FactorialTest
[ RUN ] FactorialTest.Negative
[ OK ] FactorialTest.Negative (0 ms)
[ RUN ] FactorialTest.Zero
[ OK ] FactorialTest.Zero (0 ms)
[ RUN ] FactorialTest.Positive
[ OK ] FactorialTest.Positive (0 ms)
[———-] 3 tests from FactorialTest (0 ms total)
[———-] 3 tests from IsPrimeTest
[ RUN ] IsPrimeTest.Negative
[ OK ] IsPrimeTest.Negative (0 ms)
[ RUN ] IsPrimeTest.Trivial
[ OK ] IsPrimeTest.Trivial (0 ms)
[ RUN ] IsPrimeTest.Positive
[ OK ] IsPrimeTest.Positive (0 ms)
[———-] 3 tests from IsPrimeTest (0 ms total)
[———-] Global test environment tear-down
[==========] 6 tests from 2 test cases ran. (1 ms total)
[ PASSED ] 6 tests.
ok, 测试自带用例完毕,具体测试内容请参考sample1.cc,sample1.h,sample1_unittest.cc
4. 手动编写测试用例
首先需要知道gtest测试框架所自带的函数等内容应该怎么使用,比如EXPECT_EQ(),单元测试用例名称TEST(fun1,fun1_test) 其中TEST是格式写法,fun1可以称为单元测试用例标识符,fun1_test则为要测试的函数名称。具体内容自行查看。
文件fun.h
#ifndef __FUN_H
#define __FUN_H
int fun_test(char *buf);
int add(int a, int b);
#endif
文件fun.cc
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include "fun.h"
int fun_test(char *buf)
{
if(buf == NULL)
{
printf("error occur.\n");
abort();
}
printf("%s\n",buf);
return strlen(buf);
}
int add(int a, int b)
{
return a+b;
}
文件fun_unittest.cc
#include "fun.h"
#include <gtest/gtest.h>
TEST(fun,fun_test)
{
//fun_test(NULL);
fun_test("hello world");
}
TEST(fun3,add)
{
EXPECT_EQ(2,add(1,2));
}
5. 手动编译测试
fun.o文件:
[wln@localhost samples]$ gcc -c fun.h fun.cc
可执行文件 fun_unittest
[wln@localhost samples]$ g++ -g -Wall -o fun_unittest fun.o fun_unittest.cc ../make/gtest_main.a -I/home/wln/gtest/gtest-1.7.0/include -lpthread
fun_unittest.cc: In member function ‘virtual void fun_fun_test_Test::TestBody()’:
fun_unittest.cc:6: 警告:不建议使用从字符串常量到‘char*’的转换
[wln@localhost samples]$ ll
总计 1876
-rw-r–r– 1 wln wln 278 09-25 17:12 fun.cc
-rw-r–r– 1 wln wln 87 09-25 17:19 fun.h
-rw-rw-r– 1 wln wln 635112 09-25 17:23 fun.h.gch
-rw-rw-r– 1 wln wln 1220 09-25 17:23 fun.o
-rwxrwxr-x 1 wln wln 1256752 09-25 17:26 fun_unittest
-rw-r–r– 1 wln wln 170 09-25 17:13 fun_unittest.cc
[wln@localhost samples]$ ./fun_unittest
Running main() from gtest_main.cc
[==========] Running 2 tests from 2 test cases.
[———-] Global test environment set-up.
[———-] 1 test from fun
[ RUN ] fun.fun_test
hello world
[ OK ] fun.fun_test (0 ms)
[———-] 1 test from fun (1 ms total)
[———-] 1 test from fun3
[ RUN ] fun3.add
fun_unittest.cc:12: Failure
Value of: add(1,2)
Actual: 3
Expected: 2
[ FAILED ] fun3.add (0 ms)
[———-] 1 test from fun3 (0 ms total)
[———-] Global test environment tear-down
[==========] 2 tests from 2 test cases ran. (1 ms total)
[ PASSED ] 1 test.
[ FAILED ] 1 test, listed below:
[ FAILED ] fun3.add
1 FAILED TEST
6. 利用Makefile
Makefile文件
# A sample Makefile for building Google Test and using it in user
# tests. Please tweak it to suit your environment and project. You
# may want to move it to your project's root directory.
#
# SYNOPSIS:
#
# make [all] - makes everything.
# make TARGET - makes the given target.
# make clean - removes all files generated by make.
# Please tweak the following variable definitions as needed by your
# project, except GTEST_HEADERS, which you can use in your own targets
# but shouldn't modify.
# Points to the root of Google Test, relative to where this file is.
# Remember to tweak this if you move this file.
GTEST_DIR = ..
# Where to find user code.
USER_DIR = ../samples
# Flags passed to the preprocessor.
# Set Google Test's header directory as a system directory, such that
# the compiler doesn't generate warnings in Google Test headers.
CPPFLAGS += -isystem $(GTEST_DIR)/include
# Flags passed to the C++ compiler.
CXXFLAGS += -g -Wall -Wextra -pthread
# All tests produced by this Makefile. Remember to add new tests you
# created to the list.
TESTS = fun_unittest
# All Google Test headers. Usually you shouldn't change this
# definition.
GTEST_HEADERS = $(GTEST_DIR)/include/gtest/*.h \
$(GTEST_DIR)/include/gtest/internal/*.h
# House-keeping build targets.
all : $(TESTS)
clean :
rm -f $(TESTS) gtest.a gtest_main.a *.o
# Builds gtest.a and gtest_main.a.
# Usually you shouldn't tweak such internal variables, indicated by a
# trailing _.
GTEST_SRCS_ = $(GTEST_DIR)/src/*.cc $(GTEST_DIR)/src/*.h $(GTEST_HEADERS)
# For simplicity and to avoid depending on Google Test's
# implementation details, the dependencies specified below are
# conservative and not optimized. This is fine as Google Test
# compiles fast and for ordinary users its source rarely changes.
gtest-all.o : $(GTEST_SRCS_)
$(CXX) $(CPPFLAGS) -I$(GTEST_DIR) $(CXXFLAGS) -c \
$(GTEST_DIR)/src/gtest-all.cc
gtest_main.o : $(GTEST_SRCS_)
$(CXX) $(CPPFLAGS) -I$(GTEST_DIR) $(CXXFLAGS) -c \
$(GTEST_DIR)/src/gtest_main.cc
gtest.a : gtest-all.o
$(AR) $(ARFLAGS) $@ $^
gtest_main.a : gtest-all.o gtest_main.o
$(AR) $(ARFLAGS) $@ $^
# Builds a sample test. A test should link with either gtest.a or
# gtest_main.a, depending on whether it defines its own main()
# function.
fun.o : $(USER_DIR)/fun.cc $(USER_DIR)/fun.h $(GTEST_HEADERS)
$(CXX) $(CPPFLAGS) $(CXXFLAGS) -c $(USER_DIR)/fun.cc
fun_unittest.o : $(USER_DIR)/fun_unittest.cc \
$(USER_DIR)/fun.h $(GTEST_HEADERS)
$(CXX) $(CPPFLAGS) $(CXXFLAGS) -c $(USER_DIR)/fun_unittest.cc
fun_unittest : fun.o fun_unittest.o gtest_main.a
$(CXX) $(CPPFLAGS) $(CXXFLAGS) -lpthread $^ -o $@
执行测试
[wln@localhost make]$ make
g++ -isystem ../include -g -Wall -Wextra -pthread -c ../samples/fun.cc
g++ -isystem ../include -g -Wall -Wextra -pthread -c ../samples/fun_unittest.cc
../samples/fun_unittest.cc: In member function ‘virtual void fun_fun_test_Test::TestBody()’:
../samples/fun_unittest.cc:6: 警告:不建议使用从字符串常量到‘char*’的转换
g++ -isystem ../include -I.. -g -Wall -Wextra -pthread -c \
../src/gtest-all.cc
In file included from ../src/gtest-all.cc:43:
../src/gtest.cc:370: 警告:成员‘testing::internal::MutexBase::owner_’缺少初始值设定
g++ -isystem ../include -I.. -g -Wall -Wextra -pthread -c \
../src/gtest_main.cc
ar rv gtest_main.a gtest-all.o gtest_main.o
ar: creating gtest_main.a
a – gtest-all.o
a – gtest_main.o
g++ -isystem ../include -g -Wall -Wextra -pthread -lpthread fun.o fun_unittest.o gtest_main.a -o fun_unittest
[wln@localhost make]$ ./fun_unittest
Running main() from gtest_main.cc
[==========] Running 2 tests from 2 test cases.
[———-] Global test environment set-up.
[———-] 1 test from fun
[ RUN ] fun.fun_test
hello world
[ OK ] fun.fun_test (0 ms)
[———-] 1 test from fun (0 ms total)
[———-] 1 test from fun3
[ RUN ] fun3.add
../samples/fun_unittest.cc:12: Failure
Value of: add(1,2)
Actual: 3
Expected: 2
[ FAILED ] fun3.add (0 ms)
[———-] 1 test from fun3 (0 ms total)
[———-] Global test environment tear-down
[==========] 2 tests from 2 test cases ran. (0 ms total)
[ PASSED ] 1 test.
[ FAILED ] 1 test, listed below:
[ FAILED ] fun3.add
1 FAILED TEST
gtest测试框架的使用粗略的介绍完了,达到能用的目的,用好还需要多阅读相关内容。
参考:
1.http://www.cnblogs.com/coderzh/archive/2009/03/31/1426758.html