diff options
| author | Craig Scott <craig.scott@crascit.com> | 2017-08-08 12:02:07 (GMT) |
|---|---|---|
| committer | Craig Scott <craig.scott@crascit.com> | 2017-08-08 12:02:07 (GMT) |
| commit | 2e3d89a70b50b40bb2c762a094eaeec23ff0f114 (patch) | |
| tree | 2920d5f7b0f00d8ccaf18a9cc4bb132d94908ee6 /Help/prop_test/FIXTURES_REQUIRED.rst | |
| parent | b17b6dbb8e57f159274deec9e458ab421bee09ff (diff) | |
| download | CMake-2e3d89a70b50b40bb2c762a094eaeec23ff0f114.zip CMake-2e3d89a70b50b40bb2c762a094eaeec23ff0f114.tar.gz CMake-2e3d89a70b50b40bb2c762a094eaeec23ff0f114.tar.bz2 | |
Help: Clarify test fixture naming and use
* Make it clearer that fixture names are distinct from test case names.
* Mention -FS, -FC and -FA ctest command line options for overriding
fixture behavior.
Fixes: #17141
Diffstat (limited to 'Help/prop_test/FIXTURES_REQUIRED.rst')
| -rw-r--r-- | Help/prop_test/FIXTURES_REQUIRED.rst | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/Help/prop_test/FIXTURES_REQUIRED.rst b/Help/prop_test/FIXTURES_REQUIRED.rst index e37dfb5..e3f60c4 100644 --- a/Help/prop_test/FIXTURES_REQUIRED.rst +++ b/Help/prop_test/FIXTURES_REQUIRED.rst @@ -2,7 +2,7 @@ FIXTURES_REQUIRED ----------------- Specifies a list of fixtures the test requires. Fixture names are case -sensitive. +sensitive and they are not required to have any similarity to test names. Fixtures are a way to attach setup and cleanup tasks to a set of tests. If a test requires a given fixture, then all tests marked as setup tasks for that @@ -19,7 +19,9 @@ some setup tests fail. When CTest is asked to execute only a subset of tests (e.g. by the use of regular expressions or when run with the ``--rerun-failed`` command line option), it will automatically add any setup or cleanup tests for fixtures -required by any of the tests that are in the execution set. +required by any of the tests that are in the execution set. This behavior can +be overridden with the ``-FS``, ``-FC`` and ``-FA`` command line options to +:manual:`ctest(1)` if desired. Since setup and cleanup tasks are also tests, they can have an ordering specified by the :prop_test:`DEPENDS` test property just like any other tests. |