diff options
author | Philipp Hasper <opensource@ioxp.de> | 2019-06-16 13:00:02 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-06-16 13:00:02 (GMT) |
commit | b72b1bee95f19f4ccaf9768c5cece26621218611 (patch) | |
tree | 48c8b97fb15e787d5eea679b67812412bd204162 /googletest/docs/primer.md | |
parent | e110929a7b496714c1f6f6be2edcf494a18e5676 (diff) | |
download | googletest-b72b1bee95f19f4ccaf9768c5cece26621218611.zip googletest-b72b1bee95f19f4ccaf9768c5cece26621218611.tar.gz googletest-b72b1bee95f19f4ccaf9768c5cece26621218611.tar.bz2 |
docs/primer: Fixed usage of test caserefs/pull/2287/head
According to the nomenclature, what was called a test case
is actually a test suite
Diffstat (limited to 'googletest/docs/primer.md')
-rw-r--r-- | googletest/docs/primer.md | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/googletest/docs/primer.md b/googletest/docs/primer.md index b6e988b..8f4d4a0 100644 --- a/googletest/docs/primer.md +++ b/googletest/docs/primer.md @@ -253,10 +253,10 @@ TEST(TestSuiteName, TestName) { ``` `TEST()` arguments go from general to specific. The *first* argument is the name -of the test case, and the *second* argument is the test's name within the test +of the test suite, and the *second* argument is the test's name within the test case. Both names must be valid C++ identifiers, and they should not contain -underscore (`_`). A test's *full name* consists of its containing test case and -its individual name. Tests from different test cases can have the same +underscore (`_`). A test's *full name* consists of its containing test suite and +its individual name. Tests from different test suites can have the same individual name. For example, let's take a simple integer function: @@ -282,13 +282,13 @@ TEST(FactorialTest, HandlesPositiveInput) { } ``` -googletest groups the test results by test cases, so logically-related tests -should be in the same test case; in other words, the first argument to their +googletest groups the test results by test suites, so logically-related tests +should be in the same test suite; in other words, the first argument to their `TEST()` should be the same. In the above example, we have two tests, -`HandlesZeroInput` and `HandlesPositiveInput`, that belong to the same test case +`HandlesZeroInput` and `HandlesPositiveInput`, that belong to the same test suite `FactorialTest`. -When naming your test cases and tests, you should follow the same convention as +When naming your test suites and tests, you should follow the same convention as for [naming functions and classes](https://google.github.io/styleguide/cppguide.html#Function_Names). @@ -324,7 +324,7 @@ TEST_F(TestSuiteName, TestName) { } ``` -Like `TEST()`, the first argument is the test case name, but for `TEST_F()` this +Like `TEST()`, the first argument is the test suite name, but for `TEST_F()` this must be the name of the test fixture class. You've probably guessed: `_F` is for fixture. @@ -339,7 +339,7 @@ declaration`". For each test defined with `TEST_F()` , googletest will create a *fresh* test fixture at runtime, immediately initialize it via `SetUp()` , run the test, clean up by calling `TearDown()` , and then delete the test fixture. Note that -different tests in the same test case have different test fixture objects, and +different tests in the same test suite have different test fixture objects, and googletest always deletes a test fixture before it creates the next one. googletest does **not** reuse the same test fixture for multiple tests. Any changes one test makes to the fixture do not affect other tests. @@ -436,7 +436,7 @@ your defined tests in order to run them. After defining your tests, you can run them with `RUN_ALL_TESTS()` , which returns `0` if all the tests are successful, or `1` otherwise. Note that `RUN_ALL_TESTS()` runs *all tests* in your link unit -- they can be from -different test cases, or even different source files. +different test suites, or even different source files. When invoked, the `RUN_ALL_TESTS()` macro: @@ -508,7 +508,7 @@ class FooTest : public ::testing::Test { // before the destructor). } - // Objects declared here can be used by all tests in the test case for Foo. + // Objects declared here can be used by all tests in the test suite for Foo. }; // Tests that the Foo::Bar() method does Abc. |