§
    _÷#d‡W  ã                   ó  — d 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 ddl	m
Z
mZmZmZmZmZmZmZmZmZmZ ddlmZ ddlmZmZmZ ddlmZ dd	lmZmZ dd
l m!Z! ddl"Z"ddl#m$Z$ ddl%m&Z& ddl'm(Z( ddl)m*Z* ddl+m,Z, ddl-m.Z. ddl/m0Z0 e
rddl1m2Z2  e(j3        e4¦  «        Z5 ej6        dej7        ¦  «        Z8 ej6        dej7        ¦  «        Z9de:de:de;fd„Z< G d„ de,¦  «        Z= G d„ de=¦  «        Z> G d„ de=¦  «        Z? G d„ d e=¦  «        Z@ G d!„ d"e=¦  «        ZA G d#„ d$e=¦  «        ZB ejC        ¦   «         ZD G d%„ d&¦  «        ZE G d'„ d(¦  «        ZF G d)„ d*ejG        ¦  «        ZH G d+„ d,e$¦  «        ZId-d.dee:ef         fd/„ZJdS )0zfMimic doctest in Sphinx.

The extension automatically execute code snippets and checks their results.
é    N)ÚStringIO)Úpath)ÚTYPE_CHECKINGÚAnyÚCallableÚDictÚIterableÚListÚOptionalÚSequenceÚSetÚTupleÚType)Únodes)ÚElementÚNodeÚTextElement)Ú
directives)ÚInvalidSpecifierÚSpecifierSet)ÚVersion)ÚBuilder)Ú__)Úlogging)Úbold)ÚSphinxDirective)Úrelpath)Ú
OptionSpec)ÚSphinxz^\s*<BLANKLINE>z#\s*doctest:.+$ÚspecÚversionÚreturnc                 ó>   — t          |¦  «        t          | ¦  «        v S )aY  Check `spec` satisfies `version` or not.

    This obeys PEP-440 specifiers:
    https://peps.python.org/pep-0440/#version-specifiers

    Some examples:

        >>> is_allowed_version('<=3.5', '3.3')
        True
        >>> is_allowed_version('<=3.2', '3.3')
        False
        >>> is_allowed_version('>3.2, <4.0', '3.3')
        True
    )r   r   )r    r!   s     ú4/usr/lib/python3/dist-packages/sphinx/ext/doctest.pyÚis_allowed_versionr%   (   s   € õ �7ÑÔ�|¨DÑ1Ô1Ð1Ð1ó    c                   ó:   — e Zd ZdZdZdZdZdZdee	         fd„Z
dS )ÚTestDirectivez4
    Base class for doctest-related directives.
    Tr   é   r"   c                 óÚ  — d                      | j        ¦  «        }d }| j        dk    rcd|v r|}t                               d|¦  «        }t
                               |¦  «        r(d| j        vr|s|}t
                               d|¦  «        }t          j	        }| j        dv s	d| j        v rt          j
        }| j        r+d„ | j        d	                              d
