玩转Google开源C++单元测试框架Google Test系列(gtest)之六 - 运行参数 [转载]

最新推荐文章于 2023-06-28 15:04:34 发布
最新推荐文章于 2023-06-28 15:04:34 发布
阅读量683 收藏
点赞数
分类专栏： C / C++ 代码调试 文章标签： C++ googletest unittest
一、前言

使用gtest编写的测试案例通常本身就是一个可执行文件，因此运行起来非常方便。同时，gtest也为我们提供了一系列的运行参数（环境变量、命令行参数或代码里指定），使得我们可以对案例的执行进行一些有效的控制。

二、基本介绍

前面提到，对于运行参数，gtest提供了三种设置的途径：

1. 系统环境变量

2. 命令行参数

3. 代码中指定FLAG

因为提供了三种途径，就会有优先级的问题， 有一个原则是，最后设置的那个会生效。不过总结一下，通常情况下，比较理想的优先级为：

命令行参数 > 代码中指定FLAG > 系统环境变量

为什么我们编写的测试案例能够处理这些命令行参数呢？是因为我们在main函数中，将命令行参数交给了gtest，由gtest来搞定命令行参数的问题。

int  _tmain( int  argc, _TCHAR *  argv[])
{
    testing::InitGoogleTest( & argc, argv);
     return  RUN_ALL_TESTS();
}

 

这样，我们就拥有了接收和响应gtest命令行参数的能力。如果需要在代码中指定FLAG，可以使用testing::GTEST_FLAG这个宏来设置。比如相对于命令行参数--gtest_output，可以使用testing::GTEST_FLAG(output) = "xml:";来设置。注意到了，不需要加--gtest前缀了。同时，推荐将这句放置InitGoogleTest之前，这样就可以使得对于同样的参数，命令行参数优先级高于代码中指定。

复制代码
int  _tmain( int  argc, _TCHAR *  argv[])
{
    testing::GTEST_FLAG(output)  =   " xml: " ;
    testing::InitGoogleTest( & argc, argv);
     return  RUN_ALL_TESTS();
}
复制代码

 

最后再来说下第一种设置方式-系统环境变量。如果需要gtest的设置系统环境变量，必须注意的是：

1. 系统环境变量全大写，比如对于--gtest_output，响应的系统环境变量为：GTEST_OUTPUT

2.  有一个命令行参数例外，那就是--gtest_list_tests，它是不接受系统环境变量的。（只是用来罗列测试案例名称）

三、参数列表

了解了上面的内容，我这里就直接将所有命令行参数总结和罗列一下。如果想要获得详细的命令行说明，直接运行你的案例，输入命令行参数：/? 或 --help 或 -help

1. 测试案例集合

命令行参数说明
--gtest_list_tests使用这个参数时，将不会执行里面的测试案例，而是输出一个案例的列表。
--gtest_filter

对执行的测试案例进行过滤，支持通配符

?    单个字符

*    任意字符

-    排除，如，-a 表示除了a

:    取或，如，a:b 表示a或b

比如下面的例子：

./foo_test 没有指定过滤条件，运行所有案例
./foo_test --gtest_filter=* 使用通配符*，表示运行所有案例
./foo_test --gtest_filter=FooTest.* 运行所有“测试案例名称(testcase_name)”为FooTest的案例
./foo_test --gtest_filter=*Null*:*Constructor* 运行所有“测试案例名称(testcase_name)”或“测试名称(test_name)”包含Null或Constructor的案例。
./foo_test --gtest_filter=-*DeathTest.* 运行所有非死亡测试案例。
./foo_test --gtest_filter=FooTest.*-FooTest.Bar 运行所有“测试案例名称(testcase_name)”为FooTest的案例，但是除了FooTest.Bar这个案例

--gtest_also_run_disabled_tests

执行案例时，同时也执行被置为无效的测试案例。关于设置测试案例无效的方法为：

在测试案例名称或测试名称中添加DISABLED前缀，比如：

复制代码
//  Tests that Foo does Abc.
TEST(FooTest, DISABLED_DoesAbc) {  }

 class  DISABLED_BarTest :  public  testing::Test {  };

 //  Tests that Bar does Xyz.
