o
    N iù~  ã                   @  sv  U d Z ddlm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 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m Z  ddl!m"Z" ddl#m$Z$ ddl%m&Z& ddl'm(Z(m)Z) ddl*m+Z+ ddl,m-Z-m.Z.m/Z/ eråddl0m1Z1m2Z2m3Z3 ddl4m5Z5 ddl
m6Z6m7Z7 ddl8m9Z9 ddl:m;Z; ddl<m=Z= ddl>m?Z? ddl@mAZA ddlBmCZC ddlDmEZE dd lFmGZG dd!lHmIZI dd"lJmKZK e LeM¡ZNd#d$d%d&d'dd(dd)d%d%d%d*d&g d+œZOd,ePd-< d.ZQd/ZRd0ZSd1ZTd2ZUd3ZVeTed4ƒeUed5ƒeVed6ƒiZWd%e+d7œZXd8ePd9< G d:d;„ d;ƒZYdQdAdB„ZZdRdLdM„Z[dSdOdP„Z\dS )TzGlobal creation environment.é    )ÚannotationsN)Údefaultdict)Úcopy)Úpath)ÚTYPE_CHECKING)Úaddnodes)Ú_DomainsContainer)Útoctree)ÚBuildEnvironmentErrorÚDocumentErrorÚExtensionErrorÚSphinxError)Ú__)ÚSphinxTransformer)Úlogging)ÚDownloadFilesÚFilenameUniqDict©Ú
stable_str)Ú_format_rfc3339_microseconds)ÚLoggingReporter)ÚCatalogRepositoryÚdocname_to_domain)Úis_translatable)Ú_last_modified_timeÚ
canon_pathÚos_path)ÚCallableÚIterableÚIterator)ÚPath)ÚAnyÚLiteral)Únodes)ÚNode)ÚParser)ÚSphinx)ÚBuilder)ÚConfig)ÚDomain)ÚEventManager)ÚProject)Ú_StrPathÚ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údict[str, Any]Údefault_settingsé@   éÿÿÿÿé   é   é   é   z
new configzconfig changedzextensions changed)ÚnoneÚtextz2dict[str, Literal[False] | Callable[[Node], bool]]Úversioning_conditionsc                   @  s€  e Zd ZdZd}dd„Zd~d	d
„Zddd„Zd}dd„Zed€dd„ƒZ	ddd„Z
d‚d d!„Zdƒd$d%„Zd„d)d*„Zd…d.d/„Zd†d‡d3d4„Zdˆd‰d7d8„ZedŠd:d;„ƒZd‹d>d?„ZdŒdBdC„ZddFdG„ZdƒdHdI„ZedŽdJdK„ƒZeddMdN„ƒZdd‘dQdR„Zd’dSdT„Zd’dUdV„Zd“dWdX„Zd”d[d\„Zd•d^d_„Zej d–d`da„ƒZ!	5	0	bd—d˜dgdh„Z"	0	i	b	b	bd™dšdqdr„Z#d›dtdu„Z$dœdvdw„Z%ddydz„Z&d“d{d|„Z'd5S )žÚ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.
    Úappr&   ÚreturnÚNonec                 C  sT  || _ |j| _|j| _d | _t| _d| _|j| _|j| _|j	 
|¡| _d | _d | _t ¡ | _| | jd< i | _ttƒ| _ttƒ| _tƒ | _i | _	 i | _	 ttƒ| _i | _i | _i | _i | _i | _i | _ i | _!i | _"tƒ | _#tƒ | _$i | _%t&ƒ | _'t(ƒ | _)i | _*i | _+i | _,i | _-i | _.i | _/i | _0i | _1i | _2i | _3i | _4t5 6| ¡| _7|  8|¡ d S )NÚ Úenv)9rK   Ú
doctreedirÚsrcdirÚconfigÚCONFIG_UNSETÚconfig_statusÚconfig_status_extraÚeventsÚprojectÚregistryÚget_envversionÚversionÚversioning_conditionÚversioning_comparer@   r   ÚsettingsÚall_docsr   ÚsetÚdependenciesÚincludedÚreread_alwaysÚ_pickled_doctree_cacheÚ_write_doc_doctree_cacheÚ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Ú_search_index_titlesÚ_search_index_filenamesÚ_search_index_mappingÚ_search_index_title_mappingÚ_search_index_all_titlesÚ_search_index_index_entriesÚ_search_index_objtypesÚ_search_index_objnamesr   Ú_from_environmentÚdomainsÚsetup©ÚselfrK   © r„   úO/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/environment/__init__.pyÚ__init__g   s`   




	zBuildEnvironment.__init__r?   c                 C  s,   | j  ¡ }|jdddd |ji i d |S )z'Obtains serializable data for pickling.N)rK   r€   rV   )rc   rd   )Ú__dict__r   Úupdate)rƒ   r‡   r„   r„   r…   Ú__getstate__ä   s   
