§
    _÷#dvo  ã                   ó¬  — U d 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 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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!m"Z" ddl#m$Z$m%Z%m&Z&m'Z' ddl(m)Z) ddl*m+Z+ ddl,m-Z- ddl.m/Z/ ddl0m1Z1m2Z2m3Z3 ddl4m5Z5 ddl6m7Z7m8Z8 ddl9m:Z: ddl;m<Z<m=Z= e
rddl>m?Z? ddl@mAZA  e3jB        eC¦  «        ZDddddddd dd!dddd"dg d#œZEeeFef         eGd$<   ejH        dd%…         d&k    rdeEd'<   d(ZId)ZJd%ZKd*ZLd+ZMeK e+d,¦  «        eL e+d-¦  «        eM e+d.¦  «        iZNde:d/œZOeeFeePef         f         eGd0<   e
rmdd1lQmRZR dd2lSmTZTmUZU dd3lVmWZW dd4lXmYZY dd5lZm[Z[ dd6l\m]Z] dd7l^m_Z_ dd8l`maZa dd9lbmcZc dd:ldmeZe dd;lfmgZg dd<lhmiZi dd=ljmkZk dd>llmmZm  G d?„ d@eReFe f         ¦  «        ZnneoZn G dA„ dB¦  «        ZpdS )CzGlobal creation environment.é    N)Údefaultdict)Úcopy)Údatetime)Úpath)ÚTYPE_CHECKINGÚAnyÚCallableÚDictÚ	GeneratorÚIteratorÚListÚOptionalÚSetÚTupleÚUnion)Únodes)ÚNode)Úaddnodes)ÚConfig)ÚRemovedInSphinx60Warning)ÚDomain)ÚTocTree)ÚBuildEnvironmentErrorÚDocumentErrorÚExtensionErrorÚSphinxError)ÚEventManager)Ú__)ÚProject)ÚSphinxTransformer)ÚDownloadFilesÚFilenameUniqDictÚlogging)ÚLoggingReporter)ÚCatalogRepositoryÚdocname_to_domain)Úis_translatable)Ú
canon_pathÚos_path)ÚSphinx)ÚBuilderÚidÚlinkFTzhttps://peps.python.org/z&https://datatracker.ietf.org/doc/html/z	utf-8-sigé   )Úauto_id_prefixÚimage_loadingÚembed_stylesheetÚcloak_email_addressesÚpep_base_urlÚpep_referencesÚrfc_base_urlÚrfc_referencesÚinput_encodingÚdoctitle_xformÚsectsubtitle_xformÚsection_self_linkÚ
halt_levelÚfile_insertion_enabledÚsmartquotes_localesÚdefault_settingsé   )r   é   Úembed_imagesé9   é   é   é   z
new configzconfig changedzextensions changed)ÚnoneÚtextÚversioning_conditions)ÚMutableMapping)ÚLiteralÚoverload)ÚCDomain)ÚChangeSetDomain)ÚCitationDomain)Ú	CPPDomain)ÚIndexDomain)ÚJavaScriptDomain)Ú
MathDomain)ÚPythonDomain)Ú
ReSTDomain)ÚStandardDomain)ÚDurationDomain)Ú
TodoDomainc                   ó\  — e Zd Zeded         defd„¦   «         Zeded         defd„¦   «         Zeded         defd„¦   «         Zeded	         de	fd
„¦   «         Zeded         de
fd„¦   «         Zeded         defd„¦   «         Zeded         defd„¦   «         Zeded         defd„¦   «         Zeded         defd„¦   «         Zeded         defd„¦   «         Zeded         defd„¦   «         Zeded         defd„¦   «         Zededefd„¦   «         Zd„ Zd„ Zd„ Zd„ Zd „ Zd!S )"Ú_DomainsTypeÚkeyÚcÚreturnc                 ó   — d S ©N© ©ÚselfrZ   s     ú=/usr/lib/python3/dist-packages/sphinx/environment/__init__.pyÚ__getitem__z_DomainsType.__getitem__e   s   € Ø=@¸Só    Úcppc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__g   s   € ØADÀrd   Ú	changesetc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__i   s   € ØMPÈSrd   Úcitationc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__k   ó   € ØKNÈ3rd   Úindexc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__m   s   € ØEHÀSrd   Újsc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__o   s   € ØGJÀsrd   Úmathc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__q   ó   € ØCFÀ3rd   Úpyc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__s   rr   rd   Úrstc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__u   s   € ØBEÀ#rd   Ústdc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__w   s   € ØFIÀcrd   Údurationc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__y   rk   rd   Útodoc                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__{   rr   rd   c                 ó   — d S r^   r_   r`   s     rb   rc   z_DomainsType.__getitem__}   s   € Ø36°3rd   c                 ó   — t           ‚r^   ©ÚNotImplementedErrorr`   s     rb   rc   z_DomainsType.__getitem__   ó   € Õ*=Ð$=rd   c                 ó   — t           ‚r^   r   )ra   rZ   Úvalues      rb   Ú__setitem__z_DomainsType.__setitem__€   s   € Õ1DÐ+Drd   c                 ó   — t           ‚r^   r   r`   s     rb   Ú__delitem__z_DomainsType.__delitem__�   r�   rd   c                 ó   — t           ‚r^   r   ©ra   s    rb   Ú__iter__z_DomainsType.__iter__‚   s   € Õ"5Ð5rd   c                 ó   — t           ‚r^   r   rˆ   s    rb   Ú__len__z_DomainsType.__len__ƒ   s   € Õ!4Ð4rd   N)Ú__name__Ú
__module__Ú__qualname__rK   rJ   rL   rc   rO   rM   rN   rP   rQ   rR   rS   rT   rU   rV   rW   Ústrr   r„   r†   r‰   r‹   r_   rd   rb   rY   rY   d   s  € € € € € Ø	Ø@ 7¨3¤<Ð@°GÐ@Ð@Ð@ñ 
ŒØ@Ø	ØD 7¨5¤>ÐD°iÐDÐDÐDñ 
ŒØDØ	ØP 7¨;Ô#7ÐP¸OÐPÐPÐPñ 
ŒØPØ	ØN 7¨:Ô#6ÐN¸>ÐNÐNÐNñ 
ŒØNØ	ØH 7¨7Ô#3ÐH¸ÐHÐHÐHñ 
ŒØHØ	ØJ 7¨4¤=ÐJÐ5EÐJÐJÐJñ 
ŒØJØ	ØF 7¨6¤?ÐF°zÐFÐFÐFñ 
ŒØFØ	ØF 7¨4¤=ÐF°\ÐFÐFÐFñ 
ŒØFØ	ØE 7¨5¤>ÐE°jÐEÐEÐEñ 
ŒØEØ	ØI 7¨5¤>ÐI°nÐIÐIÐIñ 
ŒØIØ	ØN 7¨:Ô#6ÐN¸>ÐNÐNÐNñ 
ŒØNØ	ØF 7¨6¤?ÐF°zÐFÐFÐFñ 
ŒØFØ	Ø6 3Ð6¨6Ð6Ð6Ð6ñ 
ŒØ6Ø=Ð=Ð=ØDÐDÐDØ=Ð=Ð=Ø5Ð5Ð5Ø4Ð4Ð4Ð4Ð4rd   rY   c                   óˆ  — e Zd ZU dZeed<   dAded         fd„Zdefd„Z	d	eddfd
„Z
dBd„Zdeddfd„Zdeddfd„Zdeeef         deddfd„Zdeddfd„Zdee         dd ddddfd„Zdedee         fd„ZdCdededefd„ZdAdedee         deeef         fd„Zedee         fd„¦   «         Zdeddddfd „Zd!edeee         ee         ee         f         fd"„Zddd#ee         de eddf         fd$„Z!deddfd%„Z"edefd&„¦   «         Z#dDd(ede$fd)„Z%deddfd*„Z&deddfd+„Z'dEd,„Z(d-ede)fd.„Z*dede+j,        fd/„Z-	 	 	 dFdeddd1ee+j,                 d2ed3ede+j,        fd4„Z.	 	 dGdeddd6e/j0        d7ed8e$d9ed:ed3edee1         fd;„Z2d1e+j,        d<eddddfd=„Z3d1e+j,        deddfd>„Z4deeeee                  f         fd?„Z5dEd@„Z6dS )HÚBuildEnvironmentz²
    The environment in which the ReST files are translated.
    Stores an inventory of cross-file targets and provides doctree
    transformations to resolve links to them.
    ÚdomainsNÚappr*   c                 óŠ  — d | _         d | _        d | _        d | _        d | _        d | _        d | _        d | _        d | _        d | _	        d | _
        t          ¦   «         | _        t                               ¦   «         | _        | | j        d<   i | _        t#          t$          ¦  «        | _        t#          t$          ¦  «        | _        t%          ¦   «         | _        t#          t,          ¦  «        | _        i | _        i | _        i | _        i | _        i | _        i | _        i | _        i | _        t%          ¦   «         | _         t%          ¦   «         | _!        i | _"        tG          ¦   «         | _$        tK          ¦   «         | _&        i | _'        i | _(        i | _)        |r|  *                    |¦  «         d S tW          j,        dtZ          d¬¦  «         d S )NÚenvz?The 'app' argument for BuildEnvironment() becomes required now.r?   )Ú
