FIXTURES_CLEANUP

Определяет список фикстур, для которых тест должен обрабатываться как тест очистки.

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

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

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

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

# Ok: Dependent fixture is different to cleanup
set_tests_properties(cleanupFoo PROPERTIES
  FIXTURES_CLEANUP  Foo
  FIXTURES_REQUIRED Bar
)

# Error: cannot require same fixture as cleanup
set_tests_properties(cleanupFoo PROPERTIES
  FIXTURES_CLEANUP  Foo
  FIXTURES_REQUIRED Foo
)

Тесты очистки будут выполняться даже если настройка или обычные тесты для данной фикстуры завершатся неудачно или будут пропущены.

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