【Gtest（Google Test）帮助手册】en-cn

Gtest官方使用文档

英文文档获得方式：框架生成的执行文件，在命令行 --help 即可获得。

中文翻译版

本操作文档只对使用Gtest (Google Test) 开发的测试用例有效。通过命令，你可以使用以下功能：

 

选择测试用例：

 --gtest_list_tests

     列出所有的测试用例，但并不执行。代码中的用例TEST(Foo, Bar) 显示出的结果是 "Foo.Bar".

  --gtest_filter=POSTIVE_PATTERNS[-NEGATIVE_PATTERNS]

     只运行名字与正模式匹配的测试用例，但不运行与负模式名字相同的用例。

PS：--gtest_filter=执行用例名[-不执行的用例名]，用例名可使用部分能配符。

  '?' 匹配任意单字符；

  '*' 匹配任意字符串；

  ':' 分离两种模式。        PS：这一条需要读者自行验证

  --gtest_also_run_disabled_tests

     运行所有用例，包括禁用的用例。

 

执行测试用例：

  --gtest_repeat=[COUNT]

     重复执行用例，使用负数表示一直重复。

  --gtest_shuffle

     洗牌执行，即模式随机顺序执行每个用例集内的用例。

 --gtest_random_seed=[NUMBER]

     设定洗牌模式的随机种子值。（种子的值在1到99999之间，[NUMBER]值为0表示以当前时间作为随机种子。

 

输出信息：

  --gtest_color=(yes|no|auto)

     启用/禁用彩色输出模式。默认的模式是自动模式（auto）。

 --gtest_print_time=0

     不打印每次测试经过的时间。

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

     在指定目录或文件路径生成XML报告。默认的FILE_PATH为test_details.xml。

 

断言行为：

 --gtest_break_on_failure

     将断言失败转到断点调试。

  --gtest_throw_on_failure

     将断言失败转为C++抛出异常。

  --gtest_catch_exceptions=0

     不将异常报告为测试失败。而是，允许他们崩溃程序或弹出一个弹出窗口（在Windows平台）。

 

除了使用入参的方式（如：--gtest_list_tests），你还可以在环境变量中新建一个配置变量（全部使用大写字母）。例如，禁止输出彩色信息，可以使用入参--gtest_color=no 或者设置环境变量GTEST_COLOR的值为
no.

 

更多信息，请至官网https://github.com/google/googletest/阅读Gtest文档。如果发现Gtest的Bug（当然，不是指你自己写的Bug），请发邮件至
<googletestframework@googlegroups.com>。

 

英文原版

This program contains tests written usingGoogle Test. You can use the

following command line flags to control itsbehavior:

 

Test Selection:

 --gtest_list_tests

     List the names of all tests instead of running them. The name ofTEST(Foo, Bar) is "Foo.Bar".

  --gtest_filter=POSTIVE_PATTERNS[-NEGATIVE_PATTERNS]

     Run only the tests whose name matches one of the positive patterns butnone of the negative patterns.

  '?' matches any single character;

  '*' matches any substring;

  ':' separates two patterns.

  --gtest_also_run_disabled_tests

     Run all disabled tests too.

 

Test Execution:

  --gtest_repeat=[COUNT]

     Run the tests repeatedly; use a negative count to repeat forever.

  --gtest_shuffle

     Randomize tests' orders on every iteration.

 --gtest_random_seed=[NUMBER]

     Random number seed to use for shuffling test orders (between 1 and99999, or 0 to use a seed based on the current time).

 

Test Output:

  --gtest_color=(yes|no|auto)

     Enable/disable colored output. The default is auto.

 --gtest_print_time=0

     Don't print the elapsed time of each test.

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

     Generate an XML report in the given directory or with the given file name.FILE_PATH defaults to
test_details.xml.

 

Assertion Behavior:

  --gtest_break_on_failure

     Turn assertion failures into debugger break-points.

  --gtest_throw_on_failure

     Turn assertion failures into C++ exceptions.

  --gtest_catch_exceptions=0

     Do not report exceptions as test failures. Instead, allow them to crashthe program or throw a pop-up (on Windows).

 

Except for --gtest_list_tests, you canalternatively set the corresponding environment variable of a flag (all lettersin upper-case). For example, to disable colored text output, you can eitherspecify
--gtest_color=noor set the
GTEST_COLORenvironment variable to no.

 

For more information, please read theGoogle Test documentation at https://github.com/google/googletest/. If youfind a bug in Google Test (not one in your own code or tests), please report itto

<googletestframework@googlegroups.com>.