]d ! @ s$ d Z d d d d d d d d d d
d d d
d d d d d d d d d d d d d d d d d d d d! g! Z d" d# l Z d" d# l Z d" d# l Z d" d# l Z d" d# l Z d" d# l Z d" d# l Z d" d# l Z d" d# l
Z
d" d# l Z d" d# l Z d" d$ l
m Z d" d% l m Z e d& d' Z i Z d( d Z e d Z e d Z e d Z e d Z e d Z e d Z e e Be Be Be Be BZ e d Z e d
Z e d Z e d Z e d Z e e Be Be Be BZ d) Z! d* Z" d+ d, Z# d- d. d/ Z$ d0 d1 Z% d2 d3 d4 Z& d5 d6 Z' Gd7 d8 d8 e Z( d9 d: Z) d; d< Z* d= d> Z+ Gd? d@ d@ e j, Z- dA dB Z. GdC d d Z/ GdD d d Z0 GdE d d Z1 GdF d d Z2 GdG d d Z3 GdH d d Z4 GdI d d e5 Z6 GdJ d d e5 Z7 GdK d d e3 Z8 d# a9 d# d# d# d# dL d" d# dM dM dN d Z: dL d# d# d# d# dL d" d# dM e1 d# dO d Z; dM dP d# d" dQ d Z< d" a= dR d Z> GdS dT dT e j? Z@ GdU dV dV e@ ZA GdW dX dX e jB ZC d# d# d# d# dY d ZD GdZ d[ d[ e@ ZE dL d# d# e1 d# d\ d] ZF d^ d ZG d_ d ZH d` d ZI dM d# da d ZJ dM d# db dc ZK dM dd d! ZL Gde df df ZM df eM dg dh di dj dk dl dm dn do dp i ZN dq dr ZO eP ds k r e
jQ eO d# S)tzreStructuredText enregister_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)StringIO)
namedtuple TestResultszfailed attemptedc C s t j | d t t > S)N )OPTIONFLAGS_BY_NAME
setdefaultlen)name r+ ,/opt/alt/python35/lib64/python3.5/doctest.pyr s z z...c C sR d } xE t j D]: } | j | d } | t t | k r | | j O} q W| S)Nr" )
__future__Zall_feature_namesgetgetattrZ
compiler_flag)globsflagsZfnameZfeaturer+ r+ r, _extract_future_flags s r2 c C su t j | r | St | t r> t | t t d g S| d k re t j t j | j
d St d d S)N*__name__z"Expected a module, string, or None) inspectismodule
isinstancestr
__import__globalslocalssysmodules _getframe f_globals TypeError)moduledepthr+ r+ r, _normalize_module s
rD c C s | r t | d } t | | } t | d d d k r t | j d r | j j | } | j | } | j t j d | f St
| d | } | j | f SWd QRXd S)N
__loader__get_data
encoding) rD _module_relative_pathr/ hasattrrF rG decodereplaceoslinesepopenread)filenamepackagemodule_relativerI Z
file_contentsfr+ r+ r, _load_testfile s rV c C s t j d | d | S)Nz
(?m)^(?!$) )resub)sindentr+ r+ r, _indent s r] c C s; t } | \ } } } t j | | | d | | j S)Nfile)r# tracebackprint_exceptiongetvalue)exc_infoZexcoutexc_typeexc_valexc_tbr+ r+ r, _exception_traceback s rf c @ s+ e Z d Z d d Z d d d Z d S) _SpoofOutc C s3 t j | } | r/ | j d r/ | d 7} | S)NrH )r# ra endswith)selfresultr+ r+ r, ra s
z_SpoofOut.getvalueNc C s | j | t j | d S)N)seekr# truncate)ri sizer+ r+ r, rl s
z_SpoofOut.truncate)r5
__module__ __qualname__ra rl r+ r+ r+ r, rg s rg c C s t | k r | | k S| j t } d t | } } | d } | rq | j | rm t | } | d =n d S| d } | r | j | r | t | 8} | d =n d S| | k r d SxC | D]; } | j | | | } | d k r d S| t | 7} q Wd S)Nr" Fr& Trp )ELLIPSIS_MARKERsplitr)
startswithrh find)wantgotZwsstartposendposwr+ r+ r, _ellipsis_match s0
rz c C s" | j } | r d | Sd Sd S)Nz# #)rstrip)liner+ r+ r,
_comment_line9 s r~ c C s d t | } } | j d } | d k r4 | } | j d d | } | d k r[ | } | j d d | } | d k r | d } | | | S)Nr" rH :.r& )r) rt rfind)msgstartendir+ r+ r, _strip_exception_detailsA s
r c @ sC e Z d Z d d Z d d d Z d d Z d d Z d S)
_OutputRedirectingPdbc C s; | | _ d | _ t j j | d | d d d | _ d S)NFstdoutnosigintTr& )_OutputRedirectingPdb__out$_OutputRedirectingPdb__debugger_usedpdbPdb__init__Z use_rawinput)ri outr+ r+ r, r a s z _OutputRedirectingPdb.__init__Nc C s; d | _ | d k r$ t j j } t j j | | d S)NT)r r= r? f_backr r set_trace)ri framer+ r+ r, r i s z _OutputRedirectingPdb.set_tracec C s | j r t j j | d S)N)r r r set_continue)ri r+ r+ r, r o s z"_OutputRedirectingPdb.set_continuec G s= t j } | j t _ z t j j | | SWd | t _ Xd S)N)r= r r r r trace_dispatch)ri args save_stdoutr+ r+ r, r u s
z$_OutputRedirectingPdb.trace_dispatch)r5 rn ro r r r r r+ r+ r+ r, r [ s r c C s t j | s t d | | j d r: t d t | d re t j j | j d } nv | j
d k r t t j
d k r t j
d d k r t j j t j
d d } q t j } n t d | j
t j j | | j d S) NzExpected a module: %r/z1Module-relative files may not have absolute paths__file__r" __main__ zBCan't resolve paths relative to the module %r (it has no __file__))r6 r7 rA rs
ValueErrorrK rN pathrr r r5 r) r= argvcurdirjoin)rB r Zbasedirr+ r+ r, rJ s (
rJ c @ s@ e Z d Z d d d d d d Z d d Z d d Z d S) r Nr" c C s | j d s | d 7} | r9 | j d r9 | d 7} | d k r_ | j d r_ | d 7} | | _ | | _ | | _ | | _ | d k r i } | | _ | | _ d S)NrH )rh sourceru linenor\ optionsexc_msg)ri r ru r r r\ r r+ r+ r, r s
zExample.__init__c C s t | t | k r t S| j | j k o | j | j k o | j | j k o | j | j k o | j | j k o | j | j k S)N)typeNotImplementedr ru r r\ r r )ri otherr+ r+ r, __eq__ s zExample.__eq__c C s( t | j | j | j | j | j f S)N)hashr ru r r\ r )ri r+ r+ r, __hash__ s zExample.__hash__)r5 rn ro r r r r+ r+ r+ r, r s # c @ sL e Z d Z d d Z d d Z d d Z d d Z d d
Z d S) r c C s@ | | _ | | _ | j | _ | | _ | | _ | | _ d S)N)examples docstringcopyr0 r* rR r )ri r r0 r* rR r r r+ r+ r, r s zDocTest.__init__c C su t | j d k r d } n1 t | j d k r< d } n d t | j } d | j j | j | j | j | f S)Nr" z no examplesr& z 1 examplez %d examplesz<%s %s from %s:%s (%s)>)r) r __class__r5 r* rR r )ri r r+ r+ r, __repr__ s zDocTest.__repr__c C s t | t | k r t S| j | j k o | j | j k o | j | j k o | j | j k o | j | j k o | j | j k S)N)r r r r r0 r* rR r )ri r r+ r+ r, r s zDocTest.__eq__c C s" t | j | j | j | j f S)N)r r r* rR r )ri r+ r+ r, r % s zDocTest.__hash__c C sS t | t s t S| j | j | j t | f | j | j | j t | f k S)N)r8 r r r* rR r id)ri r r+ r+ r, __lt__) s zDocTest.__lt__N)r5 rn ro r r r r r r+ r+ r+ r, r s
c @ s e Z d Z e j d e j e j B Z e j d e j e j Be j B Z e j d j
Z d d d Z d d Z
d d d
Z d d Z e j d
e j Z d d Z e j d e j Z d d Z d d Z d d Z d S)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 ^[ ]*(#.*)?$zc
sw | j } | j | d k rR d j f d d | j d D } g } d \ } } x | j j | D] } | j | | | j | | j d | | j 7} | j | | | \ } } } }
| j
| s'| j t | | |
d | d t | j
d d | | | j d | j | j 7} | j } qw W| j | | d | S) Nr" rH c s g | ] } | d q S)Nr+ ).0l)
min_indentr+ r,
p s z'DocTestParser.parse..r r\ r )r" r" )
expandtabs _min_indentr rr _EXAMPLE_REfinditerappendr count_parse_example_IS_BLANK_OR_COMMENTr r) groupr ) ri stringr* outputZcharnor mr r ru r r+ )r r, parsed s& + !
%zDocTestParser.parsec C s% t | j | | | | | | | S)N)r get_examples)ri r r0 r* rR r r+ r+ r, get_doctest s zDocTestParser.get_doctestc C s d d | j | | D S)Nc S s% g | ] } t | t r | q Sr+ )r8 r )r xr+ r+ r, r s z.DocTestParser.get_examples..)r )ri r r* r+ r+ r, r s zDocTestParser.get_examplesc
su t | j d | j d j d } | j | | | | j | d d d d | | d j f d d | D } | j d } | j d } t | d k r t j d
| d
r | d =| j | d | | t | d j f d d | D } | j j | } | rJ| j d } n d } | j | | | } | | | | f S)Nr\ r rH r& rX r c s$ g | ] } | d d q S)rW Nr+ )r sl)r\ r+ r, r s z0DocTestParser._parse_example..ru z *$c s g | ] } | d q S)Nr+ )r Zwl)r\ r+ r, r s r rp rp )
r) r rr _check_prompt_blank
_check_prefixr rY match
_EXCEPTION_RE
_find_options)
ri r r* r source_linesr ru
want_linesr r r+ )r\ r, r s$ ("("z DocTestParser._parse_examplez#\s*doctest:\s*([^\n\'"]*)$c C s i } x | j j | D] } | j d j d d j } xy | D]q } | d d k ss | d d t k r t d | d | | f t | d d } | d d k | | .r" )
_INDENT_REfindallr) min)ri r[ indentsr+ r+ r, r s
zDocTestParser._min_indentc C s} xv t | D]h \ } } t | | d k r
| | d d k r
t d | | d | | | | d | f q
Wd S)NrW rE rX z8line %r of the docstring for %s lacks blank after %s: %rr& ) enumerater) r )ri linesr\ r* r r r} r+ r+ r, r s
*z!DocTestParser._check_prompt_blankc C sX xQ t | D]C \ } } | r
| j | r
t d | | d | | f q
Wd S)NzGline %r of the docstring for %s has inconsistent leading whitespace: %rr& )r rs r )ri r prefixr* r r r} r+ r+ r, r s zDocTestParser._check_prefixN)r5 rn ro rY compile MULTILINEVERBOSEr DOTALLr r r r r r r r r r r r r r+ r+ r+ r, r 4 s ' 3 c @ ss e Z d Z d e d d d d Z d d d d d d Z d d Z d
d Z d d
Z d d Z d S)r FTc C s( | | _ | | _ | | _ | | _ d S)N)_parser_verbose_recurse_exclude_empty)ri verboseparserrecurse
exclude_emptyr+ r+ r, r ( s zDocTestFinder.__init__Nc C s | d k rC t | d d } | d k rC t d t | f | d k rX d } n | d k rs t j | } y t j | } Wn t k
r d } Yn X| s t j | } | d | d d d k s d } | d k r d } n? | d k rt j | | j
} n t j | } | s.d } | d k ra| d k rOi } qm| j
j } n | j } | d k r| j | d | k rd | d r )r/ r r r6 getmoduleZ
getsourcefilerA Zgetfile linecachegetlines__dict__r update_findsort) ri objr* rB r0
extraglobsr^ r testsr+ r+ r, rt > sJ $
zDocTestFinder.findc C s | d k r d St j | d k r8 | t j | k St j | rW | j | j k St j | r t | d r | j j } n t | d r | j } n d S| j | k St j
| r | j | j k St | d r | j | j k St | t rd St
d d S)NT __objclass__rn z"object must be a class or function)r6 r
isfunctionr __globals__ZismethoddescriptorrK r rn r5 isclassr8 propertyr )ri rB objectZobj_modr+ r+ r, _from_module s(
zDocTestFinder._from_modulec C s | j r t d | t | | k r- d Sd | t | <| j | | | | | } | d k rq | j | t j | r| j rx | j j D]t \ } }
d | | f } t j
t j |
s t j |
r | j
| |
r | j | |
| | | | | q Wt j | r| j rx t | d i j D] \ } }
t | t svt d t | f t j
|
pt j |
pt j |
pt |
t st d t |
f d | | f } | j | |
| | | | | qBWt j | r| j rx | j j D] \ } }
t |
t rPt | | }
t |
t rqt | | j }
t j
|
st j |
st |
t r&| j
| |
r&d | | f } | j | |
| | | | | q&Wd S)NzFinding tests in %sr& z%s.%s__test__z5DocTestFinder.find: __test__ keys must be strings: %rz`DocTestFinder.find: __test__ values must be strings, functions, methods, classes, or modules: %rz%s.__test__.%s)r printr _get_testr r6 r7 r r itemsZ isroutineZunwrapr r r r/ r8 r9 r r staticmethod classmethod__func__r ) ri r r r* rB r r0 seentestZvalnamevalr+ r+ r, r sP
% zDocTestFinder._findc C s t | t r | } na y@ | j d k r3 d } n$ | j } t | t sW t | } Wn t t f k
rx d } Yn X| j | | } | j r | r d S| d k r d } n; t | d | j } | d d d k r | d d } | j j
| | | | | S)Nr r rW z.pycr& rp ) r8 r9 __doc__rA AttributeError _find_linenor r/ r5 r r ) ri r r* rB r0 r r r rR r+ r+ r, r s( zDocTestFinder._get_testc C s{ d } t j | r d } t j | r | d k r: d St j d t | d d } x0 t | D]" \ } } | j | rf | } Pqf Wt j | r | j } t j
| r | j } t j | r | j
} t j | r | j } t j | rt | d d d } | d k rw| d k r1| d St j d } x4 t | t | D] } | j | | rV| SqVWd S)Nr" z^\s*class\s*%s\br5 -co_firstlinenor& z(^|.*:)\s*\w*("|'))r6 r7 r rY r r/ r r Zismethodr r __code__Z istracebacktb_frameZisframef_codeZiscoderanger) )ri r r r patr r} r+ r+ r, r $ s< zDocTestFinder._find_lineno)
r5 rn ro r r rt r r r r r+ r+ r+ r, r s f ? %c @ s e Z d Z d d Z d d d d d Z d d Z d d
Z d d Z d
d Z d d Z d d Z
d d Z e j
d Z d d d Z d d d d d Z d d d Z d d Z d S) r r4 F Nr" c C ss | p t | _ | d k r- d t j k } | | _ | | _ | | _ d | _ d | _ i | _ t
| _ d S)Nz-vr" ) r _checkerr= r r optionflagsoriginal_optionflagstriesfailures_name2ftrg _fakeout)ri checkerr r r+ r+ r, r s zDocTestRunner.__init__c C s\ | j rX | j r= | d t | j d t | j n | d t | j d d S)NzTrying:
z Expecting:
zExpecting nothing
)r ru r] r )ri r r exampler+ r+ r, report_start s (zDocTestRunner.report_startc C s | j r | d d S)Nzok
)r )ri r r r rv r+ r+ r, report_success s z DocTestRunner.report_successc C s3 | | j | | | j j | | | j d S)N)_failure_headerr output_differencer )ri r r r rv r+ r+ r, report_failure s z DocTestRunner.report_failurec C s. | | j | | d t t | d S)NzException raised:
)r r] rf )ri r r r rb r+ r+ r, report_unexpected_exception s z)DocTestRunner.report_unexpected_exceptionc C s | j g } | j rs | j d k rJ | j d k rJ | j | j d } n d } | j d | j | | j f n! | j d | j d | j f | j d | j } | j t | d j | S)Nr& ?zFile "%s", line %s, in %szLine %s, in %szFailed example:rH )DIVIDERrR r r r* r r] r )ri r r r r r r+ r+ r, r s !
z DocTestRunner._failure_headerc C sH d } } | j } t d \ } } } | j j }
xt | j D]\ } } | j t @of | d k }
| | _ | j r xE | j j D]4 \ } } | r | j | O_ q | j | M_ q W| j t @r qD | d 7} |
s | j
| | | d | j | f } y< t t
| j | d | d | j | j j d } Wn5 t k
r\ Yn! t j } | j j Yn X| j j } | j j d | } | d k r|
| j | | j rr| } n t j | d d d } |
s| t | 7} | j d k r| } nX |
| j | | j r;| } n7 | j t @rr|
t | j t | | j rr| } | | k r|
s| j | | | | nj | | k r|
s| j | | | | | d 7} n5 | | k r|
s| j! | | | | | d 7} n | rD | j t" @rD PqD W| | _ | j# | | | t$ | | S)Nr" rE r& zZsingler3 rp )%r r r check_outputr r r r r r r r* execr r r0 debuggerr KeyboardInterruptr= rb r ra rl ru r_ format_exception_onlyrf r r r r r r r _DocTestRunner__record_outcomer% )ri r compileflagsr r r r SUCCESSFAILUREZBOOMcheck
examplenumr quietZ
optionflagr rR exceptionrv Zoutcomer r+ r+ r, Z__run s
zDocTestRunner.__runc C s^ | j j | j d \ } } | | | | f | j | j <| j | 7_ | j | 7_ d S)Nr" )r" r" )r r. r* r r )ri r rU tf2t2r+ r+ r, Z__record_outcomel s z DocTestRunner.__record_outcomez..+)\[(?P\d+)\]>$c C sy | j j | } | re | j d | j j k re | j j t | j d } | j j d d S| j | | Sd S)Nr* r) keependsT)
%_DocTestRunner__LINECACHE_FILENAME_REr r r r* r intr
splitlinessave_linecache_getlines)ri rR module_globalsr r r+ r+ r, Z __patched_linecache_getlinesy s
! z*DocTestRunner.__patched_linecache_getlinesTc su | | _ | d k r$ t | j } t j | d k r j d k s` j d k rl j } n f d d } | j t _ t j } t
j } t | _
| j
j | j
j t
_ t j | _ | j t _ t j } t j t _ z | j | | | SWd t _ | t
_ t j | | j t _ | t _ | rp| j j d d l } d | _ Xd S)Nzutf-8c s, t | j d } j | d S)Nbackslashreplace)r9 encodewrite)r[ )rI r r+ r, r s z DocTestRunner.run..outr" )r r2 r0 r= r rI lowerr7 r gettracer r r r! resetr r r3 *_DocTestRunner__patched_linecache_getlines displayhook__displayhook___DocTestRunner__runsettraceclearbuiltins_) ri r r% r clear_globsZ
save_traceZsave_set_traceZsave_displayhookrA r+ )rI r r, run s<
zDocTestRunner.runc
C s$ | d k r | j } g } g } g } d } } x | j j D]w } | \ } \ } }
| |
7} | | 7} |
d k r | j | qA | d k r | j | |
f qA | j | qA W| rQ| rt t | d | j x | D] } t d | q W| rQt t | d | j x( | D] \ } } t d | | f q-W| rt | j t t | d | j x1 | D]) \ } \ } }
t d | |
| f qW| rt | d t | j d t | | 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.) r r r r r r) r r r% )
ri r ZnotestsZpassedZfailedZtotaltZtotalfr r* rU r, thingr r+ r+ r, summarize sP
zDocTestRunner.summarizec C ss | j } xc | j j D]R \ } \ } } | | k r[ | | \ } } | | } | | } | | f | | r$ rY r r0 r; rD rF rH r+ r+ r+ r, r X s :
$
}
I9c @ s@ e Z d Z d d Z d d Z d d Z d d Z d S)
r c C s t | j d d d S)NASCIIr5 )r9 r6 )ri r[ r+ r+ r, _toAscii s zOutputChecker._toAsciic C s | j | } | j | } | | k r. d S| t @sd | | f d k rN d S| | f d k rd d S| t @s t j d t j t d | } t j d d | } | | k r d S| t @r d j | j } d j | j } | | k r d S| t
@rt | | rd Sd
S)
NTTrue
1
False
0
z (?m)^%s\s*?$r z
(?m)^\s*?$rX F)rK rL )rM rN ) rJ r r rY rZ escapeBLANKLINE_MARKERr r rr r rz )ri ru rv r r+ r+ r, r s0
zOutputChecker.check_outputc C sL | t t Bt B@s d S| t @r$ d S| j d d k oK | j d d k S)NFTrH r3 )r r
r r )ri ru rv r r+ r+ r, _do_a_fancy_diff] s
z OutputChecker._do_a_fancy_diffc
C s | j } | t @s( t j d t | } | j | | | rQ| j d d } | j d d } | t @r t j | | d d } t
| d d } d } n | t @r t j | | d d } t
| d d } d } n@ | t
@r#t j d t j } t
| j | | } d } n d
d | D } d | t d
j | S| rw| rwd t | t | f S| rd t | S| rd t | Sd Sd S)Nz(?m)^[ ]*(?=
)r/ Tnr3 z#unified diff with -expected +actualz-context diff with expected followed by actualZcharjunkz ndiff with -expected +actualc S s g | ] } | j d q S)rH )r| )r r} r+ r+ r, r s z3OutputChecker.output_difference..zDifferences (%s):
r zExpected:
%sGot:
%szExpected:
%sGot nothing
zExpected nothing
Got:
%sz Expected nothing
Got nothing
)ru r rY rZ rP rQ r2 r difflibZ unified_difflistr
Z context_diffr ZDifferZIS_CHARACTER_JUNKZcomparer] r )
ri r rv r ru r Z got_linesZdiffkindZenginer+ r+ r, r t s6
z OutputChecker.output_differenceN)r5 rn ro rJ r rQ r r+ r+ r+ r, r s ? c @ s( e Z d Z d d Z d d Z d S)r c C s | | _ | | _ | | _ d S)N)r r rv )ri r r rv r+ r+ r, r s zDocTestFailure.__init__c C s
t | j S)N)r9 r )ri r+ r+ r, __str__ s zDocTestFailure.__str__N)r5 rn ro r rV r+ r+ r+ r, r s c @ s( e Z d Z d d Z d d Z d S)r c C s | | _ | | _ | | _ d S)N)r r rb )ri r r rb r+ r+ r, r s z UnexpectedException.__init__c C s
t | j S)N)r9 r )ri r+ r+ r, rV s zUnexpectedException.__str__N)r5 rn ro r rV r+ r+ r+ r, r s c @ s= e Z d Z d d d d d Z d d Z d d Z d S) r NTc C s2 t j | | | | d } | r. | j j | S)NF)r rD r0 r@ )ri r r% r rC rr+ r+ r, rD % s
zDebugRunner.runc C s t | | | d S)N)r )ri r r r rb r+ r+ r, r + s z'DebugRunner.report_unexpected_exceptionc C s t | | | d S)N)r )ri r r r rv r+ r+ r, r . s zDebugRunner.report_failure)r5 rn ro rD r r r+ r+ r+ r, r s [ TFc C s | d k r t j j d } t j | s@ t d | f | d k rU | j } t d | } | r t d | d | }
n t d | d | }
x3 | j
| | d | d | D] } |
j | q W| r |
j t
d k r |
a
n
t
j |
t |
j |
j S)Nr z testmod: module required; %rr r r r0 r )r= r> r. r6 r7 rA r5 r r r rt rD rF masterrH r% r r ) r r* r0 r reportr r raise_on_errorr finderrunnerr r+ r+ r, r : s$ E %
c C sH | r | r t d t | | | | p. d \ } } | d k rX t j j | } | d k rm i } n | j } | d k r | j | d | k r d | d <| r t d | d | }
n t d | d | }
|
j | | | | d } |
j
| | r|
j t d k r(|
a n
t j
|
t |
j |
j S)Nz8Package may only be specified for module-relative paths.zutf-8r5 r r r r" )r rV rN r basenamer r r r r rD rF rX rH r% r r )rR rT r* rS r0 r rY r r rZ r rI textr\ r r+ r+ r, r s0 R
ZNoNamec C sd t d | d d } t d | d | } x3 | j | | d | D] } | j | d | qC Wd S)Nr r Fr r0 r% )r r rt rD ) rU r0 r r* r% r r[ r\ r r+ r+ r, r s c C s/ | t @| k r t d | t } | a | S)Nz Only reporting flags allowed)r
r _unittest_reportflags)r1 oldr+ r+ r, r : s
c @ s e Z d Z d d d d d d Z d d Z d d Z d d
Z d d Z d
d Z d d Z d d Z
d d Z d d Z e Z
d d Z d S) DocTestCaser" Nc C sA t j j | | | _ | | _ | | _ | | _ | | _ d S)N)unittestTestCaser _dt_optionflags _dt_checker_dt_test _dt_setUp _dt_tearDown)ri r r setUptearDownr r+ r+ r, r ` s zDocTestCase.__init__c C s) | j } | j d k r% | j | d S)N)rf rg )ri r r+ r+ r, ri j s zDocTestCase.setUpc C s6 | j } | j d k r% | j | | j j d S)N)rf rh r0 r@ )ri r r+ r+ r, rj p s
zDocTestCase.tearDownc C s | j } t j } t } | j } | t @s8 | t O} t d | d | j d d } z5 d d | _ | j
| d | j d d \ } } Wd | t _ X| r | j | j
| j d S) Nr r r Fr r
r rC )rf r= r r# rd r
r_ r re r rD r7 ZfailureExceptionformat_failurera )ri r r` newr r\ r r r+ r+ r, runTestx s
"
zDocTestCase.runTestc C sp | j } | j d k r! d } n
d | j } d j | j j d d d } d | j | j | | | f S)Nzunknown line numberz%sr r& z:Failed doctest test for %s
File "%s", line %s, in %s
%srp )rf r r r* rr rR )ri errr r Zlnamer+ r+ r, rk s
%zDocTestCase.format_failurec C sO | j t d | j d | j d d } | j | j d d | j d S)Nr r r FrC )ri r rd re rD rf rj )ri r\ r+ r+ r, r! s
B
zDocTestCase.debugc C s
| j j S)N)rf r* )ri r+ r+ r, r s zDocTestCase.idc C st t | t | k r t S| j | j k os | j | j k os | j | j k os | j | j k os | j | j k S)N)r r rf rd rg rh re )ri r r+ r+ r, r s zDocTestCase.__eq__c C s" t | j | j | j | j f S)N)r rd rg rh re )ri r+ r+ r, r s zDocTestCase.__hash__c C s: | j j j d } d | d d j | d d f S)Nr z%s (%s)r& rp rp )rf r* rr r )ri r* r+ r+ r, r s zDocTestCase.__repr__c C s d | j j S)Nz Doctest: )rf r* )ri r+ r+ r, shortDescription s z DocTestCase.shortDescription)r5 rn ro r ri rj rm rk r! r r r r rV ro r+ r+ r+ r, ra ^ s H
ra c @ sF e Z d Z d d Z d d Z d d Z d d Z e Z d S)
SkipDocTestCasec C s | | _ t j | d d S)N)rB ra r )ri rB r+ r+ r, r s zSkipDocTestCase.__init__c C s | j d d S)Nz-DocTestSuite will not work with -O2 and above)ZskipTest)ri r+ r+ r, ri s zSkipDocTestCase.setUpc C s d S)Nr+ )ri r+ r+ r, test_skip s zSkipDocTestCase.test_skipc C s d | j j S)NzSkipping tests from %s)rB r5 )ri r+ r+ r, ro s z SkipDocTestCase.shortDescriptionN)r5 rn ro r ri rq ro rV r+ r+ r+ r, rp s
rp c @ s e Z d Z d d Z d S)
_DocTestSuitec C s d S)Nr+ )ri indexr+ r+ r, _removeTestAtIndex s z _DocTestSuite._removeTestAtIndexN)r5 rn ro rt r+ r+ r+ r, rr s rr c K s | d k r t } t | } | j | d | d | } | ru t j j d k ru t } | j t | | S| j t } x} | D]u } t
| j d k r q | j s | j
} | d d d k r | d d } | | _ | j t | | q W| S)
Nr0 r r3 r" rW z.pycr& r rp )r rD rt r= r1 optimizerr addTestrp r r) r rR r ra ) rB r0 r Z test_finderr r suiter rR r+ r+ r, r s( %
c @ s: e Z d Z d d Z d d Z e Z d d Z d S) DocFileCasec C s d j | j j j d S)NrB r )r rf r* rr )ri r+ r+ r, r W s zDocFileCase.idc C s
| j j S)N)rf rR )ri r+ r+ r, r Z s zDocFileCase.__repr__c C s d | j j | j j | f S)Nz2Failed doctest test for %s
File "%s", line 0
%s)rf r* rR )ri rn r+ r+ r, rk ^ s zDocFileCase.format_failureN)r5 rn ro r r rV rk r+ r+ r+ r, rx U s rx c
K s | d k r i } n | j } | r: | r: t d t | | | | pO d \ } } d | k rq | | d .rH c S s g | ] } t | q Sr+ )r~ )r r r+ r+ r, r
s r{ r" rp rp rp rp )
r r r8 r r r ru rr popr )r[ r Zpieceru r+ r+ r, r s :
- "c si t | } t j | } f d d | D } | sL t d | d } t | j } | S)Nc s% g | ] } | j k r | q Sr+ )r* )r r, )r* r+ r, r !
s z testsource..znot found in testsr" )rD r rt r r r )rB r* r r testsrcr+ )r* r, r
s
c C s t | } t | | | d S)N)r debug_script)srcpmr0 r~ r+ r+ r, r (
s c
C s d d l } | r! | j } n i } | r y t | | | Wq t t j d | j d d } | j | j d t j d Yq Xn# | j d d j d | | | d S)Nr" r& r Tr3 zexec(%r))
r r r r r= rb r r: Z interactionrD )r r r0 r pr+ r+ r, r -
s
"r c C s2 t | } t | | } t | | | j d S)N)rD r r r )rB r* r r~ r+ r+ r, r! A
s c @ s4 e Z d Z d d Z d d Z d d Z d S)
_TestClassc C s
| | _ d S)N)r )ri r r+ r+ r, r ]
s z_TestClass.__init__c C s | j d | _ | S)Nr3 )r )ri r+ r+ r, squareg
s z_TestClass.squarec C s | j S)N)r )ri r+ r+ r, r. q
s z_TestClass.getN)r5 rn ro r r r. r+ r+ r+ r, r O
s
r r z
Example of a string object, searched as-is.
>>> x = 1; y = 2
>>> x + y, x * y
(3, 2)
zbool-int equivalencea
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 linesz
Blank lines can be marked with :
>>> print('foo\n\nbar\n')
foo
bar
Zellipsisz
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]
zwhitespace normalizationa
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]
c C s t j d d } | j d d d d d d d d
| j d d d d
d t j d g d d | j d d d d d d | j d d d d d | j } | j } | j } d } x | j D] } | t | O} q W| j r | t
O} x | D] } | j d rxt j
j | \ } } t j
j d | t | d d } t j
d =t | d | d | \ } }
n$ t | d d d | d | \ } }
| r d Sq Wd S) N descriptionzdoctest runnerz-vz --verboseaction
store_truedefaultFhelpz'print very verbose output for all testsz-oz--optionr choiceszqspecify a doctest option flag to apply to the test run; may be specified more than once to apply multiple optionsz-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^ nargsr z file containing the tests to runr" z.pyrE r r rT r& )argparseArgumentParser add_argumentr' keys
parse_argsr^ r r Z fail_fastr rh rN r rr r= insertr: r r ) r r Z testfilesr r r rR dirnamer r rB r+ r+ r, _test
s<
!r r )RZ
__docformat____all__r- r rS r6 r rN r rY r= r_ rb ior# collectionsr$ r% r' r r r r r r r r r r
r r r r
rP rq r2 rD rV r] rf rg rz r~ r r r rJ r r r r r r Exceptionr r r rX r r r r_ r rc ra rp Z TestSuiterr r rx rz r r r r r r! r r r r5 exitr+ r+ r+ r, 0 s 1 % %DK : n f x $@ I R , +