stacklevel).r“   Ú
doctreedirÚsrcdirÚconfigÚconfig_statusÚconfig_status_extraÚeventsÚprojectÚversionÚversioning_conditionÚversioning_comparerY   r’   r>   r   ÚsettingsÚall_docsr   ÚsetÚdependenciesÚincludedÚreread_alwaysÚdictÚmetadataÚtitlesÚ
longtitlesÚtocsÚtoc_num_entriesÚtoc_secnumbersÚtoc_fignumbersÚtoctree_includesÚfiles_to_rebuildÚglob_toctreesÚnumbered_toctreesÚ
domaindatar"   Úimagesr!   ÚdlfilesÚoriginal_image_uriÚ	temp_dataÚref_contextÚsetupÚwarningsÚwarnr   )ra   r“   s     rb   Ú__init__zBuildEnvironment.__init__”   s»  € ØˆŒØ#ˆŒØˆŒØ"ˆŒØ"&ˆÔØ(,ˆÔ Ø$(ˆŒØ $ˆŒØ'+ˆŒð <@ˆÔ!Ø(,ˆÔõ $‘~”~ˆŒõ )×-Ò-Ñ/Ô/ˆŒØ#ˆŒ�eÑð +-ˆŒõ 2=½SÑ1AÔ1AˆÔõ .9½Ñ-=Ô-=ˆŒå'*¡u¤uˆÔõ 4?½tÑ3DÔ3DˆŒð /1ˆŒð 35ˆŒà24ˆŒ	à/1ˆÔð
 FHˆÔàPRˆÔð 79ˆÔà57ˆÔå'*¡u¤uˆÔå+.©5¬5ˆÔð ,.ˆŒõ )9Ñ(:Ô(:ˆŒå&3¡o¤oˆŒð 35ˆÔð *,ˆŒð ,.ˆÔð ð 	BØ�JŠJ�s‰OŒOˆOˆOˆOåŒMÐ[Ý2¸qðBñ Bô Bð Bð Bð Brd   r\   c                 óh   — | j                              ¦   «         }|                     di d¬¦  «         |S )z'Obtains serializable data for pickling.N)r“   r’   rœ   )Ú__dict__r   Úupdate)ra   r¾   s     rb   Ú__getstate__zBuildEnvironment.__getstate__ò   s2   € à”=×%Ò%Ñ'Ô'ˆØ�Š˜D¨"°TˆÑ:Ô:Ð:Øˆrd   Ústatec                 ó:   — | j                              |¦  «         d S r^   )r¾   r¿   )ra   rÁ   s     rb   Ú__setstate__zBuildEnvironment.__setstate__ø   s   € ØŒ×Ò˜UÑ#Ô#Ð#Ð#Ð#rd   c                 ó6  — | j         r?| j         |j                             |¦  «        k    rt          t	          d¦  «        ¦  «        ‚| j        r,| j        |j        k    rt          t	          d¦  «        ¦  «        ‚| j        r|j                             | j        ¦  «         || _        |j	        | _	        |j
        | _
        |j        | _        |j        | _        |j                             |¦  «        | _         t          ¦   «         | _        |j                             | ¦  «        D ]}|| j        |j        <   Œ| j                             ¦   «         D ]}|                     ¦   «          Œ|                      |j        ¦  «         |                      |j        ¦  «         dS )zSet up BuildEnvironment object.z%build environment version not currentzsource directory has changedN)rž   ÚregistryÚget_envversionr   r   r˜   r�   Úrestorer“   r—   rœ   rY   r’   Úcreate_domainsÚnameÚvaluesr¹   Ú_update_configr™   Ú_update_settings)ra   r“   Údomains      rb   r¹   zBuildEnvironment.setupû   su  € àŒ<ð 	L˜DœL¨C¬L×,GÒ,GÈÑ,LÔ,LÒLÐLÝ'­Ð+RÑ(SÔ(SÑTÔTÐTØŒ[ð 	L˜Tœ[¨C¬JÒ6Ð6Ý'­Ð+IÑ(JÔ(JÑKÔKÐKàŒ<ð 	.ØŒK×Ò ¤Ñ-Ô-Ð-àˆŒØœ.ˆŒØ”jˆŒØ”jˆŒØ”{ˆŒØ”|×2Ò2°3Ñ7Ô7ˆŒõ $‘~”~ˆŒØ”l×1Ò1°$Ñ7Ô7ð 	/ð 	/ˆFØ(.ˆDŒL˜œÑ%Ð%ð ”l×)Ò)Ñ+Ô+ð 	ð 	ˆFØ�LŠL‰NŒNˆNˆNð 	×Ò˜CœJÑ'Ô'Ð'ð 	×Ò˜cœjÑ)Ô)Ð)Ð)Ð)rd   r™   c                 ó2  — t           | _        d| _        | j        €t          | _        nè| j        j        |j        k    r‚t          | _        t          t          | j        j        ¦  «        t          |j        ¦  «        z  ¦  «        }t          |¦  «        dk    r	|d         }ndt          |¦  «        fz  }d|›d�| _        nQ| 
                    d¦  «        D ];}| j        |j                 |j        k    rt          | _        d|j        ›d�| _         nŒ<|| _        dS )	z!Update configurations by new one.Ú NrC   r   z%dz (ú)r•   )Ú	CONFIG_OKrš   r›   r™   Ú
