使用coverage工具统计python单元测试覆盖率
Coverage简介
Coverage是一种用于统计Python代码覆盖率的工具,通过它可以检测测试代码对被测代码的覆盖率如何。Coverage支持分支覆盖率统计,可以生成HTML/XML报告。
官方文档:http://coverage.readthedocs.org/en/latest/
获取地址:http://pypi.python.org/pypi/coverage
也可以通过easy_install或pip安装:easy_install coverage。
安装后在Python27Scripts文件夹下生成coverage.exe等工具,在path中加环境变量C:Python27Scripts,便可以在命令行中调用coverage命令来进行覆盖率分析。
Coverage使用
1.命令行方式
详见:http://coverage.readthedocs.io/en/latest/cmd.html
可以使用help命令查看帮助:$ coverage help
关键命令如下:
A.run
执行代码覆盖率统计,只需要通过coverage的run参数执行被统计代码即可。
$ coverage run test.py arg1 arg2
test.py是测试脚本,arg1 arg2是test.py执行需要的参数。跑完后,会自动生成一个覆盖率统计结果文件(data file):.coverage。
B.report
有了覆盖率统计结果文件,只需要再运行report参数,就可以在命令里看到统计的结果。
Stmts/Miss表示语句总数/未执行到的语句数
Cover=(Stmts-Miss)/Stmts
c. html
生成html的测试报告。
$ coverage html -d covhtml
生成的报告直接关联代码,高亮显示覆盖和未覆盖的代码,支持排序。-d指定html文件夹。可以在这个地址预览一下:http://nedbatchelder.com/code/coverage/sample_html/
效果如下:
测试文件:
高亮显示覆盖的和未覆盖的代码,覆盖的用绿色标示,未覆盖的用红色标示。
注:coverage run test.py命令运行的文件,会统计项目中包括测试文件本身在内的所有文件,run参数的子参数—source可以指定要统计的文件:$ coverage run --source=totest.py test.py 可以只统计totest.py文件。
d.combine
合并多份覆盖率数据文件,把需要合并的覆盖率结果数据文件放在同一个目录里,然后执行coverage combine即可。但是对目录里的结果文件名的格式有要求,需要合并的文件必须有同样的前缀,然后后面跟一个名称(通常是机器名),然后再跟一个数字(通常是进程ID),比如:.coverage.75FEC5D4B3ADAAA.14632.213308
为了方便执行结果的合并,我们在前面执行统计时,在run参数后面跟一个-p参数,会自动生成符合合并条件的结果文件。
e.run参数的子参数1:--branch 统计分支覆盖率
如果代码中的一个分支可能跳到一个以上的行,coverage.py会追踪每一个分支是否都有跳转到。
$ coverage run --branch test.py
Branch/BrPart表示分支数/未执行到的分支数
f.run参数的子参数2:--parallel-mode
$ coverage run --parallel-mode test.py
使Coverage监测被测代码子进程的覆盖率,如果被测代码是多进程的,如一些web程序等,必须使用此参数。
2.API方式
除了使用命令行,还可以在python代码中直接调用coverage模块执行代码覆盖率的统计。使用方法也非常简单:
import coverage
cov = coverage.coverage(source = ['totest'])
cov.start()
#coding
cov.stop()
cov.report()
cov.html_report(directory='covhtml')
source指定要执行统计的文件,source = ['totest']只统计totest.py的覆盖率
directory指定生成html的路径
使用Coverage统计web程序的覆盖率
web程序一般是开启服务后循环监听消息,不会自动退出。而Coverage在实现上使用了atexit模块注册一个回调函数,在Python退出时将内存中的覆盖率结果写到文件中。被测脚本只有正常退出或者以SIGINT 2信号退出才能出发atexit,才能得到覆盖率结果。CTRL+C发的即是SIGINT 2信号,所以前台启动的服务用CTRL+C停止后可以出结果。