zBuildEnvironment.__getstate__Ústatec                 C  s   | j  |¡ d S ©N)r‡   rˆ   )rƒ   rŠ   r„   r„   r…   Ú__setstate__ï   s   zBuildEnvironment.__setstate__c                 C  sà   | 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 |¡| _ | jdu rPt | ¡| _| j ¡  | j| j|j|jd\| _| _|j| _|  |j¡ dS )zSet up BuildEnvironment object.z%build environment version not currentzsource directory has changedN)Ú
old_configÚ
new_configÚ	verbosity)rZ   rX   rY   r
   r   rQ   rW   ÚrestorerK   rP   rV   r€   r   r   Ú_setupÚ_config_statusrR   r   rT   rU   Ú_update_settingsr‚   r„   r„   r…   r   ò   s(   

ÿzBuildEnvironment.setupr   úConfig | NonerŽ   r(   r   Úintútuple[int, str]c           
      C  sB  | du rt dfS | j|jkr4t| jƒ}t|jƒ}||A }t|ƒdkr'| ¡ }nt|ƒ› }td|›dfS t| |ƒ }rt|ƒ}|dkrPt t	dƒt
t|ƒƒ¡ n/|dksX|dkrjt t	dƒ|d	 ttt|ƒƒ¡¡ nt t	d
ƒ|d	 ttt|ƒdd… ƒ¡¡ | tdhƒ¡D ]}	| |	j |	jkrœtd|	j›df  S q‡tdfS )zûReport the differences between two Config objects.

        Returns a triple of:

        1. The new configuration
        2. A status code indicating how the configuration has changed.
        3. A status message indicating what has changed.
        NrN   rC   z (ú)z,The configuration has changed (1 option: %r)r/   z.The configuration has changed (%d options: %s)z, z3The configuration has changed (%d options: %s, ...)rO   )Ú
CONFIG_NEWÚ
extensionsr_   ÚlenÚpopÚCONFIG_EXTENSIONS_CHANGEDÚ_differing_config_keysÚloggerÚinfor   ÚnextÚiterÚjoinÚmapÚreprÚsortedÚfilterÚ	frozensetÚnameÚvalueÚCONFIG_CHANGEDÚ	CONFIG_OK)
r   rŽ   r   Úold_extensionsÚnew_extensionsr™   Ú	extensionÚchanged_keysÚchanged_numÚitemr„   r„   r…   r’     sB   




þýýÿzBuildEnvironment._config_statusrR   c                 C  s6   |j | jd< |j| jd< |j| jd< | j dd¡ dS )zUpdate settings by new config.r8   Útrim_footnote_reference_spaceÚlanguage_codeÚsmart_quotesTN)Úsource_encodingr]   r²   ÚlanguageÚ
setdefault)rƒ   rR   r„   r„   r…   r“   J  s
   ÿz!BuildEnvironment._update_settingsÚmethodústr | Callable[[Node], bool]ÚcompareÚboolc                 C  sX   t |ƒr|}n|tvrtd| ƒ‚t| }| jd|hvr$tdƒ}t|ƒ‚|| _|| _dS )aR  Set 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.)ÚcallablerI   Ú
