o JAf r@sdZddgZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl m ZddlZdZGdddZd d Zd d ZGd ddZddZddZdddZddZGdddZddZedkruedSdS)aprogram/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") TraceCoverageResultsN) monotonicz#pragma NO COVERc@seZdZdddZddZdS)_IgnoreNcCs:|stnt||_|sgndd|D|_ddi|_dS)NcSsg|]}tj|qS)ospathnormpath.0drr/usr/lib/python3.10/trace.py Gsz$_Ignore.__init__..z)set_mods_dirs_ignore)selfmodulesdirsrrr __init__Es z_Ignore.__init__cCs||jvr |j|S||jvrd|j|<dS|jD]}||dr*d|j|<dSq|dur6d|j|<dS|jD]}||tjrKd|j|<dSq9d|j|<dS)Nr.r)rr startswithrrsep)rfilename modulenamemodr rrr namesKs(          z _Ignore.namesNN)__name__ __module__ __qualname__rrrrrr rDs  rcCs tj|}tj|\}}|S),Return a plausible module name for the path.)rrbasenamesplitext)rbaserextrrr _modnamevs r(cCstj|}d}tjD] }tj|}||r+|t|tjkr+t|t|kr+|}q |r9|t|dd}n|}tj|\}}|tjd}tj rT|tj d}tj |\}}| dS)r#rNr) rrnormcasesysrlenr splitdrivereplacealtsepr%lstrip)rZ comparepathZlongestdirr&driverr'rrr _fullmodname}s"    r3c@s>eZdZ  dddZddZddZdd d Zdd d ZdS)rNc Cs||_|jdur i|_|j|_||_|jduri|_|j|_||_|jdur-i|_|j|_||_||_|jrz+t|jd}t |\}}}Wdn1sVwY| | |||WdSt t tfy}ztd|j|ftjdWYd}~dSd}~wwdS)NrbzSkipping counts file %r: %sfile)countscopyZcounter calledfuncscallersinfileoutfileopenpickleloadupdate __class__OSErrorEOFError ValueErrorprintr+stderr)rr7r9r;r:r<ferrrrr rs:      zCoverageResults.__init__cCs|do |dS)z_Return True if the filename does not refer to a file we want to have reported. <>)rendswith)rrrrr is_ignored_filenamesz#CoverageResults.is_ignored_filenamec Csn|j}|j}|j}|j}|j}|j}|D]}||d||||<q|D]}d||<q%|D]}d||<q.dS)z.Merge in the data from another CoverageResultsrrN)r7r9r:get) rotherr7r9r:Z other_countsZother_calledfuncsZ other_callerskeyrrr r@s  zCoverageResults.updateTFc" Cs|jr ttd|j}t|D]\}}}td|||fq|jrhttdd}} t|jD]4\\} } } \} }}| |krNttd| d| }d} | | kr]| | kr]td| | } td| | ||fq3i}|jD]\}}||i}||<|j||f||<qmi}|D]\}}||rq|dr|d d }|d urt j t j |}t |}n|}t j |st |t|}|rt|}ni}t|}t j ||d }t|d }t|j\}}Wd n1swY||||||\}}|r|rtd ||}||||f||<q|r<|rz %s.%s -> %s.%sz.pycNz.coverr4dzlines cov% module (path)z%5d %3d%% %s (%s)wbrz"Can't save counts files because %sr5)!r9rEsortedr:r7rMitemsrLrKrrdirnameabspathr(existsmakedirsr3_find_executable_linenos linecachegetlinesjoinr=tokenizedetect_encodingreadlinewrite_results_fileintr<r>dumprBr+rF)"rZ show_missingsummarycoverdirZcallsrrfuncnameZlastfileZ lastcfileZpfileZpmodZpfunccfileZcmodZcfuncZper_filelineno lines_hitZsumscountr1lnotabsourceZ coverpathfpencoding_n_hitsn_linespercentmrGrHrrr write_resultss               ( zCoverageResults.write_resultsc Csz t|d|d}Wnty'}ztd||ftjdWYd}~dSd}~wwd}d} |Jt|dD]9\} } | |vrN|d || | d7} |d7}n| |vr`t| vr`|d |d7}n|d || d q4Wd| |fS1s{wY| |fS) z'Return a coverage results file in path.wrmz3trace: Could not open %r for writing: %s - skippingr5N)rrrrz%5d: z>>>>>> z ) r=rBrEr+rF enumeratewritePRAGMA_NOCOVER expandtabs) rrlinesrjrhrmr<rHrprorglinerrr r`(s:     z"CoverageResults.write_results_file)NNNNN)TFNN)r r!r"rrLr@rsr`rrrr rs  \cCs,i}t|D] \}}||vrd||<q|S)z:Return dict where keys are lines in the line number table.r)disZfindlinestarts)codestrslinenosrnrgrrr _find_lines_from_codeHs rcCs4t||}|jD]}t|r|t||q|S)z.rcSsg|] }t|tr|qSr) isinstancerr rrr rrrcSsg|] }t|dr|qS) __bases__)hasattr)r rrrr rrz%s.%s) f_code co_filenamer(co_namergcZ get_referrersr,r ) rframerrrreZclsnameZfuncsZdictsZclassesrrr file_module_function_ofs.           zTrace.file_module_function_ofcCs4|dkr||}||j}d|j||f<dSdS)zkHandler for call events. Adds information about who called who to the self._callers dict. callrN)rf_backr)rrwhyarg this_funcZ parent_funcrrr rs   zTrace.globaltrace_trackcallerscCs$|dkr||}d|j|<dSdS)zoHandler for call events. Adds (filename, modulename, funcname) to the self._calledfuncs dict. rrN)rr)rrrrrrrr rs zTrace.globaltrace_countfuncscCsp|dkr6|j}|jdd}|r4t|}|dur0|j||}|s2|jr-td||jf|j SdSdSdSdS)zHandler for call events. If the code block being entered is to be ignored, returns `None', else returns self.localtrace. r__file__Nz! --- modulename: %s, funcname: %s) r f_globalsrMr(rrrrErr)rrrrrrrZ ignore_itrrr rs"zTrace.globaltrace_ltcCs|dkr?|jj}|j}||f}|j|dd|j|<|jr*tdt|jddtj |}td||t ||fdd|j S) Nr|rr%.2f r %s(%d): %sr))rrf_linenor7rMrrErrrr$rZgetliner)rrrrrrgrObnamerrr r's  z Trace.localtrace_trace_and_countcCsd|dkr/|jj}|j}|jrtdt|jddtj|}td||t ||fdd|j S)Nr|rrrrr)) rrrrrErrrr$rZrr)rrrrrrgrrrr r6s  zTrace.localtrace_tracecCs<|dkr|jj}|j}||f}|j|dd|j|<|jS)Nr|rr)rrrr7rMr)rrrrrrgrOrrr rCs zTrace.localtrace_countcCst|j|j|j|j|jdS)N)r;r<r9r:)rr7r;r<rr)rrrr resultsKs z Trace.results) rrrrrrNNFr)r r!r"rrrrrrrrrrrrrrrr rs  2   )   c sddl}|}|jdddd|dd}|jdd d d d |jd dd dd |jddd dd |jddd dd |d}|}|jddd dd |jddd dd |jdddd |jd!d"d#d |jd$d%d d&d |jd'd(d d)d |jd*d+d d,d |d-d.}|jd/d0gd1d2|jd3d0gd4d2|jd5d d6d7d2|jd8d9d:d;|jd<|jd=d;|}|jrt d>t d?fd@dAdBdC|j D|_ fdDdC|jD|_|j r|j s| dEt|j |j dF}||j|j|jSt|j|j|j|jgs | dG|jr|js|jr| dH|jr+|js+| dI|jdur6| dJt|j|j|j|j|j |j|j |j |jdK }zk|jruddl}|j}||\} } } | jg|jt _!dL| j| j"| j#| ddM} n:|jg|jt _!t$j%&|jt j%d<t'|jdN} t(| )|jdO} Wdn 1swY|jdLdddP} |*| | | Wn(t+y}zt ,dQt j!d|fWYd}~nd}~wt-yYnw|.}|j/s||j|j|jdSdS)RNrz --versionversionz trace 2.0)actionrz 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 .cover for each module executed, in the module's directory. See also --coverdir, --file, --no-report below.)rhelpz-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.Z 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)rz-Cz --coverdirzDirectory where the report files go. The coverage report for . will be written to file //.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 tracingZFilterszCan 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.)rdefaultrz --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 programZstdlibZ platstdlibcs4tjtj|}|dd}tj|S)Nz$prefixz $exec_prefix)rr expanduser expandvarsr.r )s) _exec_prefix_prefixrr parse_ignore_dirs zmain..parse_ignore_dircSs$g|]}|dD]}|q qS),)splitstrip)r rrrrr rs  zmain..cs&g|]}|tjD]}|q qSr)rrpathsep)r rr)rrr rs  z-r/--report requires -f/--file)r;r<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)rrrrr;r<rr)r r __package__ __loader____spec__ __cached__r4r)rr rrzCannot run file %r because: %s)0argparseArgumentParser add_argumentadd_argument_groupadd_mutually_exclusive_group REMAINDER parse_argsZ ignore_dir sysconfigZget_pathZ ignore_modulereportr6errorrrsmissingrcrdanyrriZ listfuncsZ trackcallsrrrmodulerunpyZ_get_module_detailsrrr+argvparentloaderrrrUr=rrrrBexit SystemExitrZ no_report)rparsergrpZ_grpZoptsrtr module_nameZmod_nameZmod_specrZglobsrlrHr)rrrr mainQs                        $rrr})__doc____all__rZrr+rrr]rrr~r>timerrrryrr(r3rrrrrYrrr rrrr s> 20 O