???<!-- GIF89;a -->
123123123123
.....................................................................................................................................???<!-- GIF89;a -->
123123123123
.....................................................................................................................................U
    e5d_                 !   @   sp  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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B eB eB eB eB Zed	Zed
ZedZedZedZeeB eB eB eB Zd)Z d*Z!d+d, Z"drd.d/Z#d0d1 Z$d2d3 Z%dsd5d6Z&d7d8 Z'G d9d: d:eZ(d;d< Z)d=d> Z*d?d@ Z+G dAdB dBej,Z-dCdD Z.G dEd dZ/G dFd dZ0G dGd dZ1G dHd dZ2G dId dZ3G dJd dZ4G dKd de5Z6G dLd de5Z7G dMd de3Z8d#a9dtdPdZ:dNd#d#d#d#dNd"d#dOe1 d#fdQdZ;dudSdZ<d"a=dTd Z>G dUdV dVej?Z@G dWdX dXe@ZAG dYdZ dZejBZCdvd[dZDG d\d] d]e@ZEdNd#d#e1 d#fd^d_ZFd`d ZGdad ZHdbd ZIdwdcd ZJdxdddeZKdydfd!ZLG dgdh dhZMeMdidjdkdldmdnZNdodp ZOePdqkrle	QeO  d#S )zzreStructuredText enregister_optionflagDONT_ACCEPT_TRUE_FOR_1DONT_ACCEPT_BLANKLINENORMALIZE_WHITESPACEELLIPSISSKIPIGNORE_EXCEPTION_DETAILCOMPARISON_FLAGSREPORT_UDIFFREPORT_CDIFFREPORT_NDIFFREPORT_ONLY_FIRST_FAILUREREPORTING_FLAGS	FAIL_FASTExampleDocTestDocTestParserDocTestFinderDocTestRunnerOutputCheckerDocTestFailureUnexpectedExceptionDebugRunnertestmodtestfilerun_docstring_examplesDocTestSuiteDocFileSuiteset_unittest_reportflagsscript_from_examples
testsource	debug_srcdebug    N)StringIO)
namedtupleTestResultszfailed attemptedc                 C   s   t | dtt > S )N   )OPTIONFLAGS_BY_NAME
setdefaultlenname r,   /usr/lib64/python3.8/doctest.pyr      s    z<BLANKLINE>z...c                 C   s8   d}t jD ](}| |d }|tt |kr
||jO }q
|S )Nr"   )
__future__Zall_feature_namesgetgetattrZcompiler_flag)globsflagsZfnameZfeaturer,   r,   r-   _extract_future_flags   s    
r3      c                 C   sV   t | r| S t| tr,t| t t dgS | d krJtjt	|j
d  S tdd S )N*__name__z"Expected a module, string, or None)inspectismodule
isinstancestr
__import__globalslocalssysmodules	_getframe	f_globals	TypeError)moduleZdepthr,   r,   r-   _normalize_module   s    


rD   c                 C   s   dD ]}|  |d} q| S )N)z

)replace)datanewliner,   r,   r-   _newline_convert   s    rJ   c              
   C   s   |rVt |d}t|| } t|dd d k	rVt|jdrV|j| }||}t|| fS t| |d}|	 | fW  5 Q R  S Q R X d S )N   
__loader__get_data)encoding)
rD   _module_relative_pathr0   hasattrrL   rM   decoderJ   openread)filenamepackagemodule_relativerN   Zfile_contentsfr,   r,   r-   _load_testfile   s    


rX      c                 C   s   t d|d | S )Nz
(?m)^(?!$) )resub)sindentr,   r,   r-   _indent   s    r_   c                 C   s*   t  }| \}}}tj||||d | S )N)file)r#   	tracebackprint_exceptiongetvalue)exc_infoZexcoutexc_typeZexc_valZexc_tbr,   r,   r-   _exception_traceback   s    
rf   c                   @   s   e Zd Zdd ZdddZdS )	_SpoofOutc                 C   s$   t | }|r |ds |d7 }|S NrF   )r#   rc   endswith)selfresultr,   r,   r-   rc      s    
z_SpoofOut.getvalueNc                 C   s   |  | t|  d S N)seekr#   truncate)rj   sizer,   r,   r-   rn   	  s    
z_SpoofOut.truncate)N)r6   
__module____qualname__rc   rn   r,   r,   r,   r-   rg      s   	rg   c                 C   s   t | kr| |kS | t }dt| }}|d }|rR||rNt|}|d= ndS |d }|r||r||t|8 }|d= ndS ||krdS |D ],}||||}|dk r dS |t|7 }qdS )Nr"   FT)ELLIPSIS_MARKERsplitr)   
startswithri   find)wantgotZwsstartposendposwr,   r,   r-   _ellipsis_match  s0    


