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