ctest_test

Выполнить CTest Test Step как Dashboard Client.

ctest_test([BUILD <build-dir>] [APPEND]
           [START <start-number>]
           [END <end-number>]
           [STRIDE <stride-number>]
           [EXCLUDE <exclude-regex>]
           [INCLUDE <include-regex>]
           [EXCLUDE_LABEL <label-exclude-regex>]
           [INCLUDE_LABEL <label-include-regex>]
           [EXCLUDE_FIXTURE <regex>]
           [EXCLUDE_FIXTURE_SETUP <regex>]
           [EXCLUDE_FIXTURE_CLEANUP <regex>]
           [PARALLEL_LEVEL <level>]
           [TEST_LOAD <threshold>]
           [SCHEDULE_RANDOM <ON|OFF>]
           [STOP_TIME <time-of-day>]
           [RETURN_VALUE <result-var>]
           [CAPTURE_CMAKE_ERROR <result-var>]
           [QUIET]
           )

Запустить тесты в дереве сборки проекта и сохранить результаты в Test.xml для отправки с помощью команды ctest_submit().

Параметры:

BUILD <build-dir>

Указать корневой каталог сборки. Если не указано, используется переменная CTEST_BINARY_DIRECTORY.

APPEND

Отметить Test.xml для добавления к результатам, ранее отправленным на сервер панели мониторинга, начиная с последнего вызова ctest_start(). Семантика добавления определяется используемым сервером панели мониторинга. Это не приводит к добавлению результатов в файл .xml, созданный предыдущим вызовом этой команды.

START <start-number>

Указать начало диапазона номеров тестов.

END <end-number>

Указать конец диапазона номеров тестов.

STRIDE <stride-number>

Указать шаг, с которым нужно перебирать диапазон номеров тестов.

EXCLUDE <exclude-regex>

Указать регулярное выражение, соответствующее именам тестов для исключения.

INCLUDE <include-regex>

Указать регулярное выражение, соответствующее именам тестов для включения. Тесты, не соответствующие этому выражению, исключаются.

EXCLUDE_LABEL <label-exclude-regex>

Указать регулярное выражение, соответствующее меткам тестов для исключения.

INCLUDE_LABEL <label-include-regex>

Указать регулярное выражение, соответствующее меткам тестов для включения. Тесты, не соответствующие этому выражению, исключаются.

EXCLUDE_FIXTURE <regex>

Если тест в наборе тестов, которые должны быть выполнены, требует определенного фикстуры, тесты настройки и очистки этого фикстуры обычно автоматически добавляются в набор тестов. Этот параметр предотвращает добавление тестов настройки или очистки для фикстур, соответствующих <regex>. Обратите внимание, что все остальное поведение фикстуры сохраняется, включая зависимости тестов и пропуск тестов, у которых тесты настройки фикстуры завершились неудачей.

EXCLUDE_FIXTURE_SETUP <regex>

То же, что и EXCLUDE_FIXTURE, за исключением того, что исключаются только соответствующие тесты настройки.

EXCLUDE_FIXTURE_CLEANUP <regex>

То же, что и EXCLUDE_FIXTURE, за исключением того, что исключаются только соответствующие тесты очистки.

PARALLEL_LEVEL <level>

Указать положительное число, представляющее количество тестов, которые будут запущены параллельно.

TEST_LOAD <threshold>

При параллельном запуске тестов старайтесь не запускать тесты, если они могут привести к превышению заданного порога загрузки ЦП. Если не указано, будет проверена переменная CTEST_TEST_LOAD, а затем аргумент командной строки --test-load для ctest(1). См. также параметр TestLoad в CTest Test Step.

SCHEDULE_RANDOM <ON|OFF>

Запускать тесты в случайном порядке. Это может быть полезно для обнаружения неявных зависимостей тестов.

STOP_TIME <time-of-day>

Указать время суток, в которое тесты должны прекратить выполнение.

RETURN_VALUE <result-var>

Сохранить в переменной <result-var> значение 0, если все тесты пройдены. Сохранить ненулевое значение, если что-то пошло не так.

CAPTURE_CMAKE_ERROR <result-var>

Сохранить в переменной <result-var> значение -1, если при выполнении команды возникли ошибки, и предотвратить возврат ctest ненулевого значения, если произошла ошибка.

QUIET

Подавить любые специфичные для CTest не относящиеся к ошибкам сообщения, которые в противном случае были бы выведены на консоль. Вывод из базовой команды теста не изменяется. Сводная информация, описывающая процент прошедших тестов, также не затрагивается параметром QUIET.

См. также переменные CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE и CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE.