YfA{ @ s@ d Z d d g Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l
Z
d d l Z d d l m
Z d d l m Z y d d l Z Wn' e k
r e j Z d d Z Yn Xd d
Z d d Z d d
Z d Z e j d Z Gd d d Z d d Z d d Z Gd d d Z d d Z d d Z d d d Z! d d Z" Gd d d Z# d d! Z$ d d" d# Z% d$ d% Z& Gd& d' d' e Z' d( d) Z( d* d+ Z) d, d- Z* d. d/ Z+ d d0 d1 Z, d2 d3 Z- e. d4 k r<e% d S)5a 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.base_prefix, sys.base_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")
TraceCoverageResults N)warn) monotonicc C s t j d d S)N)syssettrace r r */opt/alt/python35/lib64/python3.5/trace.py _unsettraceE s r
c C s t j | t j | d S)N) threadingr r )funcr r r _settraceH s
r
c C s t j d t j d d S)N)r r r r r r r r
L s
c C s | j d t j d d S)Na Usage: %s [OPTIONS] [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 .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 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= Directory where the report files. The coverage
report for . is written to file
//.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= Ignore the given module(s) and its submodules
(if it is a package). Accepts comma separated
list of module names
--ignore-dir= Ignore files in the given directory (multiple
directories can be joined by os.pathsep).
r )writer argv)outfiler r r _usageP s *r z#pragma NO COVERz ^\s*(#.*)?$c @ s. e Z d Z d d d d Z d d Z d S)_IgnoreNc C sS | s t n t | | _ | s* g n d d | D | _ d d i | _ d S)Nc S s" g | ] } t j j | q Sr )ospathnormpath).0dr r r
s z$_Ignore.__init__..z )set_mods_dirs_ignore)selfmodulesdirsr r r __init__ s
z_Ignore.__init__c C s | | j k r | j | S| | j k r: d | j | r@ r? r ferrr r r r! s, zCoverageResults.__init__c C s | j d o | j d S)z_Return True if the filename does not refer to a file
we want to have reported.
<>)r# endswith)r r% r r r is_ignored_filename s z#CoverageResults.is_ignored_filenamec C s | j } | j } | j } | j } | j } | j } x, | D]$ } | j | d | | | | r? get) r otherr< r> r? Z other_countsZother_calledfuncsZ
other_callerskeyr r r rD s
"
zCoverageResults.updateTFc ! C s | j rZ t t d | j } x4 t | D]& \ } } } t d | | | f q0 W| j r$t t d d } } x t | j D] \ \ }
} } \ }
} } |
| k r t t d |
d |
} d } |
|
k r| |
k rt d |
|
} t d | | | | f q Wi } xH | j D]= \ } } | j | i } | | <| j | | f | | z %s.%s -> %s.%sz.pycNr z.coverr: d z lines cov% module (path)z%5d %3d%% %s (%s)wbz"Can't save counts files because %sr; )!r> rI sortedr? r< rQ itemsrP rO r r dirnameabspathr0 existsmakedirsr9 _find_executable_linenos linecachegetlinesjoinrA tokenizedetect_encodingreadlinewrite_results_fileintr rB dumprF r rJ )!r Z show_missingsummarycoverdirZcallsr% r& funcnameZlastfileZ lastcfileZpfileZpmodZpfunccfileZcmodZcfuncZper_filelineno lines_hitZsumscountr8 lnotabsourceZ coverpathfpencoding_n_hitsn_linesZpercentmrL r r r
write_results
s~
+
z CoverageResults.write_resultsc C sR y t | d d | } WnF t k
ra } z& t d | | f d t j d SWYd d } ~ Xn Xd } d } | x t | d D] \ }
} |
| k r | j d | |
| d 7} | d 7} n^ t j | r | j d n? |
| k rt | k r| j d
| d 7} n
| j d | j | j
d q WWd QRX| | f S)
z'Return a coverage results file in path.wrq z2trace: Could not open %r for writing: %s- skippingr; r Nr z%5d: z z>>>>>> )r r ) rA rF rI r rJ enumerater rx_blankmatchPRAGMA_NOCOVER
expandtabs) r r linesrn rl rq r rL rt rs rk liner r r rd ` s,
!z"CoverageResults.write_results_file)r) r* r+ r! rP rD rv rd r r r r r s Vc C s@ i } x3 t j | D]" \ } } | | k r d | | .r c S s% g | ] } t | t r | q Sr )
isinstancer )r r r r r r # s r c S s% g | ] } t | d r | q S) __bases__)hasattr)r r r r r r & s z%s.%s) f_code co_filenamer0 co_namer gcZ
get_referrersr3 r) )
r framer r% r& ri ZclsnameZfuncsZdictsclassesr r r file_module_function_of s,
z Trace.file_module_function_ofc C sD | d k r@ | j | } | j | j } d | j | | f r? )r r< r@ r r r )r r r r results s z
Trace.results)r) r* r+ r! r r r r r r r r r r r r r r r r s 0 )
c C s2 t j j d t j d | f t j d d S)Nz%s: %s
r r )r rJ r r exit)msgr r r _err_exit s !r c # C s, d d l } | d k r! t j } yV | j | d d d d d d d d d d
d d d
d d d d d g \ } } Wnq | j k
r } zN t j j d t j d | f t j j d t j d t j d WYd d } ~ Xn Xd } d } d } d } d } d }
g } g } d }
d } d } d } d } x| D]\ } } | d k rrt t j t j d | d k rt j j d t j d | d k s| d k rd } q@| d k s| d k rd } q@| d k s| d k rd } q@| d k s| d! k r d } q@| d" k s7| d# k r@d } q@| d$ k sX| d% k rad } q@| d& k sy| d' k rd } q@| d( k s| d) k r| } q@| d* k s| d+ k rd }
q@| d, k s| d- k r| }
q@| d. k s| d/ k rd } q@| d0 k rBx* | j d1 D] } | j
| j q"Wq@| d2 k r@x | j t j
D] } t j j | } | j d3 t j j t j d4 d5 t j d d6 } | j d7 t j j t j d4 d5 t j d d6 } t j j | } | j
| qaWq@q@W| r/| s%| r/t d8 | pJ| pJ| pJ| pJ| sWt d9 | rm| rmt d: | r| rt d; | rt | d k rt d< | rt d= | d> | } | j |
d
| d? |
nK| t _ | d } t j j | d t j d | d | } yc t | } t | j | dD } Wd QRXdE | dF dG dH d dI d i } | j | | | WnQ t k
r} z t dJ t j d | f WYd d } ~ Xn t k
rYn X| j! } | s(| j |
d
| d? |
d S)KNr r ztcrRf:d:msC:lTghelpversionr rm reportz no-reportrg zfile=missingzignore-module=z ignore-dir=z coverdir= listfuncsZ
trackcallsr z%s: %s
z%Try `%s --help' for more information
Fz--helpz --versionz
trace 2.0
z-Tz --trackcallsTz-lz --listfuncsz-gz--timingz-tz--tracez-cz--countz-rz--reportz-Rz --no-reportz-fz--filez-mz --missingz-Cz
--coverdirz-sz --summaryz--ignore-module,z --ignore-dirz$prefixlibpython z $exec_prefixz8cannot specify both --listfuncs and (--trace or --count)zLmust specify one of --trace, --count, --report, --listfuncs, or --trackcallsz,cannot specify both --report and --no-reportz--report requires a --filezmissing name of file to runr@ r rh r r r r r r r) r __package__
__cached__z Cannot run file %r because: %s)"getoptr r errorrJ r r r stdoutsplitappendstripr pathsepr
expandvarsr5 r` base_prefixr base_exec_prefixr r r3 r rv r rA r r r rF
SystemExitr ) r r ZoptsZ prog_argvr r rm r Z no_reportZ counts_filer Zignore_modulesZ ignore_dirsrh rg r r r Zoptvalr' sr Zprognametrp r ZglobsrL r r r main s !
-
r c C s t d t d t | d S)Nz(The trace.usage() function is deprecated )_warnDeprecationWarningr )r r r r usage. s
r c @ s" e Z d Z d d d d Z d S)IgnoreNc C s' t d t d t j | | | d S)Nz$The class trace.Ignore is deprecatedr )r r r r! )r r r r r r r! 4 s
zIgnore.__init__)r) r* r+ r! r r r r r 3 s r c C s t d t d t | S)Nz*The trace.modname() function is deprecatedr )r r r0 )r r r r modname9 s
r c C s t d t d t | S)Nz.The trace.fullmodname() function is deprecatedr )r r r9 )r r r r fullmodname> s
r c C s t d t d t | | S)Nz7The trace.find_lines_from_code() function is deprecatedr )r r r )r r r r r find_lines_from_codeC s
r c C s t d t d t | | S)Nz-The trace.find_lines() function is deprecatedr )r r r )r r r r r
find_linesH s
r c C s t d t d t | d d S)Nz/The trace.find_strings() function is deprecatedr rq )r r r )r% rq r r r find_stringsM s
r c C s t d t d t | S)Nz:The trace.find_executable_linenos() function is deprecatedr )r r r] )r% r r r find_executable_linenosR s
r r )/__doc____all__r^ r rer r ra r r r rB warningsr r Ztimer r r ImportErrorr r
r
r r| r rz r r0 r9 r r r r r] r r r r r r r r r r r r) r r r r 1 sX
-2