Release Notes

GoogleTest will not accept patches of new features to the v1.14.x branch.
We recommend building GoogleTest from the latest commit instead.
Exceptional critical bug fixes may be considered.

C++ Language Support

• GoogleTest requires at least C++14 and follows Google's Foundational C++ Support Policy. See this table for a list of currently supported versions compilers, platforms, and build tools.

Notable Changes

• Many bug fixes

Release Notes

GoogleTest will not accept patches of new features to the v1.13.x branch.
We recommend building GoogleTest from the latest commit instead.
Exceptional critical bug fixes may be considered.

C++ Language Support

• GoogleTest now requires at least C++14 and follows Google's Foundational C++ Support Policy. See this table for a list of currently supported versions compilers, platforms, and build tools.

Notable Changes

• Floating point prints full precision by default to aid in debugging (https://github.com/google/googletest/commit/9c332145b71c36a5bad9688312c79184f98601ff)
• GTEST_FAIL_AT now terminates the test (like ASSERT_*), rather than failing and continuing (like EXPECT_*) (https://github.com/google/googletest/commit/6f149520a19c0bfd6a70075a733a69cd8b03ae94)
• Added testing::SrcDir(), which returns the configured directory for test data files (https://github.com/google/googletest/commit/912db742531bf82efb01194bc08140416e3b3467)

Release Notes

GoogleTest will not accept patches of new features to the v1.12.x branch.
We recommend building GoogleTest from the latest commit instead.
Exceptional critical bug fixes may be considered.

C++ Language Support

• This will be the last release to support C++11. Future releases will require at least C++14.

Mocking

• Support for move-only values to Return (https://github.com/google/googletest/commit/5126f7166109666a9c0534021fb1a3038659494c)

Matchers

• New matchers
  • WhenBase64Unescaped (https://github.com/google/googletest/commit/652ec31f9f53ab34af1257e5e2783d77e872ed45)
• ResultOf() now has a 3-arg overload that takes a description string for better error messages (https://github.com/google/googletest/commit/0e402173c97aea7a00749e825b194bfede4f2e45)

Build & Test

• CMake minimum increased to 3.5
• Bazel users that build GoogleTest using the Abseil library as a dependency now also require a dependency on RE2 (https://github.com/google/googletest/commit/e33c2b24ca3e13df961ed369f7ed21e4cfcf9eec)
• Bazel users that build GoogleTest using the Abseil library now use the Abseil library to parse all command-line flags (https://github.com/google/googletest/commit/25dcdc7e8bfac8967f20fb2c0a628f5cf442188d)

Patches

58d77fa8070e8cec2dc1ed015d66b454c8d78850 - Fixes the version number in CMakeLists.txt (#3911)

Release Notes

GoogleTest will not accept patches of new features to v1.12.0.
We recommend building GoogleTest from the latest commit instead.
Exceptional critical bug fixes may be considered.

C++ Language Support

• This will be the last release to support C++11. Future releases will require at least C++14.

Mocking

• Support for move-only values to Return (https://github.com/google/googletest/commit/5126f7166109666a9c0534021fb1a3038659494c)

Matchers

• New matchers
  • WhenBase64Unescaped (https://github.com/google/googletest/commit/652ec31f9f53ab34af1257e5e2783d77e872ed45)
• ResultOf() now has a 3-arg overload that takes a description string for better error messages (https://github.com/google/googletest/commit/0e402173c97aea7a00749e825b194bfede4f2e45)

Build & Test

• CMake minimum increased to 3.5
• Bazel users that build GoogleTest using the Abseil library as a dependency now also require a dependency on RE2 (https://github.com/google/googletest/commit/e33c2b24ca3e13df961ed369f7ed21e4cfcf9eec)
• Bazel users that build GoogleTest using the Abseil library now use the Abseil library to parse all command-line flags (https://github.com/google/googletest/commit/25dcdc7e8bfac8967f20fb2c0a628f5cf442188d)

Release Notes

GoogleTest will not accept patches of new features to v1.11.0.
We recommend building GoogleTest from the latest commit instead.
Exceptional critical bug fixes may be considered.

Documentation

• Contents significantly updated
• Files moved into docs (https://github.com/google/googletest/commit/489283524e3726b7adb9692763c2fb61b235d41a)
• Now using GitHub pages (https://github.com/google/googletest/commit/1a5a78b9a9c6c285a7897a411cb96bb2ab36d277, https://github.com/google/googletest/commit/d9c309fdab807b716c2cf4d4a42989b8c34f712a, https://github.com/google/googletest/commit/c3fc92f0b7ad49ce59d804dc644dcb5ecbc0c29c)
• Added Bazel quickstart (https://github.com/google/googletest/commit/32ad3c8c36382165274385a28a23addbea581f5d)
• Added CMake quickstart (https://github.com/google/googletest/commit/d4e3b8cedf4f57922efa586cb3c796c8fee2d3f3)

Mocking

• MOCK_METHOD now handles noexcept correctly (https://github.com/google/googletest/pull/2498)
• MOCK_METHOD now supports ref-qualifiers (https://github.com/google/googletest/commit/d89b36302116233b8c6377e6e891083f41ee51c5)
• MOCK_METHOD now supports returning function pointers (https://github.com/google/googletest/commit/1f9edcd9698162b48d94e1ef2e6a2ab7ab4e6c56)
• DoAll now accepts move-only arguments (https://github.com/google/googletest/commit/48ec64092a38621210ecd835fde61d76861269c1)
• MockFunction can now be used for mocking std::function (https://github.com/google/googletest/pull/2350)
• MockFunction is now templated for use with other function classes, besides std::function (https://github.com/google/googletest/commit/662fe38e44900c007eccb65a5d2ea19df7bd520e)
• ACTION macros now support more than 10 arguments (https://github.com/google/googletest/commit/63713e1ce49019da205daa1ca91b73fcfc9b333f)

Matchers

• New matchers
  • IsNan (https://github.com/google/googletest/commit/bbe4b7363bbaa7c9e07dbacde11602a4c69504d3)
  • FieldsAre (https://github.com/google/googletest/commit/a4621888650aaae118de93f9faf8ef5a18cab303)
  • Pointer (https://github.com/google/googletest/commit/a02a591605dfef9addde49634bf010dbe8f95c50)
  • Address (https://github.com/google/googletest/commit/e5644f5f12ff3d5b2232dabc1c5ea272a52e8155)
  • Throws and ThrowsMessage (https://github.com/google/googletest/pull/2904)
• New actions
  • ReturnRoundRobin (https://github.com/google/googletest/commit/37f322783175a66c11785d17fc153477b0777753)
• Added Matcher<std::string_view> specialization that internally stores a string instead of string_view (https://github.com/google/googletest/commit/6f5fd0d7199b9a19faa9f499ecc266e6ae0329e7)
• String matchers now accept string_view input (https://github.com/google/googletest/commit/13a433a94dd9c7e55907d7a9b75f44ff82f309eb)
• DoubleNearPredFormat matcher now fails on impractically small epsilons (https://github.com/google/googletest/commit/b5687db554a295e697f5d459cf6d3f343d2ca179)
• Truly matcher now explains failures (https://github.com/google/googletest/commit/0c400f67fcf305869c5fb113dd296eca266c9725)
• Matchers can now be implemented without extending MatcherInterface (https://github.com/google/googletest/commit/c13c27a513ecd1cbf5700a45fe590e85e8ae6770)
• Added output messages for skipped tests (https://github.com/google/googletest/pull/2517, https://github.com/google/googletest/pull/2767)

Behavior

• New flags
  • --gtest_brief shows only test failures in output (https://github.com/google/googletest/pull/2751)
  • --gtest_fail_fast stops test execution on first failure (https://github.com/google/googletest/commit/1ced315a483f4ecac21893ce6ceeb502afb82eff)
• Failures in SetUpTestSuite and TearDownTestSuite now cause tests to fail rather than log (https://github.com/google/googletest/commit/9ed99c6c837ae1cbfcabd36959fc802ebb5ae07f)
• Uninstantiated TEST_P and TYPED_TEST_P now fail unless allowlisted using GTEST_ALLOW_UNINSTANTIATED_PARAMETERIZED_TEST (https://github.com/google/googletest/commit/d442089d53cecbba59b2d8f35d06eac01f1e46da, https://github.com/google/googletest/commit/a13a0626188b4e7d22d63a4c9fcfe9f441c81e4a, https://github.com/google/googletest/commit/0b024bd91a14a77a7e7d6072ccd88e09c86ddeaa, https://github.com/google/googletest/commit/3e79d366e380ec85b7de9409211b184bc8529655, https://github.com/google/googletest/commit/ec94d9f24c92a5090fda5567156d6dde99cdbf31)

Output

• Added specialized printing for std::any, std::optional, and std::variant (https://github.com/google/googletest/pull/2742)
• Added recursive printing for std::unique_ptr and std::shared_ptr (https://github.com/google/googletest/commit/6b2e74905e9a7e70c7d1017ee0dfe5a8e88a1300)
• Printing incomplete types is now supported (https://github.com/google/googletest/commit/f8304d762e0ed119d3d1c72deb1976dc80029db5)
• Start timestamps in XML/JSON output now use millisecond precision (https://github.com/google/googletest/commit/af1e75ce0b3429d70790c049d8dbb0aae3e2480f)
• Added more structured information about test suite to XML/JSON output on environment failures (https://github.com/google/googletest/commit/ac1d60c2b5ae62a06eca1d2c0f9d6dc92cda8711)

Build & Test

• CMake minimum increased to 2.8.12 (https://github.com/google/googletest/pull/3094)
• GoogleTest is now using Kokoro CI instead of Travis and AppVeyor

Misc

• Removed support for GTEST_HAS_STD_STRING (https://github.com/google/googletest/pull/2456)
• Replaced pump code generation with variadic templates (https://github.com/google/googletest/pull/2388, https://github.com/google/googletest/commit/d8eeb9760afcab45dbdd887c2b6d106887c1739d, https://github.com/google/googletest/commit/4b9c1691c4b7f01fbd9d37d86c88cdad298d48e9, https://github.com/google/googletest/commit/fbf67a70d07543f40832d0cd7a58f304bc6ab1d1, https://github.com/google/googletest/commit/41b5f149ab306e96b5b2faf523505d75acffd98a, https://github.com/google/googletest/commit/710f9c11ca79e578bb38d98d10ab9b70d41d5e07, https://github.com/google/googletest/commit/997c36c1881105bd7ce482a1ec93759badf64ce6, https://github.com/google/googletest/commit/59dea67b815a046122d77113d5c6df1df66076bb)

Release 1.10.0 1.10.0 Release reflects a current version of the project. The 1.10.x will not consider any requests for any new features, The bug fix requests will only be considered if proven "critical"

High Level Changes: This release deprecated "....TEST_CASE" API in favor of "....TEST_SUITE". In a nutshell if you have code that uses something like "INSTANTIATE_TYPED_TEST_CASE_P " - this and all other "*_TEST_CASE " are now deprecated in favor of more standard _TEST_SUITE. See https://github.com/google/googletest/blob/master/googletest/docs/primer.md#beware-of-the-nomenclature.

There is also new powerful MOCK_METHOD macro. See https://github.com/google/googletest/blob/72adf7a4155b6642da1e6761678fe546590c0269/googlemock/docs/cook_book.md#creating-mock-classes. This replaces older way of mocking. For example (Old) MOCK_METHOD1(Bar, double(std::string s)); (New) MOCK_METHOD(double, Bar, (std::string s), (override)); So there is no need to count the parameters anymore.

1.8.1 Release reflects a current version of the project. The 1.8.x is the last release supporting pre-C++11 compilers. The 1.8.x will not accept any requests for any new features and any bugfix requests will only be accepted if proven "critical"