e fz @ sl 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 y d d l m Z Wn" e k
r d d l m Z Yn Xy 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/ d0 Z+ d d1 d2 Z, d3 d4 Z- e. d5 k rhe% n d S)6a 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) monotonic)timec C s t j d d S)N)syssettrace r r */opt/alt/python34/lib64/python3.4/trace.py _unsettraceH s r c C s t j | t j | d S)N) threadingr r )funcr r r
_settraceK s
r c C s t j d t j d d S)N)r r r r r r r
r O 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
_usageS 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 sT | s t n t | | _ | s* g n d d | D | _ i d d 6| _ 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$ 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 | | | | z %s.%s -> %s.%s.pyc.pyoNr z.coverr; d z lines cov% module (path)z%5d %3d%% %s (%s)wbz"Can't save counts files because %sr< )rT rU )!r? rJ sortedr@ r= rQ itemsrP rO r r dirnameabspathr1 existsmakedirsr: _find_executable_linenos linecachegetlinesjoinrD tokenizedetect_encodingreadlinewrite_results_fileintr rB dumprG r rK )!r Z show_missingsummarycoverdirZcallsr& r' funcnameZlastfileZ lastcfileZpfileZpmodZpfunccfileZcmodZcfuncZper_filelineno lines_hitZsumscountr9 lnotabsourceZ coverpathfpencoding_n_hitsn_linesZpercentmrL r r r
write_results
s|
+
!
z CoverageResults.write_resultsc C sN 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~ W| j | | f S)
z'Return a coverage results file in path.wrs z2trace: Could not open %r for writing: %s- skippingr< r Nr z%5d: z z>>>>>> )r r ) rD rG rJ r rK enumerater rx_blankmatchPRAGMA_NOCOVER
expandtabsclose) r r linesrp rn rs r rL rv ru rm liner r r
rf b s,
z"CoverageResults.write_results_file)r* r+ r, r" rP rE rx rf r r r r
r s Uc C sC i } x6 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_filenamer1 co_namer gcZ
get_referrersr4 r* )
r framer r& r' rk ZclsnameZfuncsZdictsZclassesr r r
file_module_function_of s,
z Trace.file_module_function_ofc C sG | d k rC | j | } | j | j } d | j | | f | } | j |
d
| d? |
nQ| t _ | d } t j j | d t j d | d | } yf t | } t | j | dD } Wd QXi | dE 6dF dG 6d dH 6d dI 6} | j | | | WnQ t k
r-} z t dJ t j d | f WYd d } ~ Xn t k
r>Yn X| j! } | sm| j |
d
| d? |
n d S)KNr r ztcrRf:d:msC:lTghelpversionr ro reportz no-reportri 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 runrA r rj r r r r r r r r* __package__
__cached__z Cannot run file %r because: %s)"getoptr r errorrK r r r stdoutsplitappendstripr pathsepr
expandvarsr6 rb base_prefixr base_exec_prefixr r r4 r rx r rD r r r rG
SystemExitr ) r r ZoptsZ prog_argvr r ro r Z no_reportZ counts_filer Zignore_modulesZ ignore_dirsrj ri r r r Zoptvalr( sr Zprognametrr 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
usage0 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" 6 s
zIgnore.__init__)r* r+ r, r" r r r r
r 5 s r c C s t d t d t | S)Nz*The trace.modname() function is deprecatedr )r r r1 )r r r r
modname; s
r c C s t d t d t | S)Nz.The trace.fullmodname() function is deprecatedr )r r r: )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_codeE 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_linesJ s
r c C s t d t d t | d d S)Nz/The trace.find_strings() function is deprecatedr rs )r r r )r& rs r r r
find_stringsO 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_linenosT s
r r )/__doc____all__r` r rer r rc r r r rB warningsr r r r r ImportErrorr r r r r r~ r r| r r1 r: r r r r r_ r r r r r r r r r r r r* r r r r
1 s^
-2