¦  «        D ¦   «         }ndg} |||| j        |¬¦  «        }|                      |¦  «         |�||d<   | j        dk    rd|d<   n!| j        dk    rd|d<   n| j        dk    rd|d<   i |d<   | j        dv �rd| j        v �r| j        d                              d
d¦  «                             ¦   «         }|D ]Í}|d	         |dd …         }	}|dvr<| j        j        j                             t'          d¦  «        |z  | j        ¬¦  «         ŒT|	t*          j        vr<| j        j        j                             t'          d¦  «        |	z  | j        ¬¦  «         Œžt*          j        |dd …                  }
|d	         dk    |d         |
<   ŒÎ| j        dk    rÁd| j        v r¸	 | j        d         }d                      d„ t.          j        d d …         D ¦   «         ¦  «        }t3          ||¦  «        st*          j        d!         }
d"|d         |
<   nK# t4          $ r> | j        j        j                             t'          d#¦  «        |z  | j        ¬¦  «         Y nw xY wd$| j        v r| j        d$         |d$<   d%| j        v rd"|d&<   nd| j        v rd'|d&<   |gS )(Nú
Údoctestz<BLANKLINE>Ú úno-trim-doctest-flags)Ú	testsetupÚtestcleanupÚhidec                 ó6   — g | ]}|                      ¦   «         ‘ŒS © )Ústrip)Ú.0Úxs     r$   ú
<listcomp>z%TestDirective.run.<locals>.<listcomp>X   s    € ÐFÐFÐF A�a—g’g‘i”iÐFÐFÐFr&   r   ú,Údefault)ÚtestnodetypeÚgroupsÚtestÚpyconÚlanguageÚtestcodeÚpythonÚ
testoutputÚnoneÚoptions)r,   rA   ú r)   z+-z"missing '+' or '-' in '%s' option.)Úlinez'%s' is not a valid option.ú+Ú	pyversionú.c                 ó,   — g | ]}t          |¦  «        ‘ŒS r3   )Ústr)r5   Úvs     r$   r7   z%TestDirective.run.<locals>.<listcomp>|   s   € Ð*PÐ*PÐ*P°a­3¨q©6¬6Ð*PÐ*PÐ*Pr&   é   ÚSKIPTz$'%s' is not a valid pyversion optionÚskipifútrim-doctest-flagsÚ
trim_flagsF)ÚjoinÚcontentÚnameÚblankline_reÚsubÚdoctestopt_reÚsearchrC   r   Úliteral_blockÚcommentÚ	argumentsÚsplitÚset_source_infoÚreplaceÚstateÚdocumentÚreporterÚwarningr   Úlinenor,   ÚOPTIONFLAGS_BY_NAMEÚsysÚversion_infor%   r   )ÚselfÚcoder<   Únodetyper;   ÚnodeÚoption_stringsÚoptionÚprefixÚoption_nameÚflagr    Úpython_versions                r$   ÚrunzTestDirective.runF   sñ  € ð �yŠy˜œÑ&Ô&ˆØˆØŒ9˜	Ò!Ð!Ø Ð$Ð$à�Ý#×'Ò'¨¨DÑ1Ô1�Ý×#Ò# DÑ)Ô)ð 3Ð.EÈTÌ\Ð.YÐ.YØð  Ø�DÝ$×(Ò(¨¨TÑ2Ô2�Ý&+Ô&9ˆØŒ9Ð4Ð4Ð4¸À$Ä,Ð8NÐ8NÝ”}ˆHØŒ>ð 	!ØFÐF¨¬¸Ô):×)@Ò)@ÀÑ)EÔ)EÐFÑFÔFˆFˆFà�[ˆFØˆx˜˜d°´À6ÐJÑJÔJˆØ×Ò˜TÑ"Ô"Ð"ØÐàˆD�‰LØŒ9˜	Ò!Ð!Ø&ˆD�ÑÐØŒY˜*Ò$Ð$Ø'ˆD�ÑÐØŒY˜,Ò&Ð&à%ˆD�ÑØˆˆY‰ØŒ9Ð1Ð1Ñ1°iÀ4Ä<Ð6OÑ6Oà!œ\¨)Ô4×<Ò<¸SÀ#ÑFÔF×LÒLÑNÔNˆNØ(ð ;ð ;�Ø&,¨Q¤i°¸¸¸´˜�Ø Ð%Ð%Ø”JÔ'Ô0×8Ò8ÝÐ?Ñ@Ô@À6ÑIØ!œ[ð 9ñ *ô *ð *ð Ø¥gÔ&AÐAÐAØ”JÔ'Ô0×8Ò8ÝÐ8Ñ9Ô9¸KÑGØ!œ[ð 9ñ *ô *ð *ð ÝÔ2°6¸!¸"¸"´:Ô>�Ø)/°¬°cÒ)9��Y” Ñ%Ð%ØŒ9˜	Ò!Ð! k°T´\Ð&AÐ&Að	&Ø”| KÔ0�Ø!$§¢Ð*PÐ*P½3Ô;KÈBÈQÈBÔ;OÐ*PÑ*PÔ*PÑ!QÔ!Q�Ý)¨$°Ñ?Ô?ð 1Ý"Ô6°vÔ>�DØ,0�D˜”O DÑ)øøÝ#ð &ð &ð &Ø”
Ô#Ô,×4Ò4ÝÐ=Ñ>Ô>ÀÑEØœð 5ñ &ô &ð &ð &ð &ð&øøøð �t”|Ð#Ð#Ø!œ\¨(Ô3ˆD�‰NØ 4¤<Ð/Ð/Ø!%ˆD�ÑÐØ$¨¬Ð4Ð4Ø!&ˆD�ÑØˆvˆs   É=A+K) Ë)AL1Ì0L1N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Úhas_contentÚrequired_argumentsÚoptional_argumentsÚfinal_argument_whitespacer
   r   rp   r3   r&   r$   r(   r(   <   s]   € € € € € ðð ð €KØÐØÐØ $ÐðD�T˜$”Zð Dð Dð Dð Dð Dð Dr&   r(   c                   ó,   — e Zd ZU dej        iZeed<   dS )ÚTestsetupDirectiverN   Úoption_specN©rq   rr   rs   r   Úunchanged_requiredr{   r   Ú__annotations__r3   r&   r$   rz   rz   �   ó6   € € € € € € à�*Ô/ð€K�ð ð ñ ð ð r&   rz   c                   ó,   — e Zd ZU dej        iZeed<   dS )ÚTestcleanupDirectiverN   r{   Nr|   r3   r&   r$   r�   r�   “   r   r&   r�   c                   óh   — e Zd ZU ej        ej        ej        ej        ej        ej        dœZee	d<   dS )ÚDoctestDirective©r1   r.   rC   rG   rN   rO   r{   N©
rq   rr   rs   r   rn   Ú	unchangedr}   r{   r   r~   r3   r&   r$   rƒ   rƒ   ™   óT   € € € € € € à”Ø!+¤ØÔ'ØÔ2ØÔ/Ø(œoðð €K�ð ð ñ ð ð r&   rƒ   c                   ó\   — e Zd ZU ej        ej        ej        ej        ej        dœZeed<   dS )ÚTestcodeDirective)r1   r.   rG   rN   rO   r{   N)	rq   rr   rs   r   rn   r}   r{   r   r~   r3   r&   r$   r‰   r‰   ¤   sN   € € € € € € à”Ø!+¤ØÔ2ØÔ/Ø(œoðð €K�ð ð ñ ð ð r&   r‰   c                   óh   — e Zd ZU ej        ej        ej        ej        ej        ej        dœZee	d<   dS )ÚTestoutputDirectiver„   r{   Nr…   r3   r&   r$   r‹   r‹   ®   r‡   r&   r‹   c                   ó@   — e Zd Zdeddfd„Zddddeddfd	„Zdefd
„ZdS )Ú	TestGrouprS   r"   Nc                 ó>   — || _         g | _        g | _        g | _        d S ©N)rS   ÚsetupÚtestsÚcleanup)rf   rS   s     r$   Ú__init__zTestGroup.__init__¿   s"   € ØˆŒ	Ø%'ˆŒ
Ø+-ˆŒ
Ø')ˆŒˆˆr&   Frg   ÚTestCodeÚprependc                 óB  — |j         dk    r;|r| j                             d|¦  «         d S | j                             |¦  «         d S |j         dk    r| j                             |¦  «         d S |j         dk    r| j                             |g¦  «         d S |j         dk    r| j                             |d g¦  «         d S |j         dk    r;| j        r0t          | j        d         ¦  «        dk    r|| j        d         d	<   d S d S d S t          t          d
¦  «        ¦  «        ‚)Nr/   r   r0   r,   r?   rA   éÿÿÿÿé   r)   zinvalid TestCode type)	Útyper�   ÚinsertÚappendr’   r‘   ÚlenÚRuntimeErrorr   )rf   rg   r•   s      r$   Úadd_codezTestGroup.add_codeÅ   s@  € ØŒ9˜Ò#Ð#Øð (Ø”
×!Ò! ! TÑ*Ô*Ð*Ð*Ð*à”
×!Ò! $Ñ'Ô'Ð'Ð'Ð'ØŒY˜-Ò'Ð'ØŒL×Ò Ñ%Ô%Ð%Ð%Ð%ØŒY˜)Ò#Ð#ØŒJ×Ò˜t˜fÑ%Ô%Ð%Ð%Ð%ØŒY˜*Ò$Ð$ØŒJ×Ò˜t T˜lÑ+Ô+Ð+Ð+Ð+ØŒY˜,Ò&Ð&ØŒzð )�c $¤*¨R¤.Ñ1Ô1°QÒ6Ð6Ø$(�”
˜2”˜qÑ!Ð!Ð!ð)ð )Ð6Ð6õ �rÐ"9Ñ:Ô:Ñ;Ô;Ð;r&   c           	      óH   — d| j         ›d| j        ›d| j        ›d| j        ›d�	S )NzTestGroup(name=z, setup=z
, cleanup=z, tests=ú))rS   r�   r’   r‘   ©rf   s    r$   Ú__repr__zTestGroup.__repr__×   s/   € € àŒIˆIˆI�t”z�z�z 4¤< < <°´°°ð=ð 	=r&   )F)rq   rr   rs   rJ   r“   Úboolrž   r¢   r3   r&   r$   r�   r�   ¾   s   € € € € € ð*˜Sð * Tð *ð *ð *ð *ð<ð <˜Zð <°$ð <À4ð <ð <ð <ð <ð$=˜#ð =ð =ð =ð =ð =ð =r&   r�   c                   óJ   — e Zd Z	 d
dededededee         ddfd„Zdefd	„ZdS )r”   Nrg   r™   Úfilenamerb   rC   r"   c                 óP   — || _         || _        || _        || _        |pi | _        d S r�   ©rg   r™   r¥   rb   rC   )rf   rg   r™   r¥   rb   rC   s         r$   r“   zTestCode.__init__Ý   s-   € àˆŒ	ØˆŒ	Ø ˆŒØˆŒØ�} "ˆŒˆˆr&   c                 óX   — d| j         ›d| j        ›d| j        ›d| j        ›d| j        ›d�S )Nz	TestCode(z, z, filename=z	, lineno=z
, options=r    r§   r¡   s    r$   r¢   zTestCode.__repr__å   s9   € € àŒIˆIˆI�t”y�y�y $¤- - -°´°°¸d¼l¸l¸lðLð 	Lr&   r�   )	rq   rr   rs   rJ   Úintr   r   r“   r¢   r3   r&   r$   r”   r”   Ü   sƒ   € € € € € à8<ð%ð %˜Sð %¨ð %°sð %Øð%Ø'/°¤~ð%ØAEð%ð %ð %ð %ðL˜#ð Lð Lð Lð Lð Lð Lr&   r”   c            	       óV   ‡ — e Zd Zd	dededeeef         fˆ fd„Z	 d	dede	de	fd„Z
ˆ xZS )
ÚSphinxDocTestRunnerNÚoutÚverboser"   c                 ó  •— t          ¦   «         }t          j        }|t          _        	 t          ¦   «                              |¦  «        }|t          _        n# |t          _        w xY w ||                     ¦   «         ¦  «         |S r�   )r   rd   ÚstdoutÚsuperÚ	summarizeÚgetvalue)rf   r¬   r­   Ú	string_ioÚ
old_stdoutÚresÚ	__class__s         €r$   r±   zSphinxDocTestRunner.summarizeë   ss   ø€ å‘J”Jˆ	Ý”Zˆ
Ø�Œ
ð	$Ý‘'”'×#Ò# GÑ,Ô,ˆCà#�CŒJˆJø˜�CŒJÐ#Ð#Ð#Ð#ØˆˆI×ÒÑ Ô Ñ!Ô!Ð!Øˆ
s   ©!A ÁA%r¥   Úmodule_globalsc                 óf  — | j                              |¦  «        }|r€|                     d¦  «        | j        j        k    r]	 | j        j        t          |                     d¦  «        ¦  «                 }|j                             d¦  «        S # t          $ r Y nw xY w|  
                    ||¦  «        S )NrS   Ú
