ctest_start

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

ctest_start(<model> [<source> [<binary>]] [TRACK <track>] [QUIET])

ctest_start([<model> [<source> [<binary>]]] [TRACK <track>] APPEND [QUIET])

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

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

<model>

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

<source>

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

<binary>

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

TRACK <track>

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

APPEND

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

ctest_start(Experimental TRACK TrackExperimental)

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

ctest_start(APPEND)

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

QUIET

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

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

ctest_start(Experimental path/to/source path/to/binary TRACK SomeTrack QUIET APPEND)

ctest_start(TRACK SomeTrack Experimental QUIET path/to/source APPEND path/to/binary)

ctest_start(APPEND QUIET Experimental path/to/source TRACK SomeTrack path/to/binary)

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

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