{)r r) r* s r+ __repr__zDebugControl.__repr__A s X XXDOXXXXr- optionboolc 2 |dk r | j rdS || j v S )z@Decide whether to output debug information in category `option`.callersF)r" r r* r3 s r+ r# zDebugControl.shouldD s' Y 4#8 5$,&'r- Iterator[None]c # V K | j }d| _ dV || _ dS # || _ w xY w)z;A context manager to prevent call stacks from being logged.TN)r" )r* olds r+ without_callersz DebugControl.without_callersJ sH # $ ( EEE$'D ! ! !CD ! ' ' ' 's (msgc | j |dz | d rWt j d d j d }| | j d|d | d rt | j d | j dS ) zhWrite a line of debug output.
`msg` is the line to write. A newline will be appended.
r* r Nzself: r6 outskip) r writer# inspectstackf_localsgetdump_stack_framesflush)r* r< caller_selfs r+ rC zDebugControl.writeT s
#d(### ;;v >!-//!,Q/8<z!info_formatter.. s2 33das1vv !333333r- z-none-z%*s: %rz%*s:z%*s %sr? z%*s: %s)r! all
isinstancetupleru reprset)ro ri dataprefixery s @r+ info_formatterr sI ::D I 3333d333 3 333 3 7 7 t 2::D dE " " 7s4d +<+<'='='B'By%t == = = = =
tS% 0
1
1 7y% 00F
)A+vq!99999
y% 66 6 6 6 6 7 7r- rC Callable[[str], None]headerr c v | t | t | D ]} | d| dS )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.
rk N)rn r )rC r ro lines r+ write_formatted_infor sV
E+f
t$$
j$jj r- limit
Optional[int]rB intc x t j | |d }d d |D 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
...
`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.
r> c 3 J K | ] }d |d |d |d fz V dS )z %30s : %s:%d r? NrV )rv ts r+ rz z short_stack.. s: HHQ^qtQqT1Q4&88HHHHHHr- )rD rE join)r rB rE s r+ short_stackr s; $
MOOE$rM *E 99HH%HHH H HHr- rA Optional[TWritable]c |p t j }| t | |dz | d dS )z:Print a summary of the stack to stdout, or someplace else.r? )r rB r> N)sysstdoutrC r )r rA rB fouts r+ rH rH sK #*DJJ{T!V444555JJtr- 2 textnumcharsc ` t j }||_ | | S )z(`repr(text)`, but limited to `numchars`.)reprlibRepr maxstringr )r r rs r+ clipped_reprr s$ AAK 66$<<r- id64c H d}t ddd D ]
}|| |z z } |dz S )z-Given a 64-bit id, make a shorter 16-bit one.r @ i )range)r id16offsets r+ short_idr s< D2r"" &=r- c t t j d}t j dd| d| } | S )z.A filter to add pid and tid to debug messages.04x5d.z: )r _thread get_identosgetpid)r tids r+ r% r% sI g'))
*
*
0
0Cikk , , ,s , ,d , ,D Kr- c " e Zd ZdZddgZddZdS )
AutoReprMixinz9A mixin implementing an automatic __repr__ for debugging.auto_repr_ignore$coverage.object_idr r. c fd j D }d j j t d d |D S )Nc 3 x K | ]4\ }}t |d d r t | s|j v.||fV 5dS )rS TN)getattrcallabler )rv kvr* s r+ rz z)AutoReprMixin.__repr__.. sn
q!q*D11
QKK
... F /...
r- z<{klass} @0x{id:x} {attrs}>rk c 3 * K | ]\ }}| d |V dS )=NrV rv r r s r+ rz z)AutoReprMixin.__repr__.. s0 ??DAqa<Turn things which are nearly dict/list/etc into dict/list/etc.c 4 i | ]\ }}|t | S rV simplify)rv r vvs r+
z simplify.. s$ 66651b(2,,666r- c 3 4 K | ]}t | V d S rK r )rv r s r+ rz zsimplify.. s( 00x||000000r- r c i | ] \ }}d |z | S )r rV r s r+ r z simplify.. s" AAAdaQAAAr- ) r} dictr r! r~ typehasattrr r r s r+ r r s !T 66AGGII6666 Ae} % % tAww00a000000 J AAaj.>.>.@.@AAABBBr- c H t j t | dS )zEDebug helper to pretty-print data, including SimpleNamespace objects.N)pprintr r s r+ ppr s M(1++ r- r Iterable[Callable[[str], str]]c , | }| t | d }|} |D ]`}g }| D ]2}| || 3d | } a| |z 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> )rstripru
splitlinesextendr )r r
clean_textendingfnlinesr s r+ filter_textr s J
#j//""
#F D OO%% 0 0D LLD,,.. / / / /yy &=r- c " e Zd ZdZd dZd
dZdS )
CwdTrackerz*A class to add cwd info to debug messages.r r c d | _ d S rK )cwdr1 s r+ r, zCwdTracker.__init__" s
"&r- r r. c b t j }|| j k rd|d|z }|| _ |S )z#Add a cwd message for each new cwd.z cwd is now r> )r getcwdr )r* r r s r+ filterzCwdTracker.filter% s9 ikk $(??****T1DDH r- Nrh r r. r r. )rO rP rQ rR r, r rV r- r+ r r sB 44' ' ' ' r- r c e Zd ZdZd dZe d d!d ZdZdZed"d Z ed#d Z
ed$d Z d%d Z d$d Z
d S )&r& z9A file-like object that includes pid and cwd information.r( r r r4 r r c || _ || _ t | | _ | j r| j dt j | dt j d | d
t t dd t t d rB| dt j dt j d d S d S d S ) Nr zNew process: executable: r> zNew process: cmd: {!r}
argvgetppidzNew process: pid: z, parent pid: )r( r r! r insertr r rC r
executablerm r r r r r )r* r( r r s r+ r, zDebugOutputFile.__init__0 s (G}} a L :<<#6 7 7 7 JJG3>GGG H H H JJ188fd9S9STT U U Ur9%%
a
_ __RZ\\___````` a a
a
ar- NTrV Ffileobjr r interimr c |
| ||| S | \ }}||r|t |dd }n`t j dt
}|dv rt
t | }n!|rt |dd }n t j } | ||| }| || |S )ax Get a DebugOutputFile.
If `fileobj` is provided, then a new DebugOutputFile is made with it.
If `fileobj` isn't provided, then a file is chosen (`file_name` if
provided, or COVERAGE_DEBUG_FILE, or stderr), and a process-wide
singleton DebugOutputFile is made.
`show_process` controls whether the debug file adds process-level
information, and filters is a list of other message filters to apply.
`filters` are the text filters to apply to the stream to annotate with
pids, etc.
If `interim` is true, then a future `get_one` can replace this one.
Nazutf-8)encodingCOVERAGE_DEBUG_FILE)r stderr)
_get_singleton_dataopenr environrG FORCED_DEBUG_FILEr r r _set_singleton_data)clsr r r r r the_one
is_interims r+ r' zDebugOutputFile.get_oneA s 4 3w g66 6 ! 5 5 7 7 ?j?$ y#@@@ JNN+@BS T T 444 %c9 5 5GG ) "9cG D D DGG !jGc'<99G # #GW 5 5 5r- z'$coverage.debug.DebugOutputFile.the_onethe_one_and_is_interimr r c t j | j }t || j ||f |t
j | j < dS )z-Set the one DebugOutputFile to rule them all.N)types
ModuleType SYS_MOD_NAMEsetattrSINGLETON_ATTRr modules)r r r singleton_modules r+ r z#DebugOutputFile._set_singleton_dataw sH !+C,<== #"4w6HIII(8 C$%%%r- &Tuple[Optional[DebugOutputFile], bool]c v t j | j }t || j d S )z Get the one DebugOutputFile.)NT)r r rG r r r )r r s r+ r z#DebugOutputFile._get_singleton_data~ s1 ;??3+;<<');\JJJr- c T | j t j v rt j | j = dS dS )z6Delete the one DebugOutputFile, just for tests to use.N)r r r )r s r+ _del_singleton_dataz#DebugOutputFile._del_singleton_data s/ s{ * * C ,--- + *r- r r. c | j J | j t || j | j dS )z9Just like file.write, but filter through all our filters.N)r( rC r r rI )r* r s r+ rC zDebugOutputFile.write sL |''' ;tT\::;;; r- c J | j J | j dS )zFlush our file.N)r( rI r1 s r+ rI zDebugOutputFile.flush s* |''' r- )r( r r r4 r r )NNTrV F) r r r r r r4 r r r r4 r r& )r r& r r4 r r )r r rh )r r. r r )rO rP rQ rR r, classmethodr' r r r r r rC rI rV r- r+ r& r& . s CCa a a a" &*#' !24
+ + + + [+d =L-N9 9 9 [9 K K K [K
. . . [.
r- r& Fr< rE r4 c t d }| | dz |rt |d dS dS )z.Write a log message as forcefully as possible.Tr r> r? r@ N)r& r' rC rH )r< rE rA s r+ logr sY
!
!$
!
/
/CIIc$h +c******+ +r- rV decoratorCallable[..., Any]butnotr privatec fd}|S )z2A class decorator to apply a decorator to methods.c t j | t j D ]L\ }}|| j vr|dk rs| d r-|v r2t | | | M| S )Nr, rx )rD
getmembers isroutiner
startswithr )r namemethr r r s r+
_decoratorz$decorate_methods.._decorator s !,S'2CDD 0 0JD$3<''z!! 4??3#7#7 v~~ Cyy / / / /
r- rV )r r r r s ``` r+ decorate_methodsr s0
r- funcc H t j d fd }|S )z;A function decorator to stop in the debugger for each call.argsr kwargsr c p dd l }t j t _ | | i |S Nr )pudbr
__stdout__r set_trace)r r r# r s r+ _wrapperz break_in_pudb.._wrapper s: ^
tT$V$$$r- )r r r r r r functoolswraps)r r& s ` r+
break_in_pudbr* s= _T% % % % % %
Or- r T show_args
show_stack show_returnc d fd }|S )z:A method decorator to debug-log each call to the function.r r r c P t j d fd }|S )Nr* r r r r c t | t d }|Bt j ddt t
d}t
| t | d} rvd t t | }d d |
D }|dz
}||z
}|r|r|dz
}||z
}|dz
}
rE|d z
}|d
d t D z
}t t }| d|dd
j | d }t d
|
| g|R i |} rB| d|dd
j d| d }t d
| | S )N08drk 04dr{ z, c 3 * K | ]} d j | V dS )z{}={!r}Nrl )rv items r+ rz zCshow_calls.._decorator.._wrapper.. s- #W#W$4I$4d$;#W#W#W#W#W#Wr- ()z @ z; c 3 4 K | ]}t | V d S rK )_clean_stack_line)rv rw s r+ rz zCshow_calls.._decorator.._wrapper.. s+ "\"\A#4Q#7#7"\"\"\"\"\"\r- r> Tr z return )r OBJ_ID_ATTRr r nextOBJ_IDSr r mapr r r r CALLSrO r& r' rC )r* r r oidextraeargsekwargscallidr< retr r+ r- r, s r+ r& z0show_calls.._decorator.._wrapper s $ T22C{>>>4==>>>k3///E
#dD//22 ))#W#W #W#W#WWW "W "TME
]"\"\ AYAYA[A["\"\"\\\\%[[F@@6@@@
@u@@@C # #D # 1 1 7 7 < < <$t-d---f--C
A LLvLLLDMLL3LLL '''55;;C@@@Jr- )r* r r r r r r r r' )r r& r+ r- r, s ` r+ r z show_calls.._decorator sM
4 r- r r r r rV )r+ r, r- r s ``` r+
show_callsrE s5 : r- sc j | } | t j t
dz d } | t j t j dz d } | t j dz d } | S )z6Simplify some paths in a stack trace, for compactness./r{ )stripreplacer pathdirname__file__r r )rF s r+ r8 r8 s| A "'//(++c1266A "'//"+..4b99A #*s"B''A Hr- envMapping[str, str]List[Tuple[str, str]]c R ddh}h d}h d}g }| D ]u\ }d}|v rd}n t fd|D rd}|rHt fd|D rt j d d
| }| |f vt | S ) aL Filter 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 SIGNATUREFTc 3 K | ]}|v V d S rK rV rv slugr s r+ rz z/relevant_environment_display.. s' 00$ 000000r- c 3 K | ]}|v V d S rK rV r^ s r+ rz z/relevant_environment_display.. s' 22D44<222222r- z\w*)r anyresubr$ r )rN slugsincludecloakto_showvalkeepr s @r+ relevant_environment_displayrk s DME%%%G B B BEGYY[[ ( ( c 7??DD
0000%000
0
0 D (2222E22222
.fUC-- NND#; ' ' ' g & &&r- )ri r. r r. )ro rp r rq )rC r r r. ro rp r r r" )r r rB r r r. )NNr )r r rA r rB r r r )r )r r. r r r r. )r r r r r )r r r r )r r r r )r r. r r r r. )F)r< r. rE r4 r r )rV F)r r r r r r4 r r rD )TFF)r+ r4 r, r4 r- r4 r r )rF r. r r. )rN rO r rP )=rR
__future__r rT r( rD r[ itertoolsr r rc r r r r typingr r r r r r r
r r r
coverage.miscr r coverage.typesr r __annotations__r r rX rc rn r r r rH r r r% r r r r r r& r r r* countr; r= r9 rE r8 rk rV r- r+ rs s. . - - " " " " " "
= < < < < < < < $ $ $ $ $ $^B : : : : : : : : z5 5 5 5 5 5 5 5 J J J J J, J J J . . . .
7 7 7 76 $I I I I I. #
$ * e e e e e e e e P+ + + + + ( )/
# # # # # #L
' ' ' ' ' 'r-