summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2021-04-27 17:53:45 (GMT)
committerKitware Robot <kwrobot@kitware.com>2021-04-27 17:53:55 (GMT)
commit970f175d8879d88eccb035a9d5254f4052608fb1 (patch)
treeca83a8774d4344e1126a334d1bcc55c33003b7bf /Help
parent20b2bf00479ff656d0f6b772ba5673d1cb7007c4 (diff)
parent25bf514447501963a31934b5b03c65aeb53a351f (diff)
downloadCMake-970f175d8879d88eccb035a9d5254f4052608fb1.zip
CMake-970f175d8879d88eccb035a9d5254f4052608fb1.tar.gz
CMake-970f175d8879d88eccb035a9d5254f4052608fb1.tar.bz2
Merge topic 'ctest_junit'
25bf514447 ctest: Add support for writing test results in JUnit XML format Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Zack Galbreath <zack.galbreath@kitware.com> Acked-by: Michael Hirsch <michael@scivision.dev> Acked-by: MvdHurk <maikelvandenhurk@hotmail.com> Acked-by: Alexander Richardson <arichardson.kde@gmail.com> Merge-request: !6020
Diffstat (limited to 'Help')
-rw-r--r--Help/command/ctest_test.rst10
-rw-r--r--Help/manual/ctest.1.rst6
-rw-r--r--Help/release/dev/ctest-output-junit.rst5
3 files changed, 21 insertions, 0 deletions
diff --git a/Help/command/ctest_test.rst b/Help/command/ctest_test.rst
index b4493a0..9081b3f 100644
--- a/Help/command/ctest_test.rst
+++ b/Help/command/ctest_test.rst
@@ -25,6 +25,7 @@ Perform the :ref:`CTest Test Step` as a :ref:`Dashboard Client`.
[RETURN_VALUE <result-var>]
[CAPTURE_CMAKE_ERROR <result-var>]
[REPEAT <mode>:<n>]
+ [OUTPUT_JUNIT <file>]
[QUIET]
)
@@ -150,6 +151,15 @@ The options are:
Store in the ``<result-var>`` variable -1 if there are any errors running
the command and prevent ctest from returning non-zero if an error occurs.
+``OUTPUT_JUNIT``
+ .. versionadded:: 3.21
+
+ Write test results to ``<file>`` in JUnit XML format. If ``<file>`` is a
+ relative path it will be placed in the build directory. If ``<file>>``
+ already exists it will be overwritten. Note that the resulting JUnit XML
+ file is **not** uploaded to CDash because it would be redundant with
+ CTest's ``Test.xml`` file.
+
``QUIET``
.. versionadded:: 3.3
diff --git a/Help/manual/ctest.1.rst b/Help/manual/ctest.1.rst
index 68409e1..3d80cec 100644
--- a/Help/manual/ctest.1.rst
+++ b/Help/manual/ctest.1.rst
@@ -134,6 +134,12 @@ Options
This option tells CTest to write all its output to a ``<file>`` log file.
+``--output-junit <file>``
+ Write test results in JUnit format.
+
+ This option tells CTest to write test results to a ``<file>`` JUnit XML file.
+ If ``<file>`` already exists it will be overwritten.
+
``-N,--show-only[=<format>]``
Disable actual execution of tests.
diff --git a/Help/release/dev/ctest-output-junit.rst b/Help/release/dev/ctest-output-junit.rst
new file mode 100644
index 0000000..66df19d
--- /dev/null
+++ b/Help/release/dev/ctest-output-junit.rst
@@ -0,0 +1,5 @@
+ctest-output-junit
+------------------
+
+* :manual:`ctest(1)` gained a ``--output-junit`` option to write test results
+ to a JUnit XML file.