Coverage简介

Coverage是一种用于统计Python代码覆盖率的工具,通过它可以检测测试代码对被测代码的覆盖率如何。Coverage支持分支覆盖率统计,可以生成HTML/XML报告。

官方文档:http://coverage.readthedocs.org/en/latest/

获取地址:http://pypi.python.org/pypi/coverage

也可以通过easy_install或pip安装:easy_install coverage。

安装后在Python27\Scripts文件夹下生成coverage.exe等工具,在path中加环境变量C:\Python27\Scripts,便可以在命令行中调用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参数,就可以在命令里看到统计的结果。

overlapadd python实现 python coverage_overlapadd python实现

Stmts/Miss表示语句总数/未执行到的语句数

Cover=(Stmts-Miss)/Stmts

c. html

生成html的测试报告。

$ coverage html -d covhtml

生成的报告直接关联代码,高亮显示覆盖和未覆盖的代码,支持排序。-d指定html文件夹。可以在这个地址预览一下:http://nedbatchelder.com/code/coverage/sample_html/

效果如下:

overlapadd python实现 python coverage_代码覆盖率_02

测试文件:

overlapadd python实现 python coverage_html_03

 

高亮显示覆盖的和未覆盖的代码,覆盖的用绿色标示,未覆盖的用红色标示。

注: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

overlapadd python实现 python coverage_命令行_04

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停止后可以出结果