ctest_submit

Выполняет CTest Submit Step в качестве Dashboard Client.

ctest_submit([PARTS <part>...] [FILES <file>...]
             [SUBMIT_URL <url>]
             [BUILD_ID <result-var>]
             [HTTPHEADER <header>]
             [RETRY_COUNT <count>]
             [RETRY_DELAY <delay>]
             [RETURN_VALUE <result-var>]
             [CAPTURE_CMAKE_ERROR <result-var>]
             [QUIET]
             )

Отправляет результаты на сервер панели мониторинга. По умолчанию отправляются все доступные части.

Доступны следующие параметры:

PARTS <part>...

Указывает подмножество частей для отправки. Если заданы оба параметра, имеет приоритет над переменной CTEST_SUBMIT_PARTS. Допустимые имена частей:

• Start — ничего.
• Update — результаты ctest_update(), в Update.xml.
• Configure — результаты ctest_configure(), в Configure.xml.
• Build — результаты ctest_build(), в Build.xml.
• Test — результаты ctest_test(), в Test.xml.
• Coverage — результаты ctest_coverage(), в Coverage.xml.
• MemCheck — результаты ctest_memcheck(), в DynamicAnalysis.xml и DynamicAnalysis-Test.xml.
• Notes — файлы, перечисленные в CTEST_NOTES_FILES, в Notes.xml.
• ExtraFiles — файлы, перечисленные в CTEST_EXTRA_SUBMIT_FILES.
• Upload — файлы, подготовленные для загрузки командой ctest_upload(), в Upload.xml.
• Submit — ничего.
• Done — сборка завершена, в Done.xml.

FILES <file>...

Указывает явный список файлов для отправки. Каждый файл должен существовать на момент вызова.

SUBMIT_URL <url>

Добавлено в версии 3.14.

http или https URL-адрес сервера панели мониторинга, на который нужно отправить данные. Если не указан, используется переменная CTEST_SUBMIT_URL.

BUILD_ID <result-var>

Добавлено в версии 3.15.

Сохраняет в переменной <result-var> идентификатор, присвоенный этой сборке CDash.

HTTPHEADER <HTTP-header>

Добавлено в версии 3.9.

Указывает заголовок HTTP, который будет включен в запрос к CDash при отправке. Например, CDash можно настроить так, чтобы он принимал отправки только от аутентифицированных клиентов. В этом случае следует указать токен Bearer в заголовке:

ctest_submit(HTTPHEADER "Authorization: Bearer <auth-token>")

Этот подопцию можно указывать несколько раз, чтобы добавить несколько заголовков.

RETRY_COUNT <count>

Указывает, сколько раз повторять отправку при истечении времени ожидания.

RETRY_DELAY <delay>

Указывает, сколько времени (в секундах) ждать после истечения времени ожидания отправки, прежде чем повторить попытку.

RETURN_VALUE <result-var>

Сохраняет в переменной <result-var> значение 0 при успехе и ненулевое значение при ошибке.

CAPTURE_CMAKE_ERROR <result-var>

Добавлено в версии 3.13.

Сохраняет в переменной <result-var> значение -1 при возникновении ошибок во время выполнения команды и не позволяет ctest(1) возвращать ненулевой код завершения при ошибке.

QUIET

Добавлено в версии 3.3.

Подавляет все сообщения, не являющиеся сообщениями об ошибках, которые в противном случае выводились бы в консоль.

Отправка через API загрузки CDash

ctest_submit(CDASH_UPLOAD <file> [CDASH_UPLOAD_TYPE <type>]
             [SUBMIT_URL <url>]
             [BUILD_ID <result-var>]
             [HTTPHEADER <header>]
             [RETRY_COUNT <count>]
             [RETRY_DELAY <delay>]
             [RETURN_VALUE <result-var>]
             [QUIET])

Эта вторая сигнатура используется для загрузки файлов в CDash через API загрузки файлов CDash. Сначала API отправляет в CDash запрос на загрузку вместе с хешем содержимого файла. Если файла еще нет в CDash, он загружается. Вместе с файлом указывается строка типа CDash, которая сообщает CDash, какой обработчик использовать для обработки данных.

Эта сигнатура интерпретирует параметры так же, как и первая.