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