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) установлена, ее содержимое обрабатывается как команда командной строки. Команда вызывается с текущим рабочим каталогом, установленным в родительский каталог каталога исходного кода, даже если каталог исходного кода уже существует. Это можно использовать для создания дерева исходного кода из хранилища управления версиями.