ó …¾^Yc@s{dZddlZddlZddlZddlZddlZyddlZWnek rqddlZnXddl m Z ddl m Z e eƒZgZ dZdefd„ƒYZdefd „ƒYZd „Zd „Zd „Zdd d„Zddd d„Zd„Zd„Zd„Zdefd„ƒYZdefd„ƒYZed„Zd„Zd„Z dS(s'Control of and utilities for debugging.iÿÿÿÿN(tStringIO(tisolate_modulett DebugControlcBsDeZdZd„Zd„Zd„Zejd„ƒZd„Z RS(s!Control and output for debugging.cCsut|ƒt|_||_t|_g}|jdƒrJ|jtƒnt |jd|jdƒd|ƒ|_ dS(s4Configure the options and output file for debugging.tpidt show_processtprocesstfiltersN( tlistt FORCED_DEBUGtoptionst raw_outputtFalsetsuppress_callerstshouldtappendtadd_pid_and_tidtDebugOutputFiletoutput(tselfR RR((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyt__init__"s   cCsd|j|jfS(Ns'(R R (R((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyt__repr__1scCs&|dkr|jrtS||jkS(s@Decide whether to output debug information in category `option`.tcallers(R R R (Rtoption((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyR4sccs,|j}t|_z dVWd||_XdS(s;A context manager to prevent call stacks from being logged.N(R tTrue(Rtold((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pytwithout_callers:s    cCsM|jj|dƒ|jdƒr<td|jddƒn|jjƒdS(shWrite a line of debug output. `msg` is the line to write. A newline will be appended. s RtouttskipiN(RtwriteRtdump_stack_framestflush(Rtmsg((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRDs( t__name__t __module__t__doc__RRRt contextlibtcontextmanagerRR(((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRs     tDebugControlStringcBs eZdZd„Zd„ZRS(s8A `DebugControl` that writes to a StringIO, for testing.cCs tt|ƒj|tƒƒdS(N(tsuperR&RR(RR ((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRRscCs |jjƒS(s,Get the output text from the `DebugControl`.(R tgetvalue(R((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyt get_outputUs(R!R"R#RR)(((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyR&Ps cCsdjd|dƒS(sMake a nice header string.s --{0:-<60s}t (tformat(tlabel((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyt info_headerZsccsÆt|ƒ}|sdStd„|Dƒƒ}x“|D]‹\}}|gkrTd}nt|tttfƒr¬d||f}x?|D]"}d|d||fVd}qƒWq3d|||fVq3WdS( s¦Produce 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|ƒVqdS(N(tlen(t.0tlt_d((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pys iss-none-s%*s:s%*s %siRs%*s: %s(Rtmaxt isinstancetsetttuple(tinfot label_lenR,tdatatprefixte((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pytinfo_formatter_s     cCs?|jt|ƒƒx%t|ƒD]}|jd|ƒq WdS(s.Write a sequence of (label,data) pairs nicely.s %sN(RR-R;(twritertheaderR6tline((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pytwrite_formatted_infovsicCs0tjƒ||d…}djd„|DƒƒS(sReturn 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. iÿÿÿÿs css.|]$}d|d|d|dfVqdS(s %30s : %s @%diiiN((R/tt((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pys s(tinspecttstacktjoin(tlimitRRB((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyt short_stack}scCs@|p tj}|jtd|d|dƒƒ|jdƒdS(s:Print a summary of the stack to stdout, or someplace else.RDRis N(tsyststdoutRRE(RDRR((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyR“s cCs9d}x(tdddƒD]}|||?N}qW|d@S(s-Given a 64-bit id, make a shorter 16-bit one.ii@iiÿÿ(trange(tid64tid16toffset((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pytshort_idšscCs:djttjƒƒƒ}djtjƒ||ƒ}|S(s.A filter to add pid and tid to debug messages.s{0:04x}s{0:5d}.{1}: {2}(R+RLt_threadt get_identtostgetpid(ttextttid((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyR¢scCs€|jƒ}|t|ƒ}|}xS|D]K}g}x-|jƒD]}|j||ƒjƒƒqBWdj|ƒ}q)W||S(sëRun `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. s (trstripR.t splitlinestextendRC(RQRt clean_texttendingtfntlinesR>((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyt filter_textªs  t CwdTrackercBs eZdZd„Zd„ZRS(s*A class to add cwd info to debug messages.cCs d|_dS(N(tNonetcwd(R((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRÁscCs>tjƒ}||jkr:dj|ƒ|}||_n|S(s#Add a cwd message for each new cwd.scwd is now {0!r} (ROtgetcwdR]R+(RRQR]((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pytfilterÄs   (R!R"R#RR_(((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyR[¿s RcBsGeZdZd„ZdZededd„ƒZd„Z d„Z RS(s9A file-like object that includes pid and cwd information.cCs¼||_||_t|ƒ|_|jr¸|jjtƒjƒdjtt ddgƒƒ}|j dt j fƒ|j d|fƒt t dƒr¸|j dt jƒfƒq¸ndS(NR*targvs???sNew process: executable: %s sNew process: cmd: %s tgetppidsNew process: parent pid: %s (toutfileRRRRR[R_RCtgetattrRFRt executablethasattrRORa(RRbRRtcmd((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRÏs   s'$coverage.debug.DebugOutputFile.the_onecCsZtjj|jƒ}|dkrV|dk s3t‚||||ƒtj|j<}n|S(søGet 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(RFtmodulestgett SYS_MOD_NAMER\tAssertionError(tclstfileobjRRtthe_one((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRmÞs  #cCs-|jjt||jƒƒ|jjƒdS(s9Just like file.write, but filter through all our filters.N(RbRRZRR(RRQ((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRñscCs|jjƒdS(sFlush our file.N(RbR(R((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRösN(( R!R"R#RRit classmethodR\RRmRR(((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyRÍs  cCs=tjƒ}|j|dƒ|r9td|ddƒndS(s.Write a log message as forcefully as possible.s RRiN(RRmRR(R RBR((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pytlogûs cCstjdd|ƒ}|S(sMAspectlib prints stack traces, but includes its own frames. Scrub those out.s$(?<= )aspectlib/[^.]+\.py:\d+:\w+ < R(tretsub(RQ((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pytfilter_aspectlib_framessc Csétjjddƒ}|sdSddl}ddl}tjjddƒ}ttg}tjt |dƒdt d |ƒ}|j j d |d d gd ddt ƒ}tjdƒ}x-|jdƒD]}|j||d|ƒqÅWdS(s°For 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. tCOVERAGE_ASPECTLIBRNiÿÿÿÿt COVERAGE_LOGs/tmp/covlog.txttaRRtprint_tot attributestidt stacktraceit use_loggings^(__init__|[a-zA-Z].*)$t:tmethods(ROtenvironRht aspectlibtaspectlib.debugRRrRRmtopenRtdebugRoR Rptcompiletsplittweave(taspectsR~tfilenameRt aspects_filet aspect_logtpublic_methodstaspect((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pytenable_aspectlib_maybe s   $ (!R#R$RARORpRFRMt ImportErrortthreadtcoverage.backwardRt coverage.miscRR t_TEST_NAME_FILEtobjectRR&R-R;R?R\RERRLRRZR[RR RoRrR‹(((s0/tmp/pip-build-hU8Cw8/coverage/coverage/debug.pyts:       1      .