英文文档获得方式:框架生成的执行文件,在命令行 --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),请发邮件至
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