<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/css/bootstrap.min.css" rel="stylesheet"
        integrity="sha384-GLhlTQ8iRABdZLl6O3oVMWSktQOp6b7In1Zl3/Jr59b6EGGoI1aFkw7cmDA6j6gD" crossorigin="anonymous">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.3.0/css/all.min.css"
        integrity="sha512-SzlrxWUlpfuzQ+pcUCosxcglQRNAq/DZjVsC0lE40xsADsfeQoEypE+enwcOiGjk/bSuGGKHEyjSoQ1zVisanQ=="
        crossorigin="anonymous" referrerpolicy="no-referrer" />
</head>
</html>
B
    YI~dp             !   @   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+   ,/opt/alt/python37/lib64/python3.7/doctest.pyr      s    z<BLANKLINE>z...c             C   s<   d}x2t jD ](}| |d }|tt |kr||jO }qW |S )Nr"   )
__future__Zall_feature_namesgetgetattrZcompiler_flag)globsflagsZfnameZfeaturer+   r+   r,   _extract_future_flags   s    r2      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)moduledepthr+   r+   r,   _normalize_module   s    


rD   c             C   s   xdD ]}|  |d} qW | S )N)z

)replace)datanewliner+   r+   r,   _newline_convert   s    
rJ   c          	   C   sz   |rVt |d}t|| } t|dd d k	rVt|jdrV|j| }||}t|| fS t| |d}|	 | fS Q R X d S )N   
__loader__get_data)encoding)
rD   _module_relative_pathr/   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)ri   sizer+   r+   r,   rl   	  s    
z_SpoofOut.truncate)N)r5   
__module____qualname__rc   rl   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 x2|D ]*}||||}|dk rdS |t|7 }qW dS )Nr"   FT)ELLIPSIS_MARKERsplitr)   
startswithrh   find)wantgotZwsstartposendposwr+   r+   r,   _ellipsis_match  s0    



rz   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)   rt   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)ri   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)ri   framer+   r+   r,   r   o  s    
z_OutputRedirectingPdb.set_tracec             C   s   | j rtj|  d S )N)r   r   r   set_continue)ri   r+   r+   r,   r   u  s    z"_OutputRedirectingPdb.set_continuec             G   s.   t j}| jt _ztjj| f| S |t _X d S )N)r=   r   r   r   r   trace_dispatch)ri   argssave_stdoutr+   r+   r,   r   {  s
    z$_OutputRedirectingPdb.trace_dispatch)N)r5   rn   ro   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rx,| jD ]"}tj||}tj|r|S qW t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__))r6   r7   rA   rs   
ValueErrorospathjoinrr   rP   r   r5   r)   r=   argvcurdirr   exists)rB   Z	test_pathZbasedirZ	directoryZ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 )NrF   )rh   sourceru   linenor^   optionsexc_msg)ri   r   ru   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 )N)typeNotImplementedr   ru   r   r^   r   r   )ri   otherr+   r+   r,   __eq__  s    zExample.__eq__c             C   s   t | j| j| j| j| jfS )N)hashr   ru   r   r^   r   )ri   r+   r+   r,   __hash__  s    zExample.__hash__)Nr"   r"   N)r5   rn   ro   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 )N)examples	docstringcopyr0   r*   rT   r   )ri   r   r0   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__r5   r*   rT   r   )ri   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 )N)r   r   r   r   r0   r*   rT   r   )ri   r   r+   r+   r,   r   )  s    zDocTest.__eq__c             C   s   t | j| j| j| jfS )N)r   r   r*   rT   r   )ri   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 )N)r8   r   r   r*   rT   r   id)ri   r   r+   r+   r,   __lt__8  s    
zDocTest.__lt__N)r5   rn   ro   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\}}x| j|D ]}||||   ||d|| 7 }| 	|||\}}}	}
| 
|s|t||	|
| t|d |d ||d| | 7 }| }qRW |||d   |S )Nr"   rF   c                s   g | ]}| d  qS )Nr+   ).0l)
min_indentr+   r,   
<listcomp>  s    z'DocTestParser.parse.<locals>.<listcomp>)r"   r"   r^   )r   r^   r   )
expandtabs_min_indentr   rr   _EXAMPLE_REfinditerappendr   count_parse_example_IS_BLANK_OR_COMMENTr   r)   groupr   )ri   stringr*   outputZcharnor   mr   r   ru   r   r+   )r   r,   parses  s&    


