用于汇总gcov数据的python脚本。
gcovr的Python项目详细描述
生成gcc代码覆盖率报告
website•documentation•bugtracker•GitHub
gcovr为管理gnugcov实用程序的使用提供了一个实用程序 并生成汇总的代码覆盖率结果。这个命令是 灵感来自pythoncoverage.py包,它提供了类似的 Python的实用程序
gcovr命令可以生成不同类型的覆盖率报告:
- 默认值:精简的可读摘要
- --xml:机器可读的Cobertura格式的xml报告
- --html:HTML摘要
- --html-details:带有注释源文件的html报告
因此,可以查看gcovr 作为运行gcov的lcov实用程序的命令行替代 并生成HTML格式的报告。 GCovr的发展是由 文本摘要和XML报告。
HTML摘要示例:
HTML详细信息示例:
安装
Gcovr是一个Python包,可以通过pip安装
从pypi安装最新的stablegcovr版本:
pip install gcovr
从GitHub安装开发版本:
pip install git+https://github.com/gcovr/gcovr.git
快速启动
GCC可以检测可执行文件以发出覆盖率数据。 您需要使用以下标志重新编译代码:
-fprofile-arcs -ftest-coverage -g -O0
接下来,运行您的测试套件。 这将生成原始覆盖率文件。
最后,调用gcovr。 这将在控制台上打印表格报告。
gcovr -r .
您还可以生成详细的HTML报告:
gcovr -r . --html --html-details -o coverage.html
Gcovr将在coverage.HTML摘要旁边为每个源文件创建一个HTML报告
您应该从构建目录运行gcovr。 -r选项应该指向项目的根目录。 只有在有单独的生成目录时,这才重要。
有关完整的文档,请阅读manual
贡献
如果您想报告一个bug或参与gcovr开发, 请先阅读我们的贡献指南: https://github.com/gcovr/gcovr/blob/master/CONTRIBUTING.rst
许可证
2013-2018 gcovr作者版权所有
版权所有2013 Sandia Corporation。 根据与Sandia公司签订的de-AC04-94AL85000合同条款, 美国政府保留对该软件的某些权利。
GCovr在3条款BSD许可下可用。 有关详细信息,请参见license.txt。 有关参与者的完整列表,请参见authors.txt。
2013年9月,Gcovr development从 桑迪亚国家实验室