/~hPUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlmZmZmZmZddlmZmZmZddlmZmZddlmZmZeeZgZde d <dZ!Gd d Z"Gd d e"Z#d0dZ$d1dZ% d2dZ&d3dZ'dgZ(de d<gZ)de d<ed4dZ*ed5dZ*d6dZ* d7 d8dZ+d9d:dZ,d;ddZ/dhZ0d?dZ1d@d Z2dAd!Z3dBd"Z4Gd#d$Z5Gd%d&Z6Gd'd(Z7Gd)d*Z8dCdDd+Z9 dE dFd,Z:dGd-Z;ejxZ=ejxZ>dZ? dH dId.Z@dJd/ZAy)Kz'Control of and utilities for debugging.) annotationsN)overloadAnyCallableIO)IterableIteratorMapping)human_sorted_itemsisolate_module) AnyCallable TWritablez list[str] FORCED_DEBUGcreZdZdZdZ d d dZd dZd dZejddZ dddd Z y) DebugControlz!Control and output for debugging.FNct|tz|_d|_g}|j drF|j t j|j tj|j dr#|j tj|j dr|j ttj||||_ |jj|_y)z4Configure the options and output file for debugging.Fprocesspytestpid) file_namefiltersN)listroptionssuppress_callersshouldappend CwdTrackerfilterProcessTracker PytestTrackeradd_pid_and_tidDebugOutputFileget_oneoutputoutfile raw_output)selfrr$rrs W/var/www/peopleoo.sandbox-dev.co.uk/venv/lib/python3.12/site-packages/coverage/debug.py__init__zDebugControl.__init__.sG}|3 % ;;y ! NN:<.. / NN>+22 3 ;;x NN=?11 2 ;;u  NN? +%-- .  ++--c<d|jd|jdS)Nz)rr&r's r(__repr__zDebugControl.__repr__Hs"' '7|DOOCVVWXXr*cB|dk(r |jry||jvS)z@Decide whether to output debug information in category `option`.callersF)rrr'options r(rzDebugControl.shouldKs$ Y 4#8#8$,,&'r*c#bK|j}d|_ d||_y#||_wxYww)z;A context manager to prevent call stacks from being logged.TN)r)r'olds r(without_callerszDebugControl.without_callersQs3## $ ( $'D !CD !s/#/ ,/excc $|jj|dz|I|jjdjtjd||j |j drTtjddjjd}||jjd|d|j drt|jd |jjy) zWrite a line of debug output. `msg` is the line to write. A newline will be appended. If `exc` is provided, a stack trace of the exception will be written after the message.  Nr'rzself: r0outskip) r$writejoin tracebackformat_exception __traceback__rinspectstackf_localsgetdump_stack_framesflush)r'msgr7 caller_selfs r(r?zDebugControl.write[s #*% ? KK  bggi&@&@sCL]L]&^_ ` ;;v !--/!,Q/88<Br*rc.eZdZdZddZddZddd dZy) NoDebuggingzBA replacement for DebugControl that will never try to do anything.cyrLr]r-s r(r)zNoDebugging.__init__rs r*cy)z'Should we write debug messages? Never.Fr]r1s r(rzNoDebugging.shouldvsr*Nr6ctd)zThis will never be called.z)NoDebugging.write should never be called.)AssertionError)r'rJr7s r(r?zNoDebugging.writezsHIIr*rPrQrSrU)rVrWrXrYr)rr?r]r*r(r_r_psL >BJr*r_c0djd|zdzS)zMake a nice header string.z --{:-<60s} format)labels r( info_headerrjs   s5y} --r*c#Kt|}|sydtfd|DsJ|D]\}}|gk(rd}t|tr4t t t|dkrd|t|fzQt|tt tfrd|fz}|D]}ddz||fzd }d ||fzyw) zProduce a sequence of formatted lines from info. `info` is a sequence of pairs (label, data). The produced lines are nicely formatted, ready to print. Nc3@K|]\}}t|kywrLlen).0l_ label_lens r( z!info_formatter..s3das1v !3sz-none-z%*s: %rz%*s:z%*s %sr;r:z%*s: %s)rall isinstancetupleroreprset)inforidataprefixerss @r(info_formatterr~s :D I 3d3 33 3 7 t 2:D dE "s4d +<'='By%t== = tS%0 1y%00F )A+vq!999 y%66 6 7sCCc\|t|t|D] }|d|y)a,Write a sequence of (label,data) pairs nicely. `write` is a function write(str) that accepts each line of output. `header` is a string to start the section. `info` is a sequence of (label, data) pairs, where label is a str, and data can be a single value, or a list/set/tuple. rfN)rjr~)r?headerrzlines r(write_formatted_infors3 +f t$ $jr*cptjt||}djd|DS)zIGet a one-line summary of an exception, including class name and message.|c3<K|]}|jywrL)rstrip)rprqs r(rtzexc_one_line..s.1AHHJ.s)rAformat_exception_onlytyper@)r7liness r( exc_one_liners-  + +DIs ;E 88.. ..r*)z5.*[/\\]pytest-of-.*[/\\]pytest-\d+([/\\]popen-gw\d+)?ztmp:list[tuple[str, str]]_FILENAME_REGEXES_FILENAME_SUBScyrLr]filenames r(short_filenamerr*cyrLr]rs r(rrrr*ctstjD]}tj|dfddl}tjt jj |jdftjdd|EtD]\}}tj|||}tD]\}}|j||}|S)zIShorten a file name. Directories are replaced by prefixes like 'syspath:'zsyspath:rNzcov:ct|dSNrrn)pairs r(z short_filename..sc$q'lr*T)keyreverse) rsyspathrcoverageosdirname__file__sortrresubreplace)rpathdirrpatrbeforeafters r(rrs xx 9G  ! !7J"7 8 9rwwx/@/@A6JK!:TJ) 2HCvvc31H 2+ 7MFE''6H 7 Or*cgd}tjd|d}|s |D]}tj|fd|}g}|D]n}|jdd} |r| t |j ddz } |j} |r t| } | | d |jz } |j| pd j|S) a^Return a string summarizing the call stack. The string is multi-line, with one line per stack frame. Each line shows the function name, the file name, and the line number: ... start_import_stop : /Users/ned/coverage/trunk/tests/coveragetest.py:95 import_local_file : /Users/ned/coverage/trunk/tests/coveragetest.py:81 import_local_file : /Users/ned/coverage/trunk/coverage/backward.py:159 ... `skip` is the number of closest immediate frames to skip, so that debugging functions can call this and not be included in the result. If `full` is true, then include all frames. Otherwise, initial "boring" frames (ones in site-packages and earlier) are omitted. `short_filenames` will shorten filenames using `short_filename`, to reduce the amount of repetitive noise in stack traces. )zz \bigor.py$z\bsite-packages\bNcBtj||jSrL)rsearchr)firs r(rzshort_stack..sRYYsBKK%@r*z>30sz : z#xrf:r9) rDrE itertools dropwhilefunctionidframerrlinenorr@) r>full frame_idsshort_filenamesBORING_PRELUDErErr frame_inforrs r( short_stackrs8N *1$r)BE ! C'' #@E  E %%d+3/  r***+B/q1 1D&& %h/H 8*Aj//011 T 99U r*cF|jt|dzdzy)z&Print a summary of the stack to `out`.r;)r>r9N)r?rr<s r(rHrH sIIktAv&-.r*cZtj}||_|j|S)z(`repr(text)`, but limited to `numchars`.)reprlibRepr maxstringrx)textnumcharsrs r( clipped_reprrs" AAK 66$<r*cDd}tdddD] }|||z z} |dzS)z-Given a 64-bit id, make a shorter 16-bit one.r@i)range)id64id16offsets r(short_idrs7 D2r"  &=r*c~ttjd}tjdd|d|}|S)z.A filter to add pid and tid to debug messages.04x5d.z: )r_thread get_identrgetpid)rtids r(r!r!s@g'') *3 /Ciik" Qse2dV ,D Kr*z$coverage.object_idcd|jjD}dj|jjt |dj d|DS)z.*sD1a 1& -  # % % As;=z<{klass} @{id:#x}{attrs}>r:c32K|]\}}d|d|yw)rf=Nr]rs r(rtzauto_repr..3s ;1!AaUm;)klassrattrs)__dict__itemsrh __class__rVrr@)r' show_attrss r( auto_reprr(s^==..0J ' - -nn%% d8gg; ;; . r*ct|tr-|jDcic]\}}|t|c}}St|tt frt |d|DSt|dr:t|jjDcic] \}}d|z| c}}S|Scc}}wcc}}w)z>Turn things which are nearly dict/list/etc into dict/list/etc.c32K|]}t|ywrL)simplify)rpvvs r(rtzsimplify..<s0x|0rrr) rvdictrrrrwrhasattrr)rrrs r(rr7s!T,-GGI651b(2,66 Ae} %tAw0a000 J ajj.>.>.@AdaQABB 7Bs B4B: c@tjt|y)zEDebug helper to pretty-print data, including SimpleNamespace objects.N)pprintr)rs r(pprCs MM(1+r*c|j}|t|d}|}|D]O}g}|jD]'}|j||j)dj |}Q||zS)aQRun `text` through a series of filters. `filters` is a list of functions. Each takes a string and returns a string. Each is run in turn. After each filter, the text is split into lines, and each line is passed through the next filter. Returns: the final string that results after all of the filters have run. Nr9)rro splitlinesextendr@)rr clean_textending filter_fnrrs r( filter_textrIsJ #j/" #F D OO% 7D LL4335 6 7yy  &=r*c eZdZdZddZddZy)rz*A class to add cwd info to debug messages.cd|_yrL)cwdr-s r(r)zCwdTracker.__init__as #r*cltj}||jk7rd|d|z}||_|S)z#Add a cwd message for each new cwd.z cwd is now r9)rgetcwdr)r'rrs r(rzCwdTracker.filterds7iik $((? r*T1DDH r*NrdrrRrPrRrVrWrXrYr)rr]r*r(rr_s4$r*rc eZdZdZddZddZy)rz)Track process creation for debug logging.cDtj|_d|_y)NF)rrr did_welcomer-s r(r)zProcessTracker.__init__os  r*cJd}tj}|j|k7rd|jd|d}||_nT|jsHt t dd}d|dt j dd |dzd tjdz}|r d |_||zS|S) z1Add a message about how new processes came to be.r:zNew process: forked z -> r9argvNzNew process: pid=z, executable: zNew process: cmd: zNew process parent pid: T)rrrrrr executablegetppid)r'rwelcomerrs r(rzProcessTracker.filterssiik 88s?,TXXJd3%rBGDH!!3-D$v^CNN3ERH&thb12,RZZ\, !Kr*Nrdrrr]r*r(rrms3!r*rc eZdZdZddZddZy)r z._decoratorsr!,,S'2C2CD 0JD$3<<'z!4??3#7v~ Cy / 0 r*r])r:r9r;r<s``` r(decorate_methodsr=s  r*cDtjdfd }|S)z;A function decorator to stop in the debugger for each call.cnddl}tjt_|j |i|Sr)pudbr __stdout__r set_trace)argskwargsr@funcs r(_wrapperzbreak_in_pudb.._wrappers+^^  T$V$$r*)rCrrDrrPr functoolswraps)rErFs` r( break_in_pudbrJs%__T%% Or*cdfd }|S)z:A method decorator to debug-log each call to the function.cLtjdfd }|S)Nct|td}|9tjddt t d}t |t|d} rbdjtt|}djd|jD}|dz }||z }|r|r|dz }||z }|dz } r1|d z }|d jtd jz }t t}|d|dd j|d }tj!d j#| |g|i|} r>|d|dd jd| d }tj!d j#|| S)N08drf04dr:z, c3:K|]}dj|yw)z{}={!r}Nrg)rpitems r(rtzCshow_calls.._decorator.._wrapper..3s#W$4I$4$4d$;#Ws()z @ z; T)rr9r0z return )r OBJ_ID_ATTRrrnextOBJ_IDSr$r@maprxrrrCALLSrVr"r#r?)r'rCrDoidextraeargsekwargscallidrJretrE show_args show_return show_stacks r(rFz0show_calls.._decorator.._wrapper*s{$ T2C{S)4=*=>k3/E #dD/2))#W #WW WTME  ;t#D#O#O#QRR%[FE6#,a ugR@C  # #D # 1 7 7 <t-d-f-CQvcl!DMM?(3'L'''5;;C@Jr*)r'rrCrrDrrPrrG)rErFr_r`ras` r(r<zshow_calls.._decorator)s%     4r*rEr rPr r])r_rar`r<s``` r( show_callsrc#s : r*c&ddh}hd}hd}g}|jD]e\}d}|vrd}ntfd|Drd}|s(tfd|Drtjd d |}|j |fgt |S) aLFilter environment variables for a debug display. Select variables to display (with COV or PY in the name, or HOME, TEMP, or TMP), and also cloak sensitive values with asterisks. Arguments: env: a dict of environment variable names and values. Returns: A list of pairs (name, value) to show. COVPY>TMPHOMETEMP>APIKEYPASSTOKENSECRET SIGNATUREFTc3&K|]}|v ywrLr]rpslugr7s r(rtz/relevant_environment_display.._s0$0c3&K|]}|v ywrLr]rqs r(rtz/relevant_environment_display..bs2D44<2rsz\w*)ranyrrrr )envslugsincludecloakto_showvalkeepr7s @r(relevant_environment_displayr~IsDME%G BEGYY[ ( c 7?D 0%0 0D 2E22ffUC- NND#; ' ( g &&r*)rirRrPrR)rzIterable[tuple[str, Any]]rPz Iterator[str])r?zCallable[[str], None]rrRrzrrPrQ)r7 ExceptionrPrR)rrRrPrR)rrQrPrQ)rrOrPrO)rFFF) r>intrrTrrTrrTrPrR)r)r=rr>rrPrQ)2)rrRrrrPrR)rrrPrr)r'rrPrR)rrrPr)rrrPrQ)rrRrr-rPrR)F)rJrRrErTrPrQ)r]F)r:Callable[..., Any]r9rMr;rTrPrrb)TFF)r_rTrarTr`rTrPr)rwzMapping[str, str]rPr)BrY __future__rrr[rHrDrrrrrrrAr!rtypingrrrrcollections.abcrr r coverage.miscr r coverage.typesr rr__annotations__rrr_rjr~rrrrrrrHrrr!rrrrrrrr r"r1r=rJcountrVrXrTrcr~r]r*r(rsA."    87<1B  iDDN J, J. 76   $ $/G,()+%*         "! 3 3 33 3  3l/ **   ,  8  ^^B+!  ( )//  # #### #L'r*