r|   c                 C   s   |   } | rd|  S dS d S )Nz# #)rstrip)liner,   r,   r-   _comment_line?  s    r   c                 C   sh   dt |  }}| d}|dkr$|}| dd|}|dkr>|}| dd|}|dkr\|d }| || S )Nr"   rF   :.r&   )r)   rv   rfind)msgstartendir,   r,   r-   _strip_exception_detailsG  s    
r   c                   @   s.   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 S )NFT)stdoutnosigintr&   )_OutputRedirectingPdb__out$_OutputRedirectingPdb__debugger_usedpdbPdb__init__Zuse_rawinput)rj   outr,   r,   r-   r   g  s    z_OutputRedirectingPdb.__init__Nc                 C   s*   d| _ |d krt j}tj| | d S )NT)r   r>   r@   f_backr   r   	set_trace)rj   framer,   r,   r-   r   o  s    
z_OutputRedirectingPdb.set_tracec                 C   s   | j rtj|  d S rl   )r   r   r   set_continuerj   r,   r,   r-   r   u  s    z"_OutputRedirectingPdb.set_continuec                 G   s2   t j}| jt _ztjj| f| W S |t _X d S rl   )r>   r   r   r   r   trace_dispatch)rj   argssave_stdoutr,   r,   r-   r   {  s
    z$_OutputRedirectingPdb.trace_dispatch)N)r6   rp   rq   r   r   r   r   r,   r,   r,   r-   r   a  s   
r   c                 C   s   t | std|  |dr(tdtjj|d }t	| drXtj| j
d }n| jdkrttjdkrtjd dkrtjtjd d }qtj}nFt	| dr| jD ]&}tj||}tj|r|  S qtd	| j tj||S )
NzExpected 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__))r7   r8   rB   ru   
ValueErrorospathjoinrt   rP   r   r6   r)   r>   argvcurdirr   exists)rC   Z	test_pathZbasedirZ	directoryfullpathr,   r,   r-   rO     s(    






rO   c                   @   s&   e Zd Zd	ddZdd Zdd ZdS )
r   Nr"   c                 C   sv   | ds|d7 }|r(| ds(|d7 }|d k	rB| dsB|d7 }|| _|| _|| _|| _|d krfi }|| _|| _d S rh   )ri   sourcerw   linenor^   optionsexc_msg)rj   r   rw   r   r   r^   r   r,   r,   r-   r     s    
 zExample.__init__c                 C   s\   t | t |k	rtS | j|jkoZ| j|jkoZ| j|jkoZ| j|jkoZ| j|jkoZ| j|jkS rl   )typeNotImplementedr   rw   r   r^   r   r   rj   otherr,   r,   r-   __eq__  s    




zExample.__eq__c                 C   s   t | j| j| j| j| jfS rl   )hashr   rw   r   r^   r   r   r,   r,   r-   __hash__  s    zExample.__hash__)Nr"   r"   N)r6   rp   rq   r   r   r   r,   r,   r,   r-   r     s
   #  
c                   @   s4   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,   || _ || _| | _|| _|| _|| _d S rl   )examples	docstringcopyr1   r+   rT   r   )rj   r   r1   r+   rT   r   r   r,   r,   r-   r     s    
zDocTest.__init__c                 C   sR   t | jdkrd}n"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__r6   r+   rT   r   )rj   r   r,   r,   r-   __repr__  s       zDocTest.__repr__c                 C   s\   t | t |k	rtS | j|jkoZ| j|jkoZ| j|jkoZ| j|jkoZ| j|jkoZ| j|jkS rl   )r   r   r   r   r1   r+   rT   r   r   r,   r,   r-   r   )  s    




zDocTest.__eq__c                 C   s   t | j| j| j| jfS rl   )r   r   r+   rT   r   r   r,   r,   r-   r   4  s    zDocTest.__hash__c                 C   s:   t |tstS | j| j| jt| f|j|j|jt|fk S rl   )r9   r   r   r+   rT   r   idr   r,   r,   r-   __lt__8  s
    
zDocTest.__lt__N)r6   rp   rq   r   r   r   r   r   r,   r,   r,   r-   r     s
   c                   @   s   e Zd ZedejejB ZedejejB ejB Z	edj
ZdddZdd Zdd	d
Zdd ZedejZdd Ze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<source>
            (?:^(?P<indent> [ ]*) >>>    .*)    # PS1 line
            (?:\n           [ ]*  \.\.\. .*)*)  # PS2 lines
        \n?
        # Want consists of any non-blank lines that do not start with PS1.
        (?P<want> (?:(?![ ]*$)    # Not a blank line
                     (?![ ]*>>>)  # Not a line starting with PS1
                     .+$\n?       # But any other line
                  )*)
        a  
        # Grab the traceback header.  Different versions of Python have
        # said different things on the first traceback line.
        ^(?P<hdr> Traceback\ \(
            (?: most\ recent\ call\ last
            |   innermost\ last
            ) \) :
        )
        \s* $                # toss trailing whitespace on the header.
        (?P<stack> .*?)      # don't blink: absorb stuff until...
        ^ (?P<msg> \w+ .*)   #     a line *starts* with alphanum.
        z^[ ]*(#.*)?$<string>c                    s  |  }| |  dkr8d fdd|dD }g }d\}}| j|D ]}||||   ||d|| 7 }| 	|||\}}}	}
| 
|s|t||	|
| t|d |d ||d| | 7 }| }qP|||d   |S )Nr"   rF   c                    s   g | ]}| d  qS rl   r,   .0lZ
min_indentr,   r-   
<listcomp>  s     z'DocTestParser.parse.<locals>.<listcomp>r"   r"   r^   )r   r^   r   )
expandtabs_min_indentr   rt   _EXAMPLE_REfinditerappendr   count_parse_example_IS_BLANK_OR_COMMENTr   r)   groupr   )rj   stringr+   outputZcharnor   mr   r   rw   r   r,   r   r-   parses  s*    