CONFIG_NEWÚ
extensionsÚCONFIG_EXTENSIONS_CHANGEDÚsortedr£   ÚlenÚfilterrÉ   rƒ   ÚCONFIG_CHANGED)ra   r™   rÓ   Ú	extensionÚitems        rb   rË   zBuildEnvironment._update_config  s  € å&ˆÔØ#%ˆÔ ØŒ;ÐÝ!+ˆDÔÐØŒ[Ô# vÔ'8Ò8Ð8Ý!:ˆDÔÝÝ�D”KÔ*Ñ+Ô+­c°&Ô2CÑ.DÔ.DÑDñFô FˆJå�:‰Œ !Ò#Ð#Ø& qœM�	�	à ¥C¨
¡O¤OÐ#5Ñ5�	øØ2;°)°)Ð'=ˆDÔ$Ð$ð Ÿš eÑ,Ô,ð ð �Ø”;˜tœyÔ)¨T¬ZÒ7Ð7Ý)7�DÔ&Ð&Ø:>¼)¸)¸)Ð/E�DÔ,Ø�Eð 8ð
 ˆŒˆˆrd   c                 ó–   — |j         | j        d<   |j        | j        d<   |j        | j        d<   | j                             dd¦  «         dS )zUpdate settings by new config.r7   Útrim_footnote_reference_spaceÚlanguage_codeÚsmart_quotesTN)Úsource_encodingr¡   rÜ   ÚlanguageÚ
setdefault)ra   r™   s     rb   rÌ   z!BuildEnvironment._update_settings5  sP   € à*0Ô*@ˆŒÐ&Ñ'Ø9?Ô9]ˆŒÐ5Ñ6Ø)/¬ˆŒ�oÑ&ð 	Œ× Ò  °Ñ6Ô6Ð6Ð6Ð6rd   ÚmethodÚcomparec                 óä   — t          |¦  «        r|}n(|t          vrt          d|z  ¦  «        ‚t          |         }| j        d|fvrt	          t          d¦  «        ¦  «        ‚|| _        || _        dS )aX  This sets the doctree versioning method for this environment.

        Versioning methods are a builder property; only builders with the same
        versioning method can share the same doctree directory.  Therefore, we
        raise an exception if the user tries to use an environment with an
        incompatible versioning method.
        zinvalid versioning method: %rNzdThis environment is incompatible with the selected builder, please choose another doctree directory.)ÚcallablerH   Ú
ValueErrorrŸ   r   r   r    )ra   râ   rã   Ú	conditions       rb   Úset_versioning_methodz&BuildEnvironment.set_versioning_method>  s“   € õ �FÑÔð 	6ØˆIˆIàÕ2Ð2Ð2Ý Ð!@À6Ñ!IÑJÔJÐJÝ-¨fÔ5ˆIàÔ$¨T°9Ð,=Ð=Ð=Ý�bð "6ñ 7ô 7ñ 8ô 8ð 8ð %.ˆÔ!Ø")ˆÔÐÐrd   Údocnamec                 ó  — || j         v rP| j                              |d¦  «         | j                             |d¦  «         | j                             |¦  «         | j                             ¦   «         D ]}|                     |¦  «         ŒdS )z4Remove all traces of a source file in the inventory.N)r¢   Úpopr¥   r¦   Údiscardr’   rÊ   Ú	clear_doc)ra   ré   rÍ   s      rb   rí   zBuildEnvironment.clear_docU  s”   € à�d”mÐ#Ð#ØŒM×Ò˜g tÑ,Ô,Ð,ØŒM×Ò˜g tÑ,Ô,Ð,ØÔ×&Ò& wÑ/Ô/Ð/à”l×)Ò)Ñ+Ô+ð 	&ð 	&ˆFØ×Ò˜WÑ%Ô%Ð%Ð%ð	&ð 	&rd   ÚdocnamesÚotherc                 ó‚  — t          |¦  «        }|D ]O}|j        |         | j        |<   |j        |         | j        |<   ||j        v r| j                             |¦  «         ŒP| j                             ¦   «         D ]&\  }}|                     ||j        |         ¦  «         Œ'| j	         
                    d| ||¦  «         dS )z°Merge global information gathered about *docnames* while reading them
        from the *other* environment.

        This possibly comes from a parallel build process.
        zenv-merge-infoN)r£   r¢   r¥   r¦   Úaddr’   ÚitemsÚmerge_domaindatar³   rœ   Úemit)ra   rî   rï   r“   ré   Ú
