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