zDocTestParser.parsec                 C   s   t | |||||||S rl   )r   get_examples)rj   r   r1   r+   rT   r   r,   r,   r-   get_doctest  s    	   zDocTestParser.get_doctestc                 C   s   dd |  ||D S )Nc                 S   s   g | ]}t |tr|qS r,   )r9   r   )r   xr,   r,   r-   r     s    
z.DocTestParser.get_examples.<locals>.<listcomp>)r   )rj   r   r+   r,   r,   r-   r     s    zDocTestParser.get_examplesc           
         s
  t |d |dd}| | || | |dd  d  d || d fdd|D }|d	}|d}t |dkrtd
|d r|d= | |d  ||t |  d fdd|D }| j|}|r|d}nd }| 	|||}	||	||fS )Nr^   r   rF   r&   rZ   r   c                    s   g | ]}| d  d qS )rY   Nr,   )r   Zslr^   r,   r-   r     s     z0DocTestParser._parse_example.<locals>.<listcomp>rw   z *$rr   c                    s   g | ]}| d  qS rl   r,   )r   Zwlr   r,   r-   r     s     r   )
r)   r   rt   _check_prompt_blank_check_prefixr   r[   match_EXCEPTION_RE_find_options)
rj   r   r+   r   source_linesr   rw   
want_linesr   r   r,   r   r-   r     s&     


zDocTestParser._parse_examplez#\s*doctest:\s*([^\n\'"]*)$c           	      C   s   i }| j |D ]v}|ddd }|D ]V}|d dksN|dd  tkrdtd|d ||f t|dd   }|d dk||< q.q|r| |rtd|||f |S )	Nr&   ,rZ   r"   z+-z7line %r of the doctest for %s has an invalid option: %r+zSline %r of the doctest for %s has an option directive on a line with no example: %r)_OPTION_DIRECTIVE_REr   r   rG   rt   r'   r   r   )	rj   r   r+   r   r   r   Zoption_stringsoptionflagr,   r,   r-   r     s"    zDocTestParser._find_optionsz^([ ]*)(?=\S)c                 C   s2   dd | j |D }t|dkr*t|S dS d S )Nc                 S   s   g | ]}t |qS r,   )r)   )r   r^   r,   r,   r-   r   
  s     z-DocTestParser._min_indent.<locals>.<listcomp>r"   )
_INDENT_REfindallr)   min)rj   r]   indentsr,   r,   r-   r     s    zDocTestParser._min_indentc              	   C   s^   t |D ]P\}}t||d kr||d  dkrtd|| d ||||d  |f qd S )NrY   rK   rZ   z8line %r of the docstring for %s lacks blank after %s: %rr&   )	enumerater)   r   )rj   linesr^   r+   r   r   r   r,   r,   r-   r     s      z!DocTestParser._check_prompt_blankc                 C   s>   t |D ]0\}}|r||std|| d ||f qd S )NzGline %r of the docstring for %s has inconsistent leading whitespace: %rr&   )r   ru   r   )rj   r   prefixr+   r   r   r   r,   r,   r-   r     s
    zDocTestParser._check_prefixN)r   )r   )r6   rp   rq   r[   compile	MULTILINEVERBOSEr   DOTALLr   r   r   r   r   r   r   r   r   r   r   r   r   r,   r,   r,   r-   r   C  s&   	

'
3c                   @   sJ   e Zd Zde ddfddZdddZdd	 Zd
d Zdd Zdd Z	dS )r   FTc                 C   s   || _ || _|| _|| _d S rl   )_parser_verbose_recurse_exclude_empty)rj   verboseparserrecurseexclude_emptyr,   r,   r-   r   7  s    zDocTestFinder.__init__Nc           	   	   C   sN  |d kr.t |dd }|d kr.tdt|f |dkr<d }n|d krNt|}zt|}W n tk
rt   d }Y ndX |st|}|d |dd   dksd }|d krd }n*|d k	rt	||j
}n
t	|}|sd }|d kr|d kri }n
|j
 }n| }|d k	r|| d|kr(d|d< g }| ||||||i  |  |S )Nr6   zJDocTestFinder.find: name must be given when obj.__name__ doesn't exist: %rFr"   z<]>r   )r0   r   r   r7   	getmoduleZgetsourcefilerB   Zgetfile	linecachegetlines__dict__r   update_findsort)	rj   objr+   rC   r1   
