aRc @ st d Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k
Z
y d d k Z e Z Wn e
j
o d d k Z n Xd Z d Z e i d Z d d d YZ d Z d Z d
d d YZ d Z d
Z d Z d Z d d d YZ d Z d d Z e d j o e n d S( s program/module to trace Python program or function execution
Sample use, command line:
trace.py -c -f counts --ignore-dir '$prefix' spam.py eggs
trace.py -t --ignore-dir '$prefix' spam.py eggs
trace.py --trackcalls spam.py eggs
Sample use, programmatically
import sys
# 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 /tmp
r = tracer.results()
r.write_results(show_missing=True, coverdir="/tmp")
iNc C s | i d t i d d S( Ns Usage: %s [OPTIONS] <file> [ARGS]
Meta-options:
--help Display this help then exit.
--version Output version information then exit.
Otherwise, exactly one of the following three options must be given:
-t, --trace Print each line to sys.stdout before it is executed.
-c, --count Count the number of times each line is executed
and write the counts to <module>.cover for each
module executed, in the module's directory.
See also `--coverdir', `--file', `--no-report' below.
-l, --listfuncs Keep track of which functions are executed at least
once and write the results to sys.stdout after the
program exits.
-T, --trackcalls Keep track of caller/called pairs and write the
results to sys.stdout after the program exits.
-r, --report Generate a report from a counts file; do not execute
any code. `--file' must specify the results file to
read, which must have been created in a previous run
with `--count --file=FILE'.
Modifiers:
-f, --file=<file> File to accumulate counts over several runs.
-R, --no-report Do not generate the coverage report files.
Useful if you want to accumulate over several runs.
-C, --coverdir=<dir> Directory where the report files. The coverage
report for <package>.<module> is written to file
<dir>/<package>/<module>.cover.
-m, --missing Annotate executable lines that were not executed
with '>>>>>> '.
-s, --summary Write a brief summary on stdout for each file.
(Can only be used with --count or --report.)
-g, --timing Prefix each line with the time since the program started.
Only used while tracing.
Filters, may be repeated multiple times:
--ignore-module=<mod> Ignore the given module(s) and its submodules
(if it is a package). Accepts comma separated
list of module names
--ignore-dir=<dir> Ignore files in the given directory (multiple
directories can be joined by os.pathsep).
i ( t writet syst argv( t outfile( ( s /usr/lib/python2.6/trace.pyt usageC s *s #pragma NO COVERs ^\s*(#.*)?$t Ignorec B s e Z d d d Z d Z RS( c C sO | p g | _ | p g | _ t t i i | i | _ h d d 6| _ d S( Ni s <string>( t _modst _dirst mapt ost patht normpatht _ignore( t selft modulest dirs( ( s /usr/lib/python2.6/trace.pyt __init__v s c C s | i i | o | i | Sxp | i D]e } | | j o d | i | <d St | } | | | j o# | | d j o d | i | <d Sq) W| d j o d | i | <d Sx: | i D]/ } | i | t i o d | i | <d Sq Wd | i | <d S( Ni t .i ( R t has_keyR t lent NoneR t
startswithR t sep( R
t filenamet
modulenamet modt nt d( ( s /usr/lib/python2.6/trace.pyt names} s*
"
N( t __name__t
__module__R R R ( ( ( s /usr/lib/python2.6/trace.pyR u s c C s. t i i | } t i i | \ } } | S( s- Return a plausible module name for the patch.( R R
t basenamet splitext( R
t baseR t ext( ( s /usr/lib/python2.6/trace.pyt modname s c C s) t i i | } d } xt t i D]i } t i i | } | i | oA | t | t i j o' t | t | j o
| } q q" q" W| o | t | d } n | } t i i | \ } } | i t i d } t i o | i t i d } n t i i
| \ } } | i d S( s, Return a plausible module name for the path.t i R ( R R
t normcaseR R R R t
splitdrivet replacet altsepR t lstrip( R
t comparepatht longestt dirR! t driveR R" ( ( s /usr/lib/python2.6/trace.pyt fullmodname s"
*
t CoverageResultsc B sD e Z d d d d d d Z d Z e e d d Z d Z RS( c C sK | | _ | i d j o
h | _ n | i i | _ | | _ | i d j o
h | _ n | i i | _ | | _ | i d j o
h | _ n | i i | _ | | _ | | _ | i o yD t i t
| i d \ } } } | i | i | | | WqGt
t t f j
o# } t i d | i | f IJqGXn d S( Nt rbs Skipping counts file %r: %s( t countsR t copyt countert calledfuncst callerst infileR t picklet loadt opent updatet __class__t IOErrort EOFErrort
ValueErrorR t stderr( R
R1 R4 R6 R5 R t err( ( s /usr/lib/python2.6/trace.pyR s*
$
c C s | i } | i } | i } | i } | i } | i } x2 | i D]$ } | i | d | | | | <qC Wx | i D] } d | | <qx Wx | i D] } d | | <q Wd S( s. Merge in the data from another CoverageResultsi i N( R1 R4 R5 t keyst get( R
t otherR1 R4 R5 t other_countst other_calledfuncst
other_callerst key( ( s /usr/lib/python2.6/trace.pyR: s
"
c C s | i oO Hd GH| i i } | i x- | D]! \ } } } d | | | f GHq0 Wn | i o Hd GH| i i } | i d } } x | D] \ \ }
} } \ }
} } |
| j o Hd G|
Gd GH|
} d } n |
|
j o | |
j o d G|
GH|
} n d | | | | f GHq Wn h } xN | i i D]= \ } } | i | h } | | <| i | | f | | <q<Wh } xs| i D]e\ } } | d j o qn | i d o qn | i d o | d } n | d j o. t
i i t
i i
| } t | } n7 | } t
i i | p t
i | n t | } | o t | } n h } t i | } t
i i | | d
} | i | | | | \ } } | o5 | o. t d | | } | | | | f | | <qqW| oZ | oS | i } | i d GHx5 | D]) } | | \ } } } } d | | GHq)Wn | i ob y5 t i | i | i | i f t | i d d Wqt j
o } t i d | IJqXn d S( s!
@param coverdir
s functions called:s* filename: %s, modulename: %s, funcname: %ss calling relationships:R$ s ***s -->s %s.%s -> %s.%ss <string>s <doctest s .pycs .pyois .coverid s lines cov% module (path)s %5d %3d%% %s (%s)t wbi s" Can't save counts files because %sN( s .pycs .pyo( R4 RA t sortR5 R1 RB t iteritemsR t endswithR R R
t dirnamet abspathR# t existst makedirsR. t find_executable_linenost linecachet getlinest joint write_results_filet intR R7 t dumpR9 R< R R? ( R
t show_missingt summaryt coverdirt callsR R t funcnamet lastfilet lastcfilet pfilet pmodt pfunct cfilet cmodt cfunct per_filet linenot lines_hitt sumst countR, t lnotabt sourcet coverpatht n_hitst n_linest percentt modst mR@ ( ( s /usr/lib/python2.6/trace.pyt
write_results s
c C sE y t | d } Wn- t j
o! } t i d | | f IJd SXd } d } x t | D] \ } }
| d } | | j o- | i d | | | d 7} | d 7} nh t i |
o | i d nG | | j o, t | | j o | i d | d 7} n | i d | i | | i d q\ W| i
| | f S(
s' Return a coverage results file in path.t ws2 trace: Could not open %r for writing: %s- skippingi i s %5d: s s >>>>>> i ( i i ( R9 R< R R? t enumerateR t rx_blankt matcht PRAGMA_NOCOVERt
expandtabst close( R
R
t linesRi Rf R R@ Rm Rl t it lineRe ( ( s /usr/lib/python2.6/trace.pyRT U s0
N( R R R R R: t Truet FalseRq RT ( ( ( s /usr/lib/python2.6/trace.pyR/ s
[c
C s h } g } | i d d d D] } | t | q! ~ } t | } t } | i } x3 | D]+ } | | 7} | | j o d | | <q_ q_ W| S( s: Return dict where keys are lines in the line number table.i Ni ( t co_lnotabt ordR R} t co_firstlineno(
t codet strst linenost _[1]t ct line_incrementst table_lengtht docstringRe t li( ( s /usr/lib/python2.6/trace.pyt find_lines_from_codey s 7
c C sT t | | } x> | i D]3 } t | t i o | i t | | q q W| S( s< Return lineno dict for all code objects reachable from code.( R t co_constst
isinstancet typest CodeTypeR: t
find_lines( R R R R ( ( s /usr/lib/python2.6/trace.pyR s
c C s h } t i } t | } x t i | i D] \ } } } } } | t i j oX | t i j oD | \ } }
| \ } } x) t | | d D] }
d | |
<q Wq n | } q. W| i | S( s Return a dict of possible docstring positions.
The dict maps line numbers to strings. There is an entry for
line that contains only a string or a part of a triple-quoted
string.
i ( t tokent INDENTR9 t tokenizet generate_tokenst readlinet STRINGt rangeRx ( R R t
prev_ttypet ft ttypet tstrt startt endR{ t slinet scolt elinet ecolRz ( ( s /usr/lib/python2.6/trace.pyt find_strings s
c C st y t | d i } Wn- t j
o! } t i d | | f IJh SXt | | d } t | } t | | S( sA Return dict where keys are line numbers in the line number table.t rUs% Not printing coverage data for %r: %st exec( R9 t readR< R R? t compileR R ( R t progR@ R R ( ( s /usr/lib/python2.6/trace.pyRP s
t Tracec
B s e Z d d d d d d d d e d Z d Z d d d Z d Z d Z d Z d Z
d Z d
Z d Z
d Z d
Z RS( i i c
C s: | | _ | | _ t | | | _ h | _ h | _ h | _ d | _ | | _ h | _ h | _
h | _ d | _
| o t i | _
n | o | i | _ n | o | i | _ nz | o# | o | i | _ | i | _ nP | o | i | _ | i | _ n- | o | i | _ | i | _ n
d | _ d S( sx
@param count true iff it should count number of times each
line is executed
@param trace true iff it should print out each line that is
being counted
@param countfuncs true iff it should just output a list of
(filename, modulename, funcname,) for functions
that were called at least once; This overrides
`count' and `trace'
@param ignoremods a list of the names of modules to ignore
@param ignoredirs a list of the names of directories to ignore
all of the (recursive) contents of
@param infile file from which to read stored counts to be
added into the results
@param outfile file in which to write the results
@param timing true iff timing information be displayed
i i N( R6 R R t ignoreR1 t blabbedt pathtobasenamet donothingt tracet _calledfuncst _callerst
_caller_cacheR t
start_timet timet globaltrace_trackcallerst globaltracet globaltrace_countfuncst globaltrace_ltt localtrace_trace_and_countt
localtracet localtrace_tracet localtrace_count(
R
Rh R t
countfuncst countcallerst
ignoremodst
ignoredirsR6 R t timing( ( s /usr/lib/python2.6/trace.pyR s8 c B s d d k } | i } | i p$ e i | i e i | i n z | | | UWd | i p e i d e i d n Xd S( Ni( t __main__t __dict__R R t settraceR t threadingR ( R
t cmdR t dict( ( s /usr/lib/python2.6/trace.pyt run s
c B s | d j o
h } n | d j o
h } n | i p$ e i | i e i | i n z | | | UWd | i p e i d e i d n Xd S( N( R R R R R R ( R
R t globalst locals( ( s /usr/lib/python2.6/trace.pyt runctx s
c O sZ d } | i p t i | i n z | | | } Wd | i p t i d n X| S( N( R R R R R ( R
t funct argst kwt result( ( s /usr/lib/python2.6/trace.pyt runfunc s
c
C s | i } | i } | o t | } n d } | i } d } | | i j o) | i | d j o | i | } qn2d | i | <g } t i | D]! } t | d o | | q q ~ } t | d j o g }
t i | d D]! } t
| t o |
| q q ~
} t | d j oz g }
t i | d D]! } t | d o |
| qBqB~
} t | d j o! t | d } | | i | <qqn | d j o6 | i
d d } d i | } d | | f } n | | | f S( Nt func_doci i t __bases__R s %s.%s( t f_codet co_filenameR# R t co_nameR t gct
get_referrerst hasattrR R R t strt splitRS ( R
t frameR R R R[ t clsnameR R t funcst _[2]R t dictst _[3]R t classes( ( s /usr/lib/python2.6/trace.pyt file_module_function_of s6
$ $ $
c C sI | d j o8 | i | } | i | i } d | i | | f <n d S( sk Handler for call events.
Adds information about who called who to the self._callers dict.
t calli N( R t f_backR ( R
R t whyt argt this_funct parent_func( ( s /usr/lib/python2.6/trace.pyR > s
c C s1 | d j o | i | } d | i | <n d S( so Handler for call events.
Adds (filename, modulename, funcname) to the self._calledfuncs dict.
R i N( R R ( R
R R R R ( ( s /usr/lib/python2.6/trace.pyR I s
c C s | d j o | i } | i i d d } | oe t | } | d j oH | i i | | } | p( | i o d | | i f GHn | i Sq q d Sn d S( s Handler for call events.
If the code block being entered is to be ignored, returns `None',
else returns self.localtrace.
R t __file__s! --- modulename: %s, funcname: %sN(
R t f_globalsRB R R# R R R R R ( R
R R R R R R t ignore_it( ( s /usr/lib/python2.6/trace.pyR R s
c C s | d j o | i i } | i } | | f } | i i | d d | i | <| i o d t i | i Gn t i i | } d | | t
i | | f Gn | i S( NR{ i i s %.2fs
%s(%d): %s(
R R t f_linenoR1 RB R R R R
R RQ t getlineR ( R
R R R R Re RG t bname( ( s /usr/lib/python2.6/trace.pyR i s
c C s | d j ok | i i } | i } | i o d t i | i Gn t i i | } d | | t i | | f Gn | i
S( NR{ s %.2fs
%s(%d): %s( R R R R R R R
R RQ R R ( R
R R R R Re R ( ( s /usr/lib/python2.6/trace.pyR x s
c C sY | d j oE | i i } | i } | | f } | i i | d d | i | <n | i S( NR{ i i ( R R R R1 RB R ( R
R R R R Re RG ( ( s /usr/lib/python2.6/trace.pyR s
$c
C s1 t | i d | i d | i d | i d | i S( NR6 R R4 R5 ( R/ R1 R6 R R R ( R
( ( s /usr/lib/python2.6/trace.pyt results s ( ( N( R R R R} R R R R R R R R R R R R ( ( ( s /usr/lib/python2.6/trace.pyR s 1
-
c C s2 t i i d t i d | f t i d d S( Ns %s: %s
i i ( R R? R R t exit( t msg( ( s /usr/lib/python2.6/trace.pyt _err_exit s !c C s d d k } | d j o
t i } n yP | i | d d d d d d d d d
d d d
d d d d d g \ } } Wna | i j
oR } t i i d t i d | f t i i d t i d t i d n Xd } d } d } d } d } d }
g } g } d }
d } t } t } t } x!| D]\ } } | d j o t t i
t i d n | d j o! t i
i d t i d n | d j p
| d j o
t } q/n | d j p
| d j o
t } q/n | d j p
| d j o
t } q/n | d j p
| d j o
d } q/n | d! j p
| d" j o
d } q/n | d# j p
| d$ j o
d } q/n | d% j p
| d& j o
d } q/n | d' j p
| d( j o
| } q/n | d) j p
| d* j o
d }
q/n | d+ j p
| d, j o
| }
q/n | d- j p
| d. j o
d } q/n | d/ j o4 x* | i d0 D] } | i
| i q^Wq/n | d1 j o x | i t i D] } t i i | } | i d2 t i i t i d3 d4 t i d5 } | i d6 t i i t i d3 d4 t i d5 } t i i | } | i
| qWq/q/q/W| o | p | o t d7 n | p | p | p | p | p t d8 n | o | o t d9 n | o | o t d: n | o! t | d j o t d; n | o2 t d< | d= | } | i |
d
| d> |
nY| t _ | d } t i i | d t i d <t | | d? | d@ | dA | dB | d< | d= | d | } yz t | i i } z% | ~ } t! | i" | dC } Wd QXh | dD 6dE dF 6d dG 6d dH 6} | i# | | | WnB t$ j
o$ } t dI t i d | f n t% j
o n X| i& } | p | i |
d
| d> |
n d S(J Nii s tcrRf:d:msC:lTgt helpt versionR Rh t reports no-reportRX s file=t missings ignore-module=s ignore-dir=s coverdir=t listfuncst
trackcallsR s %s: %s
i s% Try `%s --help' for more information
s --helps --versions
trace 2.0
s -Ts --trackcallss -ls --listfuncss -gs --timings -ts --traces -cs --counts -rs --reports -Rs --no-reports -fs --files -ms --missings -Cs
--coverdirs -ss --summarys --ignore-modulet ,s --ignore-dirs $prefixt libt pythoni s $exec_prefixs8 cannot specify both --listfuncs and (--trace or --count)sL must specify one of --trace, --count, --report, --listfuncs, or --trackcallss, cannot specify both --report and --no-reports --report requires a --files missing name of file to runR6 R RY R R R R R R R R t __package__t
__cached__s Cannot run file %r because: %s(' t getoptR R R t errorR? R R R} R t stdoutR| R t appendt stripR t pathsepR
t
expandvarsR' RS t prefixR t exec_prefixR R R R/ Rq R R9 t __exit__t __enter__R R R R< t
SystemExitR ( R R t optst prog_argvR R Rh R t no_reportt counts_fileR t ignore_modulest ignore_dirsRY RX R R R t optt valR t sR t prognamet tR t fpR t globsR@ ( ( s /usr/lib/python2.6/trace.pyt main s
!
#
#
R ( ( ( ( t __doc__RQ R t reR R R R R R R t cPickleR7 t ImportErrorR Rv R Rt R R# R. R/ R R R RP R R R R R ( ( ( s /usr/lib/python2.6/trace.pyt <module>0 s>
-5
y~or5J ={Eeu磝Qk ᯘG{?+]ן?wM3X^歌>{7پK>on\jy R g/=fOroNVv~Y+ NGuÝHWyw[eQʨSb> >}Gmx[o[<{Ϯ_qF vM IENDB`