TEST_F(DISABLED_BarTest, DoesXyz) {  }
复制代码
--gtest_repeat=[COUNT]

设置案例重复运行次数，非常棒的功能！比如：

--gtest_repeat=1000      重复执行1000次，即使中途出现错误。
--gtest_repeat=-1          无限次数执行。。。。
--gtest_repeat=1000 --gtest_break_on_failure     重复执行1000次，并且在第一个错误发生时立即停止。这个功能对调试非常有用。
--gtest_repeat=1000 --gtest_filter=FooBar     重复执行1000次测试案例名称为FooBar的案例。

 

2. 测试案例输出

命令行参数说明
--gtest_color=(yes|no|auto)输出命令行时是否使用一些五颜六色的颜色。默认是auto。
--gtest_print_time输出命令行时是否打印每个测试案例的执行时间。默认是不打印的。
--gtest_output=xml[:DIRECTORY_PATH\|:FILE_PATH]

将测试结果输出到一个xml中。

1.--gtest_output=xml:    不指定输出路径时，默认为案例当前路径。

2.--gtest_output=xml:d:\ 指定输出到某个目录 

3.--gtest_output=xml:d:\foo.xml 指定输出到d:\foo.xml

如果不是指定了特定的文件路径，gtest每次输出的报告不会覆盖，而会以数字后缀的方式创建。xml的输出内容后面介绍吧。 

 

3. 对案例的异常处理

命令行参数说明
--gtest_break_on_failure调试模式下，当案例失败时停止，方便调试
--gtest_throw_on_failure当案例失败时以C++异常的方式抛出
--gtest_catch_exceptions

是否捕捉异常。gtest默认是不捕捉异常的，因此假如你的测试案例抛了一个异常，很可能会弹出一个对话框，这非常的不友好，同时也阻碍了测试案例的运行。如果想不弹这个框，可以通过设置这个参数来实现。如将--gtest_catch_exceptions设置为一个非零的数。

注意：这个参数只在Windows下有效。


四、XML报告输出格式
复制代码
<? xml version="1.0" encoding="UTF-8" ?>
< testsuites  tests ="3"  failures ="1"  errors ="0"  time ="35"  name ="AllTests" >
   < testsuite  name ="MathTest"  tests ="2"  failures ="1" * errors ="0"  time ="15" >
     < testcase  name ="Addition"  status ="run"  time ="7"  classname ="" >
       < failure  message ="Value of: add(1, 1)  Actual: 3 Expected: 2"  type ="" />
       < failure  message ="Value of: add(1, -1)  Actual: 1 Expected: 0"  type ="" />
     </ testcase >
     < testcase  name ="Subtraction"  status ="run"  time ="5"  classname ="" >
     </ testcase >
   </ testsuite >
   < testsuite  name ="LogicTest"  tests ="1"  failures ="0"  errors ="0"  time ="5" >
     < testcase  name ="NonContradiction"  status ="run"  time ="5"  classname ="" >
     </ testcase >
   </ testsuite >
</ testsuites >
复制代码

从报告里可以看出，我们之前在TEST等宏中定义的测试案例名称(testcase_name)在xml测试报告中其实是一个testsuite name，而宏中的测试名称(test_name)在xml测试报告中是一个testcase name，概念上似乎有点混淆，就看你怎么看吧。

当检查点通过时，不会输出任何检查点的信息。当检查点失败时，会有详细的失败信息输出来failure节点。

在我使用过程中发现一个问题，当我同时设置了--gtest_filter参数时，输出的xml报告中还是会包含所有测试案例的信息，只不过那些不被执行的测试案例的status值为“notrun”。而我之前认为的输出的xml报告应该只包含我需要运行的测试案例的信息。不知是否可提供一个只输出需要执行的测试案例的xml报告。因为当我需要在1000个案例中执行其中1个案例时，在报告中很难找到我运行的那个案例，虽然可以查找，但还是很麻烦。

五、总结

本篇主要介绍了gtest案例执行时提供的一些参数的使用方法，这些参数都非常有用。在实际编写gtest测试案例时肯定会需要用到的时候。至少我现在比较常用的就是：

1. --gtest_filter

2. --gtest_output=xml[:DIRECTORY_PATH\|:FILE_PATH]

3. --gtest_catch_exceptions

