֦i 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 /usr/lib64/python3.12/doctest.pyr r s ) )$S9L5M0M NN r r r r r r r
r r r
r z 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; sT
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= =
__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[ sI 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)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 nd}|j |j nd}| j | j
|t
| f|j |j
|t
| fk S )Nr )rA r r r r- ra id)r r self_lno other_lnos r. __lt__zDocTest.__lt__? sv %)! !"&++"94;;r$)LL$U^^Y5 BC Dr/ N)r> r r r r r r r r r/ r. r r s# . C +MDr/ 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
(?:^(?P [ ]*) >>> .*) # PS1 line
(?:\n [ ]* \.\.\. .*)*) # PS2 lines
\n?
# Want consists of any non-blank lines that do not start with PS1.
(?P (?:(?![ ]*$) # 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 Traceback\ \(
(?: most\ recent\ call\ last
| innermost\ last
) \) :
)
\s* $ # toss trailing whitespace on the header.
(?P .*?) # don't blink: absorb stuff until...
^ (?P \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.parse| sp ""$%%f-
>YY T8J K8J1*+8J KLF !!**62A MM& 2 3 fll4; ;F ((D&9
-VWdG ,,V4
wvtW+1+5c!''(:K6L+L,3 5 7
fll4AEEG< ? ? +6!":6!'c!1
) < 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 sM E-1__-D-DQ-GH-G63v;-GH w "((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' sK !'GAtDOOF 3 "((1*dD": ; ; (r/ N)z)r> r r ri compile MULTILINEVERBOSEr DOTALLr r r r r r r r r
r r r r r r/ r. r r L 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.findV 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? r3
isfunctionr8 __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 r< r- rN r r7 seentestvalnamevals r. r: zDocTestFinder._find s] == '$. / c7d? RW
~~c4 E LL C T]] # 2 2 4 %)73 %%c*gooc.B%%fc2JJuc7FL $d,
!5 C T]] 'Z < B B D !'3/$&*7m&6 7 7 ))#.'//#2F ((-C1E$ '+3i&2 3 3 /3G<
5#w $( !E ??3 DMM # 2 2 4 cL+#>? ,,C &&s+ws/C h/''4)-w 7GJJuc7FL $d, !5 %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. rR zDocTestFinder._get_test! s c3 I
;;& "I # I%i5$' N
""3 5 y >H vz48KFOOH}&#CR=||'' 5$(0&: :% ~.
s 6B9 9C
C
c
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 |t r |j }t j | r/t |dd r"t j | } |j }t j$ | r |j& }t j( | r |j* }t j, | r|j. dz
}|N||dz S t j
d }t1 |t3 | D ] }|j || s|c S y # t" $ r Y y w xY w)Nr^ r# z^\s*class\s*%s\br> -r) z(^|.*:)\s*\w*("|\'))r5 r? r@ rE ri r# escaper r ismethodrV rA rF fgetrA rK __code__rI istracebacktb_frameisframef_codeiscodeco_firstlinenoranger, )r r< r r r patr r s r. r_ zDocTestFinder._find_linenoG s
CD1 C Y%:F
??3 I$9#** 0 YYwsJ'D E F GC$\2499T? F 3 C # c8 $((C c "wsIt'D..%C
ll s #3<># ''!+F # ax** 34C L(9:99\& 12!M ;
1 "
s G G&%G&NNNN) r> r r r r r rI rN r: rR r_ r r/ r. r r 7 s= %]_ T,,dLC: 0;,z$:L;r/ 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- rs 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 rX examples r. report_startzDocTestRunner.report_start so ==||K''.."99"#%,W\\%:; < K''.."99)* + r/ c 0 | j r |d y y )Nzok
)r* r r rX r{ r s r. report_successz DocTestRunner.report_success s == K r/ c || j || | j j ||| j z y r )_failure_headerrr output_differencers 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 rX r{ 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 rX r{ 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
J dx}}| j }t d \ }}} | j j }
t |j
D ] \ } } | 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 }t7 |d t8 rV|d j: d|d j< d |d j: dft? fd
t | D }||d }d jA | }|
s|tC | z
}| jD | }nf |
| jD || j r|}nE| j tF z r2 |
tI | jD tI | | j r|}||u r|
sT| jK ||| | n?||u r |
s| jM ||| | |dz
}n || u r|
s| jO ||| | |dz
}|s| j tP z s n || _ | jS ||| tU || S # t$ $ r t' j( }| j j# Y HxY w) Nr# rW r) zsingleT r r c 3 J K | ] \ }}|j r| y wr )r ).0indexr exception_line_prefixess r. z&DocTestRunner.__run..x s* )+BKE4 ??+BC +Bs #r )+rs rl rr check_outputr r r
r rS r r| r- execr# r r7 debuggerr KeyboardInterruptrF rs rx rr r r rp format_exception_only
issubclass SyntaxErrorr r nextr rx r r r r r r r _DocTestRunner__record_outcomer' )r rX compileflagsr rv ru rt SUCCESSFAILUREBOOMcheck
examplenumr{ quiet
optionflagrZ ra exceptionr outcome formatted_ex
exc_msg_indexr r s @r. __runzDocTestRunner.__run s 5 $ / / !&q $
** $-T]]#; J %%(AA " \
4D )0 )>)>)@%Z ((J6( ((ZK7( *A $&
QJE!!#tW5
*TYY
,CCH
-WW^^Xx )4126**>
**, --((*C MM " "1 % G sD,<,<= %G ) > > "1
N ilK8 %Q<445Q7$Q<2231Yq\5N5N4OqQ/+ %) )+4\+B) %M
$0
#?L '',/ / ::C ??* "G 7??GT5E5EF %G %%(?? 5goo F 5g > ! - -/ #* '! ''T7C@G# ''T7C@A
D 44S$5>@A
D , ,y 8_ $.+)\[(?P\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 rX r- r intr
splitlinessave_linecache_getlines)r ra module_globalsr r{ 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..out s) AHHX/A BHMA %%a(r/ r# )rX r; r7 rF r rZ lowerr rx gettracer r r r resetr6 r7 r *_DocTestRunner__patched_linecache_getlines displayhook__displayhook___DocTestRunner__runsettraceclearbuiltins_) r rX r r clear_globs
save_tracesave_set_tracesave_displayhookr rZ r s @@r. runzDocTestRunner.run s & 0>#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* rw rS r rQ r, r; 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 )rw rS )r r dr- re r r r s r. mergezDocTestRunner.mergeD s_ MM !NN 0 0 2LD&1aqy
4BFFdAdG 3r/ )NNr# r NNT)r> r r r r r| r r r r r r ri r# r r r r r r r/ r. r r sn 6r G $H +MM (L,\ )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._toAsciiY 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 rb BLANKLINE_MARKERr r r r r r r r rs s r. r zOutputChecker.check_output_ 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 r{ r rs r r
got_linesdiffkindengines
r. r z OutputChecker.output_difference s[ || 33&&*, >4r/ N)r> r r r r r r r r/ r. r r Q s C <~<.,5r/ r c e Zd Z d Zd Zy)r c . || _ || _ || _ y r )rX r{ r )r rX r{ r s r. r zDocTestFailure.__init__ s r/ c , t | j S r rB rX 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 )rX r{ rs )r rX r{ 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 rX r r r rs r. r zDebugRunner.rund s2 dD,U C JJ r/ c t ||| r )r r s r. r z'DebugRunner.report_unexpected_exceptionj s !$::r/ c t ||| r )r r~ s r. r zDebugRunner.report_failurem 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; )r0 r- rs r7 r= )rF rG r4 r? r@ rM r> r r r r r r masterr r' rv ru ) r r- r7 r- reportrs r= raise_on_errorr0 finderrunnerrX s r. r r y s >D y
KKOOJ ' A !=>> |zz
7F W+F wKH At5Z H
4 I
~ 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 r9 r r r r r r r r' rv ru )ra rc r- rb r7 r- r rs r= r r. rZ textr rX 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 rs r r rX s r. r r \ sJ 7E
:F
7
DF At5 1
4l
3 2r/ 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 y 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 | || _ || _ || _ || _ || _ y r )unittestTestCaser _dt_optionflags _dt_checker_dt_test _dt_setUp _dt_tearDown)r rX rs setUptearDownry s r. r zDocTestCase.__init__ s> ""4( * "
$r/ c | j }|j j | _ | j | j | y y r )r r7 r _dt_globsr r rX s r. r zDocTestCase.setUp s8 }} * >> % NN4 &r/ c | j }| j | j | |j j |j j | j
y r )r r r7 r r9 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)NFrs ry r- zF----------------------------------------------------------------------)r r )r rF r r$ r r r r r r r r failureExceptionformat_failurerr )r rX r newrs r rv ru 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 errrX 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__3 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__7 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 rG r r3 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__A s T4(r/ c & | j d y )Nz-DocTestSuite will not work with -O2 and above)skipTestr s r. r zSkipDocTestCase.setUpE s
EFr/ c y r r r s r. test_skipzSkipDocTestCase.test_skipH r/ c 4 d| j j z S )NzSkipping tests from %s)rN r> r s r. r3 z SkipDocTestCase.shortDescriptionK s '$++*>*>>>r/ N)r> r r r r r: r3 r r r/ r. r5 r5 @ s )G
? Gr/ r5 c e Zd Zd Zy)
_DocTestSuitec y r r )r r s r. _removeTestAtIndexz _DocTestSuite._removeTestAtIndexS r; r/ N)r> r r r@ r r/ r. r> r> Q s
r/ r> 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# r\ r] r )r rP r rF r8 optimizer> addTestr5 r; r, r ra r r ) rN r7 r= test_finderr r> suiterX ra s r. r r W s !F #o
v
&F V5Z HE SYY''!+
of-. JJL OE t}} " }} H}&#CR= $DM
k$2'23 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. rG rG s 7&r/ rG 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 rG )
r rc rb r7 r. rZ r docr- rX s
r. DocFileTestrM 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 )r> r4 rP rC rM )pathskwrE r s r. r r s` 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
s= 8 r F &&q) eW % MM%,,s+ ,::D
m,DJJt, r rX testsrcs r. r r Y
su v
&F O (E /u!$AuD / 344 7D"4>>2G N 0s
A/A/c 6 t | }t ||| y r )r debug_script)srcpmr7 rU s r. r! r! i
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 rQ rF rs r r interactionr )rX rY r7 r ps r. rW rW n
s =
3 eU # "":#3UEB
3 #,,.# $&A
GGI
MM$ q 1 2s
A A,Cc b t | } t | | }t ||| j y r )rP r rW r8 )rN r- rY rU s r. r" r"
s/ v
&F&G"foo.r/ c e Zd Z d Zd Zd Zy)
_TestClassc || _ y r rZ )r rZ s r. r z_TestClass.__init__
s r/ c 0 | j dz | _ | S )Nr ra r s r. squarez_TestClass.square
s 88q= r/ c | j S r ra r s r. r4 z_TestClass.get
s xxr/ N)r> r r r rc r4 r r/ r. r_ r_
s r/ r_ 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 :
>>> print('foo\n\nbar\n')
foo
bar
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]
)r_ 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) descriptionrq 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)ri choicesrj rk 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))ri rk ro r z file containing the tests to run)nargsrk z.pyr )rc r- rs r) )argparseArgumentParser add_argumentr* keys
parse_argsro r- r fail_fastr r~ r r r rF insertrC r r ) ro r. r testfilesr- r r ra dirnamer rv r s r. _testrx
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# rn )FN)F)S
__docformat____all__r2 r r? r6 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 r5 TestSuiter> r rG rM r r r r! rW r" r_ rP rx r> exitr r/ r. r s7 %N &
+ Z
2 " (:; . O --EF +,CD *+AB z *6"-.GH *)*()
, , #>2 ">2 ">2 /0K L , -- ! &
>2D"$/ /b4"%CGG "%J ,\B$ B$HGD GDZd; d;VK Kb
G GRP5 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/