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=

     設定洗牌模式的隨機種子值。（種子的值在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），請發郵件至 <[email protected]>。

英文原版

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

<[email protected]>.