最后再总结一下我使用过程中遇到的几个问题:

1. 同时使用--gtest_filter和--gtest_output=xml:时，在xml测试报告中能否只包含过滤后的测试案例的信息。

2. 有时，我在代码中设置 testing::GTEST_FLAG(catch_exceptions) = 1和我在命令行中使用--gtest_catch_exceptions结果稍有不同，在代码中设置FLAG方式有时候捕捉不了某些异常，但是通过命令行参数的方式一般都不会有问题。这是我曾经遇到过的一个问题，最后我的处理办法是既在代码中设置FLAG，又在命令行参数中传入--gtest_catch_exceptions。不知道是gtest在catch_exceptions方面不够稳定，还是我自己测试案例的问题。

转载自：http://www.cnblogs.com/coderzh/archive/2009/04/10/1432789.html

zhengqijun_
关注
专栏目录
玩转Google开源C++单元测试框架Google Test系列(gtest)之六 - 运行参数
weixin_34209851的博客
04-10 356
一、前言 使用gtest编写的测试案例通常本身就是一个可执行文件，因此运行起来非常方便。同时，gtest也为我们提供了一系列的运行参数（环境变量、命令行参数或代码里指定），使得我们可以对案例的执行进行一些有效的控制。 二、基本介绍 前面提到，对于运行参数，gtest提供了三种设置的途径： 1. 系统环境变量 2. 命令行参数 3. 代码中指定FLAG 因为提供了三种途径，...
gtest调试_Gtest简单使用
weixin_35434041的博客
12-24 1468
编辑推荐:本文来自51CTO，本文主要简单介绍了googletest代码的环境配置以及简单实用过程，希望对您的学习有所帮助。1、下载googletest代码得到压缩包：解压并进入msvc文件夹：googletest-master\googletest\msvc2、打开gtest.sln文件因为我的VS是2017版，下载的gtest对应的是2010版，所以打开会提示选择目标SDK版本和升级平台工具集...
GoogleTest测试C++代码
Erick Lv的笔记
03-30 4744
GoogleTest测试框架基本使用方法： 首先，给出官方文档的链接。以下内容主要是我自己翻译的官方文档并结合自己的理解，总结出的基本要点。如果想要对技术更深入的了解，建议还是去看官方文档。最后说明一下，这里的内容仅仅在Linux系统的上执行过，其他的系统应该也是按照类似的步骤进行。Linux下关于如何安装GoogleTest框架，请参考我在CSDN的这篇博客 基本概念 使用Googl...
使用gtest(googletest)进行c++单元测试
爱她就要努力
03-01 1245
https://www.cnblogs.com/gaopang/p/11630110.html 这是系列文章的第三篇,前两篇https://www.cnblogs.com/gaopang/p/11243367.html和https://www.cnblogs.com/gaopang/p/11588683.html. 为了保证软件质量,除去使用gdb进行事后调试,以及使用sanitize进行必要的提示以外,再就是单元测试了. Sanitize提供了关键性问题的提示,gdb提供了运行期间的错误解决途径,单元测
玩转Google开源C++单元测试框架Google Test系列.pdf
10-23
Google Test（gtest）是由Google提供的一个C++单元测试框架，广泛应用于C++程序的测试中。本系列文档将详细介绍如何使用gtest，包括其下载、安装、配置以及编写测试案例。文档分为多个部分，涵盖了gtest的基本使用...
玩转Google开源C++单元测试框架Google Test系列(gtest)(总) - CoderZh - 博客园1
08-03
【玩转Google开源C++单元测试框架Google Test系列(gtest)(总)】 Google Test，简称为gtest，是一款功能强大、易于使用的开源C++单元测试框架。由Google开发并维护，它提供了一整套用于编写和运行C++代码测试的工具...
玩转Google开源C++单元测试框架Google Test系列1
08-08
《玩转Google开源C++单元测试框架Google Test系列1》 单元测试是软件开发过程中的重要环节，它能确保代码的正确性和稳定性。Google Test（gtest）是一个强大的、开源的C++测试框架，旨在简化和优化C++代码的单元...
玩转Google开源C++单元测试框架Google Test系列 gtest
07-12
玩转Google开源C++单元测试框架Google Test系列 gtest
Google开源C++单元测试框架Google Test教程 第1章
最新发布
07-10
Google开源C++单元测试框架Google Test教程 第1章 Google开源C++单元测试框架Google Test教程 第1章 【资源说明】 1、该资源介绍Google开源C++单元测试框架Google Test教程 第一章。 2、第一章的主要内容为：GTest...
gtest批量执行case示例
05-19
gtest批量执行case示例
如何将同一个testcase执行多次?
03-23
如何将同一个testcase执行多次?   软件测试　　对于有经验的自动测试SQA工程师来说，很容易就可以解决该问题：建立一个main()函数，然后放置一个循环在里面。下面这个可以工作的4Test例子，在main函数的循环中就直接调用了testcase　　[-]testcaseWinrunner()appstatenone　　[]Print("HPWinRunnerlicenseandmaintenancecodesareavailableonlyfromHPwebsite")　　[-]main()　　[]intjCount=100　　[]intj　　[-]for(j=1;j<=jCount;
vs2013下gtest的配置与入门实例测试
ruyueyini的专栏
08-12 4294
配置步骤 先下载gtest，并解压。 用vs2013打开gtest—-msvc—-gtest工程（双击gtest），弹出如下“单向升级”窗口，单击“确定”，会弹出“迁移报告”，关闭“迁移报告”即可。 用vs2013打开工程gtest；对gtest右键——>生成，即可生成gtestd.lib(这个是对应Debug的)，还有一个gtest.lib(这个对应Release)，可根据需要生成相应文件
还在用gtest?更好用的测试框架介绍
OKCRoss的博客
06-28 514
doctest 是一个新的 C++ 测试框架。与其他功能丰富的替代方案相比，编译时（by）和运行时是最快的。它提供了编译语言（如DRustNim）的能力，并通过提供一个快速，透明和灵活的测试运行器与简洁的界面，可直接在生产代码中编写测试。doctest和其他测试框架之间的主要区别在于它很轻而且没有侵入性。
Gtest输出单元测试报告和输出覆盖率报告
喜欢打篮球的普通人
02-08 5510
gtest本身仅能输出xml或者json格式的测试报告，所以采用。编译工具：选择Cmake，单元测试使用Gtest。（2）CMake添加编译以及链接选项、库。（1）ubuntu环境直接安装lcov。地三方工具输出html的报告。环境：gtest已经可以使用。使用gcc的lcov。
gtest/gmock 简单实例返回值为自定义类型
beibeix2015的博客
11-13 2064
帖子：gtest/gmock 简单实例给出了返回值为内置类型的例子，在实际项目中经常出现返回值为自定义类型的数据对象，当被测试函数的返回值为自定义类型时，如何mock? 简单的例子： main函数所 // GoogleTest.cpp : 此文件包含 "main" 函数。程序执行将在此处开始并结束。 // #include <iostream> #include <gtest/gtest.h> #include <gmock/gmock.h> #incl...
[单元测试]_[VC2010使用gtest单元测试入门]
Tobey(我是机器人)
06-23 5190
场景: 1. gtest作为C++的单元测试工具很优秀了，它集成了很多标准assert所没有的功能，比如让流程继续执行的EXPECT,只测试特定测试用例的--gtest_filter, 输出xml文件的测试报告. 2.方便的FilePath对路径操作的类和Message设置Log级别,当然还有很多方便的功能，比如设置环境变量. using ::testing::internal::FilePath; using ::testing::Message; 3.这里编写了一个vc2010简单的使用gt
一文掌握开源单元测试框架Google Test
Will的大食堂
11-14 631
我们在开发的过程中，需要做一些验证测试，来保证我们的代码是按照设计要求工作的，这就需要单元测试了。单元测试（Unit Test），我们称为“UT测试”。对于一个复杂的系统来说，需要编写大量的单元测试用例，有人会觉得这么多的测试代码，将会花费大量的时间，影响开发的进度，会得不偿失。真的是这样吗？其实，对于越是复杂的系统就越是需要单元测试来保证我们的代码的开发质量，及时测试出代码的问题，在开发阶段发现问题总比在系统发布之后发现问题能够较少的节省资源或成本。 对于单元测试应该是每个开发工程师必备的技能，尤其是高阶
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值