From 0f702cebb0e63f67e986314a93dcf57379fdf1dc Mon Sep 17 00:00:00 2001 From: Herbert Thielen Date: Sat, 5 Aug 2017 15:12:12 +0200 Subject: [PATCH 1/3] add note about different definitions of Test Case There are contradictory definitions of the term "test case", so prepare new users in Primer.md to avoid confusion. --- googletest/docs/Primer.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/googletest/docs/Primer.md b/googletest/docs/Primer.md index 474c1d2a..46630449 100644 --- a/googletest/docs/Primer.md +++ b/googletest/docs/Primer.md @@ -23,6 +23,40 @@ So let's go! _Note:_ We sometimes refer to Google C++ Testing Framework informally as _Google Test_. +# Beware of the nomenclature # + +_Note:_ There might be some confusion of idea due to different +definitions of the terms _Test_, _Test Case_ and _Test Suite_, so beware +of misunderstanding these. + +Historically, the Google C++ Testing Framework started to use the term +_Test Case_ for grouping related tests, i.e. in the same sense as +current publications, including the International Software Testing +Qualifications Board ([ISTQB](http://www.istqb.org/)) and different +textbooks on Software Quality, are using the term _[Test +Suite](http://glossary.istqb.org/search/test%20suite)_. + +The related term _Test_, as it is used in the Google C++ Testing +Framework, is corresponding to the term _[Test +Case](http://glossary.istqb.org/search/test%20case)_ of ISTQB and +others. + +The term _Test_ is commonly of broad enough sense, including ISTQB's +definition of _Test Case_, so it's not much of a problem here. But the +term _Test Case_ is of contradictory sense and thus confusing. + +Unfortunately replacing the term _Test Case_ by _Test Suite_ throughout +the Google C++ Testing Framework is not easy without breaking dependent +projects, as `TestCase` is part of the public API at various places. + +So for the time being, please be aware of the different definitions of +the terms: + +Meaning | Google Test Term | [ISTQB](http://www.istqb.org/) Term +------- | ---------------- | ----------------------------------- +Exercise a particular program path with specific input values and verify the results | [TEST()](#simple-tests) | [Test Case](http://glossary.istqb.org/search/test%20case) +A set of several tests related to one component | [Test Case](#basic-concepts) | [Test Suite](http://glossary.istqb.org/search/test%20suite) + # Setting up a New Test Project # To write a test program using Google Test, you need to compile Google From 33edcaed89959cda58dd6a1491d30cf2453ba129 Mon Sep 17 00:00:00 2001 From: Herbert Thielen Date: Wed, 9 Aug 2017 16:41:38 +0200 Subject: [PATCH 2/3] be more specific on Test Case --- googletest/docs/Primer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/googletest/docs/Primer.md b/googletest/docs/Primer.md index 46630449..2943605c 100644 --- a/googletest/docs/Primer.md +++ b/googletest/docs/Primer.md @@ -43,7 +43,7 @@ others. The term _Test_ is commonly of broad enough sense, including ISTQB's definition of _Test Case_, so it's not much of a problem here. But the -term _Test Case_ is of contradictory sense and thus confusing. +term _Test Case_ as used in Google Test is of contradictory sense and thus confusing. Unfortunately replacing the term _Test Case_ by _Test Suite_ throughout the Google C++ Testing Framework is not easy without breaking dependent From c09e9e646de834b54162f584710eff2d72232080 Mon Sep 17 00:00:00 2001 From: Herbert Thielen Date: Thu, 10 Aug 2017 10:08:08 +0200 Subject: [PATCH 3/3] clarify distinction regarding Test Case --- googletest/docs/Primer.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/googletest/docs/Primer.md b/googletest/docs/Primer.md index 2943605c..fb2b81b8 100644 --- a/googletest/docs/Primer.md +++ b/googletest/docs/Primer.md @@ -30,11 +30,11 @@ definitions of the terms _Test_, _Test Case_ and _Test Suite_, so beware of misunderstanding these. Historically, the Google C++ Testing Framework started to use the term -_Test Case_ for grouping related tests, i.e. in the same sense as -current publications, including the International Software Testing -Qualifications Board ([ISTQB](http://www.istqb.org/)) and different -textbooks on Software Quality, are using the term _[Test -Suite](http://glossary.istqb.org/search/test%20suite)_. +_Test Case_ for grouping related tests, whereas current publications +including the International Software Testing Qualifications Board +([ISTQB](http://www.istqb.org/)) and various textbooks on Software +Quality use the term _[Test +Suite](http://glossary.istqb.org/search/test%20suite)_ for this. The related term _Test_, as it is used in the Google C++ Testing Framework, is corresponding to the term _[Test