examplenumT)Ú%_DocTestRunner__LINECACHE_FILENAME_REÚmatchÚgroupr<   rS   Úexamplesr©   ÚsourceÚ
splitlinesÚ
IndexErrorÚsave_linecache_getlines)rf   r¥   r·   ÚmÚexamples        r$   Ú*_DocTestRunner__patched_linecache_getlinesz>SphinxDocTestRunner._DocTestRunner__patched_linecache_getlines÷   s´   € ð Ô6×<Ò<¸XÑFÔFˆØð 		7�—’˜‘” D¤I¤NÒ2Ð2ð7Øœ)Ô,­S°·²¸Ñ1FÔ1FÑ-GÔ-GÔH�ð ”~×0Ò0°Ñ6Ô6Ð6øõ ð ð ð Ø�ðøøøð ×+Ò+¨H°nÑEÔEÐEs   Á2B Â
BÂBr�   )rq   rr   rs   r   r£   r   r©   r±   rJ   r   rÄ   Ú__classcell__)r¶   s   @r$   r«   r«   ê   s£   ø€ € € € € ð
ð 
˜Xð 
°ð 
Ø˜S #˜X”ð
ð 
ð 
ð 
ð 
ð 
ð JNðFð FÀ3ð FØCFðFØRUðFð Fð Fð Fð Fð Fð Fð Fr&   r«   c                   ó^  — e Zd ZdZdZ ed¦  «        Zd"d„Zdeddfd„Z	deddfd	„Z
d#d
edee         defd„Zdee         fd„Zd"d„Z	 d$dee         dee         deddfd„Zded
edefd„Zededee         fd„¦   «         Zdedefd„Zd
ededdfd„Zdedededededefd„Zd eddfd!„ZdS )%ÚDocTestBuilderz2
    Runs test snippets in the documentation.
    r,   zZTesting of doctests in the sources finished, look at the results in %(outdir)s/output.txt.r"   Nc           	      óÊ  — | j         j        | _        | j        t          _        | j         j        t          j        dd…<   d| _        d| _	        d| _
        d| _        d| _        d| _        d| _        t          j        d¦  «        }t#          t          j        | j        d¦  «        dd¬¦  «        | _        | j                             d|›d	d