extraglobsr`   r   testsr,   r,   r-   rv   M  sL    $


 



zDocTestFinder.findc                 C   s   |d krdS t |d k	r(|t |kS t |r>|j|jkS t |r|t|dr\|jj}nt|drn|j}ndS |j	|kS t 
|r|j	|jkS t|dr|j	|jkS t|trdS tdd S )NT__objclass__rp   z"object must be a class or function)r7   r   
isfunctionr   __globals__ZismethoddescriptorrP   r   rp   r6   isclassr9   propertyr   )rj   rC   objectZobj_modr,   r,   r-   _from_module  s(    








zDocTestFinder._from_modulec              
   C   s  | j rtd|  t||kr"d S d|t|< | |||||}|d k	rR|| t|r| jr|j	 D ]P\}	}
d||	f }	t
t|
st|
rl| ||
rl| ||
|	|||| qlt|rn| jrnt|di 	 D ]\}	}
t|	tstdt|	f t
|
sJt|
sJt|
sJt|
tsJtdt|
f d||	f }	| ||
|	|||| qt|r| jr|j	 D ]\}	}
t|
trt||	}
t|
trt||	j}
t
|
st|
st|
tr| ||
rd||	f }	| ||
|	|||| qd S )NzFinding 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   r7   r8   r   r   itemsZ	isroutineZunwrapr   r  r   r0   r9   r:   r   r   staticmethodclassmethod__func__r   )rj   r   r   r+   rC   r   r1   seentestZvalnamevalr,   r,   r-   r     sn    

  

 zDocTestFinder._findc           	   	   C   s   t |tr|}nJz,|jd kr"d}n|j}t |ts:t|}W n ttfk
rX   d}Y nX | ||}| jrt|std S |d krd }n.t|dd p|j}|dd  dkr|d d }| j	
|||||S )Nr   r   .pycrr   )r9   r:   __doc__rB   AttributeError_find_linenor   r0   r6   r   r   )	rj   r   r+   rC   r1   r   r   r   rT   r,   r,   r-   r    s,    




 zDocTestFinder._get_testc                 C   s  d }t |rd}t |rb|d kr(d S tdt|dd }t|D ]\}}||rF|} qbqFt |rr|j	}t 
|r|j}t |r|j}t |r|j}t |rt|dd d }|d k	r
|d kr|d S td}t|t|D ]}||| r|  S qd S )Nr"   z^\s*class\s*%s\br6   -co_firstlinenor&   z(^|.*:)\s*\w*("|\'))r7   r8   r   r[   r   r0   r   r   Zismethodr  r   __code__Zistracebacktb_frameZisframef_codeZiscoderanger)   )rj   r   r   r   Zpatr   r   r,   r,   r-   r  4  s>    




 
 
 
 



zDocTestFinder._find_lineno)NNNN)
r6   rp   rq   r   r   rv   r  r   r  r  r,   r,   r,   r-   r   .  s   	 

f?&c                   @   s   e Zd ZdZ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dZdddZd ddZd!ddZdd ZdS )"r   zF**********************************************************************Nr"   c                 C   sN   |pt  | _|d krdtjk}|| _|| _|| _d| _d| _i | _	t
 | _d S )N-vr"   )r   _checkerr>   r   r   optionflagsoriginal_optionflagstriesfailures_name2ftrg   _fakeout)rj   checkerr   r  r,   r,   r-   r     s    
zDocTestRunner.__init__c                 C   sH   | j rD|jr.|dt|j d t|j  n|dt|j d  d S )NzTrying:
zExpecting:
zExpecting nothing
)r   rw   r_   r   )rj   r   r
  exampler,   r,   r-   report_start  s    zDocTestRunner.report_startc                 C   s   | j r|d d S )Nzok
)r   rj   r   r
  r   rx   r,   r,   r-   report_success  s    zDocTestRunner.report_successc                 C   s&   ||  ||| j||| j  d S rl   )_failure_headerr  output_differencer  r"  r,   r,   r-   report_failure  s    zDocTestRunner.report_failurec                 C   s$   ||  ||d tt|  d S )NzException raised:
)r$  r_   rf   rj   r   r
  r   rd   r,   r,   r-   report_unexpected_exception  s
    
z)DocTestRunner.report_unexpected_exceptionc                 C   s   | j g}|jrR|jd k	r4|jd k	r4|j|j d }nd}|d|j||jf  n|d|jd |jf  |d |j}|t| d|S )Nr&   ?zFile "%s", line %s, in %szLine %s, in %szFailed example:rF   )DIVIDERrT   r   r   r+   r   r_   r   )rj   r
  r   r   r   r   r,   r,   r-   r$    s    
zDocTestRunner._failure_headerc              	   C   s  d }}| j }td\}}}	| jj}
t|jD ]6\}}| j t@ oH|dk}|| _ |jr|j D ],\}}|r||  j |O  _ q`|  j | M  _ q`| j t	@ rq.|d7 }|s| 
||| d|j|f }z,tt|j|d|d|j | j  d }W n4 tk
r    Y n   t }| j  Y nX | j }| jd |}|d kr`|
|j|| j r|}n|tj|d d  d }|s|t|7 }|jd kr|	}nB|
|j|| j r|}n*| j t@ r|
t|jt|| j r|}||kr|sR| |||| nT||kr(|s|  |||| |d7 }n*||	krR|sH| !|||| |d7 }n |r.| j t"@ r. qhq.|| _ | #||| t$||S )Nr"   rK   r&   z<doctest %s[%d]>Zsingler4   rr   )%r  r  r  check_outputr   r   r   r   r  r   r!  r+   execr   r   r1   debuggerr   KeyboardInterruptr>   rd   r  rc   rn   rw   ra   format_exception_onlyrf   r   r   r   r#  r&  r(  r   _DocTestRunner__record_outcomer%   )rj   r
  compileflagsr   r  r  r  SUCCESSFAILUREZBOOMZcheck