zDocTestParser.parsec             C   s   t | |||||||S )N)r   get_examples)ri   r   r0   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+   )r8   r   )r   xr+   r+   r,   r     s    z.DocTestParser.get_examples.<locals>.<listcomp>)r   )ri   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   sl)r^   r+   r,   r     s    z0DocTestParser._parse_example.<locals>.<listcomp>ru   z *$rp   c                s   g | ]}| d  qS )Nr+   )r   Zwl)r^   r+   r,   r     s    r   )
r)   r   rr   _check_prompt_blank_check_prefixr   r[   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 |D ]z}|ddd }x^|D ]V}|d dksR|dd  tkrhtd|d ||f t|dd   }|d dk||< q2W qW |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   rr   r'   r   r   )	ri   r   r*   r   r   r   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)ri   r]   indentsr+   r+   r,   r     s    zDocTestParser._min_indentc          	   C   sb   x\t |D ]P\}}t||d kr
||d  dkr
td|| d ||||d  |f q
W d S )NrY   rK   rZ   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   sB   x<t |D ]0\}}|r
||s
td|| d ||f q
W d 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    zDocTestParser._check_prefixN)r   )r   )r5   rn   ro   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 )N)_parser_verbose_recurse_exclude_empty)ri   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|}y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 )Nr5   zJDocTestFinder.find: name must be given when obj.__name__ doesn't exist: %rFr"   z<]>r   )r/   r   r   r6   	getmoduleZgetsourcefilerA   Zgetfile	linecachegetlines__dict__r   update_findsort)	ri   objr*   rB   r0   
extraglobsr`   r   testsr+   r+   r,   rt   M  sJ    $


 



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__rn   z"object must be a class or function)r6   r   
isfunctionr   __globals__ZismethoddescriptorrP   r   rn   r5   isclassr8   propertyr   )ri   rB   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rx^|j	 D ]P\}	}
d||	f }	t
t|
st|
rn| ||
rn| ||
|	|||| qnW t|rv| jrvxt|di 	 D ]\}	}
t|	tstdt|	f t
|
sPt|
sPt|
sPt|
tsPtdt|
f d||	f }	| ||
|	|||| qW t|r&| jr&x|j	 D ]\}	}
t|
trt||	}
t|
trt||	j}
t
|
st|
st|
tr| ||
rd||	f }	| ||
|	|||| qW d 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   r6   r7   r   r   itemsZ	isroutineZunwrapr   r   r   r/   r8   r9   r   r   staticmethodclassmethod__func__r   )ri   r   r   r*   rB   r   r0   seentestZvalnamevalr+   r+   r,   r     sP    


zDocTestFinder._findc       	   	   C   s   t |tr|}nJy,|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   z.pycrp   )r8   r9   __doc__rA   AttributeError_find_linenor   r/   r5   r   r   )	ri   r   r*   rB   r0   r   r   r   rT   r+   r+   r,   r     s(    




zDocTestFinder._get_testc             C   s  d }t |rd}t |rd|d kr(d S tdt|dd }x$t|D ]\}}||rH|}P qHW t |rt|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}x(t|t|D ]}||| r|S qW d S )Nr"   z^\s*class\s*%s\br5   -co_firstlinenor&   z(^|.*:)\s*\w*("|\'))r6   r7   r   r[   r   r/   r   r   Zismethodr  r   __code__Zistracebacktb_frameZisframef_codeZiscoderanger)   )ri   r   r   r   Zpatr   r}   r+   r+   r,   r	  4  s<    



 
 
 
 


zDocTestFinder._find_lineno)NNNN)
r5   rn   ro   r   r   rt   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 )Nz-vr"   )r   _checkerr=   r   r   optionflagsoriginal_optionflagstriesfailures_name2ftrg   _fakeout)ri   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   ru   r_   r   )ri   r   r  exampler+   r+   r,   report_start  s     zDocTestRunner.report_startc             C   s   | j r|d d S )Nzok
)r   )ri   r   r  r  rv   r+   r+   r,   report_success  s    zDocTestRunner.report_successc             C   s&   ||  ||| 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$   ||  ||d tt|  d S )NzException raised:
)r  r_   rf   )ri   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   )ri   r  r  r   r   r   r+   r+   r,   r    s    
zDocTestRunner._failure_headerc          	   C   s  d }}| j }td\}}}	| jj}
xFt|jD ]6\}}| j t@ oL|dk}|| _ |jrx:|j D ],\}}|r|  j |O  _ qf|  j | M  _ qfW | j t	@ rq2|d7 }|s| 
||| d|j|f }y,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rh|
|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|sZ| |||| nT||kr0|s&|  |||| |d7 }n*||	krZ|sP| !|||| |d7 }n |r2| j t"@ r2P q2W || _ | #||| t$||S )Nr"   rK   r&   z<doctest %s[%d]>Zsingler3   rp   )%r  r  r  check_outputr   r   r   r   r   r   r  r*   execr   r   r0   debuggerr   KeyboardInterruptr=   rd   r  rc   rl   ru   ra   format_exception_onlyrf   r   r   r   r  r  r  r   _DocTestRunner__record_outcomer%   )ri   r  compileflagsr   r  r  r  SUCCESSFAILUREZBOOMZcheck
examplenumr  quietZ
optionflagr  rT   Z	exceptionrv   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 )N)r"   r"   )r  r.   r*   r  r  )ri   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*   r*  T)keepends)
%_DocTestRunner__LINECACHE_FILENAME_REr   r   r  r*   r   intr   
splitlinessave_linecache_getlines)ri   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| |||S t_|t
_t| | jt_|t_|r|j  dd l}d |_X d S )Nzutf-8c                s    t |  d } |  d S )Nbackslashreplace)r9   encodewrite)r]   )rN   r   r+   r,   r     s    zDocTestRunner.run.<locals>.outr"   )r  r2   r0   r=   r   rN   lowerr7  r  gettracer   r   r   r#  resetr   r   r3  *_DocTestRunner__patched_linecache_getlinesdisplayhook__displayhook___DocTestRunner__runsettraceclearbuiltins_)	ri   r  r'  r   clear_globsZ
save_traceZsave_set_traceZsave_displayhookrA  r+   )rN   r   r,   run  s<    





zDocTestRunner.runc             C   s  |d kr| j }g }g }g }d }}xd| j D ]V}|\}\}	}
||
7 }||	7 }|
dkrb|| q.|	dkrz|||
f q.|| q.W |r|rtt|d |  x|D ]}td| qW |rtt|d |  x |D ]\}}td||f  qW |rJt| j tt|d |  x(|D ] \}\}	}
td|	|
|f  q&W |rvt|dt| jd	 t|| d
|d |rt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%   )ri   r   ZnotestsZpassedZfailedZtotaltZtotalfr   r*   rW   r,  thingr   r+   r+   r,   	summarize  sP    

zDocTestRunner.summarizec             C   sV   | j }xJ|j  D ]<\}\}}||krB|| \}}|| }|| }||f||< qW d S )N)r  r   )ri   r   dr*   rW   r,  r-  r.  r+   r+   r,   merge  s    zDocTestRunner.merge)NNr"   )N)NNT)N)r5   rn   ro   r   r   r  r  r  r  r  r>  r&  r[   r   r0  r;  rD  rF  rH  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ASCIIr5  )r9   r6  )ri   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)rJ  r   r   r[   r\   escapeBLANKLINE_MARKERr   r   rr   r   rz   )ri   ru   rv   r  r+   r+   r,   r!  .  s0    


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   r3   )r	   r
   r   r   )ri   ru   rv   r  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)^[ ]*(?=
)T)r/  r3   )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
)ru   r   r[   r\   rL  rM  r2  r	   difflibZunified_difflistr
   Zcontext_diffr   ZDifferZIS_CHARACTER_JUNKZcomparer_   r   )
ri   r  rv   r  ru   r   Z	got_linesZdiffkindZenginer+   r+   r,   r    s4    zOutputChecker.output_differenceN)r5   rn   ro   rJ  r!  rM  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    zDocTestFailure.__init__c             C   s
   t | jS )N)r9   r  )ri   r+   r+   r,   __str__  s    zDocTestFailure.__str__N)r5   rn   ro   r   rR  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  rd   )ri   r  r  rd   r+   r+   r,   r     s    zUnexpectedException.__init__c             C   s
   t | jS )N)r9   r  )ri   r+   r+   r,   rR    s    zUnexpectedException.__str__N)r5   rn   ro   r   rR  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   rD  r0   r@  )ri   r  r'  r   rC  rr+   r+   r,   rD  3  s    
zDebugRunner.runc             C   s   t |||d S )N)r   )ri   r   r  r  rd   r+   r+   r,   r  9  s    z'DebugRunner.report_unexpected_exceptionc             C   s   t |||d S )N)r   )ri   r   r  r  rv   r+   r+   r,   r  <  s    zDebugRunner.report_failure)NNT)r5   rn   ro   rD  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}
x$|	j
| |||dD ]}|
| qvW |r|
  td kr|
an
t|
 t|
j|
jS )Nr   ztestmod: module required; %r)r   )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   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 )Nz8Package may only be specified for module-relative paths.zutf-8r5   r   )r   r  r"   )r   rX   r   r   basenamer   r   r   r   r   rD  rF  rT  rH  r%   r  r  )rT   rV   r*   rU   r0   r   rU  r  r   rV  r   rN   textrX  r  r+   r+   r,   r     s0    R


NoNamec       	      C   sD   t |dd}t||d}x&|j| ||dD ]}|j||d q*W d S )NF)r   r   )r   r  )r0   )r'  )r   r   rt   rD  )	rW   r0   r   r*   r'  r  rW  rX  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   H  s
    
c               @   sj   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Zdd ZdS )DocTestCaser"   Nc             C   s.   t j|  || _|| _|| _|| _|| _d S )N)unittestTestCaser   _dt_optionflags_dt_checker_dt_test	_dt_setUp_dt_tearDown)ri   r  r  setUptearDownr  r+   r+   r,   r   n  s    zDocTestCase.__init__c             C   s   | j }| jd k	r| | d S )N)rc  rd  )ri   r  r+   r+   r,   rf  x  s    
zDocTestCase.setUpc             C   s(   | j }| jd k	r| | |j  d S )N)rc  re  r0   r@  )ri   r  r+   r+   r,   rg  ~  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 d |t_X |rz| | | d S )NF)r  r  r   zF----------------------------------------------------------------------)r   rC  )rc  r=   r   r#   ra  r   r\  r   rb  r   rD  r7  ZfailureExceptionformat_failurerc   )ri   r  r]  newr  rX  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   rp   z:Failed doctest test for %s
  File "%s", line %s, in %s

%s)rc  r   r   r*   rr   rT   )ri   errr  r   Zlnamer+   r+   r,   rh    s    

zDocTestCase.format_failurec             C   s6   |    t| j| jdd}|j| jdd |   d S )NF)r  r  r   )rC  )rf  r   ra  rb  rD  rc  rg  )ri   rX  r+   r+   r,   r!     s
    BzDocTestCase.debugc             C   s   | j jS )N)rc  r*   )ri   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 )N)r   r   rc  ra  rd  re  rb  )ri   r   r+   r+   r,   r     s    zDocTestCase.__eq__c             C   s   t | j| j| j| jfS )N)r   ra  rd  re  rb  )ri   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)rp   )rc  r*   rr   r   )ri   r*   r+   r+   r,   r   	  s    zDocTestCase.__repr__c             C   s   d| j j S )Nz	Doctest: )rc  r*   )ri   r+   r+   r,   shortDescription		  s    zDocTestCase.shortDescription)r"   NNN)r5   rn   ro   r   rf  rg  rj  rh  r!   r   r   r   r   rR  rl  r+   r+   r+   r,   r^  l  s    
	H
r^  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 )N)rB   r^  r   )ri   rB   r+   r+   r,   r   	  s    zSkipDocTestCase.__init__c             C   s   |  d d S )Nz-DocTestSuite will not work with -O2 and above)ZskipTest)ri   r+   r+   r,   rf  	  s    zSkipDocTestCase.setUpc             C   s   d S )Nr+   )ri   r+   r+   r,   	test_skip	  s    zSkipDocTestCase.test_skipc             C   s   d| j j S )NzSkipping tests from %s)rB   r5   )ri   r+   r+   r,   rl  	  s    z SkipDocTestCase.shortDescriptionN)r5   rn   ro   r   rf  rn  rl  rR  r+   r+   r+   r,   rm  	  s
   rm  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   rq  r+   r+   r+   r,   ro  	  s   ro  c       	      K   s   |d krt  }t| } |j| ||d}|sNtjjdkrNt }|t|  |S |	  t }x\|D ]T}t
|jdkrvqb|js| j}|dd  dkr|d d }||_|t|f| qbW |S )N)r0   r   r3   r"   r  z.pycrp   )r   rD   rt   r=   r1   optimizero  addTestrm  r   r)   r   rT   r   r^  )	rB   r0   r   Ztest_finderr   r   suiter  rT   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dS )NrB  r   )r   rc  r*   rr   )ri   r+   r+   r,   r   e	  s    zDocFileCase.idc             C   s   | j jS )N)rc  rT   )ri   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)rc  r*   rT   )ri   rk  r+   r+   r,   rh  l	  s    zDocFileCase.format_failureN)r5   rn   ro   r   r   rR  rh  r+   r+   r+   r,   ru  c	  s   ru  c       
      K   sv   |d kri }n|  }|r&|s&tdt| |||p4d\}} d|krL| |d< tj| }||||| d}	t|	f|S )Nz8Package may only be specified for module-relative paths.zutf-8r   r"   )r   r   rX   r   r   rY  r   ru  )
r   rV   rU   r0   r   rN   r   docr*   r  r+   r+   r,   DocFileTestq	  s    rw  c              O   sH   t  }|ddr$t|d|d< x| D ]}|t|f| q*W |S )NrV   TrU   )ro  r.   rD   rs  rw  )pathskwrt  r   r+   r+   r,   r   	  s    8
c             C   s   g }xt  | D ]x}t|trj||jd d  |j}|r|d |dd |dd d D 7 }q|dd |dd d D 7 }qW x|r|d dkr|  qW x|r|d dkr|d qW d	|d S )	Nrp   z# Expected:c             S   s   g | ]}d | qS )z## r+   )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,   r   
  s   r{   r"   )
r   r   r8   r   r   r   ru   rr   popr   )r]   r   Zpieceru   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   r,  )r*   r+   r,   r   /
  s    ztestsource.<locals>.<listcomp>znot 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)srcpmr0   r{  r+   r+   r,   r    6
  s    c             C   s   dd l }|r| }ni }|rvy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   r3   zexec(%r))
r   r   r"  r   r=   rd   r   r:  ZinteractionrD  )r}  r~  r0   r   pr+   r+   r,   r|  ;
  s    
r|  c             C   s$   t | } t| |}t||| j d S )N)rD   r   r|  r   )rB   r*   r~  r{  r+   r+   r,   r!   O
  s    
c               @   s$   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   k
  s    z_TestClass.__init__c             C   s   | j d | _ | S )Nr3   )r  )ri   r+   r+   r,   squareu
  s    z_TestClass.squarec             C   s   | j S )N)r  )ri   r+   r+   r,   r.   
  s    z_TestClass.getN)r5   rn   ro   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}x|jD ]}|t| O }qW |j	r|t
O }x~|D ]v}|drtj|\}}tjd| t|d d }	tjd= t|	||d\}
}nt|d||d\}
}|
rdS qW dS )Nr"   zdoctest runner)descriptionz-vz	--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.py)r   r  )rV   r   r  r&   )argparseArgumentParseradd_argumentr'   keys
parse_argsr`   r   r   Z	fail_fastr   rh   r   r   rr   r=   insertr:   r   r   )r  r   r   Z	testfilesr   r   r   rT   dirnamer   r  rB  r+   r+   r,   _test
  s>    


r  r   )r3   )rY   )	NNNNTr"   NFF)Fr[  Nr"   )NNNN)FN)FN)F)RZ__docformat____all__r-   rO  r6   r   r   r   r[   r=   ra   r_  ior#   collectionsr$   r%   r'   r   r   r   r   r   r   r   r   r	   r
   r   r   r   r   rL  rq   r2   rD   rJ   rX   r_   rf   rg   rz   r~   r   r   r   rO   r   r   r   r   r   r   	Exceptionr   r   r   rT  r   r   r   r\  r   r`  r^  rm  Z	TestSuitero  r   ru  rw  r   r   r   r    r|  r!   r  r   r  r5   exitr+   r+   r+   r,   <module>0   s  


1%.DK l  <   ; n  
fx 
$ !
@IR


,		-
