FIXTURES_SETUP

Указывает список фикстур, для которых тест рассматривается как тестовый фикстурный запуск.

Тесты фикстурного запуска — это обычные тесты со всеми обычными функциональными возможностями тестов. Установка свойства FIXTURES_SETUP для теста оказывает два основных эффекта:

• CTest гарантирует, что тест выполняется перед любым другим тестом, который перечисляет фикстуру(ы) в своём свойстве FIXTURES_REQUIRED.
• Если CTest запрошено запустить только подмножество тестов (например, с помощью регулярных выражений или параметра --rerun-failed), и тестовый запуск фикстуры не входит в набор запускаемых тестов, он будет автоматически добавлен, если какие-либо тесты в наборе требуют какую-либо фикстуру, перечисленную в FIXTURES_SETUP.

Тест фикстурного запуска может иметь несколько фикстур, перечисленных в его свойстве FIXTURES_SETUP. Он будет выполняться только один раз для всего выполнения CTest, а не один раз для каждой фикстуры. Фикстура также может иметь более одного определённого тестового запуска фикстуры. Если для фикстуры определено несколько тестовых запусков фикстуры, проекты могут контролировать их порядок с помощью обычного свойства теста DEPENDS, если это необходимо.

Тестовый запуск фикстуры может потребовать других фикстур, но не любых фикстур, перечисленных в его свойстве FIXTURES_SETUP. Например:

# Ok: dependent fixture is different to setup
set_tests_properties(setupFoo PROPERTIES
  FIXTURES_SETUP    Foo
  FIXTURES_REQUIRED Bar
)

# Error: cannot require same fixture as setup
set_tests_properties(setupFoo PROPERTIES
  FIXTURES_SETUP    Foo
  FIXTURES_REQUIRED Foo
)

Если какой-либо из тестовых запусков фикстуры завершится неудачно, ни один из тестов, перечисляющих эту фикстуру в своём свойстве FIXTURES_REQUIRED, не будет запущен. Однако тесты очистки всё равно будут выполнены.

См. FIXTURES_REQUIRED для более подробного обсуждения использования фикстур тестов.