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 не указан, используется имя модели по умолчанию. Это заменяет устаревший параметр 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

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