examplenumr   quietZ
optionflagr  rT   Z	exceptionrx   Zoutcomer   r,   r,   r-   Z__run  s    

 









zDocTestRunner.__runc                 C   sL   | j |jd\}}|| || f| j |j< |  j|7  _|  j|7  _d S )Nr   )r  r/   r+   r  r  )rj   r
  rW   tf2t2r,   r,   r-   Z__record_outcome|  s    zDocTestRunner.__record_outcomez.<doctest (?P<name>.+)\[(?P<examplenum>\d+)\]>$c                 C   sV   | j |}|rF|d| jjkrF| jjt|d }|jjddS | 	||S d S )Nr+   r4  Tkeepends)
%_DocTestRunner__LINECACHE_FILENAME_REr   r   r
  r+   r   intr   
splitlinessave_linecache_getlines)rj   rT   module_globalsr   r   r,   r,   r-   Z__patched_linecache_getlines  s
    z*DocTestRunner.__patched_linecache_getlinesTc           	   	      s  || _ |d krt|j}tj|d krVj  d ks@  dkrHj}n fdd}| jt_t	 }t
j}t| _| j  | jjt
_tj| _| jt_tj}tjt_z| |||W S t_|t
_t| | jt_|t_| r|j  dd l}d |_X d S )Nutf-8c                    s    t |  d } |  d S )Nbackslashreplace)r:   encodewrite)r]   rN   r   r,   r-   r     s    zDocTestRunner.run.<locals>.outr"   )r
  r3   r1   r>   r   rN   lowerrC  r  gettracer   r   r   r-  resetr   r   r>  *_DocTestRunner__patched_linecache_getlinesdisplayhook__displayhook__settraceclearbuiltins__DocTestRunner__run)	rj   r
  r1  r   clear_globsZ
save_traceZsave_set_traceZsave_displayhookrM  r,   rD  r-   run  s<    





