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.