Google Test

OSS Builds Status:

Announcements:

Release 1.10.x

Release 1.10.xis now available.

Coming Soon

Post 1.10.x googletest will followAbseil Live at Head philosophy
We are also planning to take a dependency onAbseil.

Welcome to Google Test, Google's C++ test framework!

This repository is a merger of the formerly separate GoogleTest and GoogleMockprojects. These were so closely related that it makes sense to maintain andrelease them together.

Please subscribe to the mailing list at [email protected] forquestions, discussions, and development.

Getting started:

The information for Google Test is available in theGoogle Test Primer documentation.

Google Mock is an extension to Google Test for writing and using C++ mockclasses. See the separate Google Mock documentation.

More detailed documentation for googletest is in its interiorgoogletest/README.md file.

Features

An xUnit test framework.
Test discovery.
A rich set of assertions.
User-defined assertions.
Death tests.
Fatal and non-fatal failures.
Value-parameterized tests.
Type-parameterized tests.
Various options for running the tests.
XML test report generation.

Platforms

Google test has been used on a variety of platforms:

Linux
Mac OS X
Windows
Cygwin
MinGW
Windows Mobile
Symbian
PlatformIO

Who Is Using Google Test?

In addition to many internal projects at Google, Google Test is also used by thefollowing notable projects:

The Chromium projects (behind the Chrome browserand Chrome OS).
The LLVM compiler.
Protocol Buffers, Google's datainterchange format.
The OpenCV computer vision library.
tiny-dnn: header only,dependency-free deep learning framework in C++11.

Related Open Source Projects

GTest Runner is a Qt5 basedautomated test-runner and Graphical User Interface with powerful features forWindows and Linux platforms.

Google Test UI is test runner thatruns your test binary, allows you to track its progress via a progress bar, anddisplays a list of test failures. Clicking on one shows failure text. GoogleTest UI is written in C#.

GTest TAP Listener is an eventlistener for Google Test that implements theTAP protocol for testresult output. If your test runner understands TAP, you may find it useful.

gtest-parallel is a test runner thatruns tests from your binary in parallel to provide significant speed-up.

GoogleTest Adapteris a VS Code extension allowing to view Google Tests in a tree view, andrun/debug your tests.

Catch2 and Google Test Exploreris a VS Code extension allowing to view Google Tests in a tree view, andrun/debug your tests.

Cornichon is a small Gherkin DSL parserthat generates stub code for Google Test.

Requirements

Google Test is designed to have fairly minimal requirements to build and usewith your projects, but there are some. If you notice any problems on yourplatform, please notify[email protected].Patches for fixing them are welcome!

Build Requirements

These are the base requirements to build and use Google Test from a sourcepackage:

Bazel or CMake. NOTE: Bazel isthe build system that googletest is using internally and tests against.CMake is community-supported.
a C++11-standard-compliant compiler