zDocTestRunner.runc                 C   s  |d kr| j }g }g }g }d }}| j D ]V}|\}\}	}
||
7 }||	7 }|
dkr`|| q,|	dkrx|||
f q,|| q,|r|rtt|d |  |D ]}td| q|rtt|d |  |D ]\}}td||f  q|r:t| j tt|d |  |D ] \}\}	}
td|	|
|f  q|rft|dt| jd	 t|| d
|d |rztd|d n|rtd t||S )Nr"   zitems had no tests:z   zitems passed all tests:z %3d tests in %szitems had failures:z %3d of %3d in %sztests inzitems.z
passed andzfailed.z***Test Failed***z	failures.zTest passed.)	r   r  r  r   r  r)   r   r*  r%   )rj   r   ZnotestsZpassedZfailedZtotaltZtotalfr   r+   rW   r6  thingr   r,   r,   r-   	summarize  sP    
zDocTestRunner.summarizec                 C   sR   | j }|j  D ]<\}\}}||kr@|| \}}|| }|| }||f||< qd S rl   )r  r  )rj   r   dr+   rW   r6  r7  r8  r,   r,   r-   merge  s    zDocTestRunner.merge)NNr"   )N)NNT)N)r6   rp   rq   r*  r   r!  r#  r&  r(  r$  rO  r0  r[   r   r;  rH  rQ  rS  rU  r,   r,   r,   r-   r   h  s   :
$}



I
9c                   @   s,   e Zd Zdd Zdd Zdd Zdd Zd	S )
r   c                 C   s   t |dddS )NASCIIrA  )r:   rB  )rj   r]   r,   r,   r-   _toAscii(  s    zOutputChecker._toAsciic                 C   s   |  |}|  |}||kr dS |t@ sH||fdkr8dS ||fdkrHdS |t@ stdtt d|}tdd|}||krdS |t@ rd|	 }d|	 }||krdS |t
@ rt||rdS dS )	NT)zTrue
z1
)zFalse
z0
z(?m)^%s\s*?$r   z(?m)^[^\S\n]+$rZ   F)rW  r   r   r[   r\   escapeBLANKLINE_MARKERr   r   rt   r   r|   rj   rw   rx   r  r,   r,   r-   r+  .  s4    

 
zOutputChecker.check_outputc                 C   s<   |t tB tB @ sdS |t@ r dS |ddko:|ddkS )NFTrF   r4   )r	   r
   r   r   rZ  r,   r,   r-   _do_a_fancy_diffm  s    zOutputChecker._do_a_fancy_diffc           
      C   s(  |j }|t@ stdt|}| |||r|jdd}|jdd}|t@ rptj	||dd}t
|dd  }d}nZ|t@ rtj||dd}t
|dd  }d}n,|t@ rtjtjd}	t
|	||}d	}n d
| td| S |r|rdt|t|f S |rdt| S |r dt| S dS d S )Nz(?m)^[ ]*(?=
)Tr9  r4   )nz#unified diff with -expected +actualz-context diff with expected followed by actual)Zcharjunkzndiff with -expected +actualzDifferences (%s):
r   zExpected:
%sGot:
%szExpected:
%sGot nothing
zExpected nothing
Got:
%szExpected nothing
Got nothing
)rw   r   r[   r\   rY  r[  r=  r	   difflibZunified_difflistr
   Zcontext_diffr   ZDifferZIS_CHARACTER_JUNKZcomparer_   r   )
rj   r   rx   r  rw   r   Z	got_linesZdiffZkindZenginer,   r,   r-   r%    s4    zOutputChecker.output_differenceN)r6   rp   rq   rW  r+  r[  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 rl   )r
  r   rx   )rj   r
  r   rx   r,   r,   r-   r     s    zDocTestFailure.__init__c                 C   s
   t | jS rl   r:   r
  r   r,   r,   r-   __str__  s    zDocTestFailure.__str__Nr6   rp   rq   r   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 rl   )r
  r   rd   )rj   r
  r   rd   r,   r,   r-   r     s    zUnexpectedException.__init__c                 C   s
   t | jS rl   r_  r   r,   r,   r-   r`    s    zUnexpectedException.__str__Nra  r,   r,   r,   r-   r     s   c                   @   s&   e Zd Zd	ddZdd Zdd ZdS )
r   NTc                 C   s$   t | |||d}|r |j  |S )NF)r   rQ  r1   rL  )rj   r
  r1  r   rP  rr,   r,   r-   rQ  3  s    
zDebugRunner.runc                 C   s   t |||d S rl   )r   r'  r,   r,   r-   r(  9  s    z'DebugRunner.report_unexpected_exceptionc                 C   s   t |||d S rl   )r   r"  r,   r,   r-   r&  <  s    zDebugRunner.report_failure)NNT)r6   rp   rq   rQ  r(  r&  r,   r,   r,   r-   r     s   [
TFc	                 C   s   | d krt jd} t| s,td| f |d kr:| j}t|d}	|rVt||d}
nt	||d}
|	j
| |||dD ]}|
| qt|r|
  td kr|
an
t|
 t|
j|
jS )Nr   ztestmod: module required; %r)r   r   r  r1   r   )r>   r?   r/   r7   r8   rB   r6   r   r   r   rv   rQ  rS  masterrU  r%   r  r  )r   r+   r1   r   reportr  r   raise_on_errorr   finderrunnerr
  r,   r,   r-   r   H  s$    E


c                 C   s   |r|st dt| |||pd\}} |d kr:tj| }|d krHi }n| }|d k	rb|| d|krrd|d< |	rt||d}nt||d}|
	|||| d}|
| |r|  td kr|an
t| t|j|jS )N8Package may only be specified for module-relative paths.r@  r6   r   rc  r"   )r   rX   r   r   basenamer   r   r   r   r   rQ  rS  re  rU  r%   r  r  )rT   rV   r+   rU   r1   r   rf  r  r   rg  r   rN   textri  r
  r,   r,   r-   r     s2    R


NoNamec           	      C   s@   t |dd}t||d}|j| ||dD ]}|j||d q(d S )NF)r   r   rc  )r1   )r1  )r   r   rv   rQ  )	rW   r1   r   r+   r1  r  rh  ri  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)r2   oldr,   r,   r-   r   H  s
    
c                   @   sl   e Zd Z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jZdd ZdS )DocTestCaser"   Nc                 C   s.   t j|  || _|| _|| _|| _|| _d S rl   )unittestTestCaser   _dt_optionflags_dt_checker_dt_test	_dt_setUp_dt_tearDown)rj   r
  r  setUptearDownr  r,   r,   r-   r   n  s    zDocTestCase.__init__c                 C   s   | j }| jd k	r| | d S rl   )ru  rv  rj   r
  r,   r,   r-   rx  x  s    
