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 для более подробного обсуждения использования тестовых фикстур.