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

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

Доступные опции:

BUILD <build-dir>

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

APPEND

Отметить результаты для добавления к ранее отправленным на сервер панели мониторинга с момента последнего вызова ctest_start(). Семантика добавления определяется используемым сервером панели мониторинга.

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, если все тесты прошли успешно. Сохранить ненулевое значение, если что-то пошло не так.

QUIET

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

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