zDocTestCase.setUpc                 C   s(   | j }| jd k	r| | |j  d S rl   )ru  rw  r1   rL  rz  r,   r,   r-   ry  ~  s    

zDocTestCase.tearDownc                 C   s~   | j }tj}t }| j}|t@ s(|tO }t|| jdd}z d|_	|j
||jdd\}}W 5 |t_X |rz| | | d S )NFr  r  r   zF----------------------------------------------------------------------)r   rP  )ru  r>   r   r#   rs  r   rn  r   rt  r*  rQ  rC  ZfailureExceptionformat_failurerc   )rj   r
  ro  newr  ri  r  r  r,   r,   r-   runTest  s(       zDocTestCase.runTestc                 C   sP   | j }|jd krd}n
d|j }d|jddd  }d|j|j|||f S )Nzunknown line numberz%sr   rr   z:Failed doctest test for %s
  File "%s", line %s, in %s

%s)ru  r   r   r+   rt   rT   )rj   errr
  r   Zlnamer,   r,   r-   r|    s    

zDocTestCase.format_failurec                 C   s6   |    t| j| jdd}|j| jdd |   d S )NFr{  )rP  )rx  r   rs  rt  rQ  ru  ry  )rj   ri  r,   r,   r-   r!     s    B zDocTestCase.debugc                 C   s   | j jS rl   ru  r+   r   r,   r,   r-   r     s    zDocTestCase.idc                 C   sP   t | t |k	rtS | j|jkoN| j|jkoN| j|jkoN| j|jkoN| j|jkS rl   )r   r   ru  rs  rv  rw  rt  r   r,   r,   r-   r     s    



zDocTestCase.__eq__c                 C   s   t | j| j| j| jfS rl   )r   rs  rv  rw  rt  r   r,   r,   r-   r     s    zDocTestCase.__hash__c                 C   s,   | j jd}d|d d|d d f S )Nr   z%s (%s)rr   )ru  r+   rt   r   )rj   r+   r,   r,   r-   r   	  s    zDocTestCase.__repr__c                 C   s   d| j j S )Nz	Doctest: r  r   r,   r,   r-   shortDescription		  s    zDocTestCase.shortDescription)r"   NNN)r6   rp   rq   r   rx  ry  r~  r|  r!   r   r   r   r   r   r`  r  r,   r,   r,   r-   rp  l  s     

