python (3.11.7)
e r d Z ddgZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
mZ ddlZdZ G d d Zd Zd
Z G d d Zd Zd
ZddZd Z G d d Zd Ze dk r e dS dS )a 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) monotonicz#pragma NO COVERc e Zd ZddZd ZdS )_IgnoreNc |st nt | | _ |sg n d |D | _ ddi| _ d S )Nc L g | ]!}t j | "S )ospathnormpath.0ds 9/BuggyBox/python/3.11.7/bootstrap/lib/python3.11/trace.py
<listcomp>z$_Ignore.__init__.<locals>.<listcomp>H s8 *9 *9 *9./ +-'*:*:1*=*= *9 *9 *9 z<string> )set_mods_dirs_ignore)selfmodulesdirss r __init__z_Ignore.__init__F sX ");SUUUs7||
# 9RR *9 *937*9 *9 *9
#Q( r c \ || j v r
| j | S || j v r d| j |< dS | j D ]'}| |dz r
d| j |< dS (| d| j |< dS | j D ]1}| |t j z r
d| j |< dS 2d| j |< dS )Nr .r )r r
startswithr r sep)r filename
modulenamemodr s r namesz
_Ignore.namesL s % %<
+ + # #'(DL $1 : C $$S3Y//
+, Z(qq
'(DL $1
A ""1rv:..
+, Z(qq
$% Z qr NN)__name__
__module__ __qualname__r r$ r
r r r r E s7 ) ) ) ) ) ) ) ) )r r c t j | }t j | \ }}|S ),Return a plausible module name for the path.)r r basenamesplitext)r baser! exts r _modnamer/ w s7 7 D ! !DG$$T**MHc Or c t j | }d}t j D ]{}t j | }| | rE|t | t j k r"t | t | k r|}||r| t | dz d }n| }t j | \ }}| t j d }t j r | t j d }t j
| \ }}| d S )r* r Nr ) r r normcasesysr lenr
splitdrivereplacealtsepr, lstrip)r comparepathlongestdirr- driver! r. s r _fullmodnamer= ~ s0 '""4((KGx g s## ! !# & & ;s3xx+@BF+J+J3xx#g,,&& CLL1$%%&'$$T**KE4 << $ $D y ,||BIs++G$$T**MHc ??3 r c 6 e Zd Z d dZd Zd Zd
dZd dZdS ) r Nc || _ | j i | _ | j | _ || _ | j i | _ | j | _ || _ | j i | _ | j | _ || _ || _ | j r t | j d 5 }t j | \ }}}d d d n # 1 swxY w Y |
| ||| d S # t t t f$ r1}t d| j d|t j Y d }~d S d }~ww xY wd S )Nrb)callerszSkipping counts file : file)countscopycounter calledfuncsrA infileoutfileopenpickleloadupdate __class__OSErrorEOFError
ValueErrorprintr3 stderr)r rE rH rI rA rJ ferrs r r zCoverageResults.__init__ s ; DK{'')) & # !D +0022 < DL|((** ; N
N$+t,, B39;q>>0FKB B B B B B B B B B B B B B B DNN6;N P PQQQQQXz2
N
N
N)-cc;BE*N N N N N N N N N N
N
N Ns< 0D" C* D" *C..D" 1C.2.D" "E*9&E%%E*c V | d o| d S )z_Return True if the filename does not refer to a file
we want to have reported.
<>)r endswith)r r! s r is_ignored_filenamez#CoverageResults.is_ignored_filename s+ ""3''BH,=,=c,B,BBr c | j }| j }| j }|j }|j }|j }|D ]$}| |d || z ||< %|D ]}d||< |D ]}d||< dS )z.Merge in the data from another CoverageResultsr r N)rE rH rA get) r otherrE rH rA other_countsother_calledfuncs
other_callerskeys r rN zCoverageResults.update s & , | ! -
A AC **S!,,|C/@@F3KK$ ! !C K C GCLL r TFc | j rRt t d | j }t | D ] \ }}}t d|d|d| | j rt t d dx}} t | j D ]o\ \ }
} } \ }
}}|
|k r#t t d|
d |
}d} |
|
k r| |
k rt d|
|
} t d | d
| d |d
| pi }| j D ]2\ }}| |i x}||< | j ||f ||< 3i }| D ]\ }}| | r | d r
|d
d }|Lt j
t j
| }t | }nD|}t j
| st j | t! | }|rt# | }ni }t% j | }t j
||dz }t+ |d 5 }t- j |j \ }}d
d
d
n # 1 swxY w Y | ||||| \ } } |r | r t5 d| z | z } | | ||f||< |rH|rFt d t | D ]'} || \ } } }}t d|| z (| j r t+ | j d 5 } t9 j | j | j | j f| d d
d
d
d
S # 1 swxY w Y d
S # t< $ r)}!t d|!z t> j Y d
}!~!d
S d
}!~!ww xY wd
S )af
Write the coverage results.
:param show_missing: Show lines that had no hits.
:param summary: Include coverage summary per module.
:param coverdir: If None, the results of each module are placed in its
directory, otherwise it is included in the directory
specified.
zfunctions called:z
filename: z, modulename: , funcname: zcalling relationships:r1 z***z -->z r z -> z.pycNz.coverr@ d z lines cov% module (path)z%5d %3d%% %s (%s)wbr z"Can't save counts files because %srC )!rH rS sortedrA rE r] itemsr[ rZ r r dirnameabspathr/ existsmakedirsr= _find_executable_linenos linecachegetlinesjoinrK tokenizedetect_encodingreadlinewrite_results_fileintrJ rL dumprP r3 rT )"r show_missingsummarycoverdircallsr! r" funcnamelastfile lastcfilepfilepmodpfunccfilecmodcfuncper_filelineno lines_hitsumscountr; lnotabsource coverpathfpencoding_n_hitsn_linespercentmrU rV s" r
write_resultsz CoverageResults.write_results s < GGG % & & &$E28--
<
<.*h"((JJJ: < < < < < I GGG * + + +#% %Hy dl++
I
I<%%u';tUH$$GGG%... $H "IE>>i5&8&8'5))) %IdddEEE444GHHHH $ @ @ Hf-5\\(B-G-G GI* $ Xv,> ?If '~~ / / J JOHe''11
((
)#CRC= goobgooh&?&?@@ %h / /
w~~c** %K$$$ )( 3 3
1(;; '11F S*x*?@@Ih%%
D & 6r{ C C !
D
D
D
D
D
D
D
D
D
D
D
D
D
D
D " 5 5i6<eX O OOFG
J7
J cFlW 455#*GZ#IZ ;t ; 2 3 3 3D\\
;
;9=a6*h/$q'9:::: < S
S$,-- &Kd.> M !1& & && & & & & & & & & & & & & & & & & &
S
S
S:S@szRRRRRRRRRR
S
S SsN J))J- 0J- N )N N NN NN
O( O Oc 4 t |d| }n:# t $ r-}t d|d|dt j Y d}~dS d}~ww xY wd }d } |5 t |d
D ]\ }
} |
|v r)| d ||
z | d
z
} |d
z
}n=|
|v r$t | vr| d |d
z
}n| d
| | d ddd n # 1 swxY w Y | |fS )z'Return a coverage results file in path.wr ztrace: Could not open z for writing: z - skippingrC N)r r r r z%5d: z>>>>>> z ) rK rP rS r3 rT enumeratewritePRAGMA_NOCOVER
expandtabs) r r linesr r r rJ rV r r r lines r ru z"CoverageResults.write_results_file) s 4x888GG E26$$=DGJ
P
P
P
P44444
2 2 )% 3 3
2
2 Y&&MM'If,="=>>>aKFqLGGv%%n.D.D MM),,,qLGGMM),,,
dooa 0 01111
2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2" w s'
A "AA B)D DD)NNNNN)TFNN)r& r' r( r r[ rN r ru r
r r r r s =A'+N N N N4C C C $ZS ZS ZS ZSx r c P i }t j | D ]\ }}||vrd||< |S )z:Return dict where keys are lines in the line number table.r )disfindlinestarts)codestrslinenosr r s r _find_lines_from_coder I s? G'-- 6 GFO Nr c t | | }| j D ]9}t j | r#| t || :|S )z<Return lineno dict for all code objects reachable from code.)r co_constsinspectiscoderN _find_lines)r r r cs r r r S sZ $D$//G ^ 1 1 >! 1 NN;q$// 0 0 0 Nr c L i }t j }t | | 5 }t j |j }|D ]O\ }}}} }
|t j k r5|t j k r%|\ } } | \ }
}t | |
dz D ]}d||< |}P ddd n # 1 swxY w Y |S )zReturn 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.
r r N)tokenINDENTrK rr generate_tokensrt STRINGrange)r! r r
prev_ttyperU tokttypetstrstartendr slinescolelineecolis r
_find_stringsr _ s
A J
h * * * a&qz22-0 )E4T $$ --"'KE4"%KE4 "5%!) 4 4 ! ! ! JJ
Hs A,BB B c j t j | 5 }| }|j }ddd n # 1 swxY w Y n:# t $ r-}t d| d|t j i cY d}~S d}~ww xY wt || d }t | | }t || S )zAReturn dict where keys are line numbers in the line number table.Nz Not printing coverage data for rB rC exec) rr rK readr rP rS r3 rT compiler r )r! rU progr rV r r s r rn rn v s
]8
$
$ "6688DzH " " " " " " " " " " " " " " "
!)3307:z C C C C 46 * *D 8 , ,D tT " ""s= A
> A
AA
AA
B"A<6B<Bc ` e Zd Z ddZd ZddZd Zd
Zd Zd Z d
Z
d Z d Z d Z
d ZdS )r r r r
NFc
|| _ || _ t || | _ i | _ i | _ d| _ || _ i | _ i | _ i | _
d| _ | rt | _ |r| j
| _ dS |r| j | _ dS |r |r| j | _ | j | _ dS |r| j | _ | j | _ dS |r| j | _ | j | _ dS d| _ dS )ax
@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
r Nr )rI rJ r ignorerE pathtobasename donothingtrace _calledfuncs_callers
_caller_cache
start_time_timeglobaltrace_trackcallers globaltraceglobaltrace_countfuncsglobaltrace_ltlocaltrace_trace_and_count
localtracelocaltrace_tracelocaltrace_count)
r r r
countfuncs countcallers
ignoremods
ignoredirsrI rJ timings
r r zTrace.__init__ s ( j*55
& #ggDO # <D
# :D
u # 2D " =DOOO
# 2D " 3DOOO
# 2D " 3DOOO DNNNr c J dd l }|j }| ||| d S )Nr )__main____dict__runctx)r cmdr dicts r runz Trace.run s/ Ct$$$$$r c x |i }|i }| j s2t j | j t j | j t ||| | j s*t j d t j d d S d S # | j s)t j d t j d w w xY wr )r threadingsettracer r3 r )r r globalslocalss r r z Trace.runctx s ?bG >B6~ + t / 0 0 0 L) * * * ) gv & & &>
) T""""4(((((
)
)4>
) T""""4((((
)s B 2B9c d }| j st j | j ||i |}| j st j d n!# | j st j d w w xY w|S r )r r3 r r )r funcargskwresults r runfuncz
Trace.runfunc s ~ + L) * * * #T4&2&&F>
# T""" >
# T""""
#
s A A&c < |j }|j }|rt | }nd }|j }d }|| j v r| j |
| j | }nd | j |< d t j | D }t | dk rd t j |d D }t | dk rNd t j |d D } t | dk r| d j }|| j |< ||d|}|||fS )Nc : g | ]}t j | |S r
)r
isfunction)r rU s r r z1Trace.file_module_function_of.<locals>.<listcomp> s7 3 3 31 # .q 1 13Q 3 3 3r r c < g | ]}t |t |S r
)
isinstancer r s r r z1Trace.file_module_function_of.<locals>.<listcomp> s6 5 5 5q *1d 3 35 5 5 5r r c 2 g | ]}t |d |S ) __bases__)hasattr)r r s r r z1Trace.file_module_function_of.<locals>.<listcomp> s6 ? ? ?Q&-a&=&= ?q ? ? ?r r ) f_code co_filenamer/ co_namer gc
get_referrersr4 r& )
r framer r! r" r| clsnamefuncsdictsclassess
r file_module_function_ofz Trace.file_module_function_of s_ |# !(++JJ J< 4% % %!$'3 ,T2'+D t $3 3 0 6 6 3 3 3E
5zzQ5 5B$4U1X$>$> 5 5 5u::?? ? ?"*:58*D*D ? ? ?G7||q((")!*"5
4;*40 ")''884HX--r c |dk r=| | }| |j }d| j ||f< dS dS )zkHandler for call events.
Adds information about who called who to the self._callers dict.
callr N)r f_backr )r r whyarg this_func parent_funcs r r z Trace.globaltrace_trackcallers sS
&== 44U;;I 66u|DDK67DM; 2 3 3 3 =r c T |dk r!| | }d| j |< dS dS )zoHandler for call events.
Adds (filename, modulename, funcname) to the self._calledfuncs dict.
r r N)r r )r r r r r s r r z Trace.globaltrace_countfuncs s:
&== 44U;;I+,D i ( ( ( =r c |dk r|j }|j dd }|rZt | }|E| j || }|s*| j rt d|d|j | j S dS dS dS dS )zHandler for call events.
If the code block being entered is to be ignored, returns `None',
else returns self.localtrace.
r __file__Nz --- modulename: rd )
r f_globalsr] r/ r r$ r rS r r )r r r r r r! r" ignore_its r r zTrace.globaltrace_lt s &==<D **:t<<H
&h / /
) $ 1 1(J G GI$ / : B !E&0jj$,,$@ B B B #.
*)/ / t =r c |dk r|j j }|j }||f}| j |d dz | j |< | j r(t
dt | j z
z d t j
| }t
d||t j || fz d | j
S ) Nr r r %.2f r
%s(%d): %sr1 )r r f_linenorE r] r rS r r r r+ ro getliner )r r r r r! r rb bnames r r z Trace.localtrace_trace_and_count( s &== |/H^FF"C #{sA 6 6 :DK
Ef$/ 9:DDDDG$$X..E ,%"+"3Hf"E"E"G GLN
P
P
P
P r c 2 |dk r|j j }|j }| j r(t dt | j z
z d t j | }t d||t j
|| fz d | j S )Nr r r r r r1 ) r r r r rS r r r r+ ro r r )r r r r r! r r s r r zTrace.localtrace_trace7 s &== |/H^F
Ef$/ 9:DDDDG$$X..E ,%"+"3Hf"E"E"G GLN
P
P
P
P r c |dk r=|j j }|j }||f}| j |d dz | j |< | j S )Nr r r )r r r rE r] r )r r r r r! r rb s r r zTrace.localtrace_countD sO &== |/H^FF"C #{sA 6 6 :DK r c \ t | j | j | j | j | j S )N)rI rJ rH rA )r rE rI rJ r r )r s r resultsz
Trace.resultsL s1 t{4;'+|+/+<'+}6 6 6 6r ) r r r r r
r
NNFr% )r& r' r( r r r r r r r r r r r r r
r r r r s DEDH 0 0 0 0 d% % %
) ) ) ) '. '. '.R 8 8 8- - - .
6 6 6 6 6r c * dd l } | }| ddd | dd }| dd d
d | d
dd
d | ddd
d | ddd
d | d }| }| ddd
d | ddd
d | d d d | d!d"d# | d$d%d
d& | d'd(d
d) | d*d+d
d, | d-d. }| d/d0g d12 | d3d0g d42 | d5d
d6d72 | d8d9d:; | d<| j d=; | }|j r(t j d> t j d? fd@dA |j
D |_
fdB|j D |_ |j r]|j s|
dC t |j |j D }| |j |j |j S t' |j |j |j |j g s|
dE |j r#|j s|j r|
dF |j r |j s|
dG |j |
dH t3 |j |j |j |j |j
|j |j |j |j I } |j rVdd l }|j }| | \ } }
} | j g|j t@ _! dJ| j |
j" |
j# |
d dK} n|j g|j t@ _! tH j% & |j t@ j% d< tO j( |j 5 }
tS |
* |j dL } d d d n # 1 swxY w Y |j dJd d dM} |+ | | | nL# tX $ r4}tA j- dNt@ j! d dO| Y d }~nd }~wt\ $ r Y nw xY w|/ }|j0 s(| |j |j |j d S d S )PNr z --versionversionz trace 2.0)actionr z Main optionsz(One of these (or --report) must be givenz-cz--count
store_truezCount 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.)r helpz-tz--tracez3Print each line to sys.stdout before it is executedz-lz --listfuncszKeep track of which functions are executed at least once and write the results to sys.stdout after the program exits. Cannot be specified alongside --trace or --count.z-Tz --trackcallsz^Keep track of caller/called pairs and write the results to sys.stdout after the program exits. Modifiersz-rz--reportzGenerate a report from a counts file; does not execute any code. --file must specify the results file to read, which must have been created in a previous run with --count --file=FILEz-Rz --no-reportz^Do not generate the coverage report files. Useful if you want to accumulate over several runs.z-fz--filez+File to accumulate counts over several runs)r z-Cz
--coverdirzDirectory where the report files go. The coverage report for <package>.<module> will be written to file <dir>/<package>/<module>.coverz-mz --missingz?Annotate executable lines that were not executed with ">>>>>> "z-sz --summaryz\Write a brief summary for each file to sys.stdout. Can only be used with --count or --reportz-gz--timingzQPrefix each line with the time since the program started. Only used while tracingFiltersz Can be specified multiple timesz--ignore-moduleappendzqIgnore the given module(s) and its submodules (if it is a package). Accepts comma separated list of module names.)r defaultr z --ignore-dirzWIgnore files in the given directory (multiple directories can be joined by os.pathsep).z--moduleFzTrace a module. progname?zfile to run as main program)nargsr argumentszarguments to the programstdlib
platstdlibc t j t j | } | d d } t j | S )Nz$prefixz $exec_prefix)r r
expanduser
expandvarsr6 r
)s _exec_prefix_prefixs r parse_ignore_dirz main.<locals>.parse_ignore_dir sa G rw 1 1! 4 4 5 5
IIi ) ) 1 1., O Ow """r c f g | ].}| d D ]}| /S ),)splitstrip)r r r# s r r zmain.<locals>.<listcomp> sW O O O O O:= ))++ O O O Or c j g | ]/}| t j D ]
} | 0S r
)r1 r pathsep)r r r+ r. s r r zmain.<locals>.<listcomp> s_ N N N 9L9LN N45 ('** N N N Nr z -r/--report requires -f/--file)rI rJ zLmust specify one of --trace, --count, --report, --listfuncs, or --trackcallsz8cannot specify both --listfuncs and (--trace or --count)z3--summary can only be used with --count or --reportz3progname is missing: required with the main options)r r r r rI rJ r r )r& r
__package__
__loader____spec__
__cached__r )r
r& r5 r8 zCannot run file z
because: )1argparseArgumentParser add_argumentadd_argument_group add_mutually_exclusive_group REMAINDER
parse_args
ignore_dir sysconfigget_path
ignore_modulereportrD errorr r missingry rz anyr r listfuncs
trackcallsr" r r modulerunpy_get_module_detailsr r% r3 argvparentloaderr r rj io open_coder r r rP exit
SystemExitr no_report)r9 parsergrp_grpoptsr trK module_namemod_namemod_specr globsr rV r, r- r. s @@@r mainr^ R sQ OOO
$
$
&
&F
I{KKK
#
#N 6 8 8C T9\& ' ' '
T9\F H H HT= E F F F T>,7 8 8 8
#
#K
0
0C + + - -DdJ|
dM,G H H H T8> @ @ @T<2 3 3 3 T;| T;|= > > > T:l+ , , ,
#
#I - / /C&x! " " " ^HbG H H H
< / 1 1 1
#. 0 0 0
8+=+ - - - D 8$X.. ),77 # # # # # #
O O#'#5O O ODN N N N $N N NDO { Py ; LL9 : : :!DIFFF$$T\4< OOO
DJH I I 5 4 5 5 5 ~ Q4: Q Q OPPP | LDJ L JKKK } JKKK
dj$* ?t7I i 5 5 5A
; LLL -K','@'@'M'M $Hh (:4>:CH & , ' &o $ "
EE
77CH '//$-88CHQK dm,,
A rwwyy$-@@
A
A
A
A
A
A
A
A
A
A
A
A
A
A
A !M & # " E
ue$$$$ H H H SXa[[[##FGGGGGGGG
iikkG > I dlDL$-HHHHHI IsC C T )S T ST S &T
U
*T==
U
U
r r ) __doc____all__rP ro r r3 rA r rr r r r rL timer r r r r r/ r= r r r r rn r r^ r& r
r r <module>rb s < ( %
&
# # # # # # #0 0 0 0 0 0 0 0d 8m m m m m m m m ^
. # # # L6 L6 L6 L6 L6 L6 L6 L6\PI PI PId ZDFFFFF r 
Browse
Usage
Versions