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)

Позже, в другом скрипте %%%CODE_BLOCK_21%% инструмента:

ctest_start(APPEND)

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

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