t-          |¦  «        z  ›d�¦  «         d S )Nr   Úsinglez%Y-%m-%d %H:%M:%Sz
output.txtÚwzutf-8)Úencodingz"Results of doctest builder run on z#
==================================ú=r+   )ÚconfigÚdoctest_default_flagsÚoptÚcompiler,   Údoctest_pathrd   r   r™   Útotal_failuresÚtotal_triesÚsetup_failuresÚsetup_triesÚcleanup_failuresÚcleanup_triesÚtimeÚstrftimeÚopenrQ   ÚoutdirÚoutfileÚwriterœ   )rf   Údates     r$   ÚinitzDocTestBuilder.init  sÜ   € à”;Ô4ˆŒð œ,�ŒàœÔ0�Œ��1�‰àˆŒ	àˆÔØˆÔØˆÔØˆÔØ !ˆÔØˆÔåŒ}Ð0Ñ1Ô1ˆå�DœI d¤k°<Ñ@Ô@À#ÐPWÐXÑXÔXˆŒØŒ×ÒÐà ˜D˜D #­¨D©	¬	¡/ / /ð3ñ 	4ô 	4ð 	4ð 	4ð 	4r&   Útextc                 ór   — t                                |d¬¦  «         | j                             |¦  «         d S ©NT)Únonl)ÚloggerÚinforÜ   rÝ   ©rf   rà   s     r$   Ú_outzDocTestBuilder._out/  s4   € Ý�Š�D˜tˆÑ$Ô$Ð$ØŒ×Ò˜4Ñ Ô Ð Ð Ð r&   c                 óØ   — | j         j        s| j         j        rt                               |¦  «         nt                               |d¬¦  «         | j                             |¦  «         d S râ   )ÚappÚquietÚwarningiserrorrä   ra   rå   rÜ   rÝ   ræ   s     r$   Ú	_warn_outzDocTestBuilder._warn_out3  sa   € ØŒ8Œ>ð 	)˜TœXÔ4ð 	)Ý�NŠN˜4Ñ Ô Ð Ð å�KŠK˜ 4ˆKÑ(Ô(Ð(ØŒ×Ò˜4Ñ Ô Ð Ð Ð r&   ÚdocnameÚtypc                 ó   — dS )Nr-   r3   )rf   rí   rî   s      r$   Úget_target_urizDocTestBuilder.get_target_uri:  s   € Øˆrr&   c                 ó   — | j         j        S r�   )ÚenvÚ
found_docsr¡   s    r$   Úget_outdated_docsz DocTestBuilder.get_outdated_docs=  s   € ØŒxÔ"Ð"r&   c           
      ó~  — dt           dt          fd„}| j         || j        ¦  «        | j         || j        ¦  «        | j         || j        ¦  «        | j         || j        ¦  «        f}|                      d|z  ¦  «         | j                             ¦   «          | j        s| j        s| j        rd| j	        _
        d S d S )NrK   r"   c                 ó   — | dk    rdndS )Nr)   Úsr-   r3   )rK   s    r$   r÷   z DocTestBuilder.finish.<locals>.sB  s   € Ø˜qš&˜&�3�3 bÐ(r&   z}
