python (3.12.0)
ˑe N d Z g dZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl m
Z
mZ ddlmZ edd Zi Zd Z ed Z ed
Z ed Z ed Z ed
Z ed Zeez ez ez ez ez Z ed Z ed Z ed Z ed Z ed Z ee z e z e z e z Z dZ!dZ"d Z#dVdZ$d Z%d Z&dWdZ'd Z( G d d e
Z)d Z*d Z+d Z, G d! d"ejZ Z.d# Z/ G d$ d% Z0 G d& d' Z1 G d( d) Z2 G d* d+ Z3 G d, d- Z4 G d. d/ Z5 G d0 d1e6 Z7 G d2 d3e6 Z8 G d4 d5e4 Z9da: dXd8Z;d6ddddd6ddd7 e2 df d9Z< dYd:Z=da>d; Z? G d< d=e j ZA G d> d?eA ZB G d@ dAe j ZDdZdBZE G dC dDeA ZFd6dd e2 dfdEZGdF ZHdG ZIdH ZJd[dIZKd[dJZLd\dKZM G dL dM ZNeNdNdOdPdQdRdSZOdT ZPeQdUk( r e j eP yy)]zreStructuredText en)!register_optionflagDONT_ACCEPT_TRUE_FOR_1DONT_ACCEPT_BLANKLINENORMALIZE_WHITESPACEELLIPSISSKIPIGNORE_EXCEPTION_DETAILCOMPARISON_FLAGS REPORT_UDIFF REPORT_CDIFF REPORT_NDIFFREPORT_ONLY_FIRST_FAILUREREPORTING_FLAGS FAIL_FASTExampleDocTest
DocTestParser
DocTestFinder
DocTestRunner
OutputCheckerDocTestFailureUnexpectedException DebugRunnertestmodtestfilerun_docstring_examples DocTestSuite DocFileSuiteset_unittest_reportflagsscript_from_examples
testsource debug_srcdebug N)StringIOIncrementalNewlineDecoder)
namedtuple TestResultszfailed attemptedc N t j | dt t z S )N )OPTIONFLAGS_BY_NAME
setdefaultlen)names ;/BuggyBox/python/3.12.0/bootstrap/lib/python3.12/doctest.pyr r s ) )$S9L5M0M NN r r r r r r r
r r r
r z <BLANKLINE>z...c d}t j D ]6 }| j |d }|t t | u s(||j z }8 |S Nr# )
__future__all_feature_namesgetgetattr
compiler_flag)globsflagsfnamefeatures r. _extract_future_flagsr; sY
E-- +))E4( gj%0 0 W** *E+ Lr/ c t j | r| S t | t r t | t t
dg S | ( t j t j | S t d # t $ r6 t j t j | j d cY S w xY w# t $ r Y y w xY w)N*__name__z"Expected a module, string, or None)inspectismodule
isinstancestr
__import__globalslocalssysmodules_getframemodulenameAttributeError _getframe f_globalsKeyError TypeError)moduledepths r. _normalize_modulerP s
FC &')VXu==
O{{3#:#:5#ABB <== "
O{{3==#7#A#A*#MNN
O s* %A= =<B<9B? ;B<<B? ? C
C c : t d d j | d S NT)r% decode)datas r. _newline_convertrU s $T4 0 7 7d CCr/ c |ryt |d }t || } t |dd x} |j j }t
|d r/|j | }|j | }t | | fS t | | 5 }|j | fcd d d S # t
$ r Y ow xY w# 1 sw Y y xY w)N
__loader__get_data)encoding) rP _module_relative_pathr5 __spec__loaderrI hasattrrY rS rU openread)filenamepackagemodule_relativerZ r]
file_contentsfs r. _load_testfilerf s #GQ/((; g|T: :F C
))00 6: & "OOH 5M ) 0 0 :M $M2H< <
h * "avvx!" " "
" "s B% B4% B10B14B=c 8 t j d|dz | S )Nz
(?m)^(?!$) )resub)sindents r. _indentrm s
66,s
A ..r/ c v t }| \ }}}t j |||| |j S )N)file)r$ tracebackprint_exceptiongetvalue)exc_infoexcoutexc_typeexc_valexc_tbs r. _exception_tracebackrx s=
ZF ( Hgv
hfE ?? r/ c e Zd Zd ZddZy) _SpoofOutc ` t j | }|r|j d s|dz
}|S N
)r$ rr endswith)selfresults r. rr z_SpoofOut.getvalue s0 ""4( &//$/ dNF
r/ Nc P | j | t j | y N)seekr$ truncate)r sizes r. r z_SpoofOut.truncate s $$ r/ r )r>
__module__ __qualname__rr r r/ r. rz rz s r/ rz c t t | vr| |k( S | j t }dt | }}|d }|r!|j | rt | }|d= ny|d }|r$|j | r|t | z }|d= ny||kD ry|D ]* }|j ||| }|dk r y|t | z
}, y)Nr# FT)ELLIPSIS_MARKERsplitr,
startswithr~ find)wantgotwsstartposendposws r. _ellipsis_matchr s
d"s{
O $B #c(fH
1A >>! 1vH1
2A <<? c!f F2&
88Ax0 a<CF r/ c 4 | j } | rd| z S y)Nz# #)rstrip)lines r.
_comment_liner F s / ;;=D Dyr/ c dt | }}| j d }|dk\ r|}| j dd| }|dk\ r|}| j dd| }|dk\ r|dz }| || S )Nr# r} :.r) )r, r rfind)msgstartendis r. _strip_exception_detailsr N sv CH3E AAv a AAv #q# AAv! uc?r/ c ( e Zd Z d ZddZd Zd Zy)_OutputRedirectingPdbc r || _ d| _ t j j | |d d| _ y )NFT)stdoutnosigintr) )_OutputRedirectingPdb__out$_OutputRedirectingPdb__debugger_usedpdbPdb__init__ use_rawinput)r outs r. r z _OutputRedirectingPdb.__init__n s2
$ cD9 r/ Nc d| _ | t j j }t j
j
| | y rR )r rF rJ f_backr r set_trace)r frames r. r z _OutputRedirectingPdb.set_tracev s4 # =MMO**E $&r/ c \ | j r t j j | y y r )r r r set_continuer s r. r z"_OutputRedirectingPdb.set_continue| s$ GG & r/ c t j }| j t _ t j j
| g| |t _ S # |t _ w xY wr )rF r r r r trace_dispatch)r args save_stdouts r. r z$_OutputRedirectingPdb.trace_dispatch sA jj ZZ
%77))$66$CJCJs A
A r )r> r r r r r r r r/ r. r r h s
' ' %r/ r c t j | st d| z |j d r t d t j j |j d }t | d r-t
j j | j d }n| j dk( rwt t j dkD rJt j d dk7 r4t
j j t j d d }nt
j }nxt | d rT| j D ]E }t
j j || }t
j j# | sC|c S t d | j z t
j j || S )
NzExpected a module: %r/z1Module-relative files may not have absolute paths__file__r# __main__ __path__zBCan't resolve paths relative to the module %r (it has no __file__))r? r@ rM r
ValueErrorospathjoinr r^ r r> r, rF argvcurdirr exists)rN test_pathbasedir directoryfullpaths r. r[ r[ sN F #/&899C LMM ys 35I vz"''--03 J & sxx=?sxx{b 0ggmmCHHQK03GiiG 6: & #__
$ 77<< 9=77>>(+#O
$ 3!??+ , ,
77<< ++r/ c & e Zd Z ddZd Zd Zy)r Nc |j d s|dz
}|r|j d s|dz
}||j d s|dz
}|| _ || _ || _ || _ |i }|| _ || _ y r| )r~ sourcer linenorl optionsexc_msg)r r r r r rl r s r. r zExample.__init__ s t$ dNF
d+ DLD w'7'7'= tOG ?bG r/ c z t | t | urt S | j |j k( xr | j |j k( xrj | j |j k( xrO | j
|j
k( xr4 | j |j k( xr | j |j k( S r )typeNotImplementedr r r rl r r r others r. __eq__zExample.__eq__ s :T%[ (! !{{ell* -yyEJJ&-{{ell*- {{ell*- ||u}}, -
||u}}, -r/ c t | j | j | j | j | j
f S r )hashr r r rl r r s r. __hash__zExample.__hash__ s3 T[[$))T[[$++\\# $ $r/ )Nr# r# N)r> r r r r r r r/ r. r r s! !D EF $ -$r/ r c , e Zd Z d Zd Zd Zd Zd Zy)r c v || _ || _ |j | _ || _ || _ || _ y r )examples docstringcopyr7 r- ra r )r r r7 r- ra r r s r. r zDocTest.__init__ s9 !
"ZZ\
r/ c & t | j dk( rd}n3t | j dk( rd}ndt | j z }d| j j d| j d| j
d | j d
|d S ) Nr# z no examplesr) z 1 examplez %d examples<rh z from r (z)>)r, r __class__r> r- ra r )r r s r. __repr__zDocTest.__repr__% sp t}} "$H
1
$"H$s4=='99H ((DMM4;;B Cr/ c z t | t | urt S | j |j k( xr | j |j k( xrj | j |j k( xrO | j
|j
k( xr4 | j |j k( xr | j |j k( S r )r r r r r7 r- ra r r s r. r zDocTest.__eq__0 s :T%[ (! !}}. +~~ 0+zzU[[(+ yyEJJ&+ }}. +
{{ell* +r/ c p t | j | j | j | j f S r )r r r- ra r r s r. r zDocTest.__hash__; s& T^^TYY
t{{KLLr/ c t |t st S | j | j | j
t
| f|j |j |j
t
| fk S r )rA r r r- ra r idr s r. __lt__zDocTest.__lt__? sV %)! !DMM4;;4AU^^U\\2e9EF Gr/ N)r> r r r r r r r r r/ r. r r s# . C +MGr/ r c e Zd Z ej dej
ej z Z ej dej ej
z ej z Z ej d j Z ddZ d Z
ddZd Z ej dej
Zd Z ej d
ej
Zd Zd Zd
Zy)r a
# Source consists of a PS1 line followed by zero or more PS2 lines.
(?P<source>
(?:^(?P<indent> [ ]*) >>> .*) # PS1 line
(?:\n [ ]* \.\.\. .*)*) # PS2 lines
\n?
# Want consists of any non-blank lines that do not start with PS1.
(?P<want> (?:(?![ ]*$) # Not a blank line
(?![ ]*>>>) # Not a line starting with PS1
.+$\n? # But any other line
)*)
a
# Grab the traceback header. Different versions of Python have
# said different things on the first traceback line.
^(?P<hdr> Traceback\ \(
(?: most\ recent\ call\ last
| innermost\ last
) \) :
)
\s* $ # toss trailing whitespace on the header.
(?P<stack> .*?) # don't blink: absorb stuff until...
^ (?P<msg> \w+ .*) # a line *starts* with alphanum.
z ^[ ]*(#.*)?$c |j }| j | }|dkD r1dj |j d D cg c] }||d c} }g }d\ }}| j j | D ] }|j
|||j ||j d||j z
}| j ||| \ } }
} } | j | s;|j
t | | | ||t |j d z |
||j d|j |j z
}|j } |j
||d |S c c}w )Nr# r} r# r# rl )r rl r )
expandtabs _min_indentr r _EXAMPLE_REfinditerappendr count_parse_example_IS_BLANK_OR_COMMENTr r, groupr )
r stringr-
min_indentloutputcharnor mr r r r s
r. parsezDocTestParser.parsez so ""$%%f-
>YY T8J K1*+ KLF !!**62 A MM& 2 3 fll4; ;F ((D&9
-VWdG ,,V4
wvtW+1+5c!''(:K6L+L,3 5 7
fll4AEEG< <FUUWF# &
fVWo&
3 Ls Fc D t | j || ||||| S r )r get_examples)r r r7 r- ra r s r. get_doctestzDocTestParser.get_doctest s0 t((6Xvv7 7r/ c n | j || D cg c] }t |t r| c}S c c}w r )r rA r )r r r- xs r. r zDocTestParser.get_examples s= ::fd3 +a a) + + +s 2c t |j d }|j d j d }| j |||| | j |dd d|z dz || dj |D cg c]
}||dz d c} }|j d }|j d } t | dkD r t
j d | d
r| d
= | j | d|z ||t | z dj | D
cg c] }
|
|d c}
}| j j | }|r|j d } nd } | j ||| } || || fS c c}w c c}
w ) Nrl r r} r) rh r r z *$r r )
r, r r _check_prompt_blank
_check_prefixr ri match
_EXCEPTION_RE
_find_options)
r r r- r rl source_linesslr r
want_lineswlr r s
r. r z DocTestParser._parse_example st QWWX&' wwx(..t4 vtVD <+SZ#-=tVLLAbBvaxyMAB
wwvZZ%
z?Q 288FJrN#C2 :s6z4!C $55 7yy
;""VW+;<
$ $T * ggenGG $$VT6:wg--/ B <s <E- E2z#\s*doctest:\s*([^\n\'"]*)$c
i }| j j | D ]x }|j d j dd j }|D ]B }|d dvs |dd t
vrt
d|dz d|d| t
|dd }|d d k( ||< D z |r%| j | rt
d|d|d
| |S ) Nr) ,rh r# z+-line z of the doctest for z has an invalid option: +z4 has an option directive on a line with no example: )_OPTION_DIRECTIVE_REr r replacer r* r r ) r r r- r r r option_stringsoptionflags r. r zDocTestParser._find_options s **33F; 3A WWQZ / /S 9 ? ? AN(
31IT)12J&99$&,Qhf&> ? ? +6!":6!'c!1
3 3 t008 $dF 4 5
5 r/ z
^([ ]*)(?=\S)c | j j | D cg c]
}t | }}t | dkD r t | S yc c}w r1 )
_INDENT_REfindallr, min)r rk rl indentss r. r zDocTestParser._min_indent sJ E-1__-D-DQ-GH63v;HH w<! w< Is A
c t | D ]E \ }}t | |dz k\ s||dz dk7 s$t d||z dz d|d|||dz d| y ) Nr rW rh r r) of the docstring for z lacks blank after z: ) enumerater, r )r linesrl r- r r r s r. r z!DocTestParser._check_prompt_blank ss !' @GAt4yF1H$fQh 3)> "((1*d"&vfQh"7"? @ @ @r/ c t | D ]3 \ }}|s |j | rt d||z dz d|d| y )Nr r) r z& has inconsistent leading whitespace: )r r r )r r prefixr- r r r s r. r zDocTestParser._check_prefix% sP !' ;GAtDOOF 3 "((1*dD": ; ; ;r/ N)z<string>)r> r r ri compile MULTILINEVERBOSEr DOTALLr r r r r r r r r r r r r r r/ r. r r J s "** \\BJJ
& (K, BJJ ZZ",,
&
2 4M &2::o6<<%N
7 + *.f &2::&D&(ll 48 ,bll;J @ ;r/ r c N e Zd Z d e ddfdZd dZd Zd Zd Zd Z d
Z
y) r FTc > || _ || _ || _ || _ y r )_parser_verbose_recurse_exclude_empty)r verboseparserrecurse
exclude_emptys r. r zDocTestFinder.__init__> s&
+r/ Nc |&t |dd }|t dt | |du rd }n|t j | } t j
| }|s%t j | }|d |dd z dk( sd }|d }n=|!t j ||j }nt j | }|sd } | |i }n+|j j }n|j }||j | d|vrd|d< g }| j ||||||i |j |S # t $ r d }Y w xY w)Nr> zHDocTestFinder.find: name must be given when obj.__name__ doesn't exist: Fr# z<]>r )r5 r r r? getmodule
getsourcefilegetfile linecachegetlines__dict__rM r update_findsort) r objr- rN r7
extraglobsro r testss r. r zDocTestFinder.findT s} ! F <3
D1D| "&s)". / / U?F
^ &&s+F
(((-D s+AwtBCy(E1$4| # % $-#5#5dFOO#LL $-#5#5d#;L##'L =~ ,,.JJLE ! LL $ U " *E*
5#tV\5"E
Y L s E E
Ec |yt j | |t j | u S t j | r|j |j u S t j
| st j | rLt |d r|j j }nt |d r
|j }ny|j |k( S t j | r|j |j k( S t |d r|j |j k( S t |t ryt d )NT __objclass__r z"object must be a class or function)r? r1
isfunctionr6 __globals__ismethoddescriptorismethodwrapperr^ r> r r> isclassrA propertyr )r rN objectobj_mods r. _from_modulezDocTestFinder._from_module s >
v
&
2W . .v 66 6
'??f&8&88 8((0%%f-v~. --88 . ++??g- -
__V
$??f&7&77 7
V\
*??f&7&77 7
) AB Br/ c | |} t j | }t j | S # t $ r Y w xY wr )r? unwrapr isroutine)r r:
maybe_routines r. _is_routinezDocTestFinder._is_routine sH
#NN= 9M // s / ;;c
| | j rt d|z t | |v ry d|t | < | j ||||| }||j | t j | r| j rz|j j D ]] \ } }
|d| } | j |
st j |
s4| j ||
sG| j ||
| |||| _ t j | r| j rt |di j D ] \ } }
t | t st# dt% | t j& |
sQt j |
s<t j |
s't |
t st# dt% |
|d| } | j ||
| |||| t j | r| j r|j j D ] \ } }
t |
t( t* f r |
j, }
t j& |
s&t j |
st |
t. sc| j ||
sv|d| } | j ||
| |||| y y y )NzFinding tests in %sr) r __test__z3DocTestFinder.find: __test__ keys must be strings: z^DocTestFinder.find: __test__ values must be strings, functions, methods, classes, or modules: z
.__test__.)r( printr _get_testr r? r@ r) r6 itemsrL rC rG r8 r5 rA rB r r rJ staticmethod classmethod__func__rD ) r r< r: r- rN r r7 seentestvalnamevals r. r8 zDocTestFinder._find sk == '$. / c7d? RW
~~c4 E LL C T]] # 2 2 4
, %)73 %%c*gooc.B%%fc2JJuc7FL $d,
, C T]] 'Z < B B D
( !'3/$&*7m&6 7 7 ))#.'//#2F ((-C1E$ '+3i&2 3 3 /3G<
5#w $(
( ??3 DMM # 2 2 4
, cL+#>? ,,C &&s+ws/C h/''4)-w 7GJJuc7FL $d,
, %2 r/ c t |t r|}n7 |j d}n'|j }t |t s t | }| j || }| j r|sy |d }n(t |dd xs |j }|dd dk( r|d d }| j j ||||| S # t t f$ r d}Y w xY w)Nr r .pycr ) rA rB __doc__rM rI _find_linenor* r5 r> r' r ) r r: r- rN r7 r r r ra s r. rP zDocTestFinder._get_test s c3 I
;;& "I # I%i5$' N
""3 5 y >H vz48KFOOH}&#CR=||'' 5$(0&: :% ~.
s 6B9 9C
C
c
P d }t |dd }t j | r|d}t j | rc|a|y t j
dt j t |dd z }t | D ] \ }}|j | s|} n t j | r |j }t j | rt |dd r |j }t j | r |j }t j | r |j }t j" | r|j$ dz
}|N||dz S t j
d }t' |t) | D ] }|j || s|c S y )Nr\ r# z^\s*class\s*%s\br> -r) z(^|.*:)\s*\w*("|\'))r5 r? r@ rC ri r! escaper r ismethodrT r? __code__ istracebacktb_frameisframef_codeiscodeco_firstlinenoranger, )r r: r r r patr r s r. r] zDocTestFinder._find_linenoE s
CD1 C Y%:F
??3 I$9#** 0 YYwsJ'D E F GC$\2
499T? F
C # c "wsIt'D,,C s #3<<S ??3 szz >># ''!+F # ax** 34C L(9:
"99\& 12!M
"
r/ NNNN) r> r r r r r rG rL r8 rP r] r r/ r. r r 5 s= %]_ T,,dLC: 0;,z$:L2r/ r c e Zd Z dZddZd Zd Zd Zd Zd Z d Z
d
Z e j d Zdd Zdd
ZddZd Zy)r zF**********************************************************************Nc |xs
t | _ |dt j v }|| _ || _ || _ d| _ d| _ i | _ t | _ y )N-vr# ) r _checkerrF r r( optionflagsoriginal_optionflagstriesfailures_name2ftrz _fakeout)r checkerr+ rp s r. r zDocTestRunner.__init__ sc 2=?
?chh&G
&$/!
"
r/ c | j rf|j r8 |dt |j z dz t |j z y |dt |j z dz y y )NzTrying:
z Expecting:
zExpecting nothing
)r( r rm r )r r rV examples r. report_startzDocTestRunner.report_start so ==||K''.."99"#%,W\\%:; < K''.."99)* + r/ c 0 | j r |d y y )Nzok
)r( r r rV rx r s r. report_successz DocTestRunner.report_success s == K r/ c || j || | j j ||| j z y r )_failure_headerro output_differencerp r{ s r. report_failurez DocTestRunner.report_failure sC D w / MM + +GS$:J:J K
L Mr/ c f || j || dz t t | z y )NzException raised:
)r~ rm rx r r rV rx rs s r. report_unexpected_exceptionz)DocTestRunner.report_unexpected_exception s= D w / !
"$+,@,J$K
L Mr/ c | j g}|j rf|j )|j |j |j z dz }nd}|j d|j d|d|j n.|j d|j dz d|j |j d |j
}|j t
| dj | S ) Nr) ?zFile "", line , in zLine zFailed example:r} )DIVIDERra r r r- r rm r )r rV rx r r r s r. r~ z DocTestRunner._failure_header s ||n =={{&7>>+E w~~59 JJ
vtyy:
;
JJ7>>!+;TYYG H
$%
76?#yy~ r/ c
V dx}}| j }t d \ }}} | j j }
t |j
D ]v \ } } | j t z xr |dkD }
|| _ | j rP| j j D ]3 \ }}|r| xj |z c_ | xj | z c_ 5 | j t z r|dz
}|
s| j ||| d|j | fz } t t | j |d|d |j | j j# d }| j* j- }| j* j/ d |}|! |
| j0 || j r|}nt3 j4 |d d d }|
s|t7 | z
}| j8 | }nf |
| j8 || j r|}nE| j t: z r2 |
t= | j8 t= | | j r|}||u r|
sT| j? ||| | n?||u r |
s| jA ||| | |dz
}n || u r|
s| jC ||| | |dz
}|sb| j tD z sw n || _ | jG ||| tI || S # t$ $ r t' j( }| j j# Y xY w) Nr# rW r) z<doctest %s[%d]>singleT r )%rp ri ro check_outputr r r
r rQ r ry r- execr! r r7 debuggerr KeyboardInterruptrF rs ru rr r r rp format_exception_onlyrx r r r r| r r r _DocTestRunner__record_outcomer' )r rV compileflagsr rs rr rq SUCCESSFAILUREBOOMcheck
examplenumrx quiet
optionflagrX ra exceptionr outcomer s r. __runzDocTestRunner.__run s2 5 $ / / !&q $
** $-T]]#; ^ J %%(AA " \
4D )0 )>)>)@ 8%Z ((J6( ((ZK7( 8 $&
QJE!!#tW5
*TYY
,CCH
-WW^^Xx )4126**>
**, --((*C MM " "1 % G sD,<,<= %G $999Ra=I"M / ::C ??* "G 7??GT5E5EF %G %%(?? 5goo F 5g > ! - -/ #* '! ''T7C@G# ''T7C@A
D 44S$5>@A
D , ,y 8}^ B 0
dHe48U++} %
- LLN
**,s
A K,,9L(c | j j |j d \ }}||z ||z f| j |j < | xj |z
c_ | xj |z
c_ y )Nr )rt r4 r- rs rr )r rV re tf2t2s r. __record_outcomez DocTestRunner.__record_outcome s` ""499e4B$%bD!B$<
dii
a
r/ z.<doctest (?P<name>.+)\[(?P<examplenum>\d+)\]>$c J | j j | }|ru|j d | j j k( rM| j j
t
|j d }|j j d S | j || S )Nr- r Tkeepends)
%_DocTestRunner__LINECACHE_FILENAME_REr r rV r- r intr
splitlinessave_linecache_getlines)r ra module_globalsr rx s r. __patched_linecache_getlinesz*DocTestRunner.__patched_linecache_getlines s ( ( . .x 8 DIINN2ii((QWW\-B)CDG>>,,d,; ;//.I Ir/ c x
|| _ |t |j }t j
|4
j
j
dk( r
j }n
fd}| j t _ t j }t j }t
| _
| j j | j j t _ t j | _ | j$ t _ t j& }t j( t _ | j+ |||
t _ |t _ t j, | | j" t _ |t _ |r&|j j/ dd l}d |_ S S #
t _ |t _ t j, | | j" t _ |t _ |r&|j j/ dd l}d |_ w w xY w)Nutf-8c ` t | j d } j | y )Nbackslashreplace)rB encodewrite)rk rZ r s r. r z DocTestRunner.run.<locals>.out s) AHHX/A BHMA %%a(r/ r# )rV r; r7 rF r rZ lowerr ru gettracer r r r resetr4 r5 r *_DocTestRunner__patched_linecache_getlines displayhook__displayhook___DocTestRunner__runsettraceclearbuiltins_) r rV r r clear_globs
save_tracesave_set_tracesave_displayhookr rZ r s @@r. runzDocTestRunner.run s & 0<Ljj ;"++H 8>>#3w#>!'') ]]
\\^
-k:
//
(1'9'9$ ! > > ?? -- "::dL#6$CJ *CM LL $!%!=!=I .CO
" !
%CJ *CM LL $!%!=!=I .CO
" !
s
>G A5H9c | | j }g }g }g }dx}}| j j D ]U }|\ }\ } }
||
z
}|| z
}|
dk( r|j | ,| dk( r|j ||
f E|j | W |r{|r8t t | d |j
|D ] } t d| |r?t t | d |j
|D ] \ } } t d| | fz |rXt | j t t | d |j
|D ] \ } \ } }
t d| |
| fz |r2t |dt | j d t ||z
d
|d |rt d |d
n
|r t d t || S )Nr# zitems had no tests:z zitems passed all tests:z %3d tests in %szitems had failures:z %3d of %3d in %sztests inzitems.z
passed andzfailed.z***Test Failed***z failures.z Test passed.) r( rt rQ r rO r, r9 r r' )
r r+ notestspassedfailedtotalttotalfr r- re r thingr s
r. summarizezDocTestRunner.summarize s ?mmG $$&
!A LD&1a aKF aKFAvt$a
ay*
a
! c'l$9: $ (E%'(c&k#<=
$* ?LE5,u~=>? $,, #f+ 4 5 KKM!'
;
v1)Q5M9:
; &*c$--&8( C &6/< C %v{ ;
. !66**r/ c | j }|j j D ]% \ }\ }}||v r|| \ }}||z }||z }||f||< ' y r )rt rQ )r r dr- re r r r s r. mergezDocTestRunner.merge( sd MM !NN 0 0 2 LD&1aqy
4BFFdAdG r/ )NNr# r NNT)r> r r r r ry r| r r r~ r r ri r! r r r r r r r/ r. r r } sn 6r G $H +MM ({,z )bjj *F GJD"R4+r r/ r c & e Zd Z d Zd Zd Zd Zy)r c < t |j dd d S )NASCIIr )rB r )r rk s r. _toAsciizOutputChecker._toAscii= s" 188G%78'BBr/ c | j | }| j | }||k( ry|t z s||fdk( ry||fdk( ry|t z sNt j dt j
t z d| }t j dd| }||k( ry|t z rDdj |j }dj |j }||k( ry|t z r
t || ryy) NT)zTrue
z1
)zFalse
z0
z (?m)^%s\s*?$r z(?m)^[^\S\n]+$rh F) r r r ri rj r` BLANKLINE_MARKERr r r r r r r r rp s r. r zOutputChecker.check_outputC s mmC }}T" $; 44Dz ..Dz // 3366/BII6F,GG d$D &&*B4Cd{
- -((399;'C88DJJL)Dd{ ! tS) r/ c |t t z t z z sy|t z ry|j d dkD xr |j d dkD S )NFTr} r )r
r r r r s r. _do_a_fancy_diffz OutputChecker._do_a_fancy_diff sV l * + * + , % zz$ !#; $!(;;r/ c |j }|t z st j dt | }| j ||| r|j
d }|j
d }|t z r)t j ||d }t | dd }d}n||t z r)t j ||d }t | dd }d}nJ|t z rAt j t j } t | j! || }d }d
z t# d j% z S |r |rd t# | d
t# | S |rdt# | z S |rdt# | z S y)Nz(?m)^[ ]*(?=
)Tr r )nz#unified diff with -expected +actualz-context diff with expected followed by actual)charjunkz ndiff with -expected +actualzDifferences (%s):
r z
Expected:
zGot:
zExpected:
%sGot nothing
zExpected nothing
Got:
%sz Expected nothing
Got nothing
)r r ri rj r r r r
difflib unified_difflistr context_diffr DifferIS_CHARACTER_JUNKcomparerm r )
r rx r rp r r got_linesdiffkindengines
r. r z OutputChecker.output_difference s[ || 33&&*,<cBC sK 8 $ 7J5I\) ++J QGDz!"~< |+ ++J QGDz!"~F |+ 1J1JKFNN:y AB5 )4/'"''$-2HH H C.5dmWS\J J
/'$-? ?
/'#,> >4r/ N)r> r r r r r r r r/ r. r r 5 s C <~<.,5r/ r c e Zd Z d Zd Zy)r c . || _ || _ || _ y r )rV rx r )r rV rx r s r. r zDocTestFailure.__init__ s r/ c , t | j S r rB rV r s r. __str__zDocTestFailure.__str__ 499~ r/ Nr> r r r r r r/ r. r r s
r/ r c e Zd Z d Zd Zy)r c . || _ || _ || _ y r )rV rx rs )r rV rx rs s r. r z UnexpectedException.__init__ s
r/ c , t | j S r r r s r. r zUnexpectedException.__str__ r r/ Nr r r/ r. r r s !
r/ r c " e Zd Z ddZd Zd Zy)r Nc p t j | |||d }|r|j j |S )NF)r r r7 r )r rV r r r rs r. r zDebugRunner.runH s2 dD,U C JJ r/ c t ||| r )r r s r. r z'DebugRunner.report_unexpected_exceptionN s !$::r/ c t ||| r )r r{ s r. r zDebugRunner.report_failureQ s T7C00r/ r )r> r r r r r r r/ r. r r s X t ;1r/ r TFc | t j j d } t j | st d| | | j }t | } |rt || }
n
t || }
| j | ||| D ] } |
j | |r|
j t |
a
nt j |
t |
j |
j" S )Nr ztestmod: module required; )r. r+ rp r7 r; )rF rG r4 r? r@ rM r> r r r r r r masterr r' rs rr ) r r- r7 r+ reportrp r; raise_on_errorr. finderrunnerrV s r. r r ] s >D y
KKOOJ ' A !=>> |zz
7F W+F wKH At5Z H
4
~ V v 55r/ c |r
|s t d t | ||| xs d \ } } | t j j | }|i }n|j }||j
| d|vrd|d< | rt || }
n
t || }
|
j | ||| d }|
j | |r|
j t |
a nt j |
t |
j |
j S )N8Package may only be specified for module-relative paths.r r> r r r# )r rf r r basenamer r7 r r r r r r r r' rs rr )ra rc r- rb r7 r+ r rp r; r r, rZ textr rV s r. r r s K\ + , , $Hg$,$79ND( |ww )
}
Z &j W+F wKH dE41 =D
JJt
~ V v 55r/ c t |d }t || }|j | || D ] }|j || y )NF)r+ r- r )r7 )r )r r r r ) re r7 r+ r- r rp r r rV s r. r r @ sO 7E
:F
7
DF At5 1 4
4l
34r/ c H | t z | k7 r t d| t }| a|S )Nz Only reporting flags allowed)r r _unittest_reportflags)r8 olds r. r r ] s4 8 E)7??
C ! Jr/ c l e Zd Z d
dZd Zd Zd Zd Zd Zd Z d Z
d
Z d Z e
j Zd Zy) DocTestCaseNc t j j | || _ || _ |j
j
| _ || _ || _ || _
y r ) unittestTestCaser _dt_optionflags _dt_checkerr7 r _dt_globs_dt_test _dt_setUp _dt_tearDown)r rV rp setUptearDownrv s r. r zDocTestCase.__init__ sP ""4( * " *
$r/ c X | j }| j | j | y y r )r r r rV s r. r zDocTestCase.setUp s& }} >> % NN4 &r/ c | j }| j | j | |j j |j j | j
y r )r r
r7 r r7 r
r s r. r zDocTestCase.tearDown sM }} ( d #
$..)r/ c | j }t j }t }| j }|t
z s |t z }t || j d } d|_ |j ||j d \ }}|t _ |r.| j | j |j y # |t _ w xY w)NFrp rv r+ zF----------------------------------------------------------------------)r r )r rF r r$ r r r r r r r r failureExceptionformat_failurerr )r rV r newrp r rs rr s r. runTestzDocTestCase.runTest s }}jjj** o-
0 0K ;'+'7'7H #FN $jj#)) ) 8OHe CJ ''(;(;CLLN(KL L CJs (C
Cc
| j }|j d}nd|j z }dj |j j d dd }d|j d|j
d|d|d |
S )
Nzunknown line numberz%sr r Failed doctest test for
File "r r z
)r r r r- r ra )r errrV r lnames r. r zDocTestCase.format_failure sj }} ;; *FDKK'F -bc23 99dmmVUCA r/ c | j t | j | j d }|j | j
d | j
y )NFr )r )r r r r r r r )r r s r. r" zDocTestCase.debug sN ? B
)=)=%)%5%5uF
4==e
4
r/ c . | j j S r r r- r s r. r zDocTestCase.id
s }}!!!r/ c D t | t | urt S | j |j k( xrj | j |j k( xrO | j |j k( xr4 | j
|j
k( xr | j |j k( S r )r r r r r r
r r s r. r zDocTestCase.__eq__
s :T%[ (! !}}. 5##u'<'<<5~~ 05 E$6$665 5#4#44 5r/ c p t | j | j | j | j f S r )r r r r
r r s r. r zDocTestCase.__hash__ s3 T))4>>4;L;L%%' ( (r/ c | j j j d }|d ddj |d d dS )Nr r r ))r r- r r )r r- s r. r zDocTestCase.__repr__ s: }}!!'', HchhtCRy&9::r/ c 4 d| j j z S )Nz Doctest: r r s r. shortDescriptionz DocTestCase.shortDescription! s T]] / ///r/ )r# NNN)r> r r r r r r r r" r r r r rE r r& r r/ r. r r sM AE %! *M0
FP"5(; nnG0r/ r c ( e Zd Zd Zd Zd Zd ZeZy)SkipDocTestCasec > || _ t j | d y r )rN r r )r rN s r. r zSkipDocTestCase.__init__% s T4(r/ c & | j d y )Nz-DocTestSuite will not work with -O2 and above)skipTestr s r. r zSkipDocTestCase.setUp) s
EFr/ c y r r r s r. test_skipzSkipDocTestCase.test_skip, r/ c 4 d| j j z S )NzSkipping tests from %s)rN r> r s r. r& z SkipDocTestCase.shortDescription/ s '$++*>*>>>r/ N)r> r r r r r- r& r r r/ r. r( r( $ s )G
? Gr/ r( c e Zd Zd Zy)
_DocTestSuitec y r r )r indexs r. _removeTestAtIndexz _DocTestSuite._removeTestAtIndex7 r. r/ N)r> r r r4 r r/ r. r1 r1 5 s
r/ r1 c |
t }t | } |j | || }|sCt j j
dk\ r&t
}|j t | |S |j t
}|D ]b }t |j dk( r |j s | j }|dd dk( r|d d }||_ |j t |fi | d |S )Nr r r# rZ r[ r )r rP r rF r8 optimizer1 addTestr( r9 r, r ra r r ) rN r7 r; test_finderr r< suiterV ra s r. r r ; s !F #o
v
&F V5Z HE SYY''!+
of-. JJL OE 4 t}} " }} H}&#CR= $DM
k$2'234 Lr/ c e Zd Zd Zd Zd Zy) DocFileCasec j dj | j j j d S )Nr r )r r r- r r s r. r zDocFileCase.id} s& xx
**00566r/ c . | j j S r )r ra r s r. r zDocFileCase.__repr__ s }}%%%r/ c h d| j j d| j j d|S )Nr r z ", line 0
)r r- ra )r r s r. r zDocFileCase.format_failure s( ==%%t}}'='=sD r/ N)r> r r r r r r r/ r. r; r; { s 7&r/ r; c |i }n|j }|r
|s t d t | |||xs d \ }} d|vr| |d< t j j | }|j
|||| d } t | fi |S )Nr r r r# )r r rf r r r r r; )
r rc rb r7 r, rZ r docr- rV s
r. DocFileTestrA s
}
+ , , tWo ' 274IC j 77 D !D c5$a 8D t 'w ''r/ c t }|j dd r t |j d |d< | D ] }|j t |fi | |S )Nrc Trb )r1 r4 rP r7 rA )pathskwr9 r s r. r r se 6n
OE
vv &)"&&*;<9
/
k$-"-./ Lr/ c ` g }t j | D ] }t |t rg|j |j
d d |j }|s@|j d ||j d d d D cg c] }d|z c}z
}z||j d d d D cg c]
}t | c}z
} |r#|d dk( r|j |r |d dk( r|r$|d dk( r |j d |r |d dk( r dj | dz S c c}w c c}w )Nr z # Expected:r} z## r r# ) r r rA r r r r r r popr )rk r piecer r s r. r r s7 8 r F &&q) 8 eW % MM%,,s+ ,::D
m,DJJt,<Sb,ABq57BB
% D 1#2 68 %Q' 8
8F 8 VBZ3&
VBZ3&
VAY#%
1
VAY#% 99V t ## C8s D&.D+c t | } t j | }|D cg c] }|j |k( s| }}|s t |d |d }t |j }|S c c}w )Nznot found in testsr# )rP r r r- r r r )rN r- r< r rV testsrcs r. r r =
st v
&F O (E /!$A /D / 344 7D"4>>2G N 0s
A/A/c 6 t | }t ||| y r )r debug_script)srcpmr7 rI s r. r! r! M
s >"3'G"e$r/ c dd l }|r|j }ni }|r t | || y |j d j d| z || y # t t j
d |j d }|j |j d t j
d Y y xY w)Nr# r) T)r r zexec(%r))
r r r rO rF rs r r interactionr )rL rM r7 r ps r. rK rK R
s =
3 eU # "":#3UEB
3 #,,.# $&A
GGI
MM$ q 1 2s
A A,Cc b t | } t | | }t ||| j y r )rP r rK r6 )rN r- rM rI s r. r" r" f
s/ v
&F&G"foo.r/ c e Zd Z d Zd Zd Zy)
_TestClassc || _ y r rX )r rX s r. r z_TestClass.__init__
s r/ c 0 | j dz | _ | S )Nr rU r s r. squarez_TestClass.square
s 88q= r/ c | j S r rU r s r. r4 z_TestClass.get
s xxr/ N)r> r r r rW r4 r r/ r. rS rS t
s r/ rS z
Example of a string object, searched as-is.
>>> x = 1; y = 2
>>> x + y, x * y
(3, 2)
a
In 2.2, boolean expressions displayed
0 or 1. By default, we still accept
them. This can be disabled by passing
DONT_ACCEPT_TRUE_FOR_1 to the new
optionflags argument.
>>> 4 == 4
1
>>> 4 == 4
True
>>> 4 > 4
0
>>> 4 > 4
False
z
Blank lines can be marked with <BLANKLINE>:
>>> print('foo\n\nbar\n')
foo
<BLANKLINE>
bar
<BLANKLINE>
z
If the ellipsis flag is used, then '...' can be used to
elide substrings in the desired output:
>>> print(list(range(1000))) #doctest: +ELLIPSIS
[0, 1, 2, ..., 999]
a
If the whitespace normalization flag is used, then
differences in whitespace are ignored.
>>> print(list(range(30))) #doctest: +NORMALIZE_WHITESPACE
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14,
15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26,
27, 28, 29]
)rS r zbool-int equivalencez blank linesellipsiszwhitespace normalizationc dd l } | j d }|j ddddd |j d
d d t j g d
|j dddd |j ddd |j }|j }|j }d}|j D ] }|t | z } |j r |t z }|D ] }|j d rst j j | \ }}t j j! d| t# |d d } t j d= t% | || \ }
} nt' |d|| \ }
} |
s y y) Nr# zdoctest runner) descriptionrn z --verbose
store_trueFz'print very verbose output for all tests)actiondefaulthelpz-oz--optionr zqspecify a doctest option flag to apply to the test run; may be specified more than once to apply multiple options)r] choicesr^ r_ z-fz --fail-fastzystop running tests after first failure (this is a shorthand for -o FAIL_FAST, and is in addition to any other -o options))r] r_ ro r z file containing the tests to run)nargsr_ z.pyr )rc r+ rp r) )argparseArgumentParser add_argumentr* keys
parse_argsro r+ r fail_fastr r~ r r r rF insertrC r r ) rc r, r testfilesr+ r r ra dirnamer rs r s r. _testrl
s
$
$1A
$
BF
k, F H
j 3 8 8 :B E G
mL F H c ? A D I llGG++ /&v../ ~~9 U # !#
h 7 GX HHOOAw '8CR=)A !!W'JKHa"8U-4'KKHa
r/ r )r )r ) NNNNTr# NFF)FNoNameNr# rk )FN)F)S
__docformat____all__r2 r r? r4 r r ri rF rp r ior$ r% collectionsr& r' r* r r r r r r r r r
r r r
r r r r r; rP rU rf rm rx rz r r r r r r[ r r r r r r Exceptionr r r r r r r r r r r r( TestSuiter1 r r; rA r r r r! rK r" rS rN rl r> exitr r/ r. <module>ru s7 %N &
+ Z
2 " (:; . O --EF +,CD *+AB z *6"-.GH *)*()
, , #>2 ">2 ">2 /0K L , -- ! &
>2D"$/ /b4"%CGG "%J ,\B$ B$HEG EGVd; d;VB BP
v vp
P5 P5d Y & ) &e1- e1\
373705f6P (,$d U=?y6v :B:;46 !Ha0(## a0F k "
H&&
>@ + '+D=? (4CRP$d %
C( / * *X %%( )Q0
f*
Z z CHHUW r/ 
Browse
Usage
Versions