H
rp  c                   @   s0   e Zd Zdd Zdd Zdd Zdd ZeZd	S )
SkipDocTestCasec                 C   s   || _ t| d  d S rl   )rC   rp  r   )rj   rC   r,   r,   r-   r   	  s    zSkipDocTestCase.__init__c                 C   s   |  d d S )Nz-DocTestSuite will not work with -O2 and above)ZskipTestr   r,   r,   r-   rx  	  s    zSkipDocTestCase.setUpc                 C   s   d S rl   r,   r   r,   r,   r-   	test_skip	  s    zSkipDocTestCase.test_skipc                 C   s   d| j j S )NzSkipping tests from %s)rC   r6   r   r,   r,   r-   r  	  s    z SkipDocTestCase.shortDescriptionN)r6   rp   rq   r   rx  r  r  r`  r,   r,   r,   r-   r  	  s
   r  c                   @   s   e Zd Zdd ZdS )_DocTestSuitec                 C   s   d S rl   r,   )rj   indexr,   r,   r-   _removeTestAtIndex	  s    z _DocTestSuite._removeTestAtIndexN)r6   rp   rq   r  r,   r,   r,   r-   r  	  s   r  c           	      K   s   |d krt  }t| } |j| ||d}|sNtjjdkrNt }|t|  |S |	  t }|D ]T}t
|jdkrtq`|js| j}|dd  dkr|d d }||_|t|f| q`|S )Nrd  r4   r"   r  r  rr   )r   rD   rv   r>   r2   optimizer  addTestr  r   r)   r   rT   r   rp  )	rC   r1   r   Ztest_finderr   r   suiter
  rT   r,   r,   r-   r   #	  s(    %c                   @   s$   e Zd Zdd Zdd Zdd ZdS )DocFileCasec                 C   s   d | jjdS )NrN  r   )r   ru  r+   rt   r   r,   r,   r-   r   e	  s    zDocFileCase.idc                 C   s   | j jS rl   )ru  rT   r   r,   r,   r-   r   h	  s    zDocFileCase.__repr__c                 C   s   d| j j| j j|f S )Nz2Failed doctest test for %s
  File "%s", line 0

%s)ru  r+   rT   )rj   r  r,   r,   r-   r|  k	  s    zDocFileCase.format_failureN)r6   rp   rq   r   r   r|  r,   r,   r,   r-   r  c	  s   r  c           
      K   sv   |d kri }n|  }|r&|s&tdt| |||p4d\}} d|krL| |d< tj| }||||| d}	t|	f|S )Nrj  r@  r   r"   )r   r   rX   r   r   rk  r   r  )
r   rV   rU   r1   r   rN   r   docr+   r
  r,   r,   r-   DocFileTestp	  s    r  c                  O   sD   t  }|ddr$t|d|d< | D ]}|t|f| q(|S )NrV   TrU   )r  r/   rD   r  r  )pathskwr  r   r,   r,   r-   r   	  s    8c                 C   s   g }t  | D ]x}t|trh||jd d  |j}|r|d |dd |dd d D 7 }q|dd |dd d D 7 }q|r|d dkr|  q|r|d dkr|d qd	|d S )	Nrr   z# Expected:c                 S   s   g | ]}d | qS )z## r,   r   r,   r,   r-   r   
  s     z(script_from_examples.<locals>.<listcomp>rF   c                 S   s   g | ]}t |qS r,   )r   r   r,   r,   r-   r   
  s   r}   r"   )
r   r   r9   r   r   r   rw   rt   popr   )r]   r   Zpiecerw   r,   r,   r-   r   	  s     :

"

c                    sJ   t | } t | } fdd|D }|s4t d|d }t|j}|S )Nc                    s   g | ]}|j  kr|qS r,   r*   )r   r6  r*   r,   r-   r   .
  s     
 ztestsource.<locals>.<listcomp>znot found in testsr"   )rD   r   rv   r   r   r   )rC   r+   r   r
  testsrcr,   r*   r-   r   %
  s    

c                 C   s   t | }t||| d S rl   )r   debug_script)srcpmr1   r  r,   r,   r-   r    5
  s    c                 C   s   dd l }|r| }ni }|rvzt| || W q   tt d  |jdd}|  |d t d  Y qX n|jdd	d|  || d S )Nr"   r&   T)r   r4   zexec(%r))
r   r   r,  r  r>   rd   r   rG  ZinteractionrQ  )r  r  r1   r   pr,   r,   r-   r  :
  s    
r  c                 C   s$   t | } t| |}t||| j d S rl   )rD   r   r  r   )rC   r+   r  r  r,   r,   r-   r!   N
  s    
c                   @   s$   e Zd Zdd Zdd Zdd ZdS )
_TestClassc                 C   s
   || _ d S rl   r  )rj   r  r,   r,   r-   r   j
  s    z_TestClass.__init__c                 C   s   | j d | _ | S )Nr4   r  r   r,   r,   r-   squaret
  s    z_TestClass.squarec                 C   s   | j S rl   r  r   r,   r,   r-   r/   ~
  s    z_TestClass.getN)r6   rp   rq   r   r  r/   r,   r,   r,   r-   r  \
  s   

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 <BLANKLINE>:
                    >>> print('foo\n\nbar\n')
                    foo
                    <BLANKLINE>
                    bar
                    <BLANKLINE>
            z
                If the ellipsis flag is used, then '...' can be used to
                elide substrings in the desired output:
                    >>> print(list(range(1000))) #doctest: +ELLIPSIS
                    [0, 1, 2, ..., 999]
            a  
                If the whitespace normalization flag is used, then
                differences in whitespace are ignored.
                    >>> print(list(range(30))) #doctest: +NORMALIZE_WHITESPACE
                    [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14,
                     15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26,
                     27, 28, 29]
            )r  r   zbool-int equivalencezblank linesZellipsiszwhitespace normalizationc                  C   s"  dd l } | jdd}|jdddddd	 |jd
ddt g dd |jddddd |jdddd | }|j}|j}d}|jD ]}|t| O }q|j	r|t
O }|D ]v}|drtj|\}}tjd| t|d d }	tjd= t|	||d\}
}nt|d||d\}
}|
r dS qdS )Nr"   zdoctest runner)Zdescriptionr  z	--verbose
store_trueFz'print very verbose output for all tests)actiondefaulthelpz-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`   r   z file containing the tests to run)nargsr  z.pyrc  )rV   r   r  r&   )argparseArgumentParseradd_argumentr'   keys
parse_argsr`   r   r   Z	fail_fastr   ri   r   r   rt   r>   insertr;   r   r   )r  r   r   Z	testfilesr   r   r   rT   dirnamer   r  rN  r,   r,   r-   _test
  sL    
 


 
r  r   )r4   )rY   )	NNNNTr"   NFF)Frm  Nr"   )NNNN)FN)FN)F)RZ__docformat____all__r.   r]  r7   r   r   r   r[   r>   ra   rq  ior#   collectionsr$   r%   r'   r   r   r   r   r   r   r   r   r	   r
   r   r   r   r   rY  rs   r3   rD   rJ   rX   r_   rf   rg   r|   r   r   r   r   rO   r   r   r   r   r   r   	Exceptionr   r   r   re  r   r   r   rn  r   rr  rp  r  Z	TestSuiter  r   r  r  r   r   r   r    r  r!   r  r  r  r6   exitr,   r,   r,   r-   <module>0   sD  -


1%.DK l  <   ; n         
h     
{    
$ !
@ 
IR


,	3-
