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>]
           [EXCLUDE_FIXTURE <regex>]
           [EXCLUDE_FIXTURE_SETUP <regex>]
           [EXCLUDE_FIXTURE_CLEANUP <regex>]
           [PARALLEL_LEVEL <level>]
           [RESOURCE_SPEC_FILE <file>]
           [TEST_LOAD <threshold>]
           [SCHEDULE_RANDOM <ON|OFF>]
           [STOP_ON_FAILURE]
           [STOP_TIME <time-of-day>]
           [RETURN_VALUE <result-var>]
           [CAPTURE_CMAKE_ERROR <result-var>]
           [REPEAT <mode>:<n>]
           [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>

Новое в версии 3.7.

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

EXCLUDE_FIXTURE_SETUP <regex>

Новое в версии 3.7.

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

EXCLUDE_FIXTURE_CLEANUP <regex>

Новое в версии 3.7.

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

PARALLEL_LEVEL <level>

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

RESOURCE_SPEC_FILE <file>

Новое в версии 3.16.

Указать файл спецификаций ресурсов. Подробнее см. в Распределении ресурсов.

TEST_LOAD <threshold>

Новое в версии 3.4.

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

REPEAT <mode>:<n>

Новое в версии 3.17.

Повторять тесты в соответствии с заданным <mode> до <n> раз. Режимы:

UNTIL_FAIL

Требовать, чтобы каждый тест выполнялся <n> раз без сбоев для прохождения. Это полезно для поиска спорадических сбоев в тестовых случаях.

UNTIL_PASS

Разрешить каждому тесту выполняться до <n> раз для прохождения. Повторять тесты, если они завершаются неудачей по любой причине. Это полезно для переносимости спорадических сбоев в тестовых случаях.

AFTER_TIMEOUT

Разрешить каждому тесту выполняться до <n> раз для прохождения. Повторять тесты только в случае таймаута. Это полезно для переносимости спорадических таймаутов в тестовых случаях на загруженных машинах.

SCHEDULE_RANDOM <ON|OFF>

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

STOP_ON_FAILURE

Новое в версии 3.18.

Остановить выполнение тестов после первого сбоя.

STOP_TIME <time-of-day>

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

RETURN_VALUE <result-var>

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

CAPTURE_CMAKE_ERROR <result-var>

Новое в версии 3.7.

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

QUIET

Новое в версии 3.3.

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

Также см. переменные CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE и CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE.