忽略指定目錄及其子目錄下的所有模塊和包。參數(shù)可為 os.pathsep 分隔的目錄列表。

編程接口

class trace.Trace(count=1, trace=1, countfuncs=0, countcallers=0, ignoremods=(), ignoredirs=(), infile=None, outfile=None, timing=False)

創(chuàng)建一個(gè)對(duì)象來(lái)跟蹤單個(gè)語(yǔ)句或表達(dá)式的執(zhí)行。所有參數(shù)均為選填。 count 可對(duì)行號(hào)計(jì)數(shù)。 trace 啟用單行執(zhí)行跟蹤。 countfuncs 可列出運(yùn)行過(guò)程中調(diào)用的函數(shù)。 countcallers 可跟蹤調(diào)用關(guān)系。 ignoremods 是要忽略的模塊或包的列表。ignoredirs 是要忽略的模塊或包的目錄列表。 infile 是個(gè)文件名，從該文件中讀取存儲(chǔ)的計(jì)數(shù)信息。 outfile 是用來(lái)寫(xiě)入最新計(jì)數(shù)信息的文件名。 timing 可以顯示相對(duì)于跟蹤開(kāi)始時(shí)間的時(shí)間戳。

• run(cmd)

  執(zhí)行命令，并根據(jù)當(dāng)前跟蹤參數(shù)從執(zhí)行過(guò)程中收集統(tǒng)計(jì)數(shù)據(jù)。 cmd 必須為字符串或 code 對(duì)象，可供傳入 exec()。

• runctx(cmd, globals=None, locals=None)

  在定義的全局和局部環(huán)境中，執(zhí)行命令并收集當(dāng)前跟蹤參數(shù)下的執(zhí)行統(tǒng)計(jì)數(shù)據(jù)。若沒(méi)有定義 globals 和 locals ，則默認(rèn)為空字典。

• runfunc(func, /, \args, **kwds*)

  在 Trace 對(duì)象的控制下，用給定的參數(shù)調(diào)用 func，并采用當(dāng)前的跟蹤參數(shù)。

• results()

  返回一個(gè) CoverageResults 對(duì)象，包含之前對(duì)指定 Trace 實(shí)例調(diào)用 run、runctx 和 runfunc 的累積結(jié)果。 累積的跟蹤結(jié)果不會(huì)重置。

class trace.CoverageResults

存放代碼覆蓋結(jié)果的容器，由 Trace.results() 創(chuàng)建。用戶不應(yīng)直接去創(chuàng)建。

• update(other)

  從另一個(gè) CoverageResults 對(duì)象中合并代碼覆蓋數(shù)據(jù)。

• write_results(show_missing=True, summary=False, coverdir=None)

  寫(xiě)入代碼覆蓋結(jié)果。設(shè)置 show_missing 可顯示未命中的行。設(shè)置*summary* 可在輸出中包含每個(gè)模塊的覆蓋率摘要信息。 coverdir 可指定覆蓋率結(jié)果文件的輸出目錄，為 None 則結(jié)果將置于源文件所在目錄中。

以下例子簡(jiǎn)單演示了編程接口的用法：

 
 
 
 

  
  
  
  
import sys
  
  
  
  
import trace
  
  
  
  

  
  
  
  
# create a Trace object, telling it what to ignore, and whether to
  
  
  
  
# do tracing or line-counting or both.
  
  
  
  
tracer = trace.Trace(
  
  
  
  
 ignoredirs=[sys.prefix, sys.exec_prefix],
  
  
  
  
 trace=0,
  
  
  
  
 count=1)
  
  
  
  

  
  
  
  
# run the new command using the given tracer
  
  
  
  
tracer.run('main()')
  
  
  
  

  
  
  
  
# make a report, placing output in the current directory
  
  
  
  
r = tracer.results()
  
  
  
  
r.write_results(show_missing=True, coverdir=".")