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