Doctest summary
===============
%5d test%s
%5d failure%s in tests
%5d failure%s in setup code
%5d failure%s in cleanup code
r)   )r©   rJ   rÓ   rÒ   rÔ   rÖ   rç   rÜ   Úcloseré   Ú
statuscode)rf   r÷   Úrepls      r$   ÚfinishzDocTestBuilder.finish@  sö   € ð	)•ð 	)�ð 	)ð 	)ð 	)ð 	)àÔ  ! ! DÔ$4Ñ"5Ô"5ØÔ# Q Q tÔ':Ñ%;Ô%;ØÔ# Q Q tÔ':Ñ%;Ô%;ØÔ% q q¨Ô)>Ñ'?Ô'?ðAˆð 	�	Š	ð ð ññ 	ô 	ð 	ð 	Œ×ÒÑÔÐàÔð 	$ $Ô"5ð 	$¸Ô9Nð 	$Ø"#ˆDŒHÔÐÐð	$ð 	$r&   ÚupdateÚbuild_docnamesÚupdated_docnamesÚmethodc                 óô   — |€t          | j        j        ¦  «        }t                               t          d¦  «        ¦  «         |D ]2}| j                             |¦  «        }|                      ||¦  «         Œ3d S )Nzrunning tests...)Úsortedrò   Úall_docsrä   rå   r   Úget_doctreeÚtest_doc)rf   rý   rþ   rÿ   rí   Údoctrees         r$   rÝ   zDocTestBuilder.writeU  sz   € àÐ!Ý# D¤HÔ$5Ñ6Ô6ˆNå�Š•DÐ+Ñ,Ô,Ñ-Ô-Ð-Ø%ð 	,ð 	,ˆGà”h×*Ò*¨7Ñ3Ô3ˆGØ�MŠM˜' 7Ñ+Ô+Ð+Ð+ð	,ð 	,r&   ri   c                 óÔ   — 	 t          |j        | j        j        ¦  «                             dd¬¦  «        d         }n+# t
          $ r | j                             |d¦  «        }Y nw xY w|S )zsTry to get the file which actually contains the doctest, not the
        filename of the document it's included in.ú:docstring of r)   )Úmaxsplitr   F)r   r¾   rò   ÚsrcdirÚrsplitÚ	ExceptionÚdoc2path)rf   ri   rí   r¥   s       r$   Úget_filename_for_nodez$DocTestBuilder.get_filename_for_node`  sr   € ð	9Ý˜tœ{¨D¬H¬OÑ<Ô<ß’Ð(°1�Ñ5Ô5°aô9ˆHˆHøåð 	9ð 	9ð 	9Ø”x×(Ò(¨°%Ñ8Ô8ˆHˆHˆHð	9øøøàˆs   ‚:= ½%A%Á$A%c                 óf   — dt          j        | j        pd¦  «        v rdS | j        �
| j        dz
  S dS )z0Get the real line number or admit we don't know.r  r-   Nr)   )r   Úbasenamer¾   rE   ©ri   s    r$   Úget_line_numberzDocTestBuilder.get_line_numberj  s@   € ð
 �tœ}¨T¬[Ð->¸BÑ?Ô?Ð?Ð?ð
 �4ØŒ9Ð à”9˜q‘=Ð Øˆtr&   c                 óÞ   — d|vrdS |d         }i }| j         j        rt          | j         j        |¦  «         t          ||¦  «        }| j         j        rt          | j         j        |¦  «         |S )NrN   F)rÍ   Údoctest_global_setupÚexecÚevalÚdoctest_global_cleanup)rf   ri   Ú	conditionÚcontextÚshould_skips        r$   ÚskippedzDocTestBuilder.skippedz  s{   € Ø˜4ÐÐØ�5à˜XœˆIØ&(ˆGØŒ{Ô/ð @Ý�T”[Ô5°wÑ?Ô?Ð?Ý˜y¨'Ñ2Ô2ˆKØŒ{Ô1ð BÝ�T”[Ô7¸ÑAÔAÐAØÐr&   r  c           
      ód  — i }g }t          d| j        ¬¦  «        | _        t          d| j        ¬¦  «        | _        t          d| j        ¬¦  «        | _        | j        j        | j        _        | j        j        | j        _        | j        j        rdt          dt          fd„}ndt          dt          fd„}| 
                    |¦  «        D �]G}|                      |¦  «        rŒd|v r|d         n|                     ¦   «         }|                      ||¦  «        }|                      |¦  «        }	|s>t                               t#          d¦  «        |                     d	d