domainnamerÍ   s          rb   Úmerge_info_fromz BuildEnvironment.merge_info_from_  sÒ   € õ �x‘=”=ˆØð 	0ð 	0ˆGØ%*¤^°GÔ%<ˆDŒM˜'Ñ"Ø%*¤^°GÔ%<ˆDŒM˜'Ñ"Ø˜%Ô-Ð-Ð-ØÔ"×&Ò& wÑ/Ô/Ð/øà"&¤,×"4Ò"4Ñ"6Ô"6ð 	Lð 	LÑˆJ˜Ø×#Ò# H¨eÔ.>¸zÔ.JÑKÔKÐKÐKØŒ×ÒÐ)¨4°¸5ÑAÔAÐAÐAÐArd   Úfilenamec                 ó6   — | j                              |¦  «        S )z‘Return the docname for the filename if the file is document.

        *filename* should be absolute or relative to the source directory.
        )r�   Úpath2doc©ra   r÷   s     rb   rù   zBuildEnvironment.path2docq  s   € ð
 Œ|×$Ò$ XÑ.Ô.Ð.rd   TÚbasec                 ó8   — | j                              ||¦  «        S )z¸Return the filename for the document name.

        If *base* is True, return absolute path under self.srcdir.
        If *base* is False, return relative path to self.srcdir.
        )r�   Údoc2path)ra   ré   rû   s      rb   rý   zBuildEnvironment.doc2pathx  s   € ð Œ|×$Ò$ W¨dÑ3Ô3Ð3rd   c                 óÂ  — t          |¦  «        }|                     d¦  «        s|                     t          j        ¦  «        r|dd…         }nEt	          j        |                      |p| j        d¬¦  «        ¦  «        }t	          j        ||¦  «        }t          t	          j
        |¦  «        ¦  «        t	          j
        t	          j        | j        |¦  «        ¦  «        fS )a+  Return paths to a file referenced from a document, relative to
        documentation root and absolute.

        In the input "filename", absolute filenames are taken as relative to the
        source dir, while relative filenames are relative to the dir of the
        containing document.
        ú/rC   NF)rû   )r)   Ú
startswithÚosÚsepr   Údirnamerý   ré   Újoinr(   Únormpathr˜   )ra   r÷   ré   Úrel_fnÚdocdirs        rb   Ú
relfn2pathzBuildEnvironment.relfn2path€  sÊ   € õ ˜8Ñ$Ô$ˆØ×Ò˜sÑ#Ô#ð 	1 x×':Ò':½2¼6Ñ'BÔ'Bð 	1Ø˜a˜b˜b”\ˆFˆFå”\ $§-¢-°Ð0G¸4¼<Ø5:ð #0ñ #<ô #<ñ =ô =ˆFå”Y˜v xÑ0Ô0ˆFå�4œ=¨Ñ0Ô0Ñ1Ô1Ý”�dœi¨¬°VÑ<Ô<Ñ=Ô=ð?ð 	?rd   c                 ó   — | j         j        S )zcontains all existing docnames.)r�   rî   rˆ   s    rb   Ú
found_docszBuildEnvironment.found_docs“  s   € ð Œ|Ô$Ð$rd   Úbuilderr+   c                 óZ  — 	 | j         j        | j         j        z   |                     ¦   «         z   }| j                             || j         j        ¦  «         |j        r”t          | j	        | j         j
        | j         j        | j         j        ¦  «        }d„ |j        D ¦   «         }| j        D ]H}t          || j         j        ¦  «        }||v r&| j        |                              ||         ¦  «         ŒGdS dS # t&          $ r,}t)          t+          d¦  «        | j	        |fz  ¦  «        |‚d}~ww xY w)zYFind all source files in the source dir and put them in
        self.found_docs.
        c                 ó(   — i | ]}|j         |j        “ŒS r_   )rÍ   Úmo_path)Ú.0r[   s     rb   ú
<dictcomp>z/BuildEnvironment.find_files.<locals>.<dictcomp>¬  s   € ÐGÐGÐG°A˜AœH a¤iÐGÐGÐGrd   z"Failed to scan documents in %s: %rN)r™   Úexclude_patternsÚtemplates_pathÚget_asset_pathsr�   ÚdiscoverÚinclude_patternsÚuse_message_catalogr%   r˜   Úlocale_dirsrà   rß   Úcatalogsr
  r&   Úgettext_compactr¤   rñ   ÚOSErrorr   r   )	ra   r™   r  Úexclude_pathsÚrepoÚmo_pathsré   rÍ   Úexcs	            rb   Ú
