add_test

Добавить тест в проект, который будет запущен ctest(1).

add_test(NAME <name> COMMAND <command> [<arg>...]
         [CONFIGURATIONS <config>...]
         [WORKING_DIRECTORY <dir>]
         [COMMAND_EXPAND_LISTS])

Добавляет тест с именем <name>. Имя теста может содержать произвольные символы, выраженные в виде Цитируемого аргумента или Аргумента в скобках, если это необходимо. См. политику CMP0110.

CMake генерирует тесты только если был вызван команда enable_testing(). Модуль CTest вызывает enable_testing автоматически, если BUILD_TESTING не установлено в OFF.

Тесты, добавленные с помощью add_test(NAME) подписи, поддерживают использование generator expressions в свойствах тестов, установленных командами set_property(TEST) или set_tests_properties(). Свойства тестов могут быть установлены только в каталоге, где тест создан.

add_test параметры:

COMMAND

Укажите командную строку для теста. Если <command> указывает целевой исполняемый файл, созданный с помощью add_executable(), он будет автоматически заменён на местоположение исполняемого файла, созданного во время сборки.

Команду можно указать с помощью generator expressions.

CONFIGURATIONS

Ограничить выполнение теста только для указанных конфигураций.

WORKING_DIRECTORY

Установить свойство теста WORKING_DIRECTORY, в котором нужно выполнить тест. Если не указано, тест будет выполнен в CMAKE_CURRENT_BINARY_DIR. Рабочий каталог может быть указан с помощью generator expressions.

COMMAND_EXPAND_LISTS

Новая версия 3.16.

Списки в COMMAND аргументах будут расширены, включая те, которые созданы с помощью generator expressions.

Если тест завершается с кодом 0, тест проходит. Код возврата, отличный от нуля, означает "неудавшегося" тест. Свойство теста WILL_FAIL инвертирует эту логику. Обратите внимание, что системные ошибки теста, такие как сегментоошибки или ошибки кучи, всё равно приведут к провалу теста, даже если WILL_FALL истина. Вывод, выведенный в stdout или stderr, захватывается ctest(1) и влияет на статус "пройти/не пройти" только через свойства PASS_REGULAR_EXPRESSION, FAIL_REGULAR_EXPRESSION или SKIP_REGULAR_EXPRESSION теста.

Пример использования:

add_test(NAME mytest
         COMMAND testDriver --config $<CONFIG>
                            --exe $<TARGET_FILE:myexe>)

Это создаёт тест mytest, чья команда запускает testDriver инструмент, передавая имя конфигурации и полный путь к исполняемому файлу, созданному целевым объектом myexe.

Синтаксис команды выше рекомендуется по сравнению со старой, менее гибкой формой:

add_test(<name> <command> [<arg>...])

Добавить тест с именем <name> с заданной командной строкой.

В отличие от вышеуказанной NAME подписи, имена целевых объектов не поддерживаются в командной строке. Кроме того, тесты, добавленные с помощью этой подписи, не поддерживают generator expressions в командной строке или свойствах тестов.