summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorAlex Neundorf <neundorf@kde.org>2023-11-29 21:51:00 (GMT)
committerBrad King <brad.king@kitware.com>2024-01-25 17:37:16 (GMT)
commit022f20f6632c934169f440271cabe8c7e52cce6e (patch)
tree3bd6022853103fede5e82a0b15089327fbfa4b80 /Help
parent5d1e689e6814283f3920cbb963fe22393e790eae (diff)
downloadCMake-022f20f6632c934169f440271cabe8c7e52cce6e.zip
CMake-022f20f6632c934169f440271cabe8c7e52cce6e.tar.gz
CMake-022f20f6632c934169f440271cabe8c7e52cce6e.tar.bz2
ctest: add command line option to run the tests listed in a given file
Add `--tests-from-file <filename>` to run only the tests listed in the given file. The test names must match exactly, no regexps or something. The listed tests can still be filtered with a regexp using -R. Issue: #25455
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/ctest.1.rst12
-rw-r--r--Help/release/dev/ctest-tests-from-file.rst5
2 files changed, 17 insertions, 0 deletions
diff --git a/Help/manual/ctest.1.rst b/Help/manual/ctest.1.rst
index 1924d4f..1174725 100644
--- a/Help/manual/ctest.1.rst
+++ b/Help/manual/ctest.1.rst
@@ -234,6 +234,18 @@ Run Tests
of the test's labels (i.e. the multiple ``-LE`` labels form an ``AND``
relationship). See `Label Matching`_.
+.. option:: --tests-from-file <filename>
+
+ .. versionadded:: 3.29
+
+ Run tests listed in the given file.
+
+ This option tells CTest to run the tests which are listed in the given
+ file. The file must contain one exact test name per line.
+ Lines can be commented out using a ``#``.
+ This option can be combined with the other options like
+ ``-R``, ``-E``, ``-L`` or ``-LE``.
+
.. option:: -FA <regex>, --fixture-exclude-any <regex>
Exclude fixtures matching ``<regex>`` from automatically adding any tests to
diff --git a/Help/release/dev/ctest-tests-from-file.rst b/Help/release/dev/ctest-tests-from-file.rst
new file mode 100644
index 0000000..f0abda9
--- /dev/null
+++ b/Help/release/dev/ctest-tests-from-file.rst
@@ -0,0 +1,5 @@
+ctest-tests-from-file
+---------------------
+
+* :manual:`ctest(1)` gained the :option:`--tests-from-file <ctest
+ --tests-from-file>` option to run tests named in a file.