a DOg$r@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*/opt/alt/python39/lib64/python3.9/trace.py Hsz$_Ignore.__init__..z)set_mods_dirs_ignore)selfmodulesdirsrrr __init__Fs z_Ignore.__init__cCs||jvr|j|S||jvr,d|j|<dS|jD]"}||dr2d|j|<dSq2|durld|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||_|jduri|_|j|_||_|jdur8i|_|j|_||_|jdurZi|_|j|_||_||_|jrzTt|jd }t |\}}}Wdn1s0Y| | |||WnDt t tfy}z$td|j|ftjdWYd}~n d}~00dS)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 urpt j t j |}t |}n$|}t j |st |t|}|rt|}ni}t|}t j ||d }t|d  }t|j\}}Wd n1s0Y||||||\}}|r|rtd ||}||||f||<q|r|rtdt|D]&}||\}}}}td||qb|jrzLt|jd*} t|j|j|jf| dWd n1s0YWn8ty}!ztd|!tj dWYd }!~!n d }!~!00d 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            0   (zCoverageResults.write_resultsc Cszt|d|d}Wn<tyN}z$td||ftjdWYd}~dSd}~00d}d} |t|dD]r\} } | |vr|d || | d7} |d7}n.| |vrt| vr|d |d7}n |d || d qhWdn1s0Y| |fS) z'Return a coverage results file in path.wrjz3trace: Could not open %r for writing: %s - skippingr2N)rrrrz%5d: z>>>>>> z ) r:r?rBr)rC enumeratewritePRAGMA_NOCOVER expandtabs) rrlinesrgrerjr9rErmrlrdlinerrr r])s.    0z"CoverageResults.write_results_file)NNNNN)TFN)N)rr r!rrIr=ror]rrrr rs  \cCs,i}t|D]\}}||vrd||<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)ztyz}z&td||ftjdiWYd}~Sd}~00t||d}t ||}t ||S)zAReturn dict where keys are line numbers in the line number table.Nz%Not printing coverage data for %r: %sr2exec) rZr:readrjr?rBr)rCcompilerr)rrDprogrjrErzr{rrr rVvs (  rVc @speZdZdddZdd Zdd d Zd d ZddZddZddZ ddZ ddZ ddZ ddZ ddZdS) rrrrNFc Cs||_||_t|||_i|_i|_d|_||_i|_i|_ i|_ d|_ | rTt |_ |rb|j |_nZ|rp|j|_nL|r|r|j|_|j|_n2|r|j|_|j|_n|r|j|_|j|_nd|_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 rNr)r8r9rignorer4Zpathtobasename donothingtrace _calledfuncs_callers _caller_cache start_time_timeglobaltrace_trackcallers globaltraceglobaltrace_countfuncsglobaltrace_ltlocaltrace_trace_and_count localtracelocaltrace_tracelocaltrace_count) rrfr countfuncs countcallers ignoremods ignoredirsr8r9timingrrr rs6      zTrace.__init__cCs ddl}|j}||||dS)Nr)__main____dict__runctx)rcmdrdictrrr runsz Trace.runc Cs|dur i}|duri}|js6t|jt|jz*t|||W|js~tdtdn|js|tdtd0dSN)r threadingsettracerr)r)rrglobalslocalsrrr rs       z Trace.runctxc OsPd}|jst|jz"||i|}W|jsLtdn|jsJtd0|Sr)rr)rr)rfuncargskwresultrrr runfuncs   z Trace.runfuncc Cs|j}|j}|rt|}nd}|j}d}||jvrL|j|dur|j|}nd|j|<ddt|D}t|dkrddt|dD}t|dkrddt|dD} t| dkr| dj}||j|<|durd||f}|||fS)NcSsg|]}t|r|qSr)rZ isfunction)r rDrrr rs z1Trace.file_module_function_of..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 rs  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|}|durf|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 rszTrace.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 r(s  z Trace.localtrace_trace_and_countcCsd|dkr^|jj}|j}|jr4tdt|jddtj|}td||t ||fdd|j S)Nrxrrrrr') rrrrrBrrrr"rWrr)rrrrrrdrrrr r7s  zTrace.localtrace_tracecCs<|dkr6|jj}|j}||f}|j|dd|j|<|jS)Nrxrr)rrrr4rJr)rrrrrrdrLrrr rDs zTrace.localtrace_countcCst|j|j|j|j|jdS)N)r8r9r6r7)rr4r8r9rr)rrrr resultsLs  z Trace.results) rrrrrrNNF)NN)rr 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|jrB|js8|jrB| dH|jr\|js\| dI|jdurr| dJt|j|j|j|j|j |j|j |j |jdK }z|jrddl}|j}||\} } } | jg|jt _!dL| j| j"| j#| ddM} nt|jg|jt _!t$j%&|jt j%d<t'(|j"} t)| *|jdN} Wdn1sJ0Y|jdLdddO} |+| | | WnPt,y}z$t -dPt j!d|fWYd}~nd}~0t.yYn0|/}|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 rszmain..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 mainRs                        2,rr)N)__doc____all__rrWrr)rrrZrrryr;timerrrrurr&r0rr}rrrVrrrrrrr s< 20  O