o Y&@sdZddlZddlZddlZddlZddlZzddlZWn ey)ddlZYnwddl m Z ddl m Z e eZgZ dZGdddeZGdd d eZd d Zd d ZddZd%ddZd&ddZddZddZddZGdddeZGdddeZd'dd Zd!d"Zd#d$ZdS)(z'Control of and utilities for debugging.N)StringIO)isolate_modulec@s>eZdZdZddZddZddZejdd Z d d Z d S) DebugControlz!Control and output for debugging.cCsNt|t|_||_d|_g}|dr|tt|j|d|d|_ dS)z4Configure the options and output file for debugging.Fpidprocess show_processfiltersN) list FORCED_DEBUGoptions raw_outputsuppress_callersshouldappendadd_pid_and_tidDebugOutputFileoutput)selfr rr r@/var/www/html/env/lib/python3.10/site-packages/coverage/debug.py__init__"s   zDebugControl.__init__cCsd|j|jfS)Nz')r rrrrr__repr__1szDebugControl.__repr__cCs|dkr |jr dS||jvS)z@Decide whether to output debug information in category `option`.callersF)rr )roptionrrrr4s zDebugControl.shouldccs*|j}d|_z dVW||_dS||_w)z;A context manager to prevent call stacks from being logged.TN)r)roldrrrwithout_callers:s zDebugControl.without_callerscCs6|j|d|drt|jdd|jdS)zhWrite a line of debug output. `msg` is the line to write. A newline will be appended.  routskipN)rwriterdump_stack_framesflush)rmsgrrrr$Ds zDebugControl.writeN) __name__ __module__ __qualname____doc__rrr contextlibcontextmanagerrr$rrrrrs  rcs(eZdZdZfddZddZZS)DebugControlStringz8A `DebugControl` that writes to a StringIO, for testing.cstt||tdSN)superr.rr)rr  __class__rrrRszDebugControlString.__init__cCs |jS)z,Get the output text from the `DebugControl`.)rgetvaluerrrr get_outputUs zDebugControlString.get_output)r(r)r*r+rr4 __classcell__rrr1rr.Ps r.cCsdd|dS)zMake a nice header string.z --{0:-<60s} )format)labelrrr info_headerZsr9ccst|}|s dStdd|D}|D]2\}}|gkrd}t|tttfr>d||f}|D]}d|d||fVd}q.qd |||fVqdS) 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. Ncss|] \}}t|VqdSr/)len).0l_drrr isz!info_formatter..z-none-z%*s:z%*s %sr rz%*s: %s)r max isinstancesettuple)info label_lenr8dataprefixerrrinfo_formatter_s   rHcCs.|t|t|D] }|d|q dS)z.Write a sequence of (label,data) pairs nicely.z %sN)r$r9rH)writerheaderrClinerrrwrite_formatted_infovs rLcCs&t||d}ddd|DS)aReturn 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 ... `limit` is the number of frames to include, defaulting to all of them. `skip` is the number of frames to skip, so that debugging functions can call this and not be included in the result. rcss*|]}d|d|d|dfVqdS)z %30s : %s @%dr Nr)r;trrrr>s(zshort_stack..)inspectstackjoin)limitr#rRrrr short_stack}srUcCs.|ptj}|t||dd|ddS)z:Print a summary of the stack to stdout, or someplace else.r )rTr#rN)sysstdoutr$rU)rTr"r#rrrr%s r%cCs*d}tdddD]}|||?N}q|d@S)z-Given a 64-bit id, make a shorter 16-bit one.r@i)range)id64id16offsetrrrshort_idsr^cCs(dtt}dt||}|S)z.A filter to add pid and tid to debug messages.z{0:04x}z{0:5d}.{1}: {2})r7r^_thread get_identosgetpid)texttidrrrrsrcCs\|}|t|d}|}|D]}g}|D] }|||qd|}q||S)zRun `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. Returns: the final string that results after all of the filters have run. Nr)rstripr: splitlinesextendrS)rcr clean_textendingfnlinesrKrrr filter_texts   rlc@s eZdZdZddZddZdS) CwdTrackerz*A class to add cwd info to debug messages.cCs d|_dSr/)cwdrrrrrs zCwdTracker.__init__cCs*t}||jkrd||}||_|S)z#Add a cwd message for each new cwd.zcwd is now {0!r} )ragetcwdrnr7)rrcrnrrrfilters  zCwdTracker.filterN)r(r)r*r+rrprrrrrms rmc@s:eZdZdZddZdZeddd Zd d Zd d Z dS)rz9A file-like object that includes pid and cwd information.cCs||_||_t||_|jrB|jtjdtt ddg}| dt j f| d|ft t drD| dt fdSdSdS)Nr6argvz???zNew process: executable: %s zNew process: cmd: %s getppidzNew process: parent pid: %s )outfiler r r rrmrprSgetattrrVr$ executablehasattrrarr)rrsr r cmdrrrrs  zDebugOutputFile.__init__z'$coverage.debug.DebugOutputFile.the_oneNTrcCs>tj|j}|dur|dusJ||||tj|j<}|S)zGet the process-wide singleton DebugOutputFile. If it doesn't exist yet, then create it as a wrapper around the file object `fileobj`. `show_process` controls whether the debug file adds process-level information. N)rVmodulesget SYS_MOD_NAME)clsfileobjr r the_onerrrr}s   zDebugOutputFile.the_onecCs"|jt||j|jdS)z9Just like file.write, but filter through all our filters.N)rsr$rlr r&)rrcrrrr$szDebugOutputFile.writecCs|jdS)zFlush our file.N)rsr&rrrrr&szDebugOutputFile.flush)NTr) r(r)r*r+rrz classmethodr}r$r&rrrrrs   rFcCs.t}||d|rt|dddSdS)z.Write a log message as forcefully as possible.rr r!N)rr}r$r%)r'rRr"rrrlogs rcCstdd|}|S)zMAspectlib prints stack traces, but includes its own frames. Scrub those out.z$(?<= )aspectlib/[^.]+\.py:\d+:\w+ < r)resub)rcrrrfilter_aspectlib_framessrcCstjdd}|s dSddl}ddl}tjdd}ttg}tjt |dd|d }|j j |d gd d d }t d}|dD] }|j|||dq>dS)aFor debugging, we can use aspectlib to trace execution. Define COVERAGE_ASPECTLIB to enable and configure aspectlib to trace execution:: $ export COVERAGE_LOG=covaspect.txt $ export COVERAGE_ASPECTLIB=coverage.Coverage:coverage.data.CoverageData $ coverage run blah.py ... This will trace all the public methods on Coverage and CoverageData, writing the information to covaspect.txt. COVERAGE_ASPECTLIBrNr COVERAGE_LOGz/tmp/covlog.txtaTridF)print_to attributes stacktrace use_loggingz^(__init__|[a-zA-Z].*)$:)methods)raenvironry aspectlibaspectlib.debugrrrr}opendebugrrcompilesplitweave)aspectsrfilenamer aspects_file aspect_logpublic_methodsaspectrrrenable_aspectlib_maybe s  r)Nr)NNr)F)r+r,rQrarrVr_ ImportErrorthreadcoverage.backwardr coverage.miscrr _TEST_NAME_FILEobjectrr.r9rHrLrUr%r^rrlrmrrrrrrrrs>     1    .