16.4.3 代码覆盖
给定–count选项时,从命令行trace会生成代码覆盖报告信息,详细列出运行了哪些代码行,而哪些行被跳过。由于复杂的程序通常由多个文件组成,所以会为各个文件分别生成一个单独的覆盖报告。默认地,覆盖报告文件会写至模块所在的目录,根据模块来命名,不过扩展名是.cover而不是.py。
这里会生成两个输出文件。main2.cover和recurse.cover
说明:尽管代码行def recurse(level):计数为1,但这并不表示这个函数只运行了一次。实际上,它表示只执行了一次函数定义。这同样适用于def not_called():,因为即使这个函数本身从未调用,也会评估函数定义。
还可以提供不同的选项让这个程序运行多次,来保存覆盖数据并生成一个合并的报告。第一次运行trace并提供一个输出文件时,如果创建文件之前试图加载现有数据与新结果合并,那么便会报告一个错误。
一旦覆盖信息被记录到.cover文件,那么要生成报告,可以使用–report选项。
由于这个程序运行了3次,所以覆盖报告显示出,值比第一个报告中大了3倍。–summary选项会在输出中增加百分比覆盖信息。recurse模块只覆盖了83%。查看recurse的覆盖文件可以看到,如>>>>>>前缀所指示的,not_called()的体实际上从未运行。