+ lhs RtRR.t^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI t ^RI Ht^RItRt!RR4tRtR t!R R4tR tR tRR ltRt!RR4tRt]R8Xd ]!4R#R#)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 COVERc0a]tRt^CtoRRltRtRtVtR#)_IgnoreNcV'g \4M \V4VnV'g.M.VUu.uF"p\PP V4NK$ upVnR^/VnR#uupi)zN)set_modsospathnormpath_dirs_ignore)selfmodulesdirsds&&& lib/python3.14/trace.py__init___Ignore.__init__DsW")SUs7| #R37*937a+-''*:*:1*=37*9 #Q( *9s(A,cW P9dVPV,#W P9d^VPV&^#VPF3pVPVR,4'gK#^VPV&^# Vf^VPV&^#VPFApVPV\P ,4'gK1^VPV&^# ^VPV&^#).)rr startswithr r sep)rfilename modulenamemodrs&&& rnames _Ignore.namesJs  %<< + +  #'(DLL $::C$$S3Y//+, Z(   '(DLL $A""1rvv:..+, Z($% Z )r rr NN)__name__ __module__ __qualname____firstlineno__rr__static_attributes____classdictcell__ __classdict__s@rrrCs) ))r rc\PPV4p\PPV4wr#V#),Return a plausible module name for the path.)r r basenamesplitext)r baserexts& r_modnamer0us3 77  D !DGG$$T*MH Or c\PPV4pRp\PFp\PPV4pVP V4'gK;V\ V4,\P 8XgKb\ V4\ V48gK}TpK V'dV\ V4^,RpMTp\PPV4wrTVP\P R4p\P'd!VP\PR4p\PPV4wrgVPR4#)r+Nr) r r normcasesysrlenr splitdrivereplacealtsepr-lstrip)r comparepathlongestdirr.driverr/s& r _fullmodnamer>|s''""4(KGxxggs#  ! !# & &;s3x+@BFF+J3x#g,&  CL1$%&''$$T*KE << $D yyy||BIIs+GG$$T*MH ??3 r cRa]tRt^toR RltRtRtR RR/RlltR RltR t Vt R#) rNc0WnVPf/VnVPP4VnW nVPf/VnVPP4VnW@nVPf/VnVPP4VnW0nWPnVP 'df\VP R4;_uu_4p\P!V4wrpRRR4VPVPWVR74R#R# +'giL6;i \\\3d9p\RTP : RT: 2\ P"R7Rp?R#Rp?ii;i)Nrb)callerszSkipping counts file : file)countscopycounter calledfuncsrBinfileoutfileopenpickleloadupdate __class__OSErrorEOFError ValueErrorprintr4stderr)rrFrIrJrBrKferrs&&&&&& rrCoverageResults.__init__s/ ;; DK{{'') &    #!D ++002 << DL||((*   ;;; N$++t,,39;;q>0F- DNN6NPQ -,Xz2 N)-c;BE**NN Ns0E,D4*E4 E ?EF-FFc VVPR4;'dVPR4#)zOReturn True if the filename does not refer to a file we want to have reported. <>)rendswith)rrs&&ris_ignored_filename#CoverageResults.is_ignored_filenames(""3'BBH,=,=c,BBr c VPpVPpVPpVPpVPpVPpVF$pVPV^4WX,,W(&K& VFp^W8&K VFp^WH&K R#)z.Merge in the data from another CoverageResultsN)rFrIrBget) rotherrFrIrB other_countsother_calledfuncs other_callerskeys && rrOCoverageResults.updates&& ,,|| !-- C **S!,|/@@FK %C K %!CGL!r Fignore_missing_filesc  xVP'dN\4\R4VPp\V4Fwrgp\RV: RV: RV: 24K VP'd\4\R4R;r\VP4Fbwwrp wrpW8wd\4\RV R4T p Rp W8wdW8wd\RV4Tp \R V : R V : R V: R V: 24Kd /pVPF5wppVP V/4;pVV&VPVV3,VV&K7 /pVP 4EFwppVPV4'dK VPR 4'dVR RpV'd(\PPV4'gKkVfI\PP\PPV44p\V4pM%Tp\P!VRR7\!V4pV'd \#V4pM/p\$P&!V4p\PP)VVR,4p\+VR4;_uu_4p\,P.!VP04wppR R R 4VP3VVVVX4wppV'gEKV'gEKVVWv3VV&EK V'dSV'dK\R4\V4F0pVV,wpprv\VR RVV, R RV RV R24K2 VP4'dd\+VP4R4;_uu_4p \6P8!VPVPVP3V ^4R R R 4R #R # +'giEL;i +'giR #;i \:d.p!\RT!,\<P>R7R p!?!R #R p!?!ii;i)a 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. :param ignore_missing_files: If True, counts for files that no longer exist are silently ignored. Otherwise, a missing file will raise a FileNotFoundError. zfunctions called:z filename: z, modulename: , funcname: zcalling relationships:r2z***z -->z rz -> z.pycNT)exist_okz.coverrAzlines cov% module (path)5dz z.1%z ()wbz"Can't save counts files because %srD) rIrTsortedrBrFr`itemsr]r\r r isfiledirnameabspathr0makedirsr>_find_executable_linenos linecachegetlinesjoinrLtokenizedetect_encodingreadlinewrite_results_filerKrMdumprQr4rU)"r show_missingsummarycoverdirrgcallsrrfuncnamelastfile lastcfilepfilepmodpfunccfilecmodcfuncper_filelineno lines_hitsumscountr<lnotabsource coverpathfpencoding_n_hitsn_linesmrVrWs"&&&&$ r write_resultsCoverageResults.write_resultssu     G % &$$E28-.h"J:<3@ <<< G * +#% %Hdll+=%%u';U$G%.$H "I>i&8'5) %IdE4GH, $ Hf-5\\(B-G GI* $ Xv,> ?If !, '~~/OHe''11  ((#CR=#BGGNN8,D,Dggoobggooh&?@%h/  C$/)(3 1(;''1F S*x*?@Ih%%&66r{{C !&"55i6.> M !1&.- &%% .-- S:S@szzRR SsB!$O5P:O- P O* - O> 8P>P P9 "P44P9c L\VRVR7p^p^p T;_uu_4\ T^4FwrY9d2TP RYJ,,4T ^, p T^, pM=Y9d'\T 9gTP R 4T^, pMTP R 4TP T P^44K RRR4Y3# \d1p\RT: RT: R2\PR7R uRp?#Rp?ii;i +'giY3#;i) z'Return a coverage results file in path.wrztrace: Could not open z for writing: z - skippingrDNz%5d: z>>>>>> z )r) rLrQrTr4rU enumeratewritePRAGMA_NOCOVER expandtabs) rr linesrrrrKrWrrrlines &&&&&& rr|"CoverageResults.write_results_file+s 4x8G  W )% 3 &MM'I,="=>aKFqLG%n.DMM),qLGMM), dooa01!4"1  26=DGJJ PK W"s)CB*D D%D D D D# )rIrBrHrFrJrK)NNNNN)TFNN) r"r#r$r%rr]rOrr|r&r'r(s@rrrs2N4C $^S+0^S@r c`/p\P!V4Fwr4WA9gK ^W$&K V#)z:Return dict where keys are lines in the line number table.)disfindlinestarts)codestrslinenosrrs&& r_find_lines_from_coderKs2G''-   GO. Nr c\W4pVPF;p\P!V4'gK!VP \ W144K= V#)z>!   NN;q/ 0 Nr c/p\Pp\WR7;_uu_4p\P!VP 4pVFXwrgrp V\P 8Xd;V\P8Xd&VwrV wr\W^,4Fp^W/&K TpKZ RRR4V# +'giT#;i)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. rN)tokenINDENTrLrygenerate_tokensr{STRINGrange)rrr prev_ttyperVtokttypetstrstartendrslinescolelineecolis&& r _find_stringsras AJ h * *a&&qzz2-0 )ET $-"'KE"%KE"5!)4 5J.1 + H + * Hs A?B00 C cr\P!V4;_uu_4pVP4pVPpRRR4\XTR4p\TX4p\YV4# +'giL4;i \d0p\ RT: RT: 2\ PR7/uRp?#Rp?ii;i)zAReturn dict where keys are line numbers in the line number table.NzNot printing coverage data for rCrDexec) ryrLreadrrQrTr4rUcompilerr)rrVprogrrWrrs& rruruxs ]]8 $ $668DzzH% 46 *D 8 ,D t ""% $  !)307:zz C s9A<A)A<) A9 4A<9A<< B6$B1+B61B6cpa]tRtRtoRRltRtRRltRtRtRt R t R t R t R t R tRtRtVtR#)riNc  lWpnWn\WV4Vn/Vn/Vn^VnW n/Vn/Vn /Vn RVn V 'd\4Vn V'dVPVnR#V'dVPVnR#V'd-V'd%VP VnVP"VnR#V'd%VP VnVP&VnR#V'd%VP VnVP(VnR#^VnR#)a @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 N)rJrKrignorerFpathtobasename donothingtrace _calledfuncs_callers _caller_cache start_time_timeglobaltrace_trackcallers globaltraceglobaltrace_countfuncsglobaltrace_ltlocaltrace_trace_and_count localtracelocaltrace_tracelocaltrace_count) rrr countfuncs countcallers ignoremods ignoredirsrJrKtimings &&&&&&&&&&rrTrace.__init__s(  j5      #gDO #<B6~~~   t// 0 LL)) * ) v &>>> T"""4("4>>> T"""4("s B..AC/c,RpVP'g!\P!VP4V!V/VBpVP'g\P!R4V# TP'g\P!R4ii;ir)rr4rr)rfuncargskwresults""*, rrunfunc Trace.runfuncsn~~~ LL)) * #4&2&F>>> T" >>> T""s A((+Bc|VPpVPpV'd \V4pMRpVPpRpW P9d+VPV,eVPV,pEM'RVPV&\ P !V4Uu.uF#p\P!V4'gK!VNK% pp\V4^8Xd\ P !V^,4U u.uFp \V \4'gKV NK p p \V 4^8Xdr\ P !V ^,4U u.uFp \V R4'gKV NK p p \V 4^8Xd"V ^,PpW`PV&Ve V: RV: 2pW4V3#uupiuup iuup i)N __bases__r)f_code co_filenamer0co_namergc get_referrersr isfunctionr5 isinstancerhasattrr") rframerrrrclsnamerVfuncsrdictsrclassess && rfile_module_function_ofTrace.file_module_function_ofs||## !(+JJ<< %% %!!$'3,,T2'+D  t $!# 0 0 63 61#..q1Q 6E3 5zQ$&$4$4U1X$>5$>q *1d 3$>5u:?*,*:*:58*D?*DQ&-a&= !q*DG?7|q(")!*"5"5 4;**40  ")84HX---3 5?s$F/F/8F4F4 F9%F9c VR8Xd?VPV4pVPVP4p^VPWT3&R#R#)z[Handler for call events. Adds information about who called who to the self._callers dict. callN)rf_backr)rrwhyarg this_func parent_funcs&&&& rrTrace.globaltrace_trackcallerssE &=44U;I66u||DK67DMM;2 3 r c XVR8Xd#VPV4p^VPV&R#R#)z_Handler for call events. Adds (filename, modulename, funcname) to the self._calledfuncs dict. r N)rr)rrr rrs&&&& rrTrace.globaltrace_countfuncs s0 &=44U;I+,D  i ( r c ZVR8XdVPpVPPRR4pV'dr\V4pVeaVPP WV4pV'g<VP 'd\RV: RVP: 24VP#R#R#R#R#)zzHandler for call events. If the code block being entered is to be ignored, returns 'None', else returns self.localtrace. r __file__Nz --- modulename: ri) r f_globalsr`r0rrrrTrr)rrr rrrr ignore_its&&&& rrTrace.globaltrace_lts &=<VR8XEd VPPpVPpWE3pVPP V^4^,VPV&VP 'd.\ R\4VP , ,RR7\PPV4p\P!WE4p\ RWu3,RR7V'd\ RVRR7VP#\ 4VP#rz%.2f )rz%s(%d)r2rC)rrf_linenorFr`rrTrr r r,rvgetliner) rrr rrrrebnamers &&&& rr Trace.localtrace_trace_and_count*s &=||//H^^F"C#{{sA6:DKK f$// 9:DGG$$X.E$$X6D (e_," 5dDb)r cVR8XdVPPpVPpVP'd.\ R\ 4VP, ,RR7\ PPV4p\P!WE4p\ RWe3,RR7V'd\ RVRR7VP#\ 4VP#r) rrrrrTrr r r,rvrr)rrr rrrrrs&&&& rrTrace.localtrace_trace=s &=||//H^^Ff$// 9:DGG$$X.E$$X6D (e_," 5dDb)r cVR8XdVVPPpVPpWE3pVPP V^4^,VPV&VP #)r)rrrrFr`r)rrr rrrres&&&& rrTrace.localtrace_countNsU &=||//H^^F"C#{{sA6:DKK r c\VPVPVPVPVP R7#))rJrKrIrB)rrFrJrKrr)rs&rresults Trace.resultsVs2t{{4;;'+||+/+<+<'+}}6 6r ) rrrrFrrrrJrrKrrr) rrrrr'NNFr!)r"r#r$r%rrrrrrrrrrrr%r&r'r(s@rrrsH0d% ) '.R 8-.&"66r c z aa^RIpVPRR7pVPRRRR7VPRR 4pVPR R R R R7VPRRR RR7VPRRR RR7VPRRR RR7VPR4pVP 4pVPRRR RR7VPRRR RR7VPRR R!R"7VPR#R$R%R"7VPR&R'R R(R7VPR)R*R R+R7VPR,R-R R.R7VPR/R04pVPR1R2.R3R47VPR5R2.R6R47VPR7R R8R9R47VPR:R;RVP R?R=7VP 4pVP'd-\P!R@4o\P!RA4oVV3RBlpVPUUu.uF*qfPRC4FpVP4NK K, uppVn VPUUu.uF0qfP\P4F pV!V4NK K2 uppVnVP'dvVP 'gVP#RD4\%VP VP RE7p V P'VP(VP*VP,4#\/VP0VP2VP4VP6.4'gVP#RF4VP4'd6VP2'gVP0'dVP#RG4VP*'d$VP2'gVP#RH4VP8fVP#RI4\;VP2VP0VP4VP6VPVPVP VP VP<RJ7 p VP>'dt^RI p VP8p V PCV 4wrpVPD.VPFO\Hn%RKRLRMVPDRNVPLROVPNRPVRQR/pMVP8.VPFO\Hn%\PPPSVP84\HPP^&\TPV!VP84;_uu_4p\YVP[4VP8RR4pRRR4RMVP8RKRLRNRRQR/pV P]XVV4V Pe4p VPf'g4V P'VP(VP*VP,4R#R#uuppiuuppi +'giL;i \^d>p\HP`!RS\HPJ^,: RTT: 24Rp?LRp?i\bdLi;i)UrNT)colorz --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 .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 . 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 tracingFilterszCan 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<\PP\PPV44pVP RS4P RS4p\PP V4#)z$prefixz $exec_prefix)r r expanduser expandvarsr7r )s _exec_prefix_prefixs&rparse_ignore_dirmain..parse_ignore_dirsX GG  rww11!4 5 IIi ) 1 1., Oww""r ,z-r/--report requires -f/--file)rJrKzLmust 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)rrrrrJrKrr"rr __package__ __loader____spec__ __cached__rzCannot run file z because: )4argparseArgumentParser add_argumentadd_argument_groupadd_mutually_exclusive_group REMAINDER parse_args ignore_dir sysconfigget_path ignore_modulesplitstripr pathsepreportrEerrorrrmissingrranyrr listfuncs trackcallsr2rrmodulerunpy_get_module_detailsrr5r4argvparentloaderr rrio open_coderrrrQexit SystemExitr% no_report)rEparsergrp_grpoptsr>rrr;r%trZ module_namemod_namemod_specrglobsrrWr<r=s @@rmainrm\s  $ $4 $ 0F  I{K  # #N 6 8CT9\&' T9\FHT=EFT>,78  # #K 0C  + + -DdJ|  dM,GHT8>@T<23T;|T;|=>T:l+,  # #I - /C&x!"^HbGH  </1  #.0  8+=+=+-    D $$X. )),7 # $(#5#5O#5a#))+AMOD!%N /19LA(*9L+ /NDO {{{yyy LL9 :!DIIF$$T\\4<<OO  DJJH I I 4 5 ~~~4::: OP |||DJJJ JK }} JK djj$**??t7I7Iii  5A ;;; --K','@'@'M $H((:4>>:CHJD,,xhooHd E 77CH''//$--8CHHQKdmm,,rwwy$--@-DMMJtd E ue$ iikG >>>dllDLL$--H ONX-, H SXXa[[#FGG    sI,0Y46Y D Y&&Y/Y& Y# Y&& Z:13Z)) Z:6Z:9Z:rr)__doc____all__r_rvr r4rMrryrrrrMtimerrrrrr0r>rrrrrurrmr"r'r rrqs8( % &    ##00d 8qqf  . #T6T6lPId ZFr