ctest_test

Выполнить шаг тестирования CTest как клиент панели мониторинга.

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>]
           [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>

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

PARALLEL_LEVEL <level>

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

TEST_LOAD <threshold>

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

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.