U e5dt@sdZddgZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZddlZdZGdddZd d Zd d ZGd ddZddZddZdddZddZGdddZddZedkredS)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:|s tnt||_|sgn dd|D|_ddi|_dS)NcSsg|]}tj|qS)ospathnormpath.0drr/usr/lib64/python3.8/trace.py Hsz$_Ignore.__init__..z)set_mods_dirs_ignore)selfmodulesdirsrrr __init__Fs z_Ignore.__init__cCs||jkr|j|S||jkr,d|j|<dS|jD]"}||dr2d|j|<dSq2|dkrld|j|<dS|jD]$}||tjrrd|j|<dSqrd|j|<dS)Nr.r)rr startswithrrsep)rfilename modulenamemodr rrr namesLs$          z _Ignore.names)NN)__name__ __module__ __qualname__rrrrrr rEs rcCs tj|}tj|\}}|S)z-Return a plausible module name for the patch.)rrbasenamesplitext)rbaserextrrr _modnamews r&cCstj|}d}tjD]@}tj|}||r|t|tjkrt|t|kr|}q|rr|t|dd}n|}tj|\}}|tjd}tj r|tj d}tj |\}}| dS)z,Return a plausible module name for the path.rNr) rrnormcasesysrlenr splitdrivereplacealtsepr#lstrip)rZ comparepathZlongestdirr$Zdriverr%rrr _fullmodname~s    r0c@s:eZdZdddZddZddZdd d Zdd d ZdS)rNc Cs||_|jdkri|_|j|_||_|jdkr8i|_|j|_||_|jdkrZi|_|j|_||_||_|jrz@t|jd}t |\}}}W5QRX| | |||Wn@t t tfk r}ztd|j|ftjdW5d}~XYnXdS)NrbzSkipping counts file %r: %sfile)countscopyZcounter calledfuncscallersinfileoutfileopenpickleloadupdate __class__OSErrorEOFError ValueErrorprintr)stderr)rr4r6r8r7r9ferrrrr rs2      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||<qJ|D] }d||<q\dS)z.Merge in the data from another CoverageResultsrrN)r4r6r7get) rotherr4r6r7Z other_countsZother_calledfuncsZ other_callerskeyrrr r=s zCoverageResults.updateTFc" Cs|jr@ttd|j}t|D]\}}}td|||fq"|jrttdd}} t|jD]h\\} } } \} }}| |krttd| d| }d} | | kr| | krtd| | } td| | ||fqfi}|jD].\}}||i}||<|j||f||<qi}|D]\}}||r0q|drH|d d }|d krpt j t j |}t |}n$|}t j |st |t|}|rt|}ni}t|}t j ||d }t|d }t|j\}}W5QRX||||||\}}|r|rtd ||}||||f||<q|rt|rttdt|D]&}||\}}}}td||qL|jrz6t|jd } t|j|j|jf| dW5QRXWn6tk r}!ztd|!tj dW5d }!~!XYnXd 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: %s, modulename: %s, funcname: %szcalling relationships:r'z***z -->z %s.%s -> %s.%sz.pycNz.coverr1dzlines cov% module (path)z%5d %3d%% %s (%s)wbrz"Can't save counts files because %sr2)!r6rBsortedr7r4rJitemsrIrHrrdirnameabspathr&existsmakedirsr0_find_executable_linenos linecachegetlinesjoinr:tokenizedetect_encodingreadlinewrite_results_fileintr9r;dumpr?r)rC)"rZ show_missingsummarycoverdirZcallsrrfuncnameZlastfileZ lastcfileZpfileZpmodZpfunccfileZcmodZcfuncZper_filelineno lines_hitZsumscountr/lnotabsourceZ coverpathfpencoding_n_hitsn_linesZpercentmrDrErrr write_resultss               zCoverageResults.write_resultsc Cszt|d|d}Wn>tk rP}z td||ftjdWYdSd}~XYnXd}d} |t|dD]r\} } | |kr|d || | d7} |d7}n.| |krt| kr|d |d7}n |d || d qjW5QRX| |fS) z'Return a coverage results file in path.wrjz3trace: Could not open %r for writing: %s - skippingr2)rrNrrz%5d: z>>>>>> z ) r:r?rBr)rC enumeratewritePRAGMA_NOCOVER expandtabs) rrlinesrgrerjr9rErmrlrdlinerrr r])s.    z"CoverageResults.write_results_file)NNNNN)TFN)N)rr r!rrIr=ror]rrrr rs  \cCs,i}t|D]\}}||krd||<q|S)z:Return dict where keys are lines in the line number table.r)disZfindlinestarts)codestrslinenosrkrdrrr _find_lines_from_codeIs  r}cCs4t||}|jD]}t|r|t||q|S)z.rcSsg|]}t|tr|qSr) isinstancerr rrr rs rcSsg|]}t|dr|qS) __bases__)hasattr)r rrrr rs z%s.%s) f_code co_filenamer&co_namergcZ get_referrersr*r) rframerzrrrbZclsnameZfuncsZdictsclassesrrr file_module_function_ofs,          zTrace.file_module_function_ofcCs0|dkr,||}||j}d|j||f<dS)zkHandler for call events. Adds information about who called who to the self._callers dict. callrN)rf_backr)rrwhyarg this_funcZ parent_funcrrr r s  zTrace.globaltrace_trackcallerscCs |dkr||}d|j|<dS)zoHandler for call events. Adds (filename, modulename, funcname) to the self._calledfuncs dict. rrN)rr)rrrrrrrr rs zTrace.globaltrace_countfuncscCsj|dkrf|j}|jdd}|rbt|}|dk rf|j||}|sf|jrZtd||jf|j SndSdS)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_globalsrJr&rrrrBrr)rrrrrzrrZ ignore_itrrr r!szTrace.globaltrace_ltcCs|dkr~|jj}|j}||f}|j|dd|j|<|jrTtdt|jddtj |}td||t ||fdd|j S) Nrxrr%.2f r %s(%d): %sr')rrf_linenor4rJrrBrrrr"rWgetliner)rrrrrrdrLbnamerrr r8s  z Trace.localtrace_trace_and_countcCsd|dkr^|jj}|j}|jr4tdt|jddtj|}td||t ||fdd|j S)Nrxrrrrr') rrrrrBrrrr"rWrr)rrrrrrdrrrr rGs  zTrace.localtrace_tracecCs<|dkr6|jj}|j}||f}|j|dd|j|<|jS)Nrxrr)rrrr4rJr)rrrrrrdrLrrr rTs zTrace.localtrace_countcCst|j|j|j|j|jdS)N)r8r9r6r7)rr4r8r9rr)rrrr results\s  z Trace.results) rrrrrrNNF)NN)rr r!rrrr__text_signature__rrrrrrrrrrrr 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|jrB|js8|jrB| dH|jr\|js\| dI|jdkrr| dJt|j|j|j|j|j |j|j |j |jdK }z|jrddl}|j}||\} } } | jf|jt _!dL| j| j"| j#| ddM} n^|jf|jt _!t$j%&|jt j%d<t'(|j} t)| *|jdN} W5QRX|jdLdddO} |+| | | WnPt,k r}zt -dPt j!d|fW5d}~XYnt.k rYnX|/}|j0s||j|j|jdS)QNrz --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_dirszmain..parse_ignore_dircSs$g|]}|dD] }|qqS),)splitstrip)r rrrrr rs zmain..cs&g|]}|tjD] }|qqSr)rrpathsep)r rr)rrr rsz-r/--report requires -f/--file)r8r9zLmust 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)rrrrr8r9rr)rr __package__ __loader____spec__ __cached__r)rrrrzCannot run file %r because: %s)1argparseArgumentParser add_argumentZadd_argument_groupZadd_mutually_exclusive_groupZ REMAINDER parse_argsZ ignore_dir sysconfigZget_pathZ ignore_moduleZreportr3errorrroZmissingr`raanyrrfZ listfuncsZ trackcallsrrrmodulerunpyZ_get_module_detailsrrr)argvparentloaderrrrRio open_coderrrr?exit SystemExitrZ no_report)rparserZgrpZ_grpZoptsrtrZ module_nameZmod_nameZmod_specrzZglobsrirEr)rrrr mainbs                        (rr)N)__doc____all__rrWrr)rrrZrrryr;timerrrrurr&r0rr}rrrVrrrrrrr s< 20  _