¦  «        ||	¦  «         t'          ||                     d	d
¦  «        ||	|                     d¦  «        ¬¦  «        }
|                     ddg¦  «        }d|v r|                     |
¦  «         �Œ|D ]3}||vrt+          |¦  «        ||<   ||                              |
¦  «         Œ4�ŒI|D ].}
|                     ¦   «         D ]}|                     |
¦  «         ŒŒ/| j        j        rKt'          | j        j        dd d¬¦  «        }
|                     ¦   «         D ]}|                     |
d¬¦  «         Œ| j        j        rIt'          | j        j        dd d¬¦  «        }
|                     ¦   «         D ]}|                     |
¦  «         Œ|sd S |                      d|›ddt7          |¦  «        z  ›d�¦  «         |                     ¦   «         D ]}|                      |¦  «         Œ| j                             | j        d¬¦  «        \  }}| xj        |z  c_        | xj        |z  c_        | j        j         rD| j                             | j        d¬¦  «        \  }}| xj!        |z  c_!        | xj"        |z  c_"        | j        j         rF| j                             | j        d¬¦  «        \  }}| xj#        |z  c_#        | xj$        |z  c_$        d S d S )NF)r­   Úoptionflagsri   r"   c                 óŠ   — t          | t          j        t          j        f¦  «        rd| v pt          | t          j        ¦  «        S ©Nr:   )Ú
isinstancer   rX   rY   Údoctest_blockr  s    r$   r  z*DocTestBuilder.test_doc.<locals>.condition•  s@   € Ý" 4­%Ô*=½u¼}Ð)MÑNÔNð /Ø&¨$Ð.ð:å˜t¥UÔ%8Ñ9Ô9ð:r&   c                 óV   — t          | t          j        t          j        f¦  «        od| v S r  )r  r   rX   rY   r  s    r$   r  z*DocTestBuilder.test_doc.<locals>.conditionš  s+   € Ý! $­Ô)<½e¼mÐ(LÑMÔMð /Ø&¨$Ð.ð/r&   r<   z#no code/output in %s block at %s:%sr:   r,   rC   )r™   r¥   rb   rC   r;   r9   Ú*r/   r   )r¥   rb   T)r•   r0   z
Document: z
----------ú-r+   )r­   )%r«   rÏ   Úsetup_runnerÚtest_runnerÚcleanup_runnerÚ_fakeoutrÍ   Údoctest_test_doctest_blocksr   r£   Úfindallr  Úastextr  r  rä   ra   r   Úgetr”   r›   r�   rž   Úvaluesr  r  rç   rœ   Ú
test_groupr±   rÔ   rÕ   ÚtriesrÒ   rÓ   rÖ   r×   )rf   rí   r  r;   Úadd_to_all_groupsr  ri   r¾   r¥   Úline_numberrg   Únode_groupsÚ	groupnamer¼   Úres_fÚres_ts                   r$   r  zDocTestBuilder.test_doc‡  sæ  € Ø')ˆØÐÝ/¸Ø<@¼HðFñ Fô FˆÔå.°uØ;?¼8ðEñ Eô EˆÔå1¸%Ø>B¼hðHñ Hô HˆÔð %)Ô$5Ô$>ˆÔÔ!Ø'+Ô'8Ô'AˆÔÔ$àŒ;Ô2ð 	/ð:¥ð :­ð :ð :ð :ð :ð :ð
/¥ð /­ð /ð /ð /ð /ð —O’O IÑ.Ô.ð 	1ñ 	1ˆDØ�|Š|˜DÑ!Ô!ð Øà%+¨t ^ ^�T˜&”\�\¸¿º¹¼ˆFØ×1Ò1°$¸Ñ@Ô@ˆHØ×.Ò.¨tÑ4Ô4ˆKØð 6Ý—’�rÐ"GÑHÔHØ#Ÿxšx¨¸	ÑBÔBØ'¨ñ6ô 6ð 6õ ˜F¨¯ª°.À)Ñ)LÔ)LØ%-°kØ$(§H¢H¨YÑ$7Ô$7ð9ñ 9ô 9ˆDð Ÿ(š( 8¨i¨[Ñ9Ô9ˆKØ�kÐ!Ð!Ø!×(Ò(¨Ñ.Ô.Ð.ÙØ(ð 1ð 1�	Ø FÐ*Ð*Ý(1°)Ñ(<Ô(<�F˜9Ñ%Ø�yÔ!×*Ò*¨4Ñ0Ô0Ð0Ð0ñ1ð &ð 	%ð 	%ˆDØŸš™œð %ð %�Ø—’˜tÑ$Ô$Ð$Ð$ð%àŒ;Ô+ð 	3Ý˜DœKÔ<Ø'°$¸qðBñ Bô BˆDàŸš™œð 3ð 3�Ø—’˜t¨T�Ñ2Ô2Ð2Ð2ØŒ;Ô-ð 	%Ý˜DœKÔ>Ø)°DÀðDñ Dô DˆDàŸš™œð %ð %�Ø—’˜tÑ$Ô$Ð$Ð$Øð 	ØˆFà�	Š	ˆ	Ø�7�7˜C¥# g¡,¤,Ñ.Ð.Ð.ð0ñ 	1ô 	1ð 	1à—]’]‘_”_ð 	#ð 	#ˆEØ�OŠO˜EÑ"Ô"Ð"Ð"àÔ(×2Ò2°4´9ÀeÐ2ÑLÔL‰ˆˆuØÐÔ˜uÑ$ÐÔØÐÔ˜EÑ!ÐÔØÔÔ!ð 	&ØÔ+×5Ò5°d´iÈÐ5ÑNÔN‰LˆE�5ØÐÔ 5Ñ(ÐÔØÐÔ Ñ%ÐÔØÔÔ$ð 	(ØÔ.×8Ò8¸¼ØAEð 9ñ Gô G‰LˆE�5àÐ!Ô! UÑ*Ð!Ô!ØÐÔ %Ñ'ÐÔÐÐð		(ð 	(r&   rg   rS   r™   ÚflagsÚdont_inheritc                 ó2   — t          ||| j        ||¦  «        S r�   )rÐ   r™   )rf   rg   rS   r™   r5  r6  s         r$   rÐ   zDocTestBuilder.compileÕ  s   € Ý�t˜T 4¤9¨e°\ÑBÔBÐBr&   r¼   c           	      ó  ‡ ‡‡— i Šdt           dt          t                   dt           dt          fˆˆˆ fd„} |‰ j        ‰j        d¦  «        sd S ‰j        D �]}t          |¦  «        dk    rý	 t           	                    |d         j
        i ‰j        |d         j        |d         j        ¦  «        }n]# t          $ rP t                               t#          d	¦  «        |d         j
        |d         j        |d         j        f¬