ValueErrorr[   r   r   r\   )rƒ   r¸   rº   Ú	conditionÚmsgr„   r„   r…   Úset_versioning_methodU  s   ÿ
z&BuildEnvironment.set_versioning_methodÚdocnameÚstrc                 C  sB   || j v r| j  |d¡ | j |d¡ | j |¡ | j |¡ dS )z4Remove all traces of a source file in the inventory.N)r^   r›   ra   rb   Údiscardr€   Ú
_clear_doc©rƒ   rÁ   r„   r„   r…   Ú	clear_docq  s
   
zBuildEnvironment.clear_docÚdocnamesúIterable[str]Úotherc                 C  sn   t |ƒ}|D ]}|j| | j|< |j| | j|< ||jv r#| j |¡ q| j ||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^   ra   rb   Úaddr€   Ú_merge_domain_datarq   rV   Úemit)rƒ   rÇ   rÉ   rK   rÁ   r„   r„   r…   Úmerge_info_fromz  s   
€z BuildEnvironment.merge_info_fromÚfilenameústr | os.PathLike[str]ú
str | Nonec                 C  s   | j  |¡S )z‘Return the docname for the filename if the file is document.

        *filename* should be absolute or relative to the source directory.
        )rW   Úpath2doc©rƒ   rÎ   r„   r„   r…   rÑ   Œ  s   zBuildEnvironment.path2docTÚbaser,   c                 C  s   | j j||d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.
        )Úabsolute)rW   Údoc2path)rƒ   rÁ   rÓ   r„   r„   r…   rÕ   “  s   zBuildEnvironment.doc2pathNútuple[str, str]c                 C  sn   t |ƒ}| dtjf¡r|dd… }nt | j|p| jdd¡}t ||¡}t	t 
|¡ƒt 
t | 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Á   r¢   r   ÚnormpathrQ   )rƒ   rÎ   rÁ   Úrel_fnÚdocdirr„   r„   r…   Ú
relfn2path›  s   þzBuildEnvironment.relfn2pathúset[str]c                 C  s   | j jS )zContains all existing docnames.)rW   rÇ   ©rƒ   r„   r„   r…   Ú
found_docs¯  s   zBuildEnvironment.found_docsÚbuilderr'   c           	   
   C  sÐ   zO| j j| j j | ¡  }| j || j j¡ |jrJt| j	| j j
| j j| j jƒ}dd„ |jD ƒ}| jD ]}t|| j jƒ}||v rI| j|  || ¡ q2W dS W dS  tyg } zttdƒ| j	|f ƒ|‚d}~ww )zYFind all source files in the source dir and put them in
        self.found_docs.
        c                 S  ó   i | ]}|j |j“qS r„   )ÚdomainÚmo_path©Ú.0Úcr„   r„   r…   Ú
<dictcomp>Î  ó    z/BuildEnvironment.find_files.<locals>.<dictcomp>z"Failed to scan documents in %s: %rN)rR   Úexclude_patternsÚtemplates_pathÚget_asset_pathsrW   ÚdiscoverÚinclude_patternsÚuse_message_catalogr   rQ   Úlocale_dirsr¶   rµ   Úcatalogsrâ   r   Úgettext_compactr`   rÊ   ÚOSErrorr   r   )	rƒ   rR   rã   Úexclude_pathsÚrepoÚmo_pathsrÁ   rå   Úexcr„   r„   r…   Ú
find_files´  s>   ÿþÿü
€ô	ÿþ€ÿzBuildEnvironment.find_filesÚconfig_changedú#tuple[set[str], set[str], set[str]]c              
   C  sœ  t | jƒ| j }t ƒ }t ƒ }|r| j}nµ| jD ]±}|| jvr*t d|¡ | |¡ qt | j|d ¡}t 	|¡sDt d|¡ | |¡ q|| j
