= x5 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#dYdZ$d Z%d Z&dZd Z'd Z( G d d e
Z)d Z*d! Z+d" Z, G d# d$ej- Z.d% Z/ G d& d' Z0 G d( d) Z1 G d* d+ Z2 G d, d- Z3 G d. d/ Z4 G d0 d1 Z5 G d2 d3e6 Z7 G d4 d5e6 Z8 G d6 d7e4 Z9da: d[d:Z;d8ddddd8ddd9 e2 df d;Z< d\d=Z=da>d> Z? G d? d@e j@ ZA G dA dBeA ZB G dC dDe jC ZDd]dEZE G dF dGeA ZFd8dd e2 dfdHZGdI ZHdJ ZIdK ZJd^dLZKd^dMZLd_dNZM G dO dP ZNeNdQdRdSdTdUdVZOdW ZPeQdXk r e jR eP dS dS )`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 b t | dt t z S )N )OPTIONFLAGS_BY_NAME
setdefaultlennames ./opt/alt/python311/lib64/python3.11/doctest.pyr r s& ) )$S9L5M5M0M N NN r r r r r r r
r r r
r z z...c d}t j D ]9}| |d }|t t | u r
||j z }:|S )Nr# )
__future__all_feature_namesgetgetattr
compiler_flag)globsflagsfnamefeatures r/ _extract_future_flagsr; s[
E- + +))E4(( gj%00 0 0 W* *E Lr0 c 0 t j | r| S t | t r+t | t t
dg S | /t j t j | j
d S t d )N*__name__z"Expected a module, string, or None) inspectismodule
isinstancestr
__import__globalslocalssysmodules _getframe f_globals TypeError)moduledepths r/ _normalize_modulerN s >
FC >&'))VXXu=== {3=//9*EFF<===r0 c J t d d | d S NT)r% decode)datas r/ _newline_convertrS s" $T4 0 0 7 7d C CCr0 c |rt |d }t || } t |dd x} |j j }n# t
$ r Y nw xY wt
|d r;| | }| | }t | | fS t | | 5 }| | fcd d d S # 1 swxY w Y d S )N
__loader__get_data)encoding) rN _module_relative_pathr5 __spec__loaderAttributeErrorhasattrrW rQ rS openread)filenamepackagemodule_relativerX r[
file_contentsfs r/ _load_testfilere s@
=#GQ//((;; g|T:: :F C
)0!
6: & & = "OOH 5 5M ) 0 0 : :M $M22H< <
h * * * "avvxx!" " " " " " " " " " " " " " " " " "s# A
AA0CCC c 6 t j d|dz | S )Nz
(?m)^(?!$) )resub)sindents r/ _indentrm s!
6,s
A . ..r0 c t }| \ }}}t j |||| | S )N)file)r$ tracebackprint_exceptiongetvalue)exc_infoexcoutexc_typeexc_valexc_tbs r/ _exception_tracebackrx sH
ZZF ( Hgv
hfEEEE ?? r0 c e Zd Zd ZddZdS ) _SpoofOutc f t j | }|r| d s|dz
}|S N
)r$ rr endswith)selfresults r/ rr z_SpoofOut.getvalue s= "4(( &//$// dNF
r0 Nc X | | t j | d S N)seekr$ truncate)r sizes r/ r z_SpoofOut.truncate
s( $$ r0 r )r?
__module__ __qualname__rr r r0 r/ rz rz s7 r0 rz c t | vr| |k S | t }dt | }}|d }|r*| | rt | }|d= ndS |d }|r-| | r|t | z }|d= ndS ||k rdS |D ]4}| ||| }|dk r dS |t | z
}5dS )Nr# FT)ELLIPSIS_MARKERsplitr,
startswithr~ find)wantgotwsstartposendposws r/ _ellipsis_matchr s"
d""s{
O $ $B #c((fH
1A >>! 1vvH15
2A <<?? c!ff F25& u
88Ax00 a<<55CFF 4r0 c > | } | rd| z S dS )Nz# #)rstrip)lines r/
_comment_liner @ s) / ;;==D Dysr0 c dt | }}| d }|dk r|}| dd| }|dk r|}| dd| }|dk r|dz }| || S )Nr# r} :.r) )r, r rfind)msgstartendis r/ _strip_exception_detailsr H s CHH3E AAvv a AAvv #q# AAvv! ucz?r0 c * e Zd Z d ZddZd Zd ZdS )_OutputRedirectingPdbc t || _ d| _ t j | |d d| _ d S )NFT)stdoutnosigintr) )_OutputRedirectingPdb__out$_OutputRedirectingPdb__debugger_usedpdbPdb__init__ use_rawinput)r outs r/ r z _OutputRedirectingPdb.__init__h s<
$ cD999 r0 Nc d| _ |t j j }t j | | d S rP )r rG rI f_backr r set_trace)r frames r/ r z _OutputRedirectingPdb.set_tracep s; # =MOO*E $&&&&&r0 c V | j r!t j | d S d S r )r r r set_continuer s r/ r z"_OutputRedirectingPdb.set_continuev s5 ' G & & & & & ' 'r0 c t j }| j t _ t j j | g|R |t _ S # |t _ w xY wr )rG r r r r trace_dispatch)r args save_stdouts r/ r z$_OutputRedirectingPdb.trace_dispatch| sK j Z
%7)$6666$CJJCJ $ $ $ $s A Ar )r? r r r r r r r r0 r/ r r b sZ
' ' ' ' ' ' ' % % % % %r0 r c t j | st d| z | d rt d t j j | d }t | d r+t
j | j
d }n| j dk rvt t j dk rLt j d dk r6t
j t j d d }nt
j }ntt | d rM| j D ]E}t
j || }t
j | r|c S Ft d | j z t
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@ rA rK r
ValueErrorospathjoinr r] r r? r, rG argvcurdirr exists)rL test_pathbasedir directoryfullpaths r/ rY rY s F # # :/&8999C NLMMM ys 3 35I vz"" ,'--003 J & & sx==??sx{b 0 0gmmCHQK003GGiGG 6: & & $ #_
$
$ 7<< 9==7>>(++ $#OOO$ 3!?+ , , ,
7<< + ++r0 c ( e Zd Z ddZd Zd ZdS )r Nr# c | d s|dz
}|r| d s|dz
}|| d s|dz
}|| _ || _ || _ || _ |i }|| _ || _ d S 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 r0 c t | t | urt S | j |j k oO| j |j k o?| j |j k o/| j |j k o | j |j k o| j |j k S r )typeNotImplementedr r r rl r r r others r/ __eq__zExample.__eq__ s ::T%[[ ( (! !{el* -yEJ&-{el*- {el*- |u}, -
|u}, -r0 c \ t | j | j | j | j | j f S r )hashr r r rl r r s r/ __hash__zExample.__hash__ s. T[$)T[$+\# $ $ $r0 )Nr# r# N)r? r r r r r r r0 r/ r r sV !D EF $ - - -$ $ $ $ $r0 r c . e Zd Z d Zd Zd Zd Zd ZdS )r c || _ || _ | | _ || _ || _ || _ d S r )examples docstringcopyr7 r. r` r )r r r7 r. r` r r s r/ r zDocTest.__init__ s? !
"ZZ\\
r0 c t | j dk rd}n2t | 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. r` r )r r s r/ __repr__zDocTest.__repr__ s t} " "$HH
1
$
$"HH$s4='9'99H (((DMMM4;;;B Cr0 c t | t | urt S | j |j k oO| j |j k o?| j |j k o/| j |j k o | j |j k o| j |j k S r )r r r r r7 r. r` r r s r/ r zDocTest.__eq__* s ::T%[[ ( (! !}. +~ 0+zU[(+ yEJ&+ }. +
{el* +r0 c P t | j | j | j | j f S r )r r r. r` r r s r/ r zDocTest.__hash__5 s! T^TY
t{KLLLr0 c t |t st S | j | j nd}|j |j nd}| j | j |t
| f|j |j |t
| fk S )Nr )rB r r r r. r` id)r r self_lno other_lnos r/ __lt__zDocTest.__lt__9 sv %)) "! !"&+"94;;r$)L$U^Y5 BC Dr0 N)r? r r r r r r r r r0 r/ r r so . C C C + + +M M MD D D D Dr0 r c N 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 d ej Zd
Z ej d ej Zd Zd
Zd ZdS )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 | }| | dk r4d fd| d D }g }d\ }}| j | D ],}| ||| || d|| z
}| ||| \ }}} }
|
| sK| t || |
| t |
d z | || d| | z
}| }.| ||d |S )Nr# r} c $ g | ] }|d
S r r ).0l
min_indents r/
z'DocTestParser.parse.. s! K K K1*++ K K Kr0 r# r# rl )r rl r )
expandtabs _min_indentr r _EXAMPLE_REfinditerappendr count_parse_example_IS_BLANK_OR_COMMENTr r, groupr ) r stringr. outputcharnor mr r r r r s @r/ parsezDocTestParser.parsev s ""$$%%f--
>>YY K K K K T8J8J K K KLLF !**622 A MM& !12 3 3 3 fll4;; ;F ((D&99
-VWdG ,,V44
7
wvtW+1+5c!''(:K:K6L6L+L,3 5 5 5 7 7 7
fll4AEEGG<< . s6 + + +a a))+ + + +r0 )r )r r r. s r/ r zDocTestParser.get_examples s5 + +4::fd33 + + + +r0 c H
t | d
| d d }| |
|| | |dd d
z dz || d
fd|D }| d }| d }t | dk r t
j d |d
r|d
= | |d
z ||t | z d
fd |D }| j | }|r| d }nd }| ||| } || ||fS )
Nrl r r} r) rh r c * g | ]}|d z d S )rf Nr )r slrl s r/ r z0DocTestParser._parse_example.. s% AAAbBvaxyyMAAAr0 r z *$r c $ g | ] }|d
S r r )r wlrl s r/ r z0DocTestParser._parse_example.. s! ;;;""VWW+;;;r0 r )
r, r r _check_prompt_blank
_check_prefixr ri match
_EXCEPTION_RE
_find_options) r r r. r source_linesr r
want_linesr r rl s @r/ r z DocTestParser._parse_example s QWWX&&'' wwx((..t44 vtVDDD <+SZ#-=tVLLLAAAALAAABB
wwvZZ%%
z??Q 28FJrN#C#C 2 :s6z4!C $5$55 7 7 7yy;;;;
;;;<<
$ $T * * ggennGGG $$VT6::wg--r0 z#\s*doctest:\s*([^\n\'"]*)$c
i }| j | D ]}| d dd }|D ]\}|d dvs|dd t
vrt
d|dz d|d| t
|dd }|d d k ||< ]|r-| | 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 s6 *33F;; 3 3A WWQZZ / /S 9 9 ? ? A AN(
3
31IT))122J&999$*&,Qhhhff&> ? ? ? +6!"":6!'c!1
3 5t0088 5 * $ffdddFF 4 5 5
5 r0 z
^([ ]*)(?=\S)c d | j | D }t | dk rt | S dS )Nc , g | ]}t | S r )r, )r rl s r/ r z-DocTestParser._min_indent..
s HHH63v;;HHHr0 r# )
_INDENT_REfindallr, min)r rk indentss r/ r zDocTestParser._min_indent sJ EHHT_-D-DQ-G-GHHH w<)> j"((1***ddd"&vfQh"7"7"7"? @ @ @ @ @r0 c t | D ]:\ }}|r3| | s t d||z dz d|d| ;d S )Nr r) r% z& has inconsistent leading whitespace: )r& r r )r r' prefixr. r r r s r/ r zDocTestParser._check_prefix! s| !'' ; ;GAt
;DOOF 3 3
; j"((1***dddDD": ; ; ; ; ;r0 N)r )r? r r ri compile MULTILINEVERBOSEr DOTALLr r r r r r r r r r r r r r r0 r/ r r F sD "* \BJ
& ( (K, BJ Z",
&
2 4 4M &2:o66<% % % %N
7
7
7 + + + + *. *. *.f &2:&D&(l 4 4 8 ,bl;;J @ @ @ ; ; ; ; ;r0 r c V e Zd Z d e ddfdZd dZd Zd Zd Zd Z d
Z
dS ) r FTc @ || _ || _ || _ || _ d S r )_parser_verbose_recurse_exclude_empty)r verboseparserrecurse
exclude_emptys r/ r zDocTestFinder.__init__: s,
+r0 Nc |2t |dd }| t dt | |du rd }n|t j | } t j | }|s-t j | }|d |dd z dk sd }|d }nH|t j ||j }nt j | }|sd }n# t $ r d }Y nw xY w| |i }n.|j }n| }|| | d|vrd|d< g }|
||||||i | |S )Nr? zHDocTestFinder.find: name must be given when obj.__name__ doesn't exist: Fr# z<]>r )r5 r r r@ getmodule
getsourcefilegetfile linecachegetlines__dict__rK r update_findsort) r objr. rL r7
extraglobsro r testss r/ r zDocTestFinder.findP s ! F <3
D11D| j"&s)))". / / / U??FF
^ &s++F
((--D
? s++AwtBCCy(E11$4| # % $-#5dFO#L#LLL $-#5d#;#;L# (#'L+ LLL 0 =~ ,,..JJLLE ! LL $ $ $ U " " *E*
5#tV\5"EEE
s C C! C!c L |dS t j | |t j | u S t j | r|j |j u S t j | st j | rBt |d r
|j j }nt |d r|j }ndS |j
|k S t j | r|j
|j k S t |d r|j
|j k S t |t rdS t d )NT __objclass__r z"object must be a class or function)r@ r:
isfunctionr? __globals__ismethoddescriptorismethodwrapperr] rG r r? isclassrB propertyr )r rL objectobj_mods r/ _from_modulezDocTestFinder._from_module s@ >4
v
&
&
2W .v 6 66 6
'
' C?f&88 8(00 C%f-- Cv~..
-8 ..
+t?g- -
_V
$
$ C?f&77 7
V\
*
* C?f&77 7
)
) C4 ABB Br0 c | |} t j | }n# t $ r Y nw xY wt j | S r )r@ unwrapr isroutine)r rC
maybe_routines r/ _is_routinezDocTestFinder._is_routine sU
#N= 9 9MM D ///s
''c
| j rt d|z t | |v rd S d|t | < | ||||| }|| | t j | r| j r|j D ]f\ } }
|d| } |
|
st j |
r1| ||
r|
||
| |||| gt j | r| j rt |di D ]\ } }
t | t s t# dt% | t j |
s\t j |
sHt j |
s4t |
t s t# dt% |
|d| } |
||
| |||| t j | r| j r|j D ]\ } }
t |
t( t* f r|
j }
t j |
s)t j |
st |
t. r8| ||
r"|d| } |
||
| |||| d S d S d S )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__.)r1 printr _get_testr r@ rA r2 r? itemsrU rL rP rA r5 rB rC r r rS staticmethod classmethod__func__rM ) r rE rC r. rL r r7 seentestvalnamevals r/ rA zDocTestFinder._find sc = 0 '$. / / / c77d?? FRWW
~~c4 EE LL C ,T] , # 2 2 4 4
,
, %)TT773 %%c** ,goc.B.B ,%%fc22,JJuc7FL $d, , , C (T] ( 'Z < < B B D D
(
( !'3// 7$*&*7mmm&6 7 7 7 )#.. 3'/#2F2F 3 (--31;C1E1E3$* '+3iii&2 3 3 3 /3ddGG<
5#w $( ( ( ( ?3 ,DM , # 2 2 4 4
,
, cL+#>?? ' ,C &s++ ,ws/C/C , h//,''44, *.ww 7GJJuc7FL $d, , , , , , ,
,
,r0 c t |t r|}nP |j d}n+|j }t |t st | }n# t t f$ r d}Y nw xY w| || }| j r|sd S |d }n0t |dd p|j }|dd dk r
|d d }| j
||||| S )Nr r .pycr ) rB rC __doc__rK r\ _find_linenor3 r5 r? r0 r ) r rC r. rL r7 r r r r` s r/ rY zDocTestFinder._get_test s! c3 II
;& "II # I%i55 3$' NN ~.
""3 55 y 4 >HH vz488KFOH}&&#CRC=|'' 5$(0&: : :s 5A A'&A'c
d }t |dd }t j | r|d}t j | rl|j|d S t j dt j t |dd z }t | D ] \ }}| | r|} n t j | r|j
}t |t r|j
}t j | r*t |dd rt j | j }t j | r|j }t j | r|j }t j | r
|j dz
}|Z||dz S t j d }t/ |t1 | D ]!}| || r|c S "d S )Nre r# z^\s*class\s*%s\br? -r) z(^|.*:)\s*\w*("|\'))r5 r@ rA rL ri r* escaper& r ismethodr] rB rM fgetrH rR __code__ istracebacktb_frameisframef_codeiscodeco_firstlinenoranger, )r rC r r r patr r s r/ rf zDocTestFinder._find_linenoA s
CD11 C Y%:F
?3 I$9#t* 0 YwsJ'D'D E E F G GC$\22
499T?? FE
C 4 # c8 $ $ (C c " " /wsIt'D'D /.%%.C s # #73# ,'!+F # ax* 344C L(9(9::
"
"99\& 122 "!MMM" tr0 NNNN) r? r r r r r rP rU rA rY rf r r0 r/ r r 1 s %]]__ T, , , ,,d d d dLC C C: 0 0 0;, ;, ;,z$: $: $:L4 4 4 4 4r0 r c e Zd Z dZddZd Zd Zd Zd Zd Z d
Z
d Z e j
d Zdd
ZddZddZd ZdS )r zF**********************************************************************Nr# c |p
t | _ |dt j v }|| _ || _ || _ d| _ d| _ i | _ t | _ d S )N-vr# ) r _checkerrG r r1 optionflagsoriginal_optionflagstriesfailures_name2ftrz _fakeout)r checkerr4 rz s r/ r zDocTestRunner.__init__ si 2=??
?ch&G
&$/!
"
r0 c | j rf|j r: |dt |j z dz t |j z d S |dt |j z dz d S d S )NzTrying:
z Expecting:
zExpecting nothing
)r1 r rm r )r r r_ examples r/ report_startzDocTestRunner.report_start s = +|
+K''."9"99"#%,W\%:%:; < < < < < K''."9"99)* + + + + + + +r0 c 0 | j r
|d d S d S )Nzok
)r1 r r r_ r r s r/ report_successz DocTestRunner.report_success s. = CKKKKK r0 c || || | j ||| j z d S r )_failure_headerry output_differencerz r s r/ report_failurez DocTestRunner.report_failure s^ D w / / M + +GS$:J K K
L M M M M Mr0 c || || dz t t | z d S )NzException raised:
)r rm rx r r r_ r rs s r/ report_unexpected_exceptionz)DocTestRunner.report_unexpected_exception s` D w / / !
"$+,@,J,J$K$K
L M M M M Mr0 c | j g}|j rL|j |j |j |j z dz }nd}| d|j d|d|j n(| d|j dz d|j | d |j }| t
| d | S ) Nr) ?zFile "", line , in zLine zFailed example:r} )DIVIDERr` r r r. r rm r )r r_ r r r r s r/ r z DocTestRunner._failure_header s |n = I{&7>+E w~59 JJJ
vvvtyy:
;
;
;
;
JJJ7>!+;+;+;TYYG H H H
$%%%
76??###yy~~ r0 c
dx}}| j }t d \ }}} | j j }
t |j D ]\ } } | j t z o|dk }
|| _ | j rC| j D ])\ }}|r| xj |z c_ | xj | z c_ *| j t z r||dz
}|
s|
||| d|j | fz } t t | j |d|d |j | j d }n=# t$ $ r t' j }| j Y nxY w| j }| j d |}| |
| j || j r|}n t3 j |d d }t7 |d t8 r`|d j d|d j d |d j dft? fd
t | D }||d }d | }|
s|tC | z
}| j" | }n\ |
| j" || j r|}nB| j tF z r3 |
tI | j" tI | | j r|}||u r|
s| % ||| | nG||u r |
s| & ||| | |dz
}n#|| u r |
s| ' ||| | |dz
}|r| j tP z r n|| _ | ) ||| tU || S ) Nr# rU r) zsingleTr< r r c 3 L K | ] \ }}| |V d S r )r )r indexr exception_line_prefixess r/ z&DocTestRunner.__run..k sN ) ) 'E4 ??+BCC) ) ) ) ) ) )r0 r )+rz rs ry check_outputr& r r
r rZ r r r. execr* r r7 debuggerr KeyboardInterruptrG rs r rr r r rp format_exception_only
issubclass SyntaxErrorr r nextr rx r r r r r r r _DocTestRunner__record_outcomer' )r r_ compileflagsr r} r| r{ SUCCESSFAILUREBOOMcheck
examplenumr quiet
optionflagra r` exceptionr outcome formatted_ex
exc_msg_indexr r s @r/ __runzDocTestRunner.__run s 5 $ / !&q $
* $-T]#;#; o o J %(AA " \
4D
8)0 )>)>)@)@ 8 8%Z 8 ((J6((( ((ZK7((( $&
QJE
6!!#tW555
*TY
,CCH
-WW^Xx )41 126*> > >
**,,, $
- LNN
**,,,,,-((**C M " "1 % % % G 5 sD,<== & %G ) > "1"
N ilK88 @ %Q<4777$Q<2QQYq\5NQQQ/+ %) ) ) ) )+4\+B+B) ) ) % %M
$0
#?L '',// ;/ :::C ?* "GG U7?GT5EFF * %GG %(?? * u 5go F F 5g > > ! -/ / * #* '!! A''T7C@@@G## A''T7C@@@A
D @44S$5>@ @ @A
D ,y 8
0
dHe4448U+++s
(AD//8E)c | j |j d \ }}||z ||z f| j |j < | xj |z
c_ | xj |z
c_ d S )Nr )r~ r4 r. r} r| )r r_ rd tf2t2s r/ __record_outcomez DocTestRunner.__record_outcome sc ""49e44B$%bD!B$<
di
a
r0 z..+)\[(?P\d+)\]>$c F | j | }|rp| d | j j k rM| j j t
| d }|j d S | || S )Nr. r Tkeepends)
%_DocTestRunner__LINECACHE_FILENAME_REr r r_ r. r intr
splitlinessave_linecache_getlines)r r` module_globalsr r s r/ __patched_linecache_getlinesz*DocTestRunner.__patched_linecache_getlines s ( . .x 8 8 J DIN22i(QWW\-B-B)C)CDG>,,d,;; ;//.II Ir0 Tc "
|| _ |t |j }t j
|/
j dk r
j }n
fd}| j t _ t j }t j }t
| _
| j
| j
j t _ t j | _ | j t _ t j }t j t _ | |||
t _ |t _ t j | | j t _ |t _ |r%|j dd l}d |_ S S #
t _ |t _ t j | | j t _ |t _ |r$|j dd l}d |_ w xY w)Nutf-8c z t | d } | d S )Nbackslashreplace)rC encodewrite)rk rX r s r/ r z DocTestRunner.run..out s; AHHX/A B BHMMA %%a(((((r0 r# )r_ r; r7 rG r rX lowerr r gettracer r r r resetr= r> r *_DocTestRunner__patched_linecache_getlines displayhook__displayhook___DocTestRunner__runsettraceclearbuiltins_) r r_ r r clear_globs
save_tracesave_set_tracesave_displayhookr rX r s @@r/ runzDocTestRunner.run s & 0<>#3#3w#>#>!') ) ) ) ) ) ]
\^^
-k::
/
(1'9$ ! > ? - "::dL#66$CJ *CM L $ $ $!%!=I .CO
"
""" !
" %CJ *CM L $ $ $!%!=I .CO
"
""" !
!!!!s
F A1Hc || j }g }g }g }dx}}| j D ]c}|\ }\ } }
||
z
}|| z
}|
dk r| | 0| dk r| ||
f N| | d|r|rFt t | d | |D ]} t d| |rMt t | d | |D ]\ } } t d| | fz |ret | j t t | d | |D ] \ } \ } }
t d| |
| fz |r9t |dt | j d t ||z
d
|d |rt d |d
n|rt 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.) r1 r~ rZ r rX r, rB r r' )
r r4 notestspassedfailedtotalttotalfr r. rd r thingr s
r/ summarizezDocTestRunner.summarize sb ?mG $$&&
!
!A LD&1a aKF aKFAvvt$$$$a
ay****
a
?
(c'll$9::: $ ( (E%''''
?c&kk#<===
$* ? ?LE5,u~=>>>> ; $, #f++ 4 5 5 5 KKMMM!'
;
;
v1)Q5M9:::: D &*c$-&8&8( C C C &6/< C C C " %v{ ; ; ; ;
" . ! ! !66***r0 c | j }|j D ](\ }\ }}||v r|| \ }}||z }||z }||f||< )d S r )r~ rZ )r r dr. rd r r r s r/ mergezDocTestRunner.merge7 sq M !N 0 0 2 2 LD&1aqyy
4BFFdAdGG r0 )NNr# r NNT)r? r r r r r r r r r r r ri r* r r r r r r r0 r/ r r { s 6r G $ $ $ $H + + + M M MM M M (L, L, L,\ )bj *F G GJ J J JD" D" D" D"R4+ 4+ 4+ 4+r r0 r c ( e Zd Z d Zd Zd Zd ZdS )r c L t | dd d S )NASCIIr )rC r )r rk s r/ _toAsciizOutputChecker._toAsciiL s( 188G%788'BBBr0 c P | | }| | }||k rdS |t z s||fdk rdS ||fdk rdS |t z sNt j dt j t z d| }t j dd| }||k rdS |t z rVd | }d | }||k rdS |t z rt || rdS dS ) NT)zTrue
z1
)zFalse
z0
z (?m)^%s\s*?$r z(?m)^[^\S\n]+$rh F) r r r ri rj ri BLANKLINE_MARKERr r r r r r r r rz s r/ r zOutputChecker.check_outputR sN mmC }}T"" $;;4 44 Dz ...tDz ///t 33 6/BI6F,G,GG d$ $D &*B44Cd{{t
- - ((399;;''C88DJJLL))Dd{{t ! tS))
t ur0 c |t t z t z z sdS |t z rdS | d dk o| d dk S )NFTr} r< )r
r r r r s r/ _do_a_fancy_diffz OutputChecker._do_a_fancy_diff si l * + * + , 5 % 4 zz$ !#; $!(;;r0 c \ |j }|t z st j dt | }| ||| r| d }| d }|t z r1t j ||d }t | dd }d}n|t z r1t j ||d }t | dd }d}nN|t z rDt j t j } t | || }d }d
|z t# d | z S |r$|r"d t# | d
t# | S |rdt# | z S |rdt# | z S dS )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 rz r r got_linesdiffkindengines
r/ r z OutputChecker.output_difference s | 33 C&*, >44r0 N)r? r r r r r r r r0 r/ r r D sY C C C < < <~< < <.,5 ,5 ,5 ,5 ,5r0 r c e Zd Z d Zd ZdS )r c 0 || _ || _ || _ d S r )r_ r r )r r_ r r s r/ r zDocTestFailure.__init__ s r0 c * t | j S r rC r_ r s r/ __str__zDocTestFailure.__str__ 49~~ r0 Nr? r r r r r r0 r/ r r s7
r0 r c e Zd Z d Zd ZdS )r c 0 || _ || _ || _ d S r )r_ r rs )r r_ r rs s r/ r z UnexpectedException.__init__ s
r0 c * t | j S r r r s r/ r zUnexpectedException.__str__ r r0 Nr r r0 r/ r r s7 ! ! !
r0 r c $ e Zd Z ddZd Zd ZdS )r NTc x t | |||d }|r|j |S )NF)r r r7 r )r r_ r r r rs r/ r zDebugRunner.runW s> dD,U C C J r0 c $ t ||| r )r r s r/ r z'DebugRunner.report_unexpected_exception] s !$:::r0 c $ t ||| r )r r s r/ r zDebugRunner.report_failure` s T7C000r0 r )r? r r r r r r r0 r/ r r sM X t ; ; ;1 1 1 1 1r0 r TFc | t j d } t j | st d| || j }t | } |rt || }
nt || }
|
| ||| D ]} |
| |r|
t |
a
nt |
t |
j |
j S )Nr ztestmod: module required; )r7 r4 rz r7 rD )rG rH r4 r@ rA rK r? r r r r r r masterr r' r} r| ) r r. r7 r4 reportrz rD raise_on_errorr7 finderrunnerr_ s r/ r r l s! >D y
KOOJ ' ' A ?i!!=>>> |z
7
7
7F I W+FFF wKHHH At5Z HH
4
~ V v 5 55r0 c Z |r|st d t | ||| pd \ } } | t j | }|i }n| }|| | d|vrd|d< | rt || }
nt || }
|
| ||| d }|
| |r|
t |
a nt
|
t |
j |
j S )N8Package may only be specified for module-relative paths.r r? r r r# )r re r r basenamer r@ r r r r r r r r' r} r| )r` rb r. ra r7 r4 r rz rD r
r5 rX textr r_ s r/ r r sb K\ , , + , , , $Hg$,$79 9ND( |w ))
}
Z &j I W+FFF wKHHH dE41 = =D
JJt
~ V v 5 55r0 NoNamec t |d }t || }| | || D ]}| || d S )NF)r4 r6 r )r7 )r )r r r r ) rd r7 r4 r. r rz r r r_ s r/ r r O sq 7E
:
:
:F
7
D
D
DF At5 11 4 4
4l
33334 4r0 c V | t z | k rt d| t }| a|S )Nz Only reporting flags allowed)r r _unittest_reportflags)r8 olds r/ r r l s: 8 E))7???
C ! Jr0 c d e Zd Z ddZd Zd Zd Zd Zd Zd Z d
Z
d Z d Z e
j Zd
ZdS ) DocTestCaser# Nc t j | || _ || _ || _ || _ || _ d S r )unittestTestCaser _dt_optionflags _dt_checker_dt_test _dt_setUp _dt_tearDown)r r_ rz setUptearDownr s r/ r zDocTestCase.__init__ sG ""4((( * "
$r0 c | j }|j | _ | j | | d S d S r )r r7 r _dt_globsr r r_ s r/ r zDocTestCase.setUp sD } ** > % NN4 & %r0 c | j }| j | | |j |j | j d S r )r r r7 r r@ r# r$ s r/ r! zDocTestCase.tearDown sZ } ( d # # #
$.)))))r0 c | j }t j }t }| j }|t
z s
|t z }t || j d } d|_ |
||j d \ }}|t _ n# |t _ w xY w|r:| |
| d S )NFrz r r4 zF----------------------------------------------------------------------)r r )r rG r r$ r r r r r r r r failureExceptionformat_failurerr )r r_ r newrz r r} r| s r/ runTestzDocTestCase.runTest s }jjj* o- 1
0 0K ;'+'7H H H #FN $jj#) ) 8 8OHe CJJCJ M''(;(;CLLNN(K(KLL L M Ms 'B Bc
| j }|j d}n
d|j z }d |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 r` )r errr_ r lnames r/ r) zDocTestCase.format_failure s| } ; *FFDK'F --bcc233 999dmmmVVVUUUCCA r0 c | t | j | j d }| | j d | d S )NFr' )r )r r r r r r r! )r r s r/ r" zDocTestCase.debug sd ? B
)=%)%5uF F F
4=e
444
r0 c | j j S r r r. r s r/ r zDocTestCase.id s
}!!r0 c t | t | urt S | j |j k o?| j |j k o/| j |j k o | j |j k o| 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$665 5#44 5r0 c P t | j | j | j | j f S r )r r r r r r s r/ r zDocTestCase.__hash__& s- T)4>4;L%' ( ( (r0 c | j j d }|d dd |d d dS )Nr r r ))r r. r r )r r. s r/ r zDocTestCase.__repr__* sG }!'',, HHHchhtCRCy&9&9&9&9::r0 c d| j j z S )Nz Doctest: r3 r s r/ shortDescriptionz DocTestCase.shortDescription0 s T] ///r0 )r# NNN)r? r r r r r! r+ r) r" r r r r rN r r9 r r0 r/ r r s AE % % % %! ! !* * *M M M0
F F FP" " "5 5 5( ( (; ; ; nG0 0 0 0 0r0 r c * e Zd Zd Zd Zd Zd ZeZdS )SkipDocTestCasec J || _ t | d d S r )rL r r )r rL s r/ r zSkipDocTestCase.__init__4 s% T4(((((r0 c 0 | d d S )Nz-DocTestSuite will not work with -O2 and above)skipTestr s r/ r zSkipDocTestCase.setUp8 s
EFFFFFr0 c d S r r r s r/ test_skipzSkipDocTestCase.test_skip; r0 c d| j j z S )NzSkipping tests from %s)rL r? r s r/ r9 z SkipDocTestCase.shortDescription> s '$+*>>>r0 N)r? r r r r r@ r9 r r r0 r/ r; r; 3 sT ) ) )G G G
? ? ? GGGr0 r; c e Zd Zd ZdS )
_DocTestSuitec d S r r )r r s r/ _removeTestAtIndexz _DocTestSuite._removeTestAtIndexF rA r0 N)r? r r rF r r0 r/ rD rD D s#
r0 rD c " |t }t | } | | || }|sGt j j dk r2t
}| t | |S | t
}|D ]h}t |j dk r|j s&| j
}|dd dk r
|d d }||_ | t |fi | i|S )Nr r< r# rc rd r )r rN r rG r8 optimizerD addTestr; rB r, r r` r r ) rL r7 rD test_finderr rE suiter_ r` s r/ r r J s !F #oo
v
&
&F V5Z H HE SY'!++
of--... JJLLL OOE 4 4 t} " " } % H}&&#CRC= $DM
k$22'223333 Lr0 c e Zd Zd Zd Zd ZdS ) DocFileCasec f d | j j d S )Nr r )r r r. r r s r/ r zDocFileCase.id s' xx
*0055666r0 c | j j S r )r r` r s r/ r zDocFileCase.__repr__ s
}%%r0 c @ d| j j d| j j d|S )Nr- r. z ", line 0
)r r. r` )r r/ s r/ r) zDocFileCase.format_failure s. =%%%t}'='='=ssD r0 N)r? r r r r r) r r0 r/ rM rM sA 7 7 7& & & r0 rM c $ |i }n| }|r|st d t | |||pd \ }} d|vr| |d< t j | }| |||| d } t | fi |S )Nr r r r# )r r re r r r r rM )
r rb ra r7 r5 rX r docr. r_ s
r/ DocFileTestrS s
}
, , + , , , tWo ' 274 4IC j 7 D ! !D c5$a 8 8D t ' 'w ' ''r0 c t }| dd r%t | d |d< | D ]"}| t |fi | #|S )Nrb Tra )rD r4 rN rI rS )pathskwrK r s r/ r r s 6n
OOE
vv && =)"&&*;*;<<9
/ /
k$--"--.... Lr0 c g }t | D ]}t |t rk| |j d d |j }|r?| d |d | d d d D z
}|d | d d d D z
}|r.|d dk r"| |r |d dk "|r/|d dk r#| d |r |d dk #d | dz S )Nr z # Expected:c g | ]}d |z S )z## r r r s r/ r z(script_from_examples..=
s BBBq57BBBr0 r} c , g | ]}t | S r )r rY s r/ r z(script_from_examples..@
s0 8 8 8 %Q'' 8 8 8r0 r r# )
r r rB r r r r r popr )rk r piecer s r/ r r s 8 r F &&q)) 8 8 eW % % 8 MM%,ss+ , , ,:D
C
m,,,BBDJJt,<,.U
s / / /!$Ar0 znot found in testsr# )rN r r r r r )rL r. rE r_ testsrcs ` r/ r r L
s} v
&
&F OO ( (E / / / /u / / /D 5 3444 7D"4>22G Nr0 c H t | }t ||| d S r )r debug_script)srcpmr7 r_ s r/ r! r! \
s* >"3''G"e$$$$$r0 c dd l }|r| }ni }|r t | || d S # t t j d |j d }| | d t j d Y d S xY w |j d d| z || d S )Nr# r) T)r r< zexec(%r))
r r r rX rG rs r r interactionr )rb rc r7 r ps r/ ra ra a
s =JJJ
C 3 eU # # # # # 3 #,..# $ $ $&&&A
GGIII
MM$ q 1 2 2 2 2 2 2 "":#3UEBBBBBs
5 A:B2c r t | } t | | }t ||| j d S r )rN r ra r? )rL r. rc r_ s r/ r" r" u
s? v
&
&F&&G"fo.....r0 c " e Zd Z d Zd Zd ZdS )
_TestClassc || _ d S r ra )r ra s r/ r z_TestClass.__init__
s r0 c & | j dz | _ | S )Nr< rk r s r/ squarez_TestClass.square
s 8q= r0 c | j S r rk r s r/ r4 z_TestClass.get
s xr0 N)r? r r r rm r4 r r0 r/ ri ri
sF r0 ri 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]
)ri r zbool-int equivalencez blank linesellipsiszwhitespace normalizationc 4 dd l } | d }| ddddd | d
d d t g d
| dddd | ddd | }|j }|j }d}|j D ]}|t | z }|j r
|t z }|D ]}| d r|t j
| \ }}t j
d| t# |d d } t j
d= t% | || \ }
} nt' |d|| \ }
} |
r dS dS ) Nr# zdoctest runner) descriptionrx 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)rs choicesrt ru 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))rs ru ro r z file containing the tests to run)nargsru z.pyr )rb r4 rz r) )argparseArgumentParser add_argumentr* keys
parse_argsro r4 r fail_fastr r~ r r r rG insertrD r r ) ry r5 r testfilesr4 r r r` dirnamer r} r s r/ _testr
s OOO
$
$1A
$
B
BF
k, F H H H
j 3 8 8 : :B E G G G
mL F H H H c ? A A A D I lGG+ / /&v.. ~ 9 U # # K !#
h 7 7 GX HOOAw ' ' '8CRC=))A !!W'JJJKHaa"8U-4'K K KKHa 11 1r0 r )r< )rf ) NNNNTr# NFF)Fr Nr# ru )FN)F)S
__docformat____all__r2 r r@ r= r r ri rG rp r ior$ r% collectionsr& r' r* r r r r r r r r r
r r r
r r r r r; rN rS re rm rx rz r r r r r rY r r r r r r Exceptionr r r r r r r r r r r r; TestSuiterD r rM rS r r r r! ra r" ri rW r r? exitr r0 r/ r sS %N &
+ + + Z
2 2 2 2 2 2 2 2 " " " " " "j (:;; . O O O -,-EFF ++,CDD **+ABB z * *6""--.GHH *)*()
, , #">22 "">22 "">22 / /0K L L , , -- ! &
> > > >&D D D" " "$/ / / / / / /b 4"% "% "% "% "%CG "% "% "%J , , ,\B$ B$ B$ B$ B$ B$ B$ B$HGD GD GD GD GD GD GD GDZd; d; d; d; d; d; d; d;VD D D D D D D DT
G G G G G G G GRP5 P5 P5 P5 P5 P5 P5 P5d Y & ) &e1 e1 e1 e1 e1- e1 e1 e1\
373705f6 f6 f6 f6P (,$d U==??y6 y6 y6 y6v :B:;4 4 4 46 ! ! !Ha0 a0 a0 a0 a0(# a0 a0 a0F k "
H&
> > > >@ + '+D==?? ( ( ( (4C C CRP$ P$ P$d % % % %
C C C C( / / / / * * * * * * * *X %%( )Q0
0
f*
*
*
Z z CHUUWW r0