*jf S r / SQrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK
r
SSK r SSK r SSK
JrJr SSKJr SSKrSSKJrJr " S S\" SS 5 5 r0 rS
r\" S 5 r\" S 5 r\" S
5 r\" S5 r\" S5 r \" S5 r \\- \- \- \ - \ - r \" S5 r \" S5 r \" S5 r!\" S5 r"\" S5 r#\ \ - \!- \"- \#- r$Sr%Sr&S r'S[S jr(S r)S r*S\S jr+S r, " S S \5 r-S r.S! r/S" r0 " S# S$\Rb 5 r2S% r3 " S& S'5 r4 " S( S)5 r5 " S* S+5 r6 " S, S-5 r7 " S. S/5 r8S0\9\:- S1\;4S2 jr< " S3 S45 r= " S5 S6\>5 r? " S7 S8\>5 r@ " S9 S:\85 rASqB S]S= jrCS;SSSSS;SSS<\6" 5 S4 S> jrD S^S? jrESqFS@ rG " SA SB\ R 5 rI " SC SD\I5 rJ " SE SF\ R 5 rLS_SG jrM " SH SI\I5 rNS;SS\6" 5 S4SJ jrOSK rPSL rQSM rRS`SN jrSS`SO jrTSaSP jrU " SQ SR5 rV\VSSSTSUSVSWSX.rWSY rX\YSZ:X a \
R " \X" 5 5 gg)bzreStructuredText 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)
ANSIColors can_colorizec < ^ \ rS rSrSS.U 4S jjrU 4S jrSrU =r$ ) TestResultsp r# skippedc 4 > [ TU ] XU5 nX4l U$ N)super__new__r- )clsfailed attemptedr- results __class__s ./opt/alt/python313/lib64/python3.13/doctest.pyr1 TestResults.__new__q s '/#y9! c > U R ( a* SU R SU R SU R S3$ [ TU ] 5 $ )NzTestResults(failed=z , attempted=z
, skipped=))r- r3 r4 r0 __repr__)selfr6 s r7 r< TestResults.__repr__v sN <<)$++ 7!!% 0 1 #||nA/
0 7#% %r9 )__name__
__module__ __qualname____firstlineno__r1 r< __static_attributes__
__classcell__)r6 s @r7 r* r* p s 34
& &r9 r* zfailed attemptedc N [ R U S[ [ 5 - 5 $ )N )OPTIONFLAGS_BY_NAME
setdefaultlen)names r7 r r s ) )$S9L5M0M NNr9 r r r r r r r
r r r
r z z...c Sn[ R H8 nU R US 5 nU[ [ U5 L d M* XR - nM: U$ Nr# )
__future__all_feature_namesgetgetattr
compiler_flag)globsflagsfnamefeatures r7 _extract_future_flagsrW sM
E--))E4( gj%0 0 ** *E . Lr9 c [ R " U 5 ( a U $ [ U [ 5 ( a [ U [ 5 [
5 S/5 $ U c) [ R [ R " U5 $ [ S5 e! [ a7 [ R [ R " U5 R S s $ f = f! [ a g f = f)N*r@ z"Expected a module, string, or None)inspectismodule
isinstancestr
__import__globalslocalssysmodules_getframemodulenameAttributeError _getframe f_globalsKeyError TypeError)moduledepths r7 _normalize_modulerk s
FC &')VXu==
O{{3#:#:5#ABB <== "
O{{3==#7#A#A*#MNN
O s* &B >C
C
C
C
CCc : [ S S5 R U S5 $ NT)r% decode)datas r7 _newline_convertrp s $T4 0 7 7d CCr9 c U( a~ [ US5 n[ X5 n [ USS 5 =nc UR R n[
US5 ( a/ UR U 5 nUR U5 n[ U5 U 4$ [ XS9 nUR 5 U 4sS S S 5 $ ! [
a Nqf = f! , ( d f g = f)N
__loader__get_data)encoding) rk _module_relative_pathrQ __spec__loaderrd hasattrrt rn rp openread)filenamepackagemodule_relativeru rx
file_contentsfs r7 _load_testfiler s #GQ/(; g|T: :F C
))00 6: & & "OOH 5M ) 0 0 :M $M2H< <
h *avvx!
+ * "
+ *s B+ B;+
B87B8;
C c 8 [ R " SUS- U 5 $ )Nz
(?m)^(?!$) )resub)sindents r7 _indentr s 66,s
A ..r9 c j [ 5 nU u p#n[ R " X#XAS9 UR 5 $ )N)file)r$ tracebackprint_exceptiongetvalue)exc_infoexcoutexc_typeexc_valexc_tbs r7 _exception_tracebackr
s2 ZF ( Hv
hE ?? r9 c $ \ rS rSrS rSS jrSrg) _SpoofOuti c v [ R " U 5 nU( a UR S5 ( d US-
nU$ N
)r$ r endswith)r= results r7 r _SpoofOut.getvalue s3 ""4( &//$// dNF
r9 Nc R U R U5 [ R " U 5 g r/ )seekr$ truncate)r= sizes r7 r _SpoofOut.truncate# s $$ r9 r? r/ )r@ rA rB rC r r rD r? r9 r7 r r s r9 r c [ U ; a X:H $ U R [ 5 nS[ U5 pCUS nU( a& UR U5 ( a [ U5 nUS OgUS nU( a) UR U5 ( a U[ U5 - nUS OgX4: a gU H+ nUR XSU5 nUS: a gU[ U5 -
nM- g)Nr# FT)ELLIPSIS_MARKERsplitrJ
startswithr find)wantgotwsstartposendposws r7 _ellipsis_matchr ( s d"{
O $B #c(f
1A >>! 1vH1
2A <<?? c!f F2
88A0 a<CF r9 c < U R 5 n U ( a SU - $ g)Nz# #)rstrip)lines r7
_comment_liner Y s ;;=D Dyr9 c S[ U 5 p!U R S5 nUS: a UnU R SSU5 nUS: a UnU R SSU5 nUS: a US- nXU $ )Nr# r :.rG )rJ r rfind)msgstartendis r7 _strip_exception_detailsr a sr CH3 AAv a AAv #q# AAv! c?r9 c 0 \ rS rSrS rSS jrS rS rSrg) _OutputRedirectingPdbi{ c h Xl SU l [ R R XSS9 SU l g )NFT)stdoutnosigintrG )_OutputRedirectingPdb__out$_OutputRedirectingPdb__debugger_usedpdbPdb__init__ use_rawinput)r= outs r7 r _OutputRedirectingPdb.__init__ s.
$ D9 r9 Nc SU l Uc [ R " 5 R n[ R
R
X5 g rm )r ra re f_backr r set_trace)r= frames r7 r _OutputRedirectingPdb.set_trace s2 # =MMO**E $&r9 c f U R ( a [ R R U 5 g g r/ )r r r set_continuer= s r7 r "_OutputRedirectingPdb.set_continue s$ GG & r9 c [ R nU R [ l [ R R
" U /UQ76 U[ l $ ! U[ l f = fr/ )ra r r r r trace_dispatch)r= args save_stdouts r7 r $_OutputRedirectingPdb.trace_dispatch sA jj ZZ
%77))$66$CJCJs A
A )__debugger_used__outr r/ ) r@ rA rB rC r r r r rD r? r9 r7 r r { s ' ' %r9 r c [ R " U 5 ( d [ SU - 5 eUR S5 ( a [ S5 e[
R R " UR S5 6 n[ U S5 ( a. [
R R U R 5 S nGO U R S:X ay [ [ R 5 S: aK [ R S S:w a4 [
R R [ R S 5 S nO[
R nO[ U S5 ( aZ U R HJ n[
R R X15 n[
R R# U5 ( d MH Us $ [ S U R - 5 e[
R R X!5 $ )
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__))rZ r[ rh r
ValueErrorospathjoinr ry r r@ rJ ra argvcurdirr exists)ri test_pathbasedir directoryfullpaths r7 rv rv sT F # #/&899C LMM ys 35I vz""''--03 J & sxx=?sxx{b 0ggmmCHHQK03GiiG 6: & & #__ 77<< =77>>(++#O - 3!??+ , ,
77<< ++r9 c . \ rS rSr SS jrS rS rSrg)r i Nc UR S5 ( d US-
nU( a UR S5 ( d US-
nUb UR S5 ( d US-
nXl X l X@l XPl Uc 0 nX`l X0l g r )r sourcer linenor optionsexc_msg)r= r r r r r r s r7 r Example.__init__ s| t$$ dNF
d++ DLD w'7'7'='= tOG ?bG r9 c [ U 5 [ U5 La [ $ U R UR :H =( a U R UR :H =( ay U R UR :H =( aY U R
UR
:H =( a9 U R UR :H =( a U R UR :H $ r/ )typeNotImplementedr r r r r r r= others r7 __eq__Example.__eq__ s :T%[ (! !{{ell* -yyEJJ&-{{ell*- {{ell*- ||u}}, -
||u}}, -r9 c [ U R U R U R U R U R
45 $ r/ )hashr r r r r r s r7 __hash__Example.__hash__ s3 T[[$))T[[$++\\# $ $r9 )r r r r r r )Nr# r# N)r@ rA rB rC r r r rD r? r9 r7 r r s F EF $ -$r9 r c 2 \ rS rSrS rS rS rS rS rSr g) r i c j Xl X`l UR 5 U l X0l X@l XPl g r/ )examples docstringcopyrS rK r| r )r= r rS rK r| r r s r7 r DocTest.__init__* s* !
"ZZ\
r9 c 4 [ U R 5 S:X a SnO4[ U R 5 S:X a SnOS[ U R 5 - nSU R R < SU R < SU R
< S U R < S
U< S 3 $ ) Nr# z no examplesrG z 1 examplez %d examples)rJ r r6 r@ rK r| r )r= r s r7 r< DocTest.__repr__8 sp t}} "$H
1
$"H$s4=='99H ((DMM4;;B Cr9 c [ U 5 [ U5 La [ $ U R UR :H =( a U R UR :H =( ay U R UR :H =( aY U R
UR
:H =( a9 U R UR :H =( a U R UR :H $ r/ )r r r r rS rK r| r r s r7 r DocTest.__eq__C s :T%[ (! !}}. +~~ 0+zzU[[(+ yyEJJ&+ }}. +
{{ell* +r9 c p [ U R U R U R U R 45 $ r/ )r r rK r| r r s r7 r DocTest.__hash__N s& T^^TYY
t{{KLLr9 c 2 [ U[ 5 ( d [ $ U R b U R OSnUR b UR OSnU R U R
U[
U 5 4UR UR
U[
U5 4: $ )Nr )r\ r r r rK r| id)r= r self_lno other_lnos r7 __lt__DocTest.__lt__R sy %))! !"&++"94;;r$)LL$U^^Y5 BC Dr9 )r r r| rS r rK N)
r@ rA rB rC r r< r r r rD r? r9 r7 r r s 0 C +MDr9 r c \ rS rSr\R
" S\R \R - 5 r\R
" S\R \R - \R - 5 r
\R
" S5 R r SS jr
S rSS jrS r\R
" S \R 5 rS
r\R
" S \R 5 rS rS
rS rSrg)r i_ 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 UR 5 nU R U5 nUS: a3 SR UR S5 Vs/ s H oDUS PM sn5 n/ nSu pgU R R U5 H nUR
XUR 5 5 XqR SXhR 5 5 -
nU R XU5 u ppU R U 5 ( d7 UR
[ XU UU[ UR S5 5 - U
S95 XqR SUR 5 UR 5 5 -
nUR 5 nM UR
XS 5 U$ s snf )Nr# r )r# r# r )r r r )
expandtabs _min_indentr r _EXAMPLE_REfinditerappendr count_parse_example_IS_BLANK_OR_COMMENTr rJ groupr )
r= stringrK
min_indentloutputcharnor mr r r r s
r7 parseDocTestParser.parse sX ""$%%f-
>YY T8J K8J1*+8J KLF !!**62A MM& 2 3 ll4; ;F ((&9
-Vd ,,V44
wvW+1+5c!''(:K6L+L,3 5 7
ll4AEEG< c < [ U R X5 UX4XQ5 $ r/ )r get_examples)r= r rS rK r| r s r7 get_doctestDocTestParser.get_doctest s% t((6v7 7r9 c ~ U R X5 Vs/ s H n[ U[ 5 ( d M UPM sn$ s snf r/ )r! r\ r )r= r rK xs r7 r$ DocTestParser.get_examples s< ::f3 +3a a) 3 + + +s ::c [ UR S5 5 nUR S5 R S5 nU R XTX#5 U R USS SU- S- X#5 SR U Vs/ s H
ofUS- S PM sn5 nUR S5 nUR S5 n [ U 5 S: a" [ R " S U S
5 ( a U S
U R U SU- UU[ U5 - 5 SR U V
s/ s H oUS PM sn
5 nU R R U5 nU( a UR S 5 n OS n U R XrU5 n X|X4$ s snf s sn
f ) Nr r r rG r r r z *$r r )
rJ r r _check_prompt_blank
_check_prefixr r match
_EXCEPTION_RE
_find_options)
r= r rK r r source_linesslr r
want_lineswlr r s
r7 r DocTestParser._parse_example sj QWWX&' wwx(..t4 tD <+SZ#-=tLLALbvaxyMLAB
wwvZZ%
z?Q 288FJrN#C#C2 :s6z4!C $55 7yy
;
"VW+
;<
$ $T * ggenGG $$V6:--/ B ? ? +6!":6!'c!1
) < t0088 $dF 4 5
5 r9 z
^([ ]*)(?=\S)c U R R U5 Vs/ s H n[ U5 PM nn[ U5 S: a [ U5 $ gs snf rM )
_INDENT_REfindallrJ min)r= r r indentss r7 r DocTestParser._min_indent$ sJ -1__-D-DQ-GH-G63v;-GH w "((1*d"&fQh"7"? @ @ (r9 c [ U5 H@ u pVU( d M UR U5 ( a M& [ SXE- S- < SU< SU< 35 e g )Nr8 rG rG z& has inconsistent leading whitespace: )rH r r )r= rI prefixrK r r r s r7 r- DocTestParser._check_prefix: sG
!'GAtDOOF 3 3 "((1*dD": ; ; (r9 r? N)z)r@ rA rB rC r compile MULTILINEVERBOSEr DOTALLr/ r. r r! r% r$ r r: r0 rA r r, r- rD r? r9 r7 r r _ s ** \\BJJ
& (K, JJ ZZ",,
&
2 4M ::o6<<%N
7 + *.f ::&D&(ll 48 ,bll;J @ ;r9 r c X \ rS rSrS\" 5 SS4S jrS
S jrS rS rS r S
r
S r S r g)r iJ FTc 4 X l Xl X0l X@l g r/ )_parser_verbose_recurse_exclude_empty)r= verboseparserrecurse
exclude_emptys r7 r DocTestFinder.__init__S s "
+r9 Nc Uc( [ USS 5 nUc [ S[ U5 < 35 eUSL a S nOUc [ R " U5 n [ R
" U5 nU( d' [ R " U5 nUS USS - S:X d S nUc S nOCUb! [ R " XcR 5 nO[ R " U5 nU( d S nUc! Uc 0 nO+UR R 5 nOUR 5 nUb UR U5 SU; a SUS' / nU R XX#Xt0 5 UR 5 U$ ! [ a S n Nf = f)Nr@ zHDocTestFinder.find: name must be given when obj.__name__ doesn't exist: Fr# z<]>r )rQ r r rZ getmodule
getsourcefilegetfile linecachegetlines__dict__rh r update_findsort) r= objrK ri rS
extraglobsr r1 testss r7 r DocTestFinder.findi sp H <3
D1D| "&s)". / / U?F
^ &&s+F
(((-D s+AwtBCy(E1$4| # % $-#5#5dOO#LL $-#5#5d#;L##'L =~ ,,.JJLE ! LL $ U " *E*
5t\"E
Y L s E E%$E%c Uc g[ R " U5 b U[ R " U5 L $ [ R " U5 ( a UR UR L $ [ R
" U5 ( d [ R " U5 ( aV [ US5 ( a UR R nO [ US5 ( a
UR nOgUR U:H $ [ R " U5 ( a UR UR :H $ [ US5 ( a UR UR :H $ [ U[ 5 ( a g[ S5 e)NT __objclass__rA z"object must be a class or function)rZ r_
isfunctionrd __globals__ismethoddescriptorismethodwrapperry rm rA r@ isclassr\ propertyr )r= ri objectobj_mods r7 _from_moduleDocTestFinder._from_module s%
>
v
&
2W . .v 66 6
'
'??f&8&88 8((00%%f--v~.. --88 .. ++??g- -
__V
$
$??f&7&77 7
V\
*
*??f&7&77 7
)
) AB Br9 c Un [ R " U5 n[ R " U5 $ ! [ a N"f = fr/ )rZ unwrapr isroutine)r= rh
maybe_routines r7 _is_routineDocTestFinder._is_routine sC
#NN= 9M // s 0
==c
^ U R ( a [ SU- 5 [ U5 U; a g SU[ U5 ' U R X#XFU5 nUb UR U5 [
R " U5 ( a U R ( a UR R 5 Hm u pU< SU < 3n U R U
5 ( d [
R " U
5 ( d MA U R XJ5 ( d MY U R XXUXg5 Mo [
R " U5 ( a U R ( a [ US0 5 R 5 H u p[ U [ 5 ( d [# S[% U 5 < 35 e[
R& " U
5 ( dc [
R " U
5 ( dH [
R " U
5 ( d- [ U
[ 5 ( d [# S[% U
5 < 35 eU< SU < 3n U R XXUXg5 M [
R " U5 ( a U R ( a UR R 5 H u p[ U
[( [* 45 ( a U
R, n
[
R& " U
5 ( d2 [
R " U
5 ( d [ U
[. 5 ( d My U R XJ5 ( d M U< SU < 3n U R XXUXg5 M g g g )NzFinding tests in %srG r __test__z3DocTestFinder.find: __test__ keys must be strings: z^DocTestFinder.find: __test__ values must be strings, functions, methods, classes, or modules: z
.__test__.)rU printr _get_testr rZ r[ rV rd itemsr| rr rv rf rQ r\ r] r r rz staticmethod classmethod__func__rs ) r= rj rh rK ri r1 rS seentestvalnamevals r7 rf DocTestFinder._find sh
== '$. / c7d? RW
~~c E LL C T]] # 2 2 4 %)73 %%c**gooc.B.B%%f22JJu7L $,
!5 C T]] 'Z < B B D !'3//$&*7m&6 7 7 ))#..'//#2F2F ((--C1E1E$ '+3i&2 3 3 /3G<
5w ( !E ??3 DMM # 2 2 4 cL+#>?? ,,C &&s++ws/C/C h//''44)-w 7GJJu7L $, !5 %2 r9 c [ U[ 5 ( a UnO= UR c SnO,UR n[ U[ 5 ( d [ U5 nU R X5 nU R ( a U( d g Uc S nO.[ USS 5 =( d UR nUSS S:X a US S nU R R XdUX5 $ ! [ [ 4 a Sn Nf = f)Nr r .pycr ) r\ r] __doc__rh rd _find_linenorW rQ r@ rT r% ) r= rh rK ri rS r1 r r r| s r7 r DocTestFinder._get_test4 s c3 I
;;& "I # I%i55$' N
""35 y >H vz48KFOOH}&#CR=||'' $(0: :% ~.
s C ,C C&%C&c
S n[ USS 5 n[ R " U5 ( a Ub Sn[ R " U5 ( am Ubj Uc g [ R
" S[ R " [ USS5 5 - 5 n[ U5 H u pgUR U5 ( d M Un O [ R " U5 ( a UR n[ U[ 5 ( a UR n[ U[ R 5 ( a UR n[ R" " U5 ( a5 [ USS 5 ( a# [ R$ " U5 n UR& n[ R* " U5 ( a UR, n[ R. " U5 ( a UR0 n[ R2 " U5 ( a UR4 S-
nUbV Uc US- $ [ R
" S5 n[7 U[9 U5 5 H nUR X# 5 ( d M Us $ g ! [( a g f = f)Nr r# z^\s*class\s*%s\br@ -rG z(^|.*:)\s*\w*("|\')) rQ rZ r[ rr r rN escaperH r. ismethodr r\ rs fget functoolscached_propertyfuncrz ry __code__rd istracebacktb_frameisframef_codeiscodeco_firstlinenorangerJ )r= rh r1 r r patr r s r7 r DocTestFinder._find_linenoZ s CD1 C Y%:F
??3 I$9#** 0 YYwsJ'D E F GC$\299T?? F 3 C # c8 $ $((C c944 5 5((C S ! !gc9d&C&C..%C
ll s # #3<># ''!+F # ax** 34C L(9:99\ 122!M ;
1 "
s / I
II)rW rT rV rU NNNN)
r@ rA rB rC r r r rv r| rf r r rD r? r9 r7 r r J s8 %]_ T,,dLC: 0;,z$:L=r9 r c \ rS rSrSrSS jrS rS rS rS r S r
S
r S r \
R " S 5 rSS
jrSS jrSS jrS rSrg)r i zF**********************************************************************Nc U=( d
[ 5 U l Uc S[ R ; nX l X0l X0l SU l SU l SU l 0 U l
[ 5 U l g )N-vr# )
r _checkerra r rU optionflagsoriginal_optionflagstriesfailuresskips_statsr _fakeout)r= checkerrX r s r7 r DocTestRunner.__init__ s_ " 2=?
?chh&G
&$/!
"
r9 c U R ( ak UR ( a8 U" S[ UR 5 - S- [ UR 5 - 5 g U" S[ UR 5 - S- 5 g g )NzTrying:
z Expecting:
zExpecting nothing
)rU r r r )r= r r examples r7 report_startDocTestRunner.report_start sj
==||K''.."99"#%,W\\%:; < K''.."99)* + r9 c 8 U R ( a U" S5 g g )Nzok
)rU r= r r r r s r7 report_success DocTestRunner.report_success s
== K r9 c U" U R X#5 U R R X4U R 5 - 5 g r/ )_failure_headerr output_differencer r s r7 report_failure DocTestRunner.report_failure s: D / MM + +G$:J:J K
L Mr9 c b U" U R X#5 S- [ [ U5 5 - 5 g )NzException raised:
)r r r r= r r r r s r7 report_unexpected_exception)DocTestRunner.report_unexpected_exception s6 D / !
"$+,@,J$K
L Mr9 c v [ 5 ( a [ R [ R 4OSu p4U U R U 3/nUR
( ak UR b* UR b UR UR - S- nOSnUR SUR
< SU< SUR < 35 O0UR SUR S- < SUR < 35 UR S5 UR nUR [ U5 5 S R U5 $ )
N)r r rG ?zFile "", line , in zLine zFailed example:r ) r( r' REDRESETDIVIDERr| r r rK r r r )r= r r redresetr r r s r7 r DocTestRunner._failure_header' s 2>..Z^^Z - - .h t||nUG,- =={{&7>>+E w~~59 JJ
vtyy:
;
JJ7>>!+;TYYG H
$%
76?#yy~ r9 c
^ S=n=pVU R n[ S5 u pn
U R R n [ UR
5 GHJ u pUS-
nU R [ - =( a US: nXpl U
R ( aX U
R R 5 H: u nnU( a U =R U- sl M$ U =R U) - sl M< U R [ - ( a US-
nM U( d U R X1U
5 SUR U 4- n [ [ U
R USUS5 UR 5 U R R# 5 S nU R* R- 5 nU R* R/ S5 U nUc' U " U
R0 UU R 5 ( a UnGO0[2 R4 " US S 6 n[7 US [8 5 ( aW US R: S3US R< S US R: S34m[? U4S
j[ U5 5 5 nUUS nS RA U5 nU( d U[C U5 -
nU
RD c U
nOuU " U
RD UU R 5 ( a UnOOU R [F - ( a7 U " [I U
RD 5 [I U5 U R 5 ( a UnUUL a U( d U RK X1U
U5 OIUU L a U( d U RM X1U
U5 US-
nO$UU
L a U( d U RO X1U
U5 US-
nU( d GM0 U R [P - ( d GMK O Xpl U RS XXV5 [U XEUS 9$ ! [$ a e [& R( " 5 nU R R# 5 GN= f)
Nr# rr rG zsingleT r r c 3 \ ># U H! u pUR T5 ( d M Uv M# g 7fr/ )r ).0indexr exception_line_prefixess r7 &DocTestRunner.__run.. s) )+BKE ??+BC +Bs , ,r r, )+r r r check_outputrH r r
r r r r rK execrN r rS debuggerr KeyboardInterruptra r r r r r r format_exception_only
issubclass SyntaxErrorrB rA nextr r r r r r r r r _DocTestRunner__record_outcomer* )r= r compileflagsr r r4 r r SUCCESSFAILUREBOOMcheck
examplenumr quiet
optionflagr r| exceptionr outcome formatted_ex
exc_msg_indexr r s @r7 __runDocTestRunner.__run> s ()((9 $ / / !&q $
** $-T]]#; J NI %%(AA " \
4 )0 )>)>)@%Z ((J6( ((ZK7( *A $&
!!#W5
*TYY
,CCH
-WW^^Xx )4126**>
**, --((*C MM " "1 % G sD,<,<== %G ) > > "1
N ilK88 %Q<445Q7$Q<2231Yq\5N5N4OqQ/+ %) )+4\+B) %M
$0
#?L '',/ / ::C ??* "G 7??GT5E5EFF %G %%(?? 5goo F 5g > ! - -/ / #* '! ''7C@G# ''7C@A
D 44S5>@A
xD , ,y 8 8a $>_ %
- LLN
**,s
/A N==;O;c U R R UR S5 u pVnX%- X6- XG- 4U R UR ' U =R U-
sl U =R U-
sl U =R
U-
sl g )N)r# r# r# )r rP rK r r r )r= r r r r failures2tries2skips2s r7 __record_outcome DocTestRunner.__record_outcome sq
%)KKOODIIy$I! 6"*"6"'."'."2 DII
!
e
e
r9 z..+)\[(?P\d+)\]>$c N U R R U5 nU( as UR S5 U R R :X aJ U R R
[
UR S5 5 nUR R SS9$ U R X5 $ )NrK r Tkeepends)
%_DocTestRunner__LINECACHE_FILENAME_REr. r r rK r intr
splitlinessave_linecache_getlines)r= r| module_globalsr r s r7 __patched_linecache_getlines*DocTestRunner.__patched_linecache_getlines s} ( ( . .x 8 DIINN2ii((QWW\-B)CDG>>,,d,; ;//I Ir9 c ^
^ Xl Uc [ UR 5 n[ R mUc7 TR
m
T
b T
R
5 S:X a
TR nOU
U4S jnU R [ l [ R " 5 n[ R n[ T5 U l
U R R 5 U R R [ l [ R U l U R$ [ l [ R& n[ R( [ l [* R, nS [* l S S S.n U H% n
[. R0 R3 U
S 5 X' M' U R5 XU5 T[ l U[ l [ R6 " U5 U R" [ l U[ l U[* l U R9 5 H u pU c M
U [. R0 U
' M U( a& UR R; 5 SS K n S U l $ $ ! T[ l U[ l [ R6 " U5 U R" [ l U[ l U[* l U R9 5 H u pU c M
U [. R0 U
' M U( a& UR R; 5 SS K n S U l f f = f)Nutf-8c ` > [ U R TS5 T5 n TR U 5 g )Nbackslashreplace)r] encodewrite)r ru r s r7 r DocTestRunner.run..out s) AHHX/A BHMA %%a(r9 c gNFr? )r kwargss r7 #DocTestRunner.run.. s r9 )
PYTHON_COLORS FORCE_COLORr# ) r rW rS ra r ru lowerr r gettracer r r r r rb rc r *_DocTestRunner__patched_linecache_getlines displayhook__displayhook__ _colorizer( r environpop_DocTestRunner__runsettracer clearbuiltins_)r= r r r clear_globs
save_tracesave_set_tracesave_displayhooksaved_can_colorizecolor_variableskeyvaluer ru r s @@r7 runDocTestRunner.run s> ( 0>#3w#>!'') ]]
\\^
-k:
//
(1'9'9$ ! > > ?? -- & 3 3!> ,0F"C#%::>>#t# [ [ U5 S35 UR 5 U H n[ SU 35 M U( aS [ U [ U5 SU 35 [ U5 H) u nnUS:X a SOSn[ SU US S
U S U U 35 M+ U( a` [ U U R U 35 [ [ U5 S 35 [ U5 H u nu pn [ SU S S
U
S S U 35 M! U( a[ US:X a SOSn[ U S
U S [ U R 5 S35 U( a
SU U SU 3OSn[ U XV-
SU U S35 U( aD US:X a SOSnU SU SU U 3nU( a US:X a SOSnU SU U SU U 3n[ U S35 OU( a [ U
SU 35 [# XeUS9$ )Nr# z had no tests:z z passed all tests:rG r r r 3dz testz in z had failures:z of r z and z failedz passedz***Test Failed*** z failurez
skipped testz Test passed.r, )rU r r r r
get_colors
BOLD_GREENBOLD_REDGREENr r YELLOWr _n_itemsrg sortedr r* )r= rX notestspassedr3 total_triestotal_failures total_skipsrK r r r ansi
bold_greenbold_redgreenr r yellowr r and_fr s r7 summarizeDocTestRunner.summarize4 s ?mmG"$b"566 6n.2kk.?.?.A *D*8E K &N Kzt$Q
tm,
t%= >? /B ##%__
==
hh
'*+>:; #DD-( $ 0 11CE7KL#)&>KD% #qjcAAeWU2JeA3d4&HI $2 SE$,, w/ 0 Xf%&n5 628...x(2 d5*D?@ 3A !Q&CA [Mqcht{{.C-DAF G " u^ ,GE7;')
UGK 89waP Q $)sA J 0 0@E7SC%*B U6(;-}QCwO SE)
ZL UG4 5> LLr9 c U R nUR R 5 H' u nu pEnX2; a X# u pxn XG- nXX- nXi- nXEU4X#' M) g r/ )r r )
r= r drK r r r r r r s
r7 mergeDocTestRunner.merge s` KK.3ll.@.@.B *D*8Ey,-G) 6#/ .AG
/Cr9 ) r r r rU r r r r r r r r )NNr# r/ NNT)r@ rA rB rC r r r r r r r r r r rN r r r r5 r9 rD r? r9 r7 r r si @ G $J +MM .K?Z !jj *F GJL"bKM`/r9 r r returnc : [ U 5 nUS:X a SOSnU SU 3$ )NrG r r z item)rJ )r nr s r7 r( r( s* E
A1f#ASaS>r9 c , \ rS rSrS rS rS rS rSrg)r i c : [ UR SS5 S5 $ )NASCIIr )r] r )r= r s r7 _toAsciiOutputChecker._toAscii s 188G%78'BBr9 c 0 U R U5 nU R U5 nX!:X a gU[ - ( d X!4S:X a gX!4S:X a gU[ - ( dQ [ R " S[ R
" [ 5 - SU5 n[ R " SSU5 nX!:X a gU[ - ( aD SR UR 5 5 nSR UR 5 5 nX!:X a gU[ - ( a [ X5 ( a gg) NT)zTrue
z1
)zFalse
z0
z (?m)^%s\s*?$r z(?m)^[^\S\n]+$r F) rB r r r r r BLANKLINE_MARKERr r r r r r= r r r s r7 r OutputChecker.check_output s mmC }}T" ; 44z ..z // 3366/BII6F,GG d$D &&*B4C{
- -((399;'C88DJJL)D{ ! t)) r9 c U[ [ - [ - - ( d gU[ - ( a gUR S5 S: =( a UR S5 S: $ )NFTr r )r
r r r rF s r7 _do_a_fancy_diff OutputChecker._do_a_fancy_diff sV l * + * + , % zz$ !#; $!(;;r9 c * UR nU[ - ( d [ R " S[ U5 nU R XBU5 ( a UR
SS9nUR
SS9nU[ - ( a& [ R " XVSS9n[ U5 SS nSnOU[ - ( a& [ R " XVSS9n[ U5 SS nSnOLU[ - ( a> [ R " [ R S9n [ U R! XV5 5 nS nS
W- [# S R% W5 5 - $ U( a# U( a S [# U5 < S
[# U5 < 3$ U( a S[# U5 - $ U( a S[# U5 - $ g)Nz(?m)^[ ]*(?=
)Tr r )r> z#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 r r rE rI r r
difflib unified_difflistr context_diffr DifferIS_CHARACTER_JUNKcomparer r )
r= r r r r r3 got_linesdiffkindengines
r7 r OutputChecker.output_difference sQ || 33&&*, >4r9 r? N) r@ rA rB rC rB r rI r rD r? r9 r7 r r s C <~<.,5r9 r c \ rS rSrS rS rSrg)r i* c ( Xl X l X0l g r/ )r r r )r= r r r s r7 r DocTestFailure.__init__5 s r9 c , [ U R 5 $ r/ r] r r s r7 __str__DocTestFailure.__str__: 499~ r9 )r r r Nr@ rA rB rC r r^ rD r? r9 r7 r r * s
r9 r c \ rS rSrS rS rSrg)r i= c ( Xl X l X0l g r/ )r r r )r= r r r s r7 r UnexpectedException.__init__H s
r9 c , [ U R 5 $ r/ r] r s r7 r^ UnexpectedException.__str__M r` r9 )r r r Nra r? r9 r7 r r = s !
r9 r c * \ rS rSrSS jrS rS rSrg)r iP Nc v [ R XX#S5 nU( a UR R 5 U$ r )r r rS r )r= r r r r rs r7 r DebugRunner.run s. d,U C JJ r9 c [ X#U5 er/ )r r s r7 r 'DebugRunner.report_unexpected_exception s !$::r9 c [ X#U5 er/ )r r s r7 r DebugRunner.report_failure s TC00r9 r? r; )r@ rA rB rC r r r rD r? r9 r7 r r P s v ;1r9 r TFc U c [ R R S5 n [ R " U 5 ( d [ SU < 35 eUc U R n[ US9n U( a
[ X5S9n
O [ X5S9n
U R XX&S9 H n U
R U 5 M U( a U
R 5 [ c U
q
O[ R U
5 [ U
R U
R" U
R$ S9$ )Nr ztestmod: module required; )r[ rX r rS ri r, )ra rb rP rZ r[ rh r@ r r r r r r5 masterr9 r* r r r ) r rK rS rX reportr ri raise_on_errorr[ finderrunnerr s r7 r r s J y
KKOOJ ' A !=>> |zz
7F WF wH A5 H
4 I
~ V v fll KKr9 c L U( a U( d [ S5 e[ XUU =( d S5 u pUc [ R R U 5 nUc 0 nOUR 5 nUb UR
U5 SU; a SUS' U ( a
[ XWS9n
O [ XWS9n
U
R XX S5 nU
R U5 U( a U
R 5 [ c U
q O[ R U
5 [ U
R U
R U
R" S9$ )N8Package may only be specified for module-relative paths.r r@ r rp r# r, )r r r r basenamer re r r r% r r5 rr r9 r* r r r )r| r~ rK r} rS rX rs r ri rt rY ru textrv r s r7 r r ) s d + , , $H$,$79ND |ww )
}
Z &j WF wH d41 =D
JJt
~ V v fll KKr9 c v [ USS9n[ X%S9nUR XUS9 H nUR XS9 M g )NF)rX rZ rp )rS )r )r r r r ) r rS rX rK r r ru rv r s r7 r r s? $ 7E
:F
7
DF A5 1
4
3 2r9 c H U [ - U :w a [ SU 5 e[ nU qU$ )Nz Only reporting flags allowed)r r _unittest_reportflags)rT olds r7 r r s/ : E)7??
C ! Jr9 c v \ rS rSr SS jrS rS rS rS rS r S r
S
r S r S r
\R rS
rSrg) DocTestCasei Nc ~ [ R R U 5 X l XPl Xl X0l X@l g r/ )unittestTestCaser _dt_optionflags _dt_checker_dt_test _dt_setUp _dt_tearDown)r= r r setUptearDownr s r7 r DocTestCase.__init__ s4 ""4( * "
$r9 c U R nUR R 5 U l U R b U R U5 g g r/ )r rS r _dt_globsr r= r s r7 r DocTestCase.setUp s8 }} * >> % NN4 &r9 c U R nU R b U R U5 UR R 5 UR R U R
5 g r/ )r r rS r re r r s r7 r DocTestCase.tearDown sM }} ( d #
$..)r9 c U R n[ R n[ 5 nU R nU[
- ( d U[ - n[ UU R SS9n SUl UR XR SS9nUR UR :X a [ R " S5 e U[ l UR ( a. U R# U R% UR' 5 5 5 eg ! U[ l f = f)NFr r rX zF----------------------------------------------------------------------)r r zall examples were skipped)r ra r r$ r r r} r r r r r r- r4 r SkipTestr3 failureExceptionformat_failurer )r= r r~ newr rv r5 s r7 runTestDocTestCase.runTest s }}jjj** o-
0 0K ;'+'7'7H #FN jj99%jHG'"3"33 ''(CDD 4 CJ >>''(;(;CLLN(KL L CJs
AC= =
D
c
U R nUR c SnOSUR - nSR UR R S5 SS 5 nSUR < SUR
< SU< SU< S U< 3
$ )
Nzunknown line numberz%sr r Failed doctest test for
File "r r z
)r r r rK r r| )r= errr r lnames r7 r DocTestCase.format_failure sj }} ;; *FDKK'F -bc23 99dmmVUCA r9 c U R 5 [ U R U R SS9nUR U R
SS9 U R
5 g )NFr )r )r r r r r r r )r= rv s r7 r" DocTestCase.debug( sI D
)=)=%)%5%5uF
4==e
4
r9 c . U R R $ r/ r rK r s r7 r DocTestCase.idp s }}!!!r9 c n [ U 5 [ U5 La [ $ U R UR :H =( ay U R UR :H =( aY U R UR :H =( a9 U R
UR
:H =( a U R UR :H $ r/ )r r r r r r r r s r7 r DocTestCase.__eq__s s :T%[ (! !}}. 5##u'<'<<5~~ 05 E$6$665 5#4#44 5r9 c p [ U R U R U R U R 45 $ r/ )r r r r r r s r7 r DocTestCase.__hash__} s3 T))4>>4;L;L%%' ( (r9 c U R R R S5 nUS < SSR US S 5 < S3$ )Nr r r r; )r rK r r )r= rK s r7 r< DocTestCase.__repr__ s: }}!!'', HchhtCRy&9::r9 c 4 SU R R - $ )Nz Doctest: r r s r7 shortDescription DocTestCase.shortDescription s T]] / ///r9 )r r r r r r )r# NNN)r@ rA rB rC r r r r r r" r r r r< rt r^ r rD r? r9 r7 r r sM AE %!*M2
FP"5(; nnG0r9 r c 0 \ rS rSrS rS rS rS r\rSr g)SkipDocTestCasei c < Xl [ R U S 5 g r/ )ri r r )r= ri s r7 r SkipDocTestCase.__init__ s T4(r9 c & U R S5 g )Nz-DocTestSuite will not work with -O2 and above)skipTestr s r7 r SkipDocTestCase.setUp s
EFr9 c g r/ r? r s r7 test_skipSkipDocTestCase.test_skip r9 c 4 SU R R - $ )NzSkipping tests from %s)ri r@ r s r7 r SkipDocTestCase.shortDescription s '$++*>*>>>r9 )ri N)
r@ rA rB rC r r r r r^ rD r? r9 r7 r r s )G
? Gr9 r c \ rS rSrS rSrg)
_DocTestSuitei c g r/ r? )r= r s r7 _removeTestAtIndex _DocTestSuite._removeTestAtIndex r r9 r? N)r@ rA rB rC r rD r? r9 r7 r r s
r9 r c Uc
[ 5 n[ U 5 n UR XUS9nU( dD [ R R
S: a& [
5 nUR [ U 5 5 U$ UR 5 [
5 nU Hj n[ UR 5 S:X a M UR ( d U R nUSS S:X a US S nXl UR [ U40 UD65 Ml U$ )Nrq r r# r r r )r rk r ra rT optimizer addTestr rg rJ r r| r r ) ri rS ri test_finderr rj suiter r| s r7 r r s J #o
v
&F VZ HE SYY''!+
of-. JJL OE t}} " }} H}&#CR= $M
k$2'23 Lr9 c & \ rS rSrS rS rS rSrg) DocFileCasei c j SR U R R R S5 5 $ )Nr r )r r rK r r s r7 r DocFileCase.id s& xx
**00566r9 c . U R R $ r/ )r r| r s r7 r< DocFileCase.__repr__ s }}%%%r9 c n SU R R < SU R R < SU< 3$ )Nr r z ", line 0
)r rK r| )r= r s r7 r DocFileCase.format_failure s( ==%%t}}'='=sD r9 r? N)r@ rA rB rC r r< r rD r? r9 r7 r r s 7&r9 r c Uc 0 nOUR 5 nU( a U( d [ S5 e[ XUU=( d S5 u ppSU; a XS' [ R R U 5 nUR
XsXS5 n [ U 40 UD6$ )Nrx r r r# )r r r r r ry r% r )
r r~ r} rS rY ru r docrK r s
r7 DocFileTestr s
}
+ , , to ' 274IC j 77 D !D c$a 8D t 'w ''r9 c [ 5 nUR SS5 ( a [ UR S5 5 US' U H nUR [ U40 UD65 M U$ )Nr~ Tr} )r rP rk r r )pathskwr r s r7 r r
s^ p
OE
vv &&)"&&*;<9
k$-"-. Lr9 c / n[ 5 R U 5 H n[ U[ 5 ( ap UR UR
S S 5 UR nU( a= UR S5 XR S5 S S Vs/ s H nSU- PM
sn-
nM M UUR S5 S S Vs/ s H n[ U5 PM sn-
nM U( a+ US S:X a" UR 5 U( a US S:X a M" U( a, US S:X a# UR S5 U( a US S:X a M# SR U5 S- $ s snf s snf )Nr z # Expected:r z## r r# ) r r! r\ r r r r r r r r )r r piecer r s r7 r r Q
s> t F &&q) eW % % MM%,,s+ ,::D
m,JJt,>2G N 0s A7 A7c 2 [ U 5 n[ X1U5 g r/ )r debug_script)srcpmrS r s r7 r! r!
s "3'Ge$r9 c SS K nU( a UR 5 nO0 nU( a [ XU5 g UR " SS9R SU - X"5 g ! [ [ R
" 5 S 5 UR " SS9nUR 5 UR S [ R
" 5 S 5 g = f)Nr# rG T)r r zexec(%r))
r r r r ra r r r interactionr )r r rS r ps r7 r r
s
3 U # "":#3UB
3 #,,.# $&A
GGI
MM$ q 1 2s A A+Cc \ [ U 5 n [ X5 n[ X2U R 5 g r/ )rk r r rd )ri rK r r s r7 r" r"
s& v
&F&Gfoo.r9 c & \ rS rSrS rS rS rSrg)
_TestClassi
c Xl g r/ r )r= r s r7 r _TestClass.__init__
s r9 c . U R S- U l U $ )Nr r r s r7 square_TestClass.square
s 88q= r9 c U R $ r/ r r s r7 rP _TestClass.get
s
xxr9 r N)r@ rA rB rC r r rP rD r? r9 r7 r r
s r9 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 SS K n U R SS9nUR SSSSSS 9 UR S
S S [ R 5 / S
S9 UR SSSSS9 UR SSSS9 UR 5 nUR nUR nSnUR H nU[ U - nM UR ( a U[ - nU H nUR S5 ( am [ R R U5 u p[ R R! SU5 [# US S 5 n [ R S [% XUS9u pO
[' USXES9u pU
( d M g g) Nr# zdoctest runner) descriptionr 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 r r9 z file containing the tests to run)nargsr z.pyrp )r~ rX r rG )argparseArgumentParser add_argumentrH keys
parse_argsr rX r= fail_fastr r r r r ra insertr^ r r ) r rY r testfilesrX r r= r| dirnamer r r s r7 _testr 9 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 G HHOOAw '8CR=)A !!'JKHa"8U-4KKH 8
r9 r )r )r+ ) NNNNTr# NFF)FNoNameNr# r )FN)F)[
__docformat____all__rN rM r rZ rb r r r ra r r ior$ r% collectionsr& r r' r( r* rH r r r r r r r r r
r r r
r r rE r rW rk rp r r r r r r r r r rv r r r r r rO dictr] r( r Exceptionr r r rr r r r r} r r r r TestSuiter r r r r r r r! r r" r r r r@ exitr? r9 r7 r sZ ` &
+ Z
2 " .&*],>? &L O --EF +,CD *+AB z *6"-.GH *)*()
, , #>2 ">2 ">2 /0K L , -- ! &
>2D"$/ /b4"%CGG "%J ,\B$ B$HGD GDZd; d;VM Mf
o/ o/dD4K C P5 P5d Y & ) &e1- e1\
373705fLR (,$d U=?yLx :B:;46 !Hb0(## b0H k "
H&&
>@ + '+D=? (4CRP$d %
C( / * *X %%( )Q0
f*
Z zHHUW r9