¦  «         Y Œµw xY w|j        sŒÁ|j        D ]B}|d         j                             ¦   «         }|                     |j        ¦  «         ||_        ŒCd‰ _        ná|d         r|d         j
        nd}|d         r|d         j        ni }d|t.          j        <   t          j                             |¦  «        }	|	r|	                     d¦  «        }
nd }
t/          j        |d         j
        ||
|d         j        |¬¦  «        }t/          j        |gi ‰j        |d         j        |d         j        d ¦  «        }d‰ _        ‰|_        ‰ j                              |‰ j!        d¬¦  «         �Œ |‰ j"        ‰j#        d¦  «         d S )NÚrunnerÚ	testcodesÚwhatr"   c                 óf  •— g }|D ]8}t          j        |j        d|j        ¬¦  «        }|                     |¦  «         Œ9|sdS t          j        |i ‰j        ›d|›d�|d         j        dd ¦  «        }‰	|_        | j	        }d‰
_
        |                      |‰
j        d¬	¦  «         | j	        |k    rdS dS )
Nr-   )rb   Tz (z code)r   r  F©r¬   Úclear_globs)r,   ÚExamplerg   rb   r›   ÚDocTestrS   r¥   ÚglobsÚfailuresr™   rp   rì   )r9  r:  r;  r½   r?   rÃ   Úsim_doctestÚold_fr¼   Únsrf   s           €€€r$   Úrun_setup_cleanupz4DocTestBuilder.test_group.<locals>.run_setup_cleanupÛ  sÓ   ø€ ØˆHØ%ð )ð )�Ý!œ/¨(¬-¸ÀHÄOÐTÑTÔT�Ø—’ Ñ(Ô(Ð(Ð(Øð Ø�tå!œ/¨(°BØ<A¼J¸J¸JÈÈÈÐ*MØ*3°A¬,Ô*?ÀÀDñJô JˆKð !#ˆKÔØ”OˆEØˆDŒIØ�JŠJ�{¨¬ÀEˆJÑJÔJÐJØŒ Ò&Ð&Ø�uØ�4r&   r�   r)   r   z!ignoring invalid doctest code: %r)ÚlocationrÉ   r-   TÚmsg)Úexc_msgrb   rC   r  Fr=  r’   )$r   r
   r”   r£   r$  r�   r‘   rœ   ÚparserÚget_doctestrg   rS   r¥   rb   r  rä   ra   r   r½   rC   Úcopyrü   r™   r,   ÚDONT_ACCEPT_BLANKLINEÚ_EXCEPTION_REr»   r¼   r?  r@  rA  r%  rp   rì   r&  r’   )rf   r¼   rF  rg   r<   rÃ   Únew_optÚoutputrC   rÂ   rI  rE  s   ``         @r$   r-  zDocTestBuilder.test_groupØ  sÃ  øøø€ Øˆð	¥cð 	µd½8´nð 	ÍCð 	ÕTXð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð( !Ð  Ô!2°E´KÀÑIÔIð 	àˆFð ”Kð &	Nñ &	NˆDÝ�4‰yŒy˜AŠ~ˆ~ðÝ!×-Ò-¨d°1¬g¬l¸BÀÄ
Ø.2°1¬gÔ.>ÀÀQÄÄñPô P�D�Døå ð ð ð Ý—N’N¥2Ð&IÑ#JÔ#JÈDÐQRÌGÌLØ-1°!¬WÔ-=¸tÀA¼w¼~Ð,Nð #ñ Pô Pð Pà�Hðøøøð ”}ð ØØ#œ}ð .ð .�Gà" 1œgœo×2Ò2Ñ4Ô4�GØ—N’N 7¤?Ñ3Ô3Ð3Ø&-�G”O�OØ$�”	�	ð *.¨a¬Ð8˜˜aœœ˜°b�Ø-1°!¬WÐ<˜$˜qœ'œ/˜/¸"�à9=��Ô5Ñ6åÔ(×.Ò.¨vÑ6Ô6�Øð #ØŸgšg e™nœn�G�Gà"�GÝ!œ/¨$¨q¬'¬,¸ÈØ15°a´´ÈðRñ Rô R�å”¨ y°"°e´jØ'+¨A¤wÔ'7¸¸a¼¼ÈñOô O�à"�”	àˆDŒJàÔ× Ò  ¨4¬>ÀuÐ ÑMÔMÐMÑMð 	Ð˜$Ô-¨u¬}¸iÑHÔHÐHÐHÐHs   Á,AB1Â1ADÄ
D)r"   Nr�   )rü   ) rq   rr   rs   rt   rS   r   Úepilogrß   rJ   rç   rì   r   rð   r   rô   rû   r	   r   rÝ   r   r  Ústaticmethodr©   r  r   r£   r  r  r   rÐ   r�   r-  r3   r&   r$   rÇ   rÇ   
  sf  € € € € € ðð ð €DØˆRð 4ñ 5ô 5€Fð4ð 4ð 4ð 4ð:!˜ð ! ð !ð !ð !ð !ð!˜cð ! dð !ð !ð !ð !ðð  cð °¸´ð Èð ð ð ð ð# 3 s¤8ð #ð #ð #ð #ð$ð $ð $ð $ð, %ð	,ð 	, H¨S¤Mð 	,ÀXÈcÄ]ð 	,Øð	,Ø)-ð	,ð 	,ð 	,ð 	,ð¨$ð ¸ð Àð ð ð ð ð ð˜dð  x°¤}ð ð ð ñ „\ðð˜Gð ¨ð ð ð ð ðL( ð L(¨dð L(°tð L(ð L(ð L(ð L(ð\C˜Cð C sð C°#ð C¸cð CÐQUð CÐZ]ð Cð Cð Cð CðEI 	ð EI¨dð EIð EIð EIð EIð EIð EIr&   rÇ   ré   r   c                 ó�  — |                       dt          ¦  «         |                       dt          ¦  «         |                       dt          ¦  «         |                       dt          ¦  «         |                       dt
          ¦  «         |                      t          ¦  «         |                      dg d¦  «         |                      dd	d¦  «         |                      d
dd¦  «         |                      ddd¦  «         |                      dt          j
        t          j        z  t          j        z  d¦  «         t          j        ddœS )Nr/   r0   r,   r?   rA   rÑ   Fr(  r9   r  r-   r  rÎ   T)r!   Úparallel_read_safe)Úadd_directiverz   r�   rƒ   r‰   r‹   Úadd_builderrÇ   Úadd_config_valuer,   ÚDONT_ACCEPT_TRUE_FOR_1ÚELLIPSISÚIGNORE_EXCEPTION_DETAILÚsphinxÚ__display_version__)ré   s    r$   r�   r�      s1  € Ø×Ò�kÕ#5Ñ6Ô6Ð6Ø×Ò�mÕ%9Ñ:Ô:Ð:Ø×Ò�iÕ!1Ñ2Ô2Ð2Ø×Ò�jÕ"3Ñ4Ô4Ð4Ø×Ò�lÕ$7Ñ8Ô8Ð8Ø‡O‚O•NÑ#Ô#Ð#à×Ò˜¨¨UÑ3Ô3Ð3Ø×ÒÐ6¸	À5ÑIÔIÐIØ×ÒÐ/°°UÑ;Ô;Ð;Ø×ÒÐ1°2°uÑ=Ô=Ð=Ø×ÒØÝÔ&­Ô)9Ñ9½GÔ<[Ñ[Øñô ð õ Ô1ÈÐNÐNÐNr&   )Krt   r,   Úrerd   rØ   Úior   Úosr   Útypingr   r   r   r   r	   r
   r   r   r   r   r   Údocutilsr   Údocutils.nodesr   r   r   Údocutils.parsers.rstr   Úpackaging.specifiersr   r   Úpackaging.versionr   r[  Úsphinx.buildersr   Úsphinx.localer   Úsphinx.utilr   Úsphinx.util.consoler   Úsphinx.util.docutilsr   Úsphinx.util.osutilr   Úsphinx.util.typingr   Úsphinx.applicationr   Ú	getLoggerrq   rä   rÐ   Ú	MULTILINErT   rV   rJ   r£   r%   r(   rz   r�   rƒ   r‰   r‹   ÚDocTestParserrJ  r�   r”   ÚDocTestRunnerr«   rÇ   r�   r3   r&   r$   ú<module>rr     so  ððð ð
 €€€Ø 	€	€	€	Ø 
€
€
€
Ø €€€Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð ð&ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð &ð Ð Ð Ð Ð Ð Ø 5Ð 5Ð 5Ð 5Ð 5Ð 5Ð 5Ð 5Ð 5Ð 5Ø +Ð +Ð +Ð +Ð +Ð +Ø ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ø %Ð %Ð %Ð %Ð %Ð %à €€€Ø #Ð #Ð #Ð #Ð #Ð #Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø $Ð $Ð $Ð $Ð $Ð $Ø 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø &Ð &Ð &Ð &Ð &Ð &Ø )Ð )Ð )Ð )Ð )Ð )àð *Ø)Ð)Ð)Ð)Ð)Ð)ð 
ˆÔ	˜8Ñ	$Ô	$€àˆrŒzÐ,¨b¬lÑ;Ô;€Ø�”
Ð-¨r¬|Ñ<Ô<€ð2˜Sð 2¨3ð 2°4ð 2ð 2ð 2ð 2ð(Nð Nð Nð Nð N�Oñ Nô Nð Nðbð ð ð ð ˜ñ ô ð ðð ð ð ð ˜=ñ ô ð ðð ð ð ð �}ñ ô ð ðð ð ð ð ˜ñ ô ð ðð ð ð ð ˜-ñ ô ð ð 
ˆÔ	Ñ	 Ô	 €ð
=ð =ð =ð =ð =ñ =ô =ð =ð<Lð Lð Lð Lð Lñ Lô Lð LðFð Fð Fð Fð F˜'Ô/ñ Fô Fð Fð@SIð SIð SIð SIð SI�Wñ SIô SIð SIðlOˆxð O˜D  c œNð Oð Oð Oð Oð Oð Or&   