code-coverage - 如何在 lcov/genhtml 代码覆盖率输出中包含测试用例描述

Question

我正在使用 lcov 为 C 代码库生成代码覆盖率报告。我想将测试描述集成到最终输出中(使用 lcov 的 gendesc 实用程序。)

但是，我不知道如何做到这一点，并且关于 gendesc 的文档似乎相当稀少(就好的老谷歌能够告诉我而言。)

gendesc info at LTP描述了如何创建输入测试用例描述文件(正如 genhtml 所期望的那样)。和 genhtml info提供 --show-descriptions , 和 --description-file用于输入此类测试用例描述文件。

但是，我不知道如何引用测试用例以便将它们包含在最终报告中。 genhtml 将它们视为未使用的测试用例，因此将它们排除在生成的 html 输出之外。我可以用 --keep-descriptions ，但这并没有告诉我运行了哪些测试用例(显然是因为我不知道如何从代码到测试描述进行引用。)

那么，我们如何告诉 lcov/genhtml 在最终输出中运行了哪些测试？有任何想法吗？

Answer 1

要将测试用例名称与覆盖数据相关联，请在使用 lcov 的 --test-name 选项收集覆盖数据时指定该名称:

lcov --capture --directory project-dir --output-file coverage.info --test-name "test01"

然后继续您已经提到的步骤，即创建一个测试用例描述文件“tests.txt”:

test01
    Some test

将其转换为 genhtml 期望的格式:

gendesc tests.txt --output-filename tests.desc

最后将描述文件指定为 genhtml:

genhtml coverage.info --output-directory out --description-file tests.desc --show-details