find_fileszBuildEnvironment.find_files˜  s[  € ð	=Ø!œ[Ô9Ø!œ[Ô7ñ8à$×4Ò4Ñ6Ô6ñ7ˆMð ŒL×!Ò! -°´Ô1MÑNÔNÐNð Ô*ð Iå(¨¬°d´kÔ6MØ)-¬Ô)=¸t¼{Ô?Zñ\ô \�àGÐG¸¼ÐGÑGÔG�Ø#œð Ið I�GÝ.¨w¸¼Ô8SÑTÔT�FØ Ð)Ð)ØÔ)¨'Ô2×6Ò6°xÀÔ7GÑHÔHÐHøðIð Ið
Ið Iøõ ð 	=ð 	=ð 	=Ý¥Ð#GÑ HÔ HØ!%¤¨cÐ 2ñ!3ñ 4ô 4Ø9<ð=øøøøð	=øøøs   ‚C.C4 Ã4
D*Ã>'D%Ä%D*Úconfig_changedc           	      óÔ  — t          | j        ¦  «        | j        z
  }t          ¦   «         }t          ¦   «         }|r	| j        }�n!| j        D �]}|| j        vr1t                               d|¦  «         |                     |¦  «         Œ=t          j        | j        |dz   ¦  «        }t          j	        |¦  «        s1t                               d|¦  «         |                     |¦  «         ŒŸ|| j
        v r1t                               d|¦  «         |                     |¦  «         ŒÙ| j        |         }t          j        |                      |¦  «        ¦  «        }||k    rXt                               d|t          j        |¦  «        t          j        |¦  «        ¦  «         |                     |¦  «         �Œk| j        |         D ]Ÿ}		 t          j        | j        |	¦  «        }
t          j	        |
¦  «        s|                     |¦  «          nXt          j        |
¦  «        }||k    r|                     |¦  «          n'Œz# t"          $ r |                     |¦  «         Y  nw xY w�Œ|||fS )z&Return (added, changed, removed) sets.z[build target] added %rú.doctreez[build target] changed %rz$[build target] outdated %r: %s -> %s)r£   r¢   r
  ÚloggerÚdebugrñ   r   r  r—   Úisfiler¦   Úgetmtimerý   r   Úutcfromtimestampr¤   r˜   r  )ra   r   ÚremovedÚaddedÚchangedré   r÷   ÚmtimeÚnewmtimeÚdepÚdeppathÚdepmtimes               rb   Úget_outdated_filesz#BuildEnvironment.get_outdated_filesµ  si  € õ �d”mÑ$Ô$ t¤Ñ6ˆå™%œ%ˆÝ™EœEˆàð -	à”OˆE‰Eàœ?ð )ñ )�Ø $¤-Ð/Ð/Ý—L’LÐ!:¸GÑDÔDÐDØ—I’I˜gÑ&Ô&Ð&Øåœ9 T¤_°gÀ
Ñ6JÑKÔK�Ý”{ 8Ñ,Ô,ð Ý—L’LÐ!<¸gÑFÔFÐFØ—K’K Ñ(Ô(Ð(Øà˜dÔ0Ð0Ð0Ý—L’LÐ!<¸gÑFÔFÐFØ—K’K Ñ(Ô(Ð(Øàœ gÔ.�Ýœ=¨¯ª°wÑ)?Ô)?Ñ@Ô@�Ø˜eÒ#Ð#Ý—L’LÐ!GØ!(Ý!)Ô!:¸5Ñ!AÔ!AÝ!)Ô!:¸8Ñ!DÔ!DñFô Fð Fð —K’K Ñ(Ô(Ð(ÙàÔ,¨WÔ5ð ð �Cðå"&¤)¨D¬K¸Ñ"=Ô"=˜Ý#œ{¨7Ñ3Ô3ð "Ø#ŸKšK¨Ñ0Ô0Ð0Ø!˜EÝ#'¤=°Ñ#9Ô#9˜Ø# eÒ+Ð+Ø#ŸKšK¨Ñ0Ô0Ð0Ø!˜Eð ,øõ #ð ð ð àŸš GÑ,Ô,Ð,Ø˜˜ðøøøùð
 �g˜wÐ&Ð&s   ÇAH=È/H=È=I ÉI Úalreadyc              #   ó¨   K  — g }| j                              d| ¦  «        D ]}|                     |¦  «         Œt          |¦  «        D ]
}||vr|V — Œd S )Nzenv-get-updated)rœ   rô   Úextendr£   )ra   r“   r1  Ú
to_rewriterî   ré   s         rb   Úcheck_dependentsz!BuildEnvironment.check_dependentsî  sx   è è € Ø "ˆ
Øœ×(Ò(Ð):¸DÑAÔAð 	(ð 	(ˆHØ×Ò˜hÑ'Ô'Ð'Ð'Ý˜:‘”ð 	ð 	ˆGØ˜gÐ%Ð%Ø���øð	ð 	rd   c                 óš   — || j         d<   | j        j        | j         d<   | j                             | j        j        ¦  «        | j         d<   dS )z*Prepare to set up environment for reading.ré   Údefault_roleÚdefault_domainN)r·   r™   r7  r’   ÚgetÚprimary_domain)ra   ré   s     rb   Úprepare_settingsz!BuildEnvironment.prepare_settingsø  sJ   € à$+ˆŒ�yÑ!à)-¬Ô)AˆŒ�~Ñ&àŒL×Ò˜Tœ[Ô7Ñ8Ô8ð 	ŒÐ'Ñ(Ð(Ð(rd   c                 ó   — | j         d         S )z;Returns the docname of the document currently being parsed.ré   )r·   rˆ   s    rb   ré   zBuildEnvironment.docname  s   € ð Œ~˜iÔ(Ð(rd   rÏ   Úcategoryc                 ó`   — |dz   }| j                              |d¦  «        }|dz   | j         |<   |S )z†Return a serial number, e.g. for index entry targets.

        The number is guaranteed to be unique in the current document.
        Úserialnor   rC   )r·   r9  )ra   r=  rZ   Úcurs       rb   Únew_serialnozBuildEnvironment.new_serialno  s:   € ð
 ˜Ñ#ˆØŒn× Ò   aÑ(Ô(ˆØ! A™gˆŒ�sÑØˆ
