ctest_start

Запускает тестирование для заданной модели

ctest_start(<model> [<source> [<binary>]] [GROUP <group>] [QUIET])

ctest_start([<model> [<source> [<binary>]]] [GROUP <group>] APPEND [QUIET])

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

Параметры следующие:

<model>

Устанавливает модель панели управления. Должно быть одно из значений Experimental, Continuous, или Nightly. Этот параметр обязателен, если не указан APPEND.

<source>

Устанавливает каталог исходных файлов. Если не указано, используется значение CTEST_SOURCE_DIRECTORY.

<binary>

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

GROUP <group>

Если используется GROUP, отправка результатов будет выполняться в указанную группу на сервере CDash. Если GROUP не указано, по умолчанию используется имя модели.

Изменено в версии 3.16: Это заменяет устаревший параметр TRACK. Несмотря на изменение названия, его поведение не изменилось.

APPEND

Если используется APPEND, используется существующая TAG, а не создается новая на основе текущей отметки времени. Если используется APPEND, можно опустить параметры <model> и GROUP <group>, так как они будут считываться из сгенерированного файла TAG. Например:

ctest_start(Experimental GROUP GroupExperimental)

Позже, в другом скрипте ctest -S:

ctest_start(APPEND)

При выполнении второго скрипта ctest_start(APPEND), он будет считывать модель Experimental и группу GroupExperimental из файла TAG, сгенерированного первой командой ctest_start(). Обратите внимание, что если вы вызовете ctest_start(APPEND) и укажете другую модель или группу, чем в первой команде ctest_start(), будет выведено предупреждение, и будут использоваться новые модель и группа.

QUIET

Добавлена в версии 3.3.

Если используется QUIET, CTest будет подавлять любые сообщения, которые в противном случае были бы выведены на консоль, кроме сообщений об ошибках.

Параметры ctest_start() могут быть указаны в любом порядке, за исключением того, что <model>, <source>, и <binary> должны быть указаны в этом порядке относительно друг друга. Следующие варианты являются допустимыми и эквивалентными:

ctest_start(Experimental path/to/source path/to/binary GROUP SomeGroup QUIET APPEND)

ctest_start(GROUP SomeGroup Experimental QUIET path/to/source APPEND path/to/binary)

ctest_start(APPEND QUIET Experimental path/to/source GROUP SomeGroup path/to/binary)

Однако для лучшей читаемости рекомендуется указывать параметры в порядке, указанном в начале этой страницы.

Если переменная CTEST_CHECKOUT_COMMAND (или переменная CTEST_CVS_CHECKOUT) установлена, ее содержимое обрабатывается как командная строка. Команда вызывается с текущим рабочим каталогом, установленным в родительский каталог каталога исходных файлов, даже если каталог исходных файлов уже существует. Это можно использовать для создания дерева исходных файлов из хранилища системы управления версиями.