简介
在测试中，为了度量代码质量，代码覆盖率被作为一种测试结果的评判依据，在Python代码中用来分析代码覆盖率的工具有很多，Coverage就是其中一个。代码覆盖率是由特定的测试套件覆盖被侧源代码的程度来度量，Coverage是一种用于统计Python代码覆盖率的工具，通过它可以测试代码的有效性，即测试case对被测代码的覆盖率几何。Coverage不仅支持分支覆盖率统计，还可以生成HTML/XML报告。并且XML报告可以结合Jenkins和Sonar集成工具一起使用。
Coverage官方文档：/en/latest/
安装
Coverage作为Python的一个第三方库，使用时需要先安装，使用pip命令进行安装。
安装命令：pip install coverage
E:\python3.6.5\Scripts>pip install coverageCollecting coverageDownloading /packages/ec/9e/8d3418fecaccfae242d75e5b906b1f172a57366ec28da30ca9e5a6ce5d43/coverage-5.2.1-cp36-cp36m-win_amd64.whl (208kB)83% |██████████████████████████▊| 174kB 7.9MB/s eta 0:00:0188% |████████████████████████████▎ | 184kB 8.5MB/s eta 0:00:93% |██████████████████████████████ | 194kB 7.9MB/s eta 0:0098% |███████████████████████████████▌| 204kB 7.9MB/s eta 0:100% |████████████████████████████████| 215kB 7.9MB/sInstalling collected packages: coverageSuccessfully installed coverage-5.2.1
安装完成后可以看到安装的版本：coverage-5.2.1
安装完成后我们就可以使用coverage了，coverage有两种使用方法，一种是在命令行中使用，一种是调用API使用。方便控制部分需要测试的代码。
命令行中使用
1、基本参数
命令行中使用的文档：/en/latest/cmd.html
命令行中使用时常用参数：
run——运行Python程序并收集执行数据report——报告覆盖率结果，内容覆盖率结果json——生成JSON文件，内容覆盖率结果xml——生成XML报告文件，内容覆盖率结果erase——清除之前收集的覆盖率数据combine——合并多个数据文件debug——获取调试信息
可以使用help命令查看帮助：coverage help
2、运行代码收集信息
在使用coverage时，基本需要两步运行，第一步运行源代码，收集被测试的源代码覆盖率的信息，第二步生成代码覆盖率的信息报告。
如下测试代码：
#test.py# coding:utf-8import unittestdef add_numb(a, b):return a + bdef division_numb(a, b):return a / bclass Test(unittest.TestCase):def test_add_1(self):self.assertEqual(add_numb(1,1), 2)def test_add_2(self):self.assertEqual(add_numb(2,0), 1)def test_division_1(self):self.assertEqual(division_numb(2,1), 2)def test_division_2(self):self.assertEqual(division_numb(2,0), 2)if __name__ == "__main__":unittest.main(verbosity=2)
使用命令运行： coverage run test.py
E:\Python_Files\signal_project\test_code>coverage run test.pytest_add_1 (__main__.Test) ... oktest_add_2 (__main__.Test) ... FAILtest_division_1 (__main__.Test) ... oktest_division_2 (__main__.Test) ... ERROR======================================================================ERROR: test_division_2 (__main__.Test)----------------------------------------------------------------------Traceback (most recent call last):File "test.py", line 46, in test_division_2self.assertEqual(division_numb(2,0), 2)File "test.py", line 33, in division_numbreturn a / bZeroDivisionError: division by zero======================================================================FAIL: test_add_2 (__main__.Test)----------------------------------------------------------------------Traceback (most recent call last):File "test.py", line 40, in test_add_2self.assertEqual(add_numb(2,0), 1)AssertionError: 2 != 1----------------------------------------------------------------------Ran 4 tests in 0.001sFAILED (failures=1, errors=1)
代码执行完成后会生成一个覆盖率统计结果文件：coverage。该文件名可通过设置COVERAGE_FILE环境变量进行修改。
3、生成报告
查看报告有两种方式，一种是在当前命令行模式下查看，一种是生成HTML报告文件查看。
命令行模式下查看
根据运行代码后生成的.coverage文件，使用report参数可在命令行模式下查看覆盖率统计结果。
使用命令：coverage report
E:\Python_Files\signal_project\test_code>coverage reportNameStmts Miss Cover-----------------------------test.py170 100%
由结果可以得知，执行test.py文件，代码覆盖率是100%
结果展示中的字段含义：
tmts：语句总数Miss：未执行到的语句数Cover：覆盖率，计算公式 Cover=(Stmts-Miss)/Stmts
生成HTML报告文件
使用命令行生成HTML报告：coverage html -d covhtml
其中参数-d是指定生成的html所在的文件夹名
命令执行完成后会生成一个covhtml文件。
文件中的index.html文件覆盖率数据统计。
也可以看一些示例：/files/sample_coverage_html/
各字段说明：
Stmts 总的有效代码行数（不包含空行和注释行）Miss 未执行的代码行数（不包含空行和注释行）Branch 总分支数BrMiss 未执行的分支数Cover 代码覆盖率Missing 未执行的代码部分在源文件中行号
以执行的测试原文件命名的文件，可以高亮显示覆盖和未覆盖的代码。如test.html。
也可以看一些示例，如/code/coverage/sample_html/
调用API使用
调用API使用文档：/en/latest/api.html
在Python代码中通过调用coverage模块执行代码生成代码覆盖率的统计结果。使用方法也非常简单，如下示例：
if __name__ == "__main__":# 实例化对象cov = coverage.coverage()# 开始分析cov.start()suite = unittest.defaultTestLoader.discover(os.getcwd(), "test.py")unittest.TextTestRunner().run(suite)# 结束分析cov.stop()# 结果保存cov.save()# 命令行模式展示结果cov.report()# 生成HTML覆盖率报告cov.html_report(directory='covhtml')
