third_party/googletest/docs.rst

.. _module-pw_third_party_googletest:

==========
GoogleTest
==========
The ``$dir_pw_third_party/googletest/`` module provides various helpers to
optionally use full upstream GoogleTest/GoogleMock with
:ref:`module-pw_unit_test`.

----------------------------------------
Using upstream GoogleTest and GoogleMock
----------------------------------------
If you want to use the full upstream GoogleTest/GoogleMock, you must do the
following:

GN
==
* Set the GN var ``dir_pw_third_party_googletest`` to the location of the
  GoogleTest source. You can use ``pw package install googletest`` to fetch the
  source if desired.
* Set the GN var ``pw_unit_test_MAIN = "//third_party/googletest:gmock_main"``.
* Set the GN var
  ``pw_unit_test_GOOGLETEST_BACKEND = "//third_party/googletest"``.

CMake
=====
* Set the ``dir_pw_third_party_googletest`` to the location of the
  GoogleTest source. You can use ``pw package install googletest`` to fetch the
  source if desired.
* Set the ``pw_unit_test_MAIN`` to ``pw_third_party.googletest.gmock_main``.
* Set the GN var ``pw_unit_test_GOOGLETEST_BACKEND`` to
  ``pw_third_party.googletest``.

.. note::

  Not all unit tests build properly with upstream GoogleTest yet. This is a
  work in progress.