v rUt d|¡ | |¡ q| j| }t|  |¡ƒ}||krwt d|t|ƒt|ƒ¡ | |¡ q| j| D ]K}	z:t | j|	¡}
t 	|
¡sšt d||
¡ | |¡ W  n.t|
ƒ}||kr·t d||
t|ƒt|ƒ¡ | |¡ W  nW q| tyÇ   | |¡ Y  nw q|||fS )z&Return (added, changed, removed) sets.z[build target] added %rú.doctreez[build target] changed %rz$[build target] outdated %r: %s -> %sz/[build target] changed %r missing dependency %rz7[build target] outdated %r from dependency %r: %s -> %s)r_   r^   râ   rž   ÚdebugrÊ   r   r¢   rP   Úisfilerb   r   rÕ   r   r`   rQ   rõ   )rƒ   rû   ÚremovedÚaddedÚchangedrÁ   rÎ   ÚmtimeÚnewmtimeÚdepÚdeppathÚdepmtimer„   r„   r…   Úget_outdated_filesØ  sv   







ü

ý
û
÷

ý€
z#BuildEnvironment.get_outdated_filesÚalreadyúIterator[str]c                 c  sD    g }| j  d| ¡D ]}| |¡ q
t|ƒD ]	}||vr|V  qd S )Nzenv-get-updated)rV   rÌ   Úextendr_   )rƒ   rK   r	  Ú
to_rewriterÇ   rÁ   r„   r„   r…   Úcheck_dependents!  s   €€þz!BuildEnvironment.check_dependentsc                 C  s2   || 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)ru   rR   r  r€   ÚgetÚprimary_domainrÅ   r„   r„   r…   Úprepare_settings+  s   
z!BuildEnvironment.prepare_settingsc                 C  ó
   | j d S )z;Returns the docname of the document currently being parsed.rÁ   ©ru   rá   r„   r„   r…   rÁ   4  ó   
zBuildEnvironment.docnamer%   c                 C  r  )z@Returns the parser being used for to parse the current document.Ú_parserr  rá   r„   r„   r…   Úparser9  r  zBuildEnvironment.parserrN   Úcategoryc                 C  s(   |d }| j  |d¡}|d | 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   )ru   r  )rƒ   r  ÚkeyÚcurr„   r„   r…   Únew_serialno>  s   zBuildEnvironment.new_serialnoc                 C  s   | 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Ò   r„   r„   r…   Únote_dependencyH  s   z BuildEnvironment.note_dependencyc                 C  s(   |   |¡}|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Ñ   ra   rÁ   rÊ   )rƒ   rÎ   Údocr„   r„   r…   Únote_includedQ  s   
ÿzBuildEnvironment.note_includedc                 C  s   | j  | j¡ dS )zxAdd the current document to the list of documents that will
        automatically be re-read at the next build.
        N)rb   rÊ   rÁ   rá   r„   r„   r…   Únote_reread\  s   zBuildEnvironment.note_rereadÚ
domainnamer)   c              
   C  s<   z| j | W S  ty } ztdƒ| }t|ƒ|‚d}~w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   )rƒ   r!  rù   r¿   r„   r„   r…   Ú
get_domainb  s   
€þzBuildEnvironment.get_domainúnodes.documentc                 C  sš   z| j | }W n0 ty7   t | j|d ¡}t|dƒ}| ¡  }| j |< W d  ƒ n1 s0w   Y  Y nw t |¡}| |j	_
tt|  |¡ƒƒ|_|S )z:Read the doctree for a file from the pickle and return it.rý   ÚrbN)rc   r"  r   r¢   rP   ÚopenÚreadÚpickleÚloadsr]   rO   r   rÂ   rÕ   Úreporter)rƒ   rÁ   Ú
serialisedrÎ   ÚfÚdoctreer„   r„   r…   Úget_doctreeo  s   ÿ€þ
zBuildEnvironment.get_doctreec                 C  s   |   | jj¡S r‹   )r.  rR   Úroot_docrá   r„   r„   r…   Úmaster_doctree}  s   zBuildEnvironment.master_doctreeFr-  únodes.document | NoneÚprune_toctreesÚincludehiddenc              	   C  s¬   |du r)z| j  |¡}| |j_tt|  |¡ƒƒ|_W n ty(   |  	|¡}Y nw |  
||¡ | tj¡D ]}tj| |||||d}|du rN|j |g ¡ q5| |¡ q5|S )zgRead the doctree from the pickle, resolve cross-references and
        toctrees and return it.
        N)Úpruner3  )rd   r›   r]   rO   r   rÂ   rÕ   r*  r"  r.  Úapply_post_transformsÚfindallr   r	   Útoctree_adaptersÚ_resolve_toctreeÚparentÚreplaceÚreplace_self)rƒ   rÁ   rã   r-  r2  r3  ÚtoctreenodeÚresultr„   r„   r…   Úget_and_resolve_doctree  s,   ÿúz(BuildEnvironment.get_and_resolve_doctreer   r	   úaddnodes.toctreer4  ÚmaxdepthÚtitles_onlyÚcollapseúNode | Nonec	           	      C  s   t j| ||||||||d	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.
        )r4  r@  rA  rB  r3  )r7  r8  )	rƒ   rÁ   rã   r	   r4  r@  rA  rB  r3  r„   r„   r…   Úresolve_toctree¨  s   ÷z BuildEnvironment.resolve_toctreeÚfromdocnamec                 C  s   |   ||¡ d S r‹   )r5  )rƒ   r-  rE  rã   r„   r„   r…   Úresolve_referencesÊ  s   z#BuildEnvironment.resolve_referencesc                 C  sh   z%t | jƒ}|| jd< t|ƒ}| | ¡ | | jj ¡ ¡ | ¡  W || _n|| _w | j	 
d||¡ dS )zApply all post-transforms.rÁ   zdoctree-resolvedN)r   ru   r   Úset_environmentÚadd_transformsrK   rX   Úget_post_transformsÚapply_transformsrV   rÌ   )rƒ   r-  rÁ   ÚbackupÚtransformerr„   r„   r…   r5  Ï  s   



z&BuildEnvironment.apply_post_transformsúdict[str, list[str | None]]c           	      C  sh   t ƒ }i }t|d | jj| jƒ}d }t|ƒ\}}|D ]\}}|||g||< |}|}|}q||d g||< |S r‹   )r_   Ú_traverse_toctreerR   r/  rm   r    )	rƒ   Ú	traversedÚ	relationsrÇ   Úprev_docr9  rÁ   Únext_parentÚnext_docr„   r„   r…   Úcollect_relationsà  s   ÿz"BuildEnvironment.collect_relationsc                 C  sŒ   t ƒ j| j ¡ Ž }t| jƒD ]$}|| jvr2|| jjkrq||v r!qd| j	| v r)qt
jtdƒ|d qt| jƒ | j ¡  | j d| ¡ dS )zDo consistency checks.Úorphanz&document isn't included in any toctree)Úlocationzenv-check-consistencyN)r_   Úunionra   Úvaluesr¥   r^   rn   rR   r/  rf   rž   Úwarningr   Ú_check_toc_parentsrm   r€   Ú_check_consistencyrV   rÌ   )rƒ   ra   rÁ   r„   r„   r…   Úcheck_consistencyó  s    
ÿ€

z"BuildEnvironment.check_consistency)rK   r&   rL   rM   )rL   r?   )rŠ   r?   rL   rM   )r   r”   rŽ   r(   r   r•   rL   r–   )rR   r(   rL   rM   )r¸   r¹   rº   r»   rL   rM   )rÁ   rÂ   rL   rM   )rÇ   rÈ   rÉ   rJ   rK   r&   rL   rM   )rÎ   rÏ   rL   rÐ   )T)rÁ   rÂ   rÓ   r»   rL   r,   r‹   )rÎ   rÂ   rÁ   rÐ   rL   rÖ   )rL   rà   )rR   r(   rã   r'   rL   rM   )rû   r»   rL   rü   )rK   r&   r	  rà   rL   r
  )rL   rÂ   )rL   r%   )rN   )r  rÂ   rL   r•   )rÎ   rÂ   rL   rM   )rL   rM   )r!  rÂ   rL   r)   )rÁ   rÂ   rL   r$  )rL   r$  )NTF)rÁ   rÂ   rã   r'   r-  r1  r2  r»   r3  r»   rL   r$  )Tr   FFF)rÁ   rÂ   rã   r'   r	   r?  r4  r»   r@  r•   rA  r»   rB  r»   r3  r»   rL   rC  )r-  r$  rE  rÂ   rã   r'   rL   rM   )r-  r$  rÁ   rÂ   rL   rM   )rL   rM  )(Ú__name__Ú
__module__Ú__qualname__Ú__doc__r†   r‰   rŒ   r   Ústaticmethodr’   r“   rÀ   rÆ   rÍ   rÑ   rÕ   rß   Úpropertyrâ   rú   r  r  r  rÁ   r  r  r  r  r   r#  r.  Ú	functoolsÚcached_propertyr0  r>  rD  rF  r5  rT  r\  r„   r„   r„   r…   rJ   ^   s^    

}

#
4


	


$
I

	


	


ú,÷
"

rJ   Úoldr(   ÚnewrL   úfrozenset[str]c                   sX   dd„ | D ƒ‰dd„ |D ƒ‰ ˆ  ¡ ˆ   ¡ A }‡ ‡fdd„ˆ  ¡ ˆ   ¡ @ D ƒ}t||B ƒS )z<Return a set of keys that differ between two config objects.c                 S  rä   r„   ©r¨   r©   rç   r„   r„   r…   rê     rë   z*_differing_config_keys.<locals>.<dictcomp>c                 S  rä   r„   rh  rç   r„   r„   r…   rê     rë   c                   s(   h | ]}t ˆ| ƒt ˆ | ƒkr|’qS r„   r   )rè   r  ©Únew_valsÚold_valsr„   r…   Ú	<setcomp>  s
    þz)_differing_config_keys.<locals>.<setcomp>)Úkeysr§   )re  rf  Únot_in_bothÚdifferent_valuesr„   ri  r…   r     s   þr   rO  rà   r9  rÐ   rÁ   rÂ   rm   údict[str, list[str]]ú Iterator[tuple[str | None, str]]c                 c  s‚    ||krt jtdƒ|ddd d S ||fV  |  |¡ | |d¡D ]}t| |||ƒD ]\}}|| vr=||fV  |  |¡ q+q"d S )Nz'self referenced toctree found. Ignored.ÚtocÚcircular©rV  ÚtypeÚsubtyper„   )rž   rY  r   rÊ   r  rN  )rO  r9  rÁ   rm   ÚchildÚ
sub_parentÚsub_docnamer„   r„   r…   rN    s*   €ü

ÿ

€ûÿrN  rM   c              
   C  sx   i }|   ¡ D ]\}}|D ]}| |g ¡ |¡ qqt|  ¡ ƒD ]\}}t|ƒdkr9tjtdƒ|t|ƒ||ddd qd S )NrC   zDdocument is referenced in multiple toctrees: %s, selecting: %s <- %srr  Úmultiple_toc_parentsrt  )	Úitemsr·   Úappendr¥   rš   rž   rŸ   r   Úmax)rm   Útoc_parentsr9  Úchildrenrw  r  Úparentsr„   r„   r…   rZ  6  s(   ÿÿ÷€þrZ  )re  r(   rf  r(   rL   rg  )
rO  rà   r9  rÐ   rÁ   rÂ   rm   rp  rL   rq  )rm   rp  rL   rM   )]r`  Ú
__future__r   rc  rÙ   r(  Úcollectionsr   r   r   Útypingr   Úsphinxr   Ú!sphinx.domains._domains_containerr   Úsphinx.environment.adaptersr	   r7  Úsphinx.errorsr
   r   r   r   Úsphinx.localer   Úsphinx.transformsr   Úsphinx.utilr   Úsphinx.util._filesr   r   Úsphinx.util._serialiser   Úsphinx.util._timestampsr   Úsphinx.util.docutilsr   Úsphinx.util.i18nr   r   Úsphinx.util.nodesr   Úsphinx.util.osutilr   r   r   Úcollections.abcr   r   r   Úpathlibr    r!   r"   Údocutilsr#   Údocutils.nodesr$   Údocutils.parsersr%   Úsphinx.applicationr&   Úsphinx.buildersr'   Úsphinx.configr(   Úsphinx.domainsr)   Úsphinx.eventsr*   Úsphinx.projectr+   Úsphinx.util._pathlibr,   Ú	getLoggerr]  rž   r@   Ú__annotations__ÚENV_VERSIONrS   r«   r˜   rª   rœ   ÚCONFIG_CHANGED_REASONrI   rJ   r   rN  rZ  r„   r„   r„   r…   Ú<module>   s˜    
ñýþ     
4
