ctest: allow dashboard clients to specify presets via variables

Add variables to support specifying PRESET and PRESETS_FILE to
dashboard clients from the command-line.
This commit is contained in:
Zack Galbreath
2026-05-27 09:33:06 -04:00
parent 9000ffa974
commit 63b6e7d785
31 changed files with 513 additions and 26 deletions
+10
View File
@@ -0,0 +1,10 @@
CTEST_BUILD_PRESET
------------------
.. versionadded:: 4.4
Specify the ``PRESET`` option for the :command:`ctest_build` command
in a :manual:`ctest(1)` :ref:`Dashboard Client` script,
or on the :program:`ctest` command line via the :ref:`-D <ctest-option-D-var>` option.
See also :variable:`CTEST_PRESET` and :variable:`CTEST_PRESETS_FILE`.
+10
View File
@@ -0,0 +1,10 @@
CTEST_CONFIGURE_PRESET
----------------------
.. versionadded:: 4.4
Specify the ``PRESET`` option for the :command:`ctest_configure` command
in a :manual:`ctest(1)` :ref:`Dashboard Client` script,
or on the :program:`ctest` command line via the :ref:`-D <ctest-option-D-var>` option.
See also :variable:`CTEST_PRESET` and :variable:`CTEST_PRESETS_FILE`.
+22
View File
@@ -0,0 +1,22 @@
CTEST_PRESET
------------
.. versionadded:: 4.4
Specify a preset name to use for all relevant :manual:`ctest(1)`
:ref:`Dashboard Client` steps in a dashboard script,
or on the :program:`ctest` command line via the :ref:`-D <ctest-option-D-var>` option.
This variable sets the ``PRESET`` option for :command:`ctest_configure`,
:command:`ctest_build`, :command:`ctest_test`, and :command:`ctest_memcheck`
when those commands are not given an explicit ``PRESET`` argument and the
corresponding command-specific variable
(:variable:`CTEST_CONFIGURE_PRESET`, :variable:`CTEST_BUILD_PRESET`, or
:variable:`CTEST_TEST_PRESET`) is also unset.
For :command:`ctest_configure`, an error is raised if no configure preset
with this name exists. For :command:`ctest_build`, :command:`ctest_test`,
and :command:`ctest_memcheck`, a warning is emitted and the variable is
ignored if no preset of the matching type exists with this name.
See also :variable:`CTEST_PRESETS_FILE`.
+16
View File
@@ -0,0 +1,16 @@
CTEST_PRESETS_FILE
------------------
.. versionadded:: 4.4
Specify the ``PRESETS_FILE`` option for all relevant :manual:`ctest(1)`
:ref:`Dashboard Client` step commands in a dashboard script,
or on the :program:`ctest` command line via the :ref:`-D <ctest-option-D-var>` option.
This variable sets the ``PRESETS_FILE`` option for
:command:`ctest_configure`, :command:`ctest_build`, :command:`ctest_test`,
and :command:`ctest_memcheck` when those commands are not given an explicit
``PRESETS_FILE`` argument.
See also :variable:`CTEST_PRESET`, :variable:`CTEST_CONFIGURE_PRESET`,
:variable:`CTEST_BUILD_PRESET`, and :variable:`CTEST_TEST_PRESET`.
+11
View File
@@ -0,0 +1,11 @@
CTEST_TEST_PRESET
-----------------
.. versionadded:: 4.4
Specify the ``PRESET`` option for the :command:`ctest_test` and
:command:`ctest_memcheck` commands in a :manual:`ctest(1)`
:ref:`Dashboard Client` script,
or on the :program:`ctest` command line via the :ref:`-D <ctest-option-D-var>` option.
See also :variable:`CTEST_PRESET` and :variable:`CTEST_PRESETS_FILE`.