echo/CMake
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Help: Add pre-test to prose for gtest_discover_tests()

Browse Source 
The prose previously gave the impression that discovery was always done
as a post-build operation, but later in the documentation the
DISCOVERY_MODE option is explained where pre-test can also be specified.
Update the earlier prose to mention both methods equally.
This commit is contained in:
Craig Scott 2024-09-27 17:43:56 +10:00
parent b5403cdc5d
commit 9f1703530b
No known key found for this signature in database
GPG Key ID: 6FF37CBDCCADED9F
1 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
Modules/GoogleTest.cmake
View File

@ -162,15 +162,15 @@ same as the Google Test name (i.e. ``suite.testcase``); see also
.. versionadded:: 3.10
``gtest_discover_tests()`` sets up a post-build command on the test executable
that generates the list of tests by parsing the output from running the test
with the ``--gtest_list_tests`` argument. Compared to the source parsing
approach of :command:`gtest_add_tests`, this ensures that the full list of
tests, including instantiations of parameterized tests, is obtained. Since
test discovery occurs at build time, it is not necessary to re-run CMake when
the list of tests changes.
However, it requires that :prop_tgt:`CROSSCOMPILING_EMULATOR` is properly set
in order to function in a cross-compiling environment.
``gtest_discover_tests()`` sets up a post-build or pre-test command on the
test executable that generates the list of tests by parsing the output from
running the test executable with the ``--gtest_list_tests`` argument.
Compared to the source parsing approach of :command:`gtest_add_tests`,
this ensures that the full list of tests, including instantiations of
parameterized tests, is obtained. Since test discovery occurs at build
or test time, it is not necessary to re-run CMake when the list of tests
changes. However, it requires that :prop_tgt:`CROSSCOMPILING_EMULATOR`
is properly set in order to function in a cross-compiling environment.
Additionally, setting properties on tests is somewhat less convenient, since
the tests are not available at CMake time. Additional test properties may be