rd   c                 óP   — | j         | j                                      |¦  «         dS )zØAdd *filename* as a dependency of the current document.

        This means that the document will be rebuilt if this file changes.

        *filename* should be absolute or relative to the source directory.
        N)r¤   ré   rñ   rú   s     rb   Únote_dependencyz BuildEnvironment.note_dependency  s(   € ð 	Ô˜$œ,Ô'×+Ò+¨HÑ5Ô5Ð5Ð5Ð5rd   c                 ó‚   — |                       |¦  «        }|r'| j        | j                                      |¦  «         dS dS )z¸Add *filename* as a included from other document.

        This means the document is not orphaned.

        *filename* should be absolute or relative to the source directory.
        N)rù   r¥   ré   rñ   )ra   r÷   Údocs      rb   Únote_includedzBuildEnvironment.note_included  sJ   € ð �mŠm˜HÑ%Ô%ˆØð 	1ØŒM˜$œ,Ô'×+Ò+¨CÑ0Ô0Ð0Ð0Ð0ð	1ð 	1rd   c                 óD   — | j                              | j        ¦  «         dS )zxAdd the current document to the list of documents that will
        automatically be re-read at the next build.
        N)r¦   rñ   ré   rˆ   s    rb   Únote_rereadzBuildEnvironment.note_reread%  s#   € ð 	Ô×Ò˜tœ|Ñ,Ô,Ð,Ð,Ð,rd   rõ   c                 ó‚   — 	 | j         |         S # t          $ r%}t          t          d¦  «        |z  ¦  «        |‚d}~ww xY w)zReturn the domain instance with the specified name.

        Raises an ExtensionError if the domain is not registered.
        zDomain %r is not registeredN)r’   ÚKeyErrorr   r   )ra   rõ   r  s      rb   Ú
get_domainzBuildEnvironment.get_domain+  sW   € ð
	ZØ”< 
Ô+Ð+øÝð 	Zð 	Zð 	ZÝ ¥Ð$AÑ!BÔ!BÀZÑ!OÑPÔPÐVYÐYøøøøð	Zøøøs   ‚ �
>™ 9¹>c                 ó  — t          j        | j        |dz   ¦  «        }t          |d¦  «        5 }t	          j        |¦  «        }ddd¦  «         n# 1 swxY w Y   | |j        _        t          |  	                    |¦  «        ¦  «        |_
        |S )z:Read the doctree for a file from the pickle and return it.r"  ÚrbN)r   r  r—   ÚopenÚpickleÚloadr¡   r•   r$   rý   Úreporter)ra   ré   r÷   ÚfÚdoctrees        rb   Úget_doctreezBuildEnvironment.get_doctree7  sµ   € å”9˜Tœ_¨g¸
Ñ.BÑCÔCˆÝ�(˜DÑ!Ô!ð 	% QÝ”k !‘n”nˆGð	%ð 	%ð 	%ñ 	%ô 	%ð 	%ð 	%ð 	%ð 	%ð 	%ð 	%øøøð 	%ð 	%ð 	%ð 	%à#ˆÔÔÝ*¨4¯=ª=¸Ñ+AÔ+AÑBÔBˆÔØˆs   ®AÁAÁAFrS  Úprune_toctreesÚincludehiddenc                 óL  — |€|                       |¦  «        }|                      ||¦  «         |                     t          j        ¦  «        D ]V}t          | ¦  «                             |||||¬¦  «        }|€|                     g ¦  «         ŒA|                     |¦  «         ŒW|S )zgRead the doctree from the pickle, resolve cross-references and
        toctrees and return it.
        N)ÚprunerV  )rT  Úapply_post_transformsÚfindallr   Útoctreer   ÚresolveÚreplace_self)ra   ré   r  rS  rU  rV  ÚtoctreenodeÚresults           rb   Úget_and_resolve_doctreez(BuildEnvironment.get_and_resolve_doctree@  s¼   € ð ˆ?Ø×&Ò& wÑ/Ô/ˆGð 	×"Ò" 7¨GÑ4Ô4Ð4ð #Ÿ?š?­8Ô+;Ñ<Ô<ð 	1ð 	1ˆKÝ˜T‘]”]×*Ò*¨7°G¸[Ø1?Ø9Fð +ñ Hô HˆFð ˆ~Ø×(Ò(¨Ñ,Ô,Ð,Ð,à×(Ò(¨Ñ0Ô0Ð0Ð0àˆrd   r   r[  rX  ÚmaxdepthÚtitles_onlyÚcollapsec	           
      óT   — t          | ¦  «                             ||||||||¦  «        S )a   Resolve a *toctree* node into individual bullet lists with titles
        as items, returning None (if no containing titles are found) or
        a new node.

        If *prune* is True, the tree is pruned to *maxdepth*, or if that is 0,
        to the value of the *maxdepth* option on the *toctree* node.
        If *titles_only* is True, only toplevel document titles will be in the
        resulting tree.
        If *collapse* is True, all branches not containing docname will
        be collapsed.
        )r   r\  )	ra   ré   r  r[  rX  ra  rb  rc  rV  s	            rb   Úresolve_toctreez BuildEnvironment.resolve_toctree]  s4   € õ �t‰}Œ}×$Ò$ W¨g°wÀØ%-¨{¸HØ%2ñ4ô 4ð 	4rd   Úfromdocnamec                 ó2   — |                       ||¦  «         d S r^   )rY  )ra   rS  rf  r  s       rb   Úresolve_referencesz#BuildEnvironment.resolve_referenceso  s   € à×"Ò" 7¨KÑ8Ô8Ð8Ð8Ð8rd   c                 óv  — 	 t          | j        ¦  «        }|| j        d<   t          |¦  «        }|                     | ¦  «         |                     | j        j                             ¦   «         ¦  «         |                     ¦   «          || _        n# || _        w xY w| j	         
                    d||¦  «         dS )zApply all post-transforms.ré   zdoctree-resolvedN)r   r·   r    Úset_environmentÚadd_transformsr“   rÅ   Úget_post_transformsÚapply_transformsrœ   rô   )ra   rS  ré   ÚbackupÚtransformers        rb   rY  z&BuildEnvironment.apply_post_transformss  s¹   € ð
	$å˜$œ.Ñ)Ô)ˆFØ(/ˆDŒN˜9Ñ%å+¨GÑ4Ô4ˆKØ×'Ò'¨Ñ-Ô-Ð-Ø×&Ò& t¤xÔ'8×'LÒ'LÑ'NÔ'NÑOÔOÐOØ×(Ò(Ñ*Ô*Ð*à#ˆDŒNˆNø˜VˆDŒNÐ#Ð#Ð#Ð#ð 	Œ×ÒÐ+¨W°gÑ>Ô>Ð>Ð>Ð>s   ‚BB Â	Bc           	      ó\  ‡ ‡‡	— t          ¦   «         Š	dt          t                   dt          dt          t          t          t                   t          f                  fˆ ˆˆ	fd„Ši } ‰d ‰ j        j        ¦  «        }d }t          |¦  «        \  }}|D ]\  }}|||g||<   |}|}|}Œ||d g||<   |S )NÚparentré   r\   c              3   óH  •K  — | |k    r-t                                t          d¦  «        |dd¬¦  «         d S | |fV — ‰                     |¦  «         ‰j                             |¦  «        pg D ]3} ‰||¦  «        D ]$\  }}|‰vr||fV — ‰                     |¦  «         Œ%Œ4d S )Nz'self referenced toctree found. Ignored.ÚtocÚcircular)ÚlocationÚtypeÚsubtype)r#  Úwarningr   rñ   r¯   r9  )rq  ré   ÚchildÚ	subparentÚ
subdocnamera   Útraverse_toctreeÚ	traverseds        €€€rb   r|  z<BuildEnvironment.collect_relations.<locals>.traverse_toctree‡  sñ   øè è € ð ˜Ò Ð Ý—’�rÐ"KÑLÔLØ(/°eØ'1ð ñ 3ô 3ð 3ð �ð ˜'�/Ð!Ð!Ð!Ø�MŠM˜'Ñ"Ô"Ð"àÔ/×3Ò3°GÑ<Ô<ÐBÀð 2ð 2�Ø-=Ð-=¸gÀuÑ-MÔ-Mð 2ð 2Ñ)�I˜zØ!¨Ð2Ð2Ø'¨Ð3Ð3Ð3Ð3Ø!Ÿš jÑ1Ô1Ð1øð2ð2ð 2rd   )r£   r   r�   r   r   r™   Úroot_docÚnext)
ra   Ú	relationsrî   Úprevdocrq  ré   Ú
nextparentÚnextdocr|  r}  s
   `       @@rb   Úcollect_relationsz"BuildEnvironment.collect_relations„  sä   øøø€ Ý‘E”Eˆ	ð	2Ý�S”Mð	2Ý,/ð	2å•e�H¥SœM­3Ð.Ô/Ô0ð	2ð 	2ð 	2ð 	2ð 	2ð 	2ð 	2ð 	2ð& ˆ	Ø#Ð# D¨$¬+Ô*>Ñ?Ô?ˆØˆÝ˜x™.œ.‰ˆ�Ø#+ð 	 ð 	 ÑˆJ˜Ø"(¨'°7Ð!;ˆI�gÑØˆGØˆGØˆFˆFà$ g¨tÐ4ˆ	�'ÑàÐrd   c                 óÔ  —  t          ¦   «         j        | j                             ¦   «         Ž }t	          | j        ¦  «        D ]Z}|| j        vrO|| j        j        k    rŒ||v rŒ!d| j	        |         v rŒ1t                               t          d¦  «        |¬¦  «         Œ[| j                             ¦   «         D ]}|                     ¦   «          Œ| j                             d| ¦  «         dS )zDo consistency checks.Úorphanz&document isn't included in any toctree)ru  zenv-check-consistencyN)r£   Úunionr¥   rÊ   rÕ   r¢   r°   r™   r~  r¨   r#  rx  r   r’   Úcheck_consistencyrœ   rô   )ra   r¥   ré   rÍ   s       rb   rˆ  z"BuildEnvironment.check_consistency¨  sü   € à•3‘5”5”; ¤× 4Ò 4Ñ 6Ô 6Ð7ˆÝ˜dœmÑ,Ô,ð 	1ð 	1ˆGØ˜dÔ3Ð3Ð3Ø˜dœkÔ2Ò2Ð2àØ˜hÐ&Ð&àØ˜tœ}¨WÔ5Ð5Ð5ØÝ—’�rÐ"KÑLÔLØ(/ð ñ 1ô 1ð 1øð ”l×)Ò)Ñ+Ô+ð 	'ð 	'ˆFØ×$Ò$Ñ&Ô&Ð&Ð&ØŒ×ÒÐ0°$Ñ7Ô7Ð7Ð7Ð7rd   r^   )r“   r*   r\   N)T)rÏ   )r\   N)NTF)Tr   FFF)7rŒ   r�   rŽ   Ú__doc__rY   Ú__annotations__r   r¼   r
   rÀ   rÃ   r¹   r   rË   rÌ   r   r�   r	   Úboolrè   rí   r   rö   rù   rý   r   r  Úpropertyr   r
  r  r0  r   r5  r;  ré   ÚintrA  rC  rF  rH  r   rK  r   ÚdocumentrT  r`  r   r[  r   re  rh  rY  r„  rˆ  r_   rd   rb   r‘   r‘   ‰   su  € € € € € € ðð ð ÐÐÑð\Bð \B˜H XÔ.ð \Bð \Bð \Bð \Bð|˜dð ð ð ð ð$ $ð $¨4ð $ð $ð $ð $ð*ð *ð *ð *ð@ Vð °ð ð ð ð ð47 vð 7°$ð 7ð 7ð 7ð 7ð*¨E°#°x°-Ô,@ð *È4ð *ÐTXð *ð *ð *ð *ð.& ð &¨ð &ð &ð &ð &ðB¨¨S¬	ð BÐ:Lð BØ%ðBØ*.ðBð Bð Bð Bð$/ ð /¨°#¬ð /ð /ð /ð /ð4ð 4 ð 4¨4ð 4¸3ð 4ð 4ð 4ð 4ð?ð ? 3ð ?°¸#´ð ?È%ÐPSÐUXÐPXÌ/ð ?ð ?ð ?ð ?ð& ð%˜C œHð %ð %ð %ñ „Xð%ð= ð =°)ð =Àð =ð =ð =ð =ð:7'°ð 7'¸%ÀÀCÄÈ#ÈcÌ(ÐTWÐX[ÔT\Ð@\Ô:]ð 7'ð 7'ð 7'ð 7'ðr Hð °s¸3´xð ÀIÈcÐSWÐY]ÈoÔD^ð ð ð ð ð9¨ð 9°ð 9ð 9ð 9ð 9ð ð)˜ð )ð )ð )ñ „Xð)ðð  Sð °#ð ð ð ð ð6¨ð 6°ð 6ð 6ð 6ð 6ð	1 cð 	1¨dð 	1ð 	1ð 	1ð 	1ð-ð -ð -ð -ðZ Sð Z¨Vð Zð Zð Zð Zð 3ð ¨5¬>ð ð ð ð ð -1Ø#Ø#ðð àðð ðð ˜%œ.Ô)ð	ð
 ðð ðð 
Œðð ð ð ð< TYØFKð4ð 4 sð 4°Yð 4ÈÔIYð 4Ø#ð4Ø69ð4ØLPð4à"&ð4à?Cð4àPXÐY]ÔP^ð4ð 4ð 4ð 4ð$9¨%¬.ð 9Àsð 9Ø$-ð9Ø26ð9ð 9ð 9ð 9ð?¨U¬^ð ?Àcð ?Èdð ?ð ?ð ?ð ?ð"" 4¨¨T°(¸3´-Ô-@Ð(@Ô#Að "ð "ð "ð "ðH8ð 8ð 8ð 8ð 8ð 8rd   r‘   )qr‰  r  rO  rº   Úcollectionsr   r   r   r   Útypingr   r   r	   r
   r   r   r   r   r   r   r   Údocutilsr   Údocutils.nodesr   Úsphinxr   Úsphinx.configr   Úsphinx.deprecationr   Úsphinx.domainsr   Ú#sphinx.environment.adapters.toctreer   Úsphinx.errorsr   r   r   r   Úsphinx.eventsr   Úsphinx.localer   Úsphinx.projectr   Úsphinx.transformsr    Úsphinx.utilr!   r"   r#   Úsphinx.util.docutilsr$   Úsphinx.util.i18nr%   r&   Úsphinx.util.nodesr'   Úsphinx.util.osutilr(   r)   Úsphinx.applicationr*   Úsphinx.buildersr+   Ú	getLoggerrŒ   r#  r>   r�   rŠ  Ú__version_info__ÚENV_VERSIONrÑ   rÒ   rØ   rÔ   ÚCONFIG_CHANGED_REASONrH   r‹  Úcollections.abcrI   Útyping_extensionsrJ   rK   Úsphinx.domains.crL   Úsphinx.domains.changesetrM   Úsphinx.domains.citationrN   Úsphinx.domains.cpprO   Úsphinx.domains.indexrP   Úsphinx.domains.javascriptrQ   Úsphinx.domains.mathrR   Úsphinx.domains.pythonrS   Úsphinx.domains.rstrT   Úsphinx.domains.stdrU   Úsphinx.ext.durationrV   Úsphinx.ext.todorW   rY   r§   r‘   r_   rd   rb   ú<module>r¶     s+  ðØ "Ð "Ð "à 	€	€	€	Ø €€€Ø €€€Ø #Ð #Ð #Ð #Ð #Ð #Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð ð'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð 'ð €€€Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð à Ð Ð Ð Ð Ð Ø  Ð  Ð  Ð  Ð  Ð  Ø 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø !Ð !Ð !Ð !Ð !Ð !Ø 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø [Ð [Ð [Ð [Ð [Ð [Ð [Ð [Ð [Ð [Ð [Ð [Ø &Ð &Ð &Ð &Ð &Ð &Ø Ð Ð Ð Ð Ð Ø "Ð "Ð "Ð "Ð "Ð "Ø /Ð /Ð /Ð /Ð /Ð /Ø @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ð @Ø 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø AÐ AÐ AÐ AÐ AÐ AÐ AÐ AØ -Ð -Ð -Ð -Ð -Ð -Ø 2Ð 2Ð 2Ð 2Ð 2Ð 2Ð 2Ð 2àð (Ø)Ð)Ð)Ð)Ð)Ð)Ø'Ð'Ð'Ð'Ð'Ð'ð 
ˆÔ	˜8Ñ	$Ô	$€ð ØØØ!Ø.ØØ<ØØ!ØØØØØ"Øð$ð $Ð �$�s˜C�x”.ð ð ñ ð" Ô˜R˜a˜RÔ  GÒ+Ð+Ø',Ð�^Ñ$ð €ð €	Ø€
Ø€ØÐ ð ���<Ñ Ô Ø�B�BÐ'Ñ(Ô(Ø˜r˜rÐ"6Ñ7Ô7ðÐ ð Øð;ð ;Ð �t˜C  t¨X ~Ô!6Ð6Ô7ð ð ñ ð
 ð 4Ø.Ð.Ð.Ð.Ð.Ð.à3Ð3Ð3Ð3Ð3Ð3Ð3Ð3à(Ð(Ð(Ð(Ð(Ð(Ø8Ð8Ð8Ð8Ð8Ð8Ø6Ð6Ð6Ð6Ð6Ð6Ø,Ð,Ð,Ð,Ð,Ð,Ø0Ð0Ð0Ð0Ð0Ð0Ø:Ð:Ð:Ð:Ð:Ð:Ø.Ð.Ð.Ð.Ð.Ð.Ø2Ð2Ð2Ð2Ð2Ð2Ø-Ð-Ð-Ð-Ð-Ð-Ø1Ð1Ð1Ð1Ð1Ð1Ø2Ð2Ð2Ð2Ð2Ð2Ø*Ð*Ð*Ð*Ð*Ð*ð5ð 5ð 5ð 5ð 5�~ c¨6 kÔ2ñ 5ô 5ð 5ð 5ðD €Lðr8ð r8ð r8ð r8ð r8ñ r8ô r8ð r8ð r8ð r8rd   