ctest_start

Выполняет шаг запуска CTest в качестве клиента панели мониторинга.

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