CTestCoverageCollectGCOV

Этот модуль предоставляет функцию ctest_coverage_collect_gcov.

Эта функция запускает gcov для всех файлов .gcda, найденных в бинарном дереве, и упаковывает полученные файлы .gcov в архив tar. Этот архив также содержит следующее:

• data.json определяет каталоги исходного кода и сборки для использования CDash.
• Labels.json указывает все LABELS, которые были установлены для файлов исходного кода.
• Каталог uncovered содержит все не покрытые файлы, найденные с помощью CTEST_EXTRA_COVERAGE_GLOB.

После создания этого архива tar его можно отправить в CDash для отображения с помощью команды ctest_submit(CDASH_UPLOAD).

ctest_coverage_collect_gcov

ctest_coverage_collect_gcov(TARBALL <tarfile>
  [SOURCE <source_dir>][BUILD <build_dir>]
  [GCOV_COMMAND <gcov_command>]
  [GCOV_OPTIONS <options>...]
  )

Запустить gcov и упаковать архив tar для CDash. Доступны следующие параметры:

TARBALL <tarfile>

Укажите расположение файла .tar, который будет создан для последующей загрузки в CDash. Относительные пути будут интерпретированы относительно каталога сборки верхнего уровня.

TARBALL_COMPRESSION <option>

Добавлен в версии 3.18.

Укажите алгоритм сжатия для файла данных TARBALL. Использование этого параметра уменьшает размер файла данных перед отправкой в CDash. <option> должен быть одним из GZIP, BZIP2, XZ, ZSTD, FROM_EXT, или выражением, которое CMake обрабатывает как FALSE. Значение по умолчанию равно BZIP2.

Если FROM_EXT указан, результирующий файл будет сжат в соответствии с расширением файла <tarfile> (например, .tar.gz будет использовать сжатие GZIP). Расширения файлов, которые приведут к сжатому выводу, включают .tar.gz, .tgz, .tar.bzip2, .tbz, .tar.xz, и .txz.

SOURCE <source_dir>

Укажите каталог верхнего уровня исходного кода для сборки. Значение по умолчанию - значение переменной CTEST_SOURCE_DIRECTORY.

BUILD <build_dir>

Укажите каталог верхнего уровня сборки. Значение по умолчанию - значение переменной CTEST_BINARY_DIRECTORY.

GCOV_COMMAND <gcov_command>

Укажите полный путь к команде gcov на компьютере. Значение по умолчанию - значение переменной CTEST_COVERAGE_COMMAND.

GCOV_OPTIONS <options>...

Укажите параметры, которые будут переданы в gcov. Команда gcov будет запущена как gcov <options>... -o <gcov-dir> <file>.gcda. Если не указано, параметр по умолчанию - просто -b -x.

GLOB

Добавлен в версии 3.6.

Рекурсивно ищет файлы .gcda в каталоге build_dir вместо определения расположений поиска путем чтения файла TargetDirectories.txt.

DELETE

Добавлен в версии 3.6.

Удалить файлы покрытия после их упаковки в .tar.

QUIET

Скрыть сообщения, не являющиеся ошибками, которые в противном случае были бы выведены этой функцией.

Добавлен в версии 3.3: Добавлена поддержка переменной CTEST_CUSTOM_COVERAGE_EXCLUDE.