§
    _÷#d›K  ã                   óš  — U d 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 ddlmZ ddlmZ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mZmZmZ ddl 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/ ddl0m1Z1m2Z2m3Z3m4Z4 ddl5m6Z6 ddl7m8Z8m9Z9m:Z:m;Z; ddl<m=Z=m>Z>m?Z?m@Z@mAZAmBZBmCZCmDZD ddlEmFZF erddlGmHZH  e/jI        eJ¦  «        ZK ejL        d¦  «        ZMeeNd<    ejL        d¦  «        ZOeeNd<   dePdePdePfd„ZQdePdePfd„ZR	 	 dbdePdeeFd f         d!eeFd f         deeP         fd"„ZSd#eePePf         d$ePdePfd%„ZT G d&„ d'eU¦  «        ZVdcd)„ZWdcd*„ZX G d+„ d,eU¦  «        ZYd-ZZd.ed/         dePfd0„Z[d1ePd2ePdeeP         fd3„Z\ ejL        d4¦  «        Z] G d5„ d6¦  «        Z^ G d7„ d8¦  «        Z_d9ePd:e`dee`         fd;„Zad<e`d=ePd>ePdeeP         fd?„Zbd=ePd>ePdeeP         fd@„ZcdddBe`dePfdC„ZddedDePdEeeP         defdF„ZedGePdeeeP         ePf         fdH„ZfdIePdePfdJ„ZgdKePdehfdL„ZidMedePfdN„Zj edO¦  «        ZkdPejfdQeek         dRePdSePdTeegePf         deekddf         f
dU„ZldPddejfdQeek         dRePdSePdVe`dWe`dTeegePf         deekddf         fdX„Zm G dY„ dZen¦  «        Zo G d[„ d\¦  «        Zpd]eqdePfd^„Zrd_ePdeqfd`„Zsdefda„ZtdS )fzUtility functions for Sphinx.é    N)Údatetime)Úimport_module)Úpath©ÚmktimeÚstrptime)ÚIOÚTYPE_CHECKINGÚAnyÚCallableÚDictÚ	GeneratorÚIterableÚListÚOptionalÚPatternÚSetÚTupleÚTypeÚTypeVar)Ú	parse_qslÚ
quote_plusÚ	urlencodeÚurlsplitÚ
urlunsplit)ÚRemovedInSphinx70Warning)ÚExtensionErrorÚFiletypeNotFoundErrorÚSphinxParallelError)Ú__)Úlogging)ÚboldÚcolorizeÚstrip_colorsÚterm_width_line)Ú	patfilter)Úcaption_ref_reÚexplicit_title_reÚnested_parse_with_titlesÚsplit_explicit_title)ÚSEPÚcopyfileÚ	copytimesÚ	ensuredirÚmake_filenameÚmtimes_of_filesÚos_pathÚrelative_uri)ÚPathMatcher)ÚSphinxz\s+Úws_rez(?P<schema>.+)://.*Úurl_reÚbasedocnameÚdocnameÚreturnc                 óh   — t          j        t          j        d| z   d|¦  «        ¦  «        dd …         S )Nú/z..é   )Ú	posixpathÚnormpathÚjoin)r7   r8   s     ú6/usr/lib/python3/dist-packages/sphinx/util/__init__.pyÚdocname_joinrA   /   s9   € ÝÔÝŒ�s˜[Ñ(¨$°Ñ8Ô8ñ:ô :Ø:;¸"¸"ô>ð >ó    Úfilepathc                 óp   — t          j        dt          d¬¦  «         ddlm} |                     | ¦  «        S )z+Normalize path separator and unicode stringz\'sphinx.util.path_stabilize' is deprecated, use 'sphinx.util.osutil.path_stabilize' instead.é   ©Ú
stacklevelr   )Úosutil)ÚwarningsÚwarnr   Úsphinx.utilrH   Úpath_stabilize)rC   rH   s     r@   rL   rL   4   sN   € å„Mð Aå*°qð:ñ :ô :ð :ð #Ð"Ð"Ð"Ð"Ð"à× Ò  Ñ*Ô*Ð*rB   © ÚdirnameÚexclude_matchers.Úinclude_matchersc              #   ó(  ‡	‡
‡K  — t          j        dt          d¬¦  «         t          j        t          j        | ¦  «        ¦  «        } t          j        | d¬¦  «        D ]³\  }Š	}t          j        || ¦  «        Š‰dk    rdŠt          ˆfd„‰	D ¦   «         ¦  «        }t          ˆfd	„|D ¦   «         ¦  «        }|D ]Š
ˆ
fd
„|D ¦   «         }ˆ
fd„|D ¦   «         }Œt          ˆ	fd„|D ¦   «         ¦  «        ‰	dd…<   t          |¦  «        D ]	\  }}|V — Œ
Œ´dS )z}Get all file names in a directory, recursively.

    Exclude files and dirs matching some matcher in *exclude_matchers*.
    zÅ'sphinx.util.get_matching_files' is deprecated, use 'sphinx.util.matching.get_matching_files' instead. Note thatthe types of the arguments have changed from callables to plain string glob patterns.rE   rF   T)Úfollowlinksú.Ú c              3   ó\   •K  — | ]&}t          t          j        ‰|¦  «        ¦  «        V — Œ'd S ©N©rL   r   r?   )Ú.0ÚdnÚrelativeroots     €r@   ú	<genexpr>z%get_matching_files.<locals>.<genexpr>Q   sK   øè è € ð *ð *Ø õ )­¬°<ÀÑ)DÔ)DÑEÔEð *ð *ð *ð *ð *ð *rB   c              3   ó\   •K  — | ]&}t          t          j        ‰|¦  «        ¦  «        V — Œ'd S rV   rW   )rX   ÚfnrZ   s     €r@   r[   z%get_matching_files.<locals>.<genexpr>S   sK   øè è € ð ,ð ,Ø!õ *­$¬)°LÀ"Ñ*EÔ*EÑFÔFð ,ð ,ð ,ð ,ð ,ð ,rB   c                 ó6   •— g | ]} ‰|d          ¦  «        °|‘ŒS ©r<   rM   ©rX   ÚentryÚmatchers     €r@   ú
<listcomp>z&get_matching_files.<locals>.<listcomp>V   s,   ø€ ÐGÐGÐG˜u°W°W¸UÀ1¼XÑ5FÔ5FÐG�UÐGÐGÐGrB   c                 ó6   •— g | ]} ‰|d          ¦  «        °|‘ŒS r_   rM   r`   s     €r@   rc   z&get_matching_files.<locals>.<listcomp>W   s,   ø€ ÐIÐIÐI °w°w¸uÀQ¼xÑ7HÔ7HÐI�eÐIÐIÐIrB   c              3   ó.   •K  — | ]\  }}‰|         V — Œd S rV   rM   )rX   ÚiÚ_Údirss      €r@   r[   z%get_matching_files.<locals>.<genexpr>Y   s+   øè è € Ð5Ð5¡V a¨˜˜aœÐ5Ð5Ð5Ð5Ð5Ð5rB   N)rI   rJ   r   r   r>   ÚabspathÚosÚwalkÚrelpathÚ	enumerateÚsorted)rN   rO   rP   ÚrootÚfilesÚqdirsÚqfilesÚ_iÚfilenamerh   rb   rZ   s            @@@r@   Úget_matching_filesru   >   s£  øøøè è € õ „Mð 0õ 2JÐVWðYñ Yô Yð Yõ
 Œm�DœL¨Ñ1Ô1Ñ2Ô2€GåœW W¸$Ð?Ñ?Ô?ð ð Ñˆˆd�EÝ”| D¨'Ñ2Ô2ˆØ˜3ÒÐØˆLåð *ð *ð *ð *Ø$(ð*ñ *ô *ñ *ô *ˆåð ,ð ,ð ,ð ,Ø%*ð,ñ ,ô ,ñ ,ô ,ˆà'ð 	Jð 	JˆGØGÐGÐGÐG¨ÐGÑGÔGˆEØIÐIÐIÐI¨ÐIÑIÔIˆFˆFåÐ5Ð5Ð5Ð5¨uÐ5Ñ5Ô5Ñ5Ô5ˆˆQˆQˆQ‰å" 6™NœNð 	ð 	‰LˆB�ØˆNˆNˆNˆNð	ðð rB   Úsource_suffixrt   c                 óz   — |                       ¦   «         D ] \  }}|                     |¦  «        r|pdc S Œ!t          ‚)NÚrestructuredtext)ÚitemsÚendswithr   )rv   rt   ÚsuffixÚfiletypes       r@   Úget_filetyper}   _   sW   € Ø)×/Ò/Ñ1Ô1ð $ð $Ñˆ�Ø×Ò˜VÑ$Ô$ð 	2àÐ1Ð1Ð1Ð1Ð1ð	2õ $Ð#rB   c                   ó¾   — e Zd ZdZdd„Zdededefd„Zdeddfd„Zd	ee         d
e	ee
ee         ef         f         ddfd„Zdee         fd„Zdee         ddfd„ZdS )ÚFilenameUniqDictzá
    A dictionary that automatically generates unique names for its keys,
    interpreted as filenames, and keeps track of a set of docnames they
    appear in.  Used for images and downloadable files in the environment.
    r9   Nc                 ó,   — t          ¦   «         | _        d S rV   )ÚsetÚ	_existing©Úselfs    r@   Ú__init__zFilenameUniqDict.__init__n   s   € Ý#&¡5¤5ˆŒˆˆrB   r8   Únewfilec                 óH  — || v r/| |         d                               |¦  «         | |         d         S t          j        |¦  «        }t          j        |¦  «        \  }}d}|| j        v r|dz  }|›|›|›�}|| j        v °|h|f| |<   | j                              |¦  «         |S )Nr   r<   )Úaddr   ÚbasenameÚsplitextr‚   )r„   r8   r†   Ú
uniquenameÚbaseÚextrf   s          r@   Úadd_filezFilenameUniqDict.add_fileq   sÃ   € Ø�dˆ?ˆ?Ø�ŒM˜!Ô× Ò  Ñ)Ô)Ð)Ø˜”= Ô#Ð#Ý”] 7Ñ+Ô+ˆ
Ý”M *Ñ-Ô-‰	ˆˆcØˆØ˜DœNÐ*Ð*Ø�‰FˆAØ%) T¨1¨1¨c¨cÐ2ˆJð ˜DœNÐ*Ð*ð "˜ JÐ/ˆˆW‰ØŒ×Ò˜:Ñ&Ô&Ð&ØÐrB   c                 óÂ   — t          |                      ¦   «         ¦  «        D ]<\  }\  }}|                     |¦  «         |s| |= | j                             |¦  «         Œ=d S rV   )Úlistry   Údiscardr‚   )r„   r8   rt   ÚdocsÚuniques        r@   Ú	purge_doczFilenameUniqDict.purge_doc   sl   € Ý(,¨T¯ZªZ©\¬\Ñ(:Ô(:ð 	/ð 	/Ñ$ˆH‘n�t˜VØ�LŠL˜Ñ!Ô!Ð!Øð /Ø˜�NØ”×&Ò& vÑ.Ô.Ð.øð		/ð 	/rB   ÚdocnamesÚotherc                 ó–   — |                      ¦   «         D ]3\  }\  }}|t          |¦  «        z  D ]}|                      ||¦  «         ŒŒ4d S rV   ©ry   r�   rŽ   )r„   r•   r–   rt   r’   Ú_uniqueÚdocs          r@   Úmerge_otherzFilenameUniqDict.merge_other†   sb   € Ø).¯ª©¬ð 	-ð 	-Ñ%ˆH‘o�t˜WØ�c (™mœmÑ+ð -ð -�Ø—’˜c 8Ñ,Ô,Ð,Ð,ð-ð	-ð 	-rB   c                 ó   — | j         S rV   ©r‚   rƒ   s    r@   Ú__getstate__zFilenameUniqDict.__getstate__‹   s
   € ØŒ~ÐrB   Ústatec                 ó   — || _         d S rV   r�   )r„   rŸ   s     r@   Ú__setstate__zFilenameUniqDict.__setstate__Ž   s   € ØˆŒˆˆrB   ©r9   N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r…   ÚstrrŽ   r”   r   r   r   r   r›   rž   r¡   rM   rB   r@   r   r   h   s  € € € € € ðð ð
)ð )ð )ð )ð ð ¨cð °cð ð ð ð ð/ ð /¨ð /ð /ð /ð /ð- C¨¤Hð -°T¸#¸uÀSÈÄXÈsÀ]Ô?SÐ:SÔ5Tð -ÐY]ð -ð -ð -ð -ð
˜c #œhð ð ð ð ð # c¤(ð ¨tð ð ð ð ð ð rB   r   rB   c                 ót   — 	 t          j        | fi |¤ŽS # t          $ r t          j        | fi |¤ddi¤ŽcY S w xY w)a3  Wrapper around hashlib.md5

    Attempt call with 'usedforsecurity=False' if we get a ValueError, which happens when
    OpenSSL FIPS mode is enabled:
    ValueError: error:060800A3:digital envelope routines:EVP_DigestInit_ex:disabled for fips

    See: https://github.com/sphinx-doc/sphinx/issues/7611
    ÚusedforsecurityF)ÚhashlibÚmd5Ú
ValueError©ÚdataÚkwargss     r@   r«   r«   ’   sh   € ðBÝŒ{˜4Ð*Ð* 6Ð*Ð*Ð*øÝð Bð Bð BÝŒ{˜4ÐAÐA 6ÐAÐA¸5ÐAÐAÐAÐAÐAÐAðBøøøó   ‚ ” 7¶7c                 ót   — 	 t          j        | fi |¤ŽS # t          $ r t          j        | fi |¤ddi¤ŽcY S w xY w)z¡Wrapper around hashlib.sha1

    Attempt call with 'usedforsecurity=False' if we get a ValueError

    See: https://github.com/sphinx-doc/sphinx/issues/7611
    r©   F)rª   Úsha1r¬   r­   s     r@   r²   r²   ¢   sh   € ðCÝŒ|˜DÐ+Ð+ FÐ+Ð+Ð+øÝð Cð Cð CÝŒ|˜DÐBÐB FÐBÐB¸EÐBÐBÐBÐBÐBÐBðCøøør°   c                   ó‚   — e Zd ZdZdededefd„Zdeddfd„Zdee         d	eee	ee         e
f         f         ddfd
„ZdS )ÚDownloadFilesz¥A special dictionary for download files.

    .. important:: This class would be refactored in nearly future.
                   Hence don't hack this directly.
    r8   rt   r9   c                 ó<  — || vrjt          |                     ¦   «         ¦  «                             ¦   «         }|›dt          j                             |¦  «        ›�}t          ¦   «         |f| |<   | |         d                              |¦  «         | |         d         S )Nr;   r   r<   )r«   ÚencodeÚ	hexdigestrj   r   r‰   r�   rˆ   )r„   r8   rt   ÚdigestÚdests        r@   rŽ   zDownloadFiles.add_file·   sŽ   € Ø˜4ÐÐÝ˜ŸšÑ*Ô*Ñ+Ô+×5Ò5Ñ7Ô7ˆFØ$˜f˜f¥b¤g×&6Ò&6°xÑ&@Ô&@Ð&@ÐAˆDÝ!™eœe T˜]ˆD�‰NàˆXŒ�qÔ×Ò˜gÑ&Ô&Ð&Ø�HŒ~˜aÔ Ð rB   Nc                 óŽ   — t          |                      ¦   «         ¦  «        D ]"\  }\  }}|                     |¦  «         |s| |= Œ#d S rV   )r�   ry   r‘   )r„   r8   rt   r’   Ú_dests        r@   r”   zDownloadFiles.purge_docÀ   sV   € Ý'+¨D¯JªJ©L¬LÑ'9Ô'9ð 	#ð 	#Ñ#ˆH‘m�t˜UØ�LŠL˜Ñ!Ô!Ð!Øð #Ø˜�Nøð	#ð 	#rB   r•   r–   c                 ó–   — |                      ¦   «         D ]3\  }\  }}|t          |¦  «        z  D ]}|                      ||¦  «         ŒŒ4d S rV   r˜   )r„   r•   r–   rt   r’   r»   r8   s          r@   r›   zDownloadFiles.merge_otherÆ   sb   € Ø',§{¢{¡}¤}ð 	1ð 	1Ñ#ˆH‘m�t˜UØ¥# h¡-¤-Ñ/ð 1ð 1�Ø—’˜g xÑ0Ô0Ð0Ð0ð1ð	1ð 	1rB   )r£   r¤   r¥   r¦   r§   rŽ   r”   r   r   r   r   r›   rM   rB   r@   r´   r´   °   s®   € € € € € ðð ð! ð !¨sð !°sð !ð !ð !ð !ð# ð #¨ð #ð #ð #ð #ð1 C¨¤Hð 1°T¸#¸uÀSÈÄXÈsÀ]Ô?SÐ:SÔ5Tð 1ÐY]ð 1ð 1ð 1ð 1ð 1ð 1rB   r´   z‡# Sphinx version: %s
# Python version: %s (%s)
# Docutils version: %s %s
# Jinja2 version: %s
# Last messages:
%s
# Loaded extensions:
Úappr4   c                 ó„  — ddl }ddl}ddl}ddl}t	          j        ¦   «         d         }t          |t          ¦  «        rd|j        z   }nt          j	        ¦   «         }t          j        dd¦  «        \  }}d}	| �$d                     d	„ | j        D ¦   «         ¦  «        }	t          j        |t           |j        |                     ¦   «         |                     ¦   «         |j        |j        |j        |	fz                       ¦   «         ¦  «         | �x| j                             ¦   «         D ]^}
t3          |
j        d
d¦  «        }|
j        dk    r;t          j        |d|
j        ›d|
j        ›d|›d�                     ¦   «         ¦  «         Œ_t          j        ||                     ¦   «         ¦  «         t          j        |¦  «         |S )z;Save the current exception's traceback in a temporary file.r   Nr<   z(Error in parallel process)
z.logzsphinx-err-rT   ú
c              3   ó^   K  — | ](}d t          |¦  «                             ¦   «         z  V — Œ)dS )z#   %sN)r$   Ústrip)rX   Úss     r@   r[   z!save_traceback.<locals>.<genexpr>ç   sM   è è € ð %ð %àð •| A‘”×,Ò,Ñ.Ô.Ñ.ð%ð %ð %ð %ð %ð %rB   Ú__file__ÚunknownÚbuiltinz#   z (z) from )ÚplatformÚdocutilsÚjinja2ÚsphinxÚsysÚexc_infoÚ
isinstancer   Ú	tracebackÚ
format_excÚtempfileÚmkstempr?   Ú
messagelogrj   ÚwriteÚ_DEBUG_HEADERÚ__display_version__Úpython_versionÚpython_implementationÚ__version__Ú__version_details__r¶   Ú
extensionsÚvaluesÚgetattrÚmoduleÚversionÚnameÚclose)r½   rÆ   rÇ   rÈ   rÉ   ÚexcÚ
exc_formatÚfdr   Ú	last_msgsr�   Úmodfiles               r@   Úsave_tracebackrå   ×   sÔ  € à€O€O€Oà€O€O€OØ€M€M€Mà€M€M€MÝ
Œ,‰.Œ.˜Ô
€CÝ�#Õ*Ñ+Ô+ð ,Ø4°s´}ÑDˆ
ˆ
åÔ)Ñ+Ô+ˆ
ÝÔ ¨Ñ6Ô6�H€BˆØ€IØ
€Ø—I’Ið %ð %à”^ð%ñ %ô %ñ %ô %ˆ	õ „HˆR•-ØÔ-Ø×*Ò*Ñ,Ô,Ø×1Ò1Ñ3Ô3ØÔ'¨Ô)EØÔ%Øðñ÷  &šv™xœxñ)ô )ð )ð €Ø”>×(Ò(Ñ*Ô*ð 	Jð 	JˆCÝ˜cœj¨*°iÑ@Ô@ˆGØŒ{˜iÒ'Ð'Ý”˜˜Ø"œx˜x˜x¨¬¨¨°g°g°gð?ß@FÂÁÄñJô Jð Jøå„HˆR�×"Ò"Ñ$Ô$Ñ%Ô%Ð%Ý„HˆR�L„L€LØ€KrB   ÚmodnameÚ	attributec                 ó¢   — | €d S t          | ¦  «        }|}|                     d¦  «        D ]}|rt          ||¦  «        }Œt          |dd ¦  «        S )NrS   r¤   )r   ÚsplitrÛ   )ræ   rç   rÜ   ÚvalueÚattrs        r@   Úget_full_modnamerì   ü   sg   € Ø€ð ˆtÝ˜7Ñ#Ô#€Fð €EØ—’ Ñ$Ô$ð )ð )ˆØð 	)Ý˜E 4Ñ(Ô(ˆEøå�5˜,¨Ñ-Ô-Ð-rB   zcoding[:=]\s*([-\w.]+)c                   óB   — e Zd ZdZdeddfd„Zdedeeef         fd„Z	dS )ÚUnicodeDecodeErrorHandlerz8Custom error handler for open() that warns and replaces.r8   r9   Nc                 ó   — || _         d S rV   )r8   )r„   r8   s     r@   r…   z"UnicodeDecodeErrorHandler.__init__  ó   € ØˆŒˆˆrB   Úerrorc                 ó  — |j                              dd|j        ¦  «        }|j                              d|j        ¦  «        }|dk    rt	          |j         ¦  «        }|j                              dd|j        ¦  «        dz   }t                               t          d¦  «        |j         |dz   |j        …         dz   |j         |j        |j	        …         z   dz   |j         |j	        |…         z   | j
        |f¬¦  «         d	|j	        fS )
Nó   
r   éÿÿÿÿr<   z5undecodable source characters, replacing with "?": %rs   >>>s   <<<)Úlocationú?)ÚobjectÚrfindÚstartÚfindÚlenÚcountÚloggerÚwarningr    Úendr8   )r„   rñ   Ú	linestartÚlineendÚlinenos        r@   Ú__call__z"UnicodeDecodeErrorHandler.__call__  s   € Ø”L×&Ò& u¨a°´Ñ=Ô=ˆ	Ø”,×#Ò# E¨5¬;Ñ7Ô7ˆØ�bŠ=ˆ=Ý˜%œ,Ñ'Ô'ˆGØ”×#Ò# E¨1¨e¬kÑ:Ô:¸QÑ>ˆÝ�Š•rÐQÑRÔRØœ Y°¡]°5´;Ð%>Ô?À&ÑHØœ U¤[°´Ð%:Ô;ñ<Ø>DñEàœ U¤Y¨wÐ%6Ô7ñ8ð "&¤¨vÐ 6ð	 	ñ 	8ô 	8ð 	8ð
 �U”YÐÐrB   )
r£   r¤   r¥   r¦   r§   r…   ÚUnicodeDecodeErrorr   Úintr  rM   rB   r@   rî   rî     sg   € € € € € ØBÐBð ð ¨ð ð ð ð ð Ð0ð  °U¸3À¸8´_ð  ð  ð  ð  ð  ð  rB   rî   c                   ó>   — e Zd ZdZdededdfd„Zdeddfd„Zd
d	„ZdS )ÚTeez2
    File-like object writing to two streams.
    Ústream1Ústream2r9   Nc                 ó"   — || _         || _        d S rV   )r  r	  )r„   r  r	  s      r@   r…   zTee.__init__+  s   € ØˆŒØˆŒˆˆrB   Útextc                 ón   — | j                              |¦  «         | j                             |¦  «         d S rV   )r  rÒ   r	  )r„   r  s     r@   rÒ   z	Tee.write/  s4   € ØŒ×Ò˜4Ñ Ô Ð ØŒ×Ò˜4Ñ Ô Ð Ð Ð rB   c                 óÂ   — t          | j        d¦  «        r| j                             ¦   «          t          | j        d¦  «        r| j                             ¦   «          d S d S )NÚflush)Úhasattrr  r  r	  rƒ   s    r@   r  z	Tee.flush3  sb   € Ý�4”< Ñ)Ô)ð 	!ØŒL×ÒÑ Ô Ð Ý�4”< Ñ)Ô)ð 	!ØŒL×ÒÑ Ô Ð Ð Ð ð	!ð 	!rB   r¢   )	r£   r¤   r¥   r¦   r	   r…   r§   rÒ   r  rM   rB   r@   r  r  '  s}   € € € € € ðð ð ð ¨Rð °Dð ð ð ð ð!˜#ð ! $ð !ð !ð !ð !ð!ð !ð !ð !ð !ð !rB   r  ÚspecÚtotalc                 óŒ  — g }|                       d¦  «        }|D �](}	 |                     ¦   «                               d¦  «        }ddg|k    rt          ‚t          |¦  «        dk    r,|                     t          |d         ¦  «        dz
  ¦  «         nŠt          |¦  «        dk    rpt          |d         pd¦  «        }t          |d         pt          ||¦  «        ¦  «        }||k    rt          ‚|                     t          |dz
  |¦  «        ¦  «         nt          ‚�Œ# t          $ r}t          d| z  ¦  «        |‚d}~ww xY w|S )	z_Parse a line number spec (such as "1,2,4-6") and return a list of
    wanted line numbers.
    ú,ú-rT   r<   r   rE   zinvalid line number spec: %rN)
ré   rÁ   r¬   rû   Úappendr  ÚmaxÚextendÚrangeÚ	Exception)	r  r  ry   ÚpartsÚpartÚbegendrù   rÿ   rà   s	            r@   Úparselinenosr  :  sS  € ð €EØ�JŠJ�s‰OŒO€EØð Mñ Mˆð	MØ—Z’Z‘\”\×'Ò'¨Ñ,Ô,ˆFØ�Bˆx˜6Ò!Ð!Ý Ð Ý�V‘” Ò!Ð!Ø—’�S ¨¤™^œ^¨aÑ/Ñ0Ô0Ð0Ð0Ý�V‘” Ò!Ð!Ý˜F 1œI˜N¨Ñ+Ô+�Ý˜& œ)Ð8¥s¨5°%Ñ'8Ô'8Ñ9Ô9�Ø˜3’;�;Ý$Ð$Ø—’�U 5¨1¡9¨cÑ2Ô2Ñ3Ô3Ð3Ð3å Ð ùøÝð 	Mð 	Mð 	MÝÐ;¸dÑBÑCÔCÈÐLøøøøð	Møøøð €Ls   žC?DÄ
EÄ)D<Ä<EÚnÚtyperê   c                 ó°   — d„ |                      d| dz
  ¦  «        D ¦   «         }t          d„ |D ¦   «         ¦  «        | k     rt          d|›d|›�¦  «        ‚|S )z@Split an index entry into a given number of parts at semicolons.c                 ó6   — g | ]}|                      ¦   «         ‘ŒS rM   )rÁ   )rX   Úxs     r@   rc   zsplit_into.<locals>.<listcomp>W  s    € Ð8Ð8Ð8˜1ˆQ�WŠW‰YŒYÐ8Ð8Ð8rB   ú;r<   c              3   ó   K  — | ]}|¯d V — Œ	dS )r<   NrM   )rX   r  s     r@   r[   zsplit_into.<locals>.<genexpr>X  s'   è è € Ð
'Ð
'� $Ð
'ˆ1Ð
'Ð
'Ð
'Ð
'Ð
'Ð
'rB   úinvalid ú index entry )ré   Úsumr¬   )r  r  rê   r  s       r@   Ú
split_intor(  U  si   € à8Ð8 §¢¨C°°Q±Ñ 7Ô 7Ð8Ñ8Ô8€EÝ
Ð
'Ð
'˜Ð
'Ñ
'Ô
'Ñ'Ô'¨!Ò+Ð+Ýˆj¸¸¸¸e¸eÐDÑEÔEÐEØ€LrB   c                 ód  — | dk    r4	 t          dd|¦  «        }n–# t          $ r t          dd|¦  «        }Y nyw xY w| dk    rt          dd|¦  «        }n]| dk    rt          dd|¦  «        }nE| dk    rt          dd|¦  «        }n-| dk    rt          dd|¦  «        }nt          d	| ›d
|›�¦  «        ‚|S )NÚsinglerE   r<   ÚpairÚtripleé   ÚseeÚseealsor%  r&  )r(  r¬   )r  rê   Úresults      r@   Úsplit_index_msgr1  ]  sé   € àˆxÒÐð	4Ý  8¨UÑ3Ô3ˆFˆFøÝð 	4ð 	4ð 	4Ý  8¨UÑ3Ô3ˆFˆFˆFð	4øøøà	�ŠˆÝ˜A˜v uÑ-Ô-ˆˆØ	�Ò	Ð	Ý˜A˜x¨Ñ/Ô/ˆˆØ	�ŠˆÝ˜A˜u eÑ,Ô,ˆˆØ	�Ò	Ð	Ý˜A˜u eÑ,Ô,ˆˆåˆj¸¸¸¸e¸eÐDÑEÔEÐEà€Ms   ˆ š8·8r<   r"  c                 óÒ   — t          j        ¦   «         \  }}}g }t          j        |¦  «        }|||  d…         z  }|t          j        ||¦  «        z  }d                     |¦  «        S )z?Format an exception with traceback, but only the last x frames.NrT   )rÊ   rË   rÍ   Ú	format_tbÚformat_exception_onlyr?   )r"  ÚtypÚvalÚtbÚresÚtbress         r@   Úformat_exception_cut_framesr:  r  sc   € å”<‘>”>�L€Cˆˆbà€CÝÔ Ñ#Ô#€EØˆ5�!���Œ:Ñ€CØ�9Ô*¨3°Ñ4Ô4Ñ4€CØ�7Š7�3‰<Œ<ÐrB   ÚobjnameÚsourcec                 ó‚  — 	 |                       d¦  «        }|                     d¦  «        }t          |¦  «        }|D ]:}|d|z   z  }	 t          ||¦  «        }Œ# t          $ r t          |¦  «        }Y Œ7w xY w|S # t          t
          f$ r3}|rt          d| ›d|›d�|¦  «        |‚t          d| z  |¦  «        |‚d}~ww xY w)z!Import python object by qualname.rS   r   zCould not import z (needed for ú)zCould not import %sN)ré   Úpopr   rÛ   ÚAttributeErrorÚImportErrorr   )r;  r<  Úobjpathræ   ÚobjrÞ   rà   s          r@   Úimport_objectrD  }  s  € ðPØ—-’- Ñ$Ô$ˆØ—+’+˜a‘.”.ˆÝ˜GÑ$Ô$ˆØð 	-ð 	-ˆDØ�s˜T‘zÑ!ˆGð-Ý˜c 4Ñ(Ô(��øÝ!ð -ð -ð -Ý# GÑ,Ô,���ð-øøøð ˆ
øÝ�KÐ(ð Pð Pð PØð 	PÝ �.Ø") ' '¨6¨6¨6ð"3Ø47ñ9ô 9Ø>AðBõ !Ð!6¸Ñ!@À#ÑFÔFÈCÐOøøøøðPøøøs<   ‚AA: ÁAÁA: ÁA5Á2A: Á4A5Á5A: Á:B>Â.B9Â9B>rÞ   c                 óÄ  — |                       d¦  «        }t          |d¦  «        D ]·\  }}	 d                     |d|…         ¦  «        }t          |¦  «         Œ3# t          $ rm |d|dz
  …         rDd                     |d|dz
  …         ¦  «        d                     ||dz
  d…         ¦  «        fcY c S dd                     |¦  «        fcY c S t
          $ r Y Œ´w xY w| dfS )a  Split full qualified name to a pair of modname and qualname.

    A qualname is an abbreviation for "Qualified name" introduced at PEP-3155
    (https://peps.python.org/pep-3155/).  It is a dotted path name
    from the module top-level.

    A "full" qualified name means a string containing both module name and
    qualified name.

    .. note:: This function actually imports the module to check its existence.
              Therefore you need to mock 3rd party modules if needed before
              calling this function.
    rS   r<   NrT   )ré   rm   r?   r   rA  Ú
IndexError)rÞ   r  rf   Ú_partræ   s        r@   Úsplit_full_qualified_namerH  “  s  € ð �JŠJ�s‰OŒO€EÝ˜e QÑ'Ô'ð 
ð 
‰ˆˆ5ð		Ø—h’h˜u R a RœyÑ)Ô)ˆGÝ˜'Ñ"Ô"Ð"Ð"øÝð 	-ð 	-ð 	-Ø�V�a˜!‘e�VŒ}ð -Ø—x’x  f q¨1¡u f¤Ñ.Ô.°·²¸¸qÀ1¹u¸v¸v¼Ñ0GÔ0GÐGÐGÐGÐGÐGÐGà˜SŸXšX e™_œ_Ð,Ð,Ð,Ð,Ð,Ð,Ýð 	ð 	ð 	ØˆDð	øøøð �ˆ8€Os   ¬,AÁACÂ4CÃ	CÃCÚuric                 ór  — t          t          | ¦  «        ¦  «        }|d                              d¦  «                             d¦  «        |d<   t	          |d                              ¦   «         d¦  «        |d<   d„ t          |d         ¦  «        D ¦   «         }t          |¦  «        |d<   t          |¦  «        S )Nr<   ÚidnaÚasciirE   r;   c                 ó@   — g | ]\  }}||                      ¦   «         f‘ŒS rM   )r¶   )rX   ÚqÚvs      r@   rc   zencode_uri.<locals>.<listcomp>µ  s(   € Ð?Ð?Ð?¡ ! Qˆa�—’‘”ˆ_Ð?Ð?Ð?rB   r-  )r�   r   r¶   Údecoder   r   r   r   )rI  ré   Úquerys      r@   Ú
encode_urirR  ±  s›   € Ý•˜#‘”ÑÔ€EØ�QŒx�Š˜vÑ&Ô&×-Ò-¨gÑ6Ô6€Eˆ!�HÝ˜% œ(Ÿ/š/Ñ+Ô+¨SÑ1Ô1€Eˆ!�HØ?Ð?­9°U¸1´XÑ+>Ô+>Ð?Ñ?Ô?€EÝ˜ÑÔ€Eˆ!�HÝ�eÑÔÐrB   Úurlc                 ó   — | rd| v rdS dS )zCheck *url* is URL or not.z://TFrM   )rS  s    r@   ÚisurlrU  º  s   € à
ð ˆu˜ˆ|ˆ|ØˆtàˆurB   Úchunkc                 óÎ   — t          | t          t          f¦  «        r;t          | ¦  «        dk    rt	          | d         ¦  «        S | d         ›d| d         ›�S t	          | ¦  «        S )Nr<   r   z .. rô   )rÌ   r�   Útuplerû   r§   )rV  s    r@   Údisplay_chunkrY  Â  s\   € Ý�%�$¥˜Ñ'Ô'ð 2Ýˆu‰:Œ:˜Š?ˆ?Ý�u˜Q”x‘=”=Ð Ø" 1œX˜X˜X u¨R¤y yÐ1Ð1Ýˆu‰:Œ:ÐrB   ÚTÚ	darkgreenÚiterableÚsummaryÚcolorÚstringify_funcc              #   óJ  K  — d}| D ]y}|dk    r+t                                t          |¦  «        d¬¦  «         d}t                                 ||¦  «        |d¬¦  «         t                                dd¬¦  «         |V — Œz|dk    rt                                d¦  «         d S d S )Nr   T©Únonlr<   )r^  rb  ú rT   )rý   Úinfor"   )r\  r]  r^  r_  ÚlÚitems         r@   Úold_status_iteratorrg  Í  s¬   è è € ð 	
€AØð ð ˆØ�Š6ˆ6Ý�KŠK�˜W™œ¨DˆKÑ1Ô1Ð1ØˆAÝ�Š�N�N 4Ñ(Ô(°¸DˆÑAÔAÐAÝ�Š�C˜dˆÑ#Ô#Ð#Øˆ
ˆ
ˆ
ˆ
ØˆA‚v€vÝ�Š�B‰Œˆˆˆð €vrB   ÚlengthÚ	verbosityc           
   #   ó|  K  — |dk    rt          | |||¦  «        E d {V —† d S d}t          |¦  «        }| D ]c}|dz  }d|d|z  |z  t          | ||¦  «        ¦  «        fz  }|r|dz  }nt          |¦  «        }t                               |d¬¦  «         |V — Œd|dk    rt                               d¦  «         d S d S )	Nr   r<   z%s[%3d%%] %séd   r¿   Tra  rT   )rg  r"   r#   r%   rý   rd  )	r\  r]  r^  rh  ri  r_  re  rf  rÂ   s	            r@   Ústatus_iteratorrl  Ý  s÷   è è € ð �‚{€{Ý& x°¸%ÀÑPÔPÐPÐPÐPÐPÐPÐPÐPØˆØ	€AÝ�7‰mŒm€GØð ð ˆØ	ˆQ‰ˆØ˜g s¨Q¡w°Ñ'7½À%ÈÈÐX\ÑI]ÔI]Ñ9^Ô9^Ð_Ñ_ˆØð 	#Ø�‰IˆAˆAå Ñ"Ô"ˆAÝ�Š�A˜DˆÑ!Ô!Ð!Øˆ
ˆ
ˆ
ˆ
Øˆ1‚u€uÝ�Š�B‰Œˆˆˆð €urB   c                   ó   — e Zd ZdS )ÚSkipProgressMessageN)r£   r¤   r¥   rM   rB   r@   rn  rn  ó  s   € € € € € Ø€DrB   rn  c                   óZ   — e Zd Zdeddfd„Zdd„Zdee         dedede	fd	„Z
d
edefd„ZdS )Úprogress_messageÚmessager9   Nc                 ó   — || _         d S rV   )rq  )r„   rq  s     r@   r…   zprogress_message.__init__ø  rð   rB   c                 óh   — t                                t          | j        dz   ¦  «        d¬¦  «         d S )Nz... Tra  )rý   rd  r"   rq  rƒ   s    r@   Ú	__enter__zprogress_message.__enter__û  s-   € Ý�Š•D˜œ¨Ñ.Ñ/Ô/°dˆÑ;Ô;Ð;Ð;Ð;rB   Úexc_typeÚ	exc_valuerÍ   c                 óX  — t          |t          ¦  «        rCt                               t	          d¦  «        ¦  «         |j        rt          j        |j        Ž  dS |r(t                               t	          d¦  «        ¦  «         n't                               t	          d¦  «        ¦  «         dS )NÚskippedTÚfailedÚdoneF)rÌ   rn  rý   rd  r    Úargs)r„   ru  rv  rÍ   s       r@   Ú__exit__zprogress_message.__exit__þ  s‹   € Ý�iÕ!4Ñ5Ô5ð 	$Ý�KŠK�˜9™œÑ&Ô&Ð&ØŒ~ð -Ý”˜Yœ^Ð,Ð,Ø�4Øð 	$Ý�KŠK�˜8™œÑ%Ô%Ð%Ð%å�KŠK�˜6™
œ
Ñ#Ô#Ð#àˆurB   Úfc                 óv   ‡ ‡— t          j        ‰¦  «        dt          dt          dt          fˆˆ fd„¦   «         }|S )Nr{  r¯   r9   c                  óL   •— ‰5   ‰| i |¤Žcd d d ¦  «         S # 1 swxY w Y   d S rV   rM   )r{  r¯   r}  r„   s     €€r@   Úwrapperz*progress_message.__call__.<locals>.wrapper  s   ø€ àð *ð *Ø�q˜$Ð) &Ð)Ð)ð*ð *ð *ð *ñ *ô *ð *ð *ð *ð *ð *ð *øøøð *ð *ð *ð *ð *ð *s   „™ )Ú	functoolsÚwrapsr   )r„   r}  r€  s   `` r@   r  zprogress_message.__call__  sX   øø€ Ý	Œ˜Ñ	Ô	ð	*�3ð 	*­#ð 	*µ#ð 	*ð 	*ð 	*ð 	*ð 	*ð 	*ñ 
Ô	ð	*ð ˆrB   r¢   )r£   r¤   r¥   r§   r…   rt  r   r  r   Úboolr|  r   r  rM   rB   r@   rp  rp  ÷  s¢   € € € € € ð ð ¨ð ð ð ð ð<ð <ð <ð <ð  i¤ð ¸Yð ÐSVð Ð[_ð ð ð ð ð˜(ð  xð ð ð ð ð ð rB   rp  Úepochc                 ó\   — ddl m} t          j        | ¦  «        }d} |||d¬¦  «        dz   S )z)Convert datetime format epoch to RFC1123.r   )Úformat_datetimezEEE, dd LLL yyyy hh:mm:ssÚen)Úlocalez GMT)Úbabel.datesr†  r   Úfromtimestamp)r„  r†  ÚdtÚfmts       r@   Úepoch_to_rfc1123r�    sE   € à+Ð+Ð+Ð+Ð+Ð+å	Ô	 Ñ	&Ô	&€BØ
%€CØˆ?˜2˜s¨4Ð0Ñ0Ô0°6Ñ9Ð9rB   Úrfc1123c                 ó<   — t          t          | d¦  «        ¦  «        S )Nz%a, %d %b %Y %H:%M:%S %Zr   )rŽ  s    r@   Úrfc1123_to_epochr�    s   € Ý•(˜7Ð$>Ñ?Ô?Ñ@Ô@Ð@rB   c                  ó  ‡— dddgdddgddgd	d
gddgddgddgddgddgddgddgddgddgddgg} dd d!d"gd#d$d%gd&d'gg}d0d)t           d*t          d+t          fˆfd,„Š ‰| ¦  «        } ‰|¦  «        }t          j        d-|›d.|›d(|›d/�¦  «        S )1Nú:ÚAÚZrg   ÚaÚzõ   Ã€õ   Ã–õ   Ã˜õ   Ã¶õ   Ã¸u   Ë¿u   Í°u   Í½u   Í¿u   á¿¿u   â€Œu   â€�u   â�°u   â†�u   â°€u   â¿¯u   ã€�u   íŸ¿u   ï¤€u   ï·�u   ï·°u   ï¿½u   ð�€€u   ó¯¿¿z\-z\.Ú0Ú9õ   Â·u   Ì€u   Í¯u   â€¿u   â�€ú|ÚentriesÚsplitterr9   c                 óÖ   •— g }| D ]O}t          |t          ¦  «        r#|                     d ‰|d¦  «        z  ¦  «         Œ:|                     |¦  «         ŒP|                     |¦  «        S )Nz[%s]r  )rÌ   r�   r  r?   )r   r¡  Úresultsra   Úconverts       €r@   r¤  z xmlname_checker.<locals>.convert/  sv   ø€ ØˆØð 	&ð 	&ˆEÝ˜%¥Ñ&Ô&ð &Ø—’˜v¨¨°°sÑ(;Ô(;Ñ;Ñ<Ô<Ð<Ð<à—’˜uÑ%Ô%Ð%Ð%Ø�}Š}˜WÑ%Ô%Ð%rB   ú(z)(z)*)rŸ  )r   r§   ÚreÚcompile)Úname_start_charsÚ
name_charsÚstart_chars_regexÚname_chars_regexr¤  s       @r@   Úxmlname_checkerr¬  !  s0  ø€ ð 	ˆc�3ˆZ˜˜s C˜j¨8°XÐ*>Ø	�8Ð˜x¨Ð2°X¸xÐ4HØ	�8Ð˜x¨Ð2°X¸xÐ4HØ	�8Ð˜x¨Ð2°X¸xÐ4HØ	�8Ð˜|¨\Ð:ð<Ðð 	ˆu�s˜C�j (¨X°xÐ,@Ø	�8Ðð€Jð
&ð &�ð &­ð &µcð &ð &ð &ð &ð &ð &ð  ˜Ð 0Ñ1Ô1ÐØ�w˜zÑ*Ô*ÐÝŒ:ˆ:ØÐÐÐ,Ð,Ð,Ð.>Ð.>Ð.>ð@ñ Aô Að ArB   )rM   rM   )rB   r_   rV   )ur¦   r�  rª   rj   r=   r¦  rÊ   rÏ   rÍ   rI   r   Ú	importlibr   r   Útimer   r   Útypingr	   r
   r   r   r   r   r   r   r   r   r   r   r   r   Úurllib.parser   r   r   r   r   Úsphinx.deprecationr   Úsphinx.errorsr   r   r   Úsphinx.localer    rK   r!   Úsphinx.util.consoler"   r#   r$   r%   Úsphinx.util.matchingr&   Úsphinx.util.nodesr'   r(   r)   r*   Úsphinx.util.osutilr+   r,   r-   r.   r/   r0   r1   r2   Úsphinx.util.typingr3   Úsphinx.applicationr4   Ú	getLoggerr£   rý   r§  r5   Ú__annotations__r6   r§   rA   rL   ru   r}   Údictr   r«   r²   r´   rÓ   rå   rì   Ú
_coding_rerî   r  r  r  r(  r1  r:  rD  rH  rR  rƒ  rU  rY  rZ  rg  rl  r  rn  rp  Úfloatr�  r�  r¬  rM   rB   r@   ú<module>r¿     s¹  ðØ #Ð #Ð #à Ð Ð Ð Ø €€€Ø 	€	€	€	Ø Ð Ð Ð Ø 	€	€	€	Ø 
€
€
€
Ø €€€Ø Ð Ð Ð Ø €€€Ø Ð Ð Ð Ð Ð Ø #Ð #Ð #Ð #Ð #Ð #Ø Ð Ð Ð Ð Ð Ø !Ð !Ð !Ð !Ð !Ð !Ð !Ð !ðBð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bð Bà OÐ OÐ OÐ OÐ OÐ OÐ OÐ OÐ OÐ OÐ OÐ OÐ OÐ Oà 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø TÐ TÐ TÐ TÐ TÐ TÐ TÐ TÐ TÐ TØ Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø MÐ MÐ MÐ MÐ MÐ MÐ MÐ MÐ MÐ MÐ MÐ MØ *Ð *Ð *Ð *Ð *Ð *ðOð Oð Oð Oð Oð Oð Oð Oð Oð Oð Oð OðHð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hð Hà *Ð *Ð *Ð *Ð *Ð *àð *Ø)Ð)Ð)Ð)Ð)Ð)ð 
ˆÔ	˜8Ñ	$Ô	$€ð �”˜FÑ#Ô#€€wÐ #Ð #Ñ #Ø�"”*Ð3Ñ4Ô4€ˆÐ 4Ð 4Ñ 4ð
>˜cð >¨Cð >°Cð >ð >ð >ð >ð
+˜Sð + Sð +ð +ð +ð +ð DFØCEðð  ð Ø).¨{¸CÐ/?Ô)@ðà).¨{¸CÐ/?Ô)@ðàJRÐSVÌ-ðð ð ð ðB$  S¨# X¤ð $¸#ð $À#ð $ð $ð $ð $ð'ð 'ð 'ð 'ð '�tñ 'ô 'ð 'ðTBð Bð Bð Bð Cð Cð Cð Cð1ð 1ð 1ð 1ð 1�Dñ 1ô 1ð 1ð8€ð"˜ Ô*ð "¨sð "ð "ð "ð "ðJ.˜cð .¨cð .°h¸s´mð .ð .ð .ð .ð$ ˆRŒZÐ1Ñ2Ô2€
ð ð  ð  ð  ð  ñ  ô  ð  ð,!ð !ð !ð !ð !ñ !ô !ð !ð&�sð  3ð ¨4°¬9ð ð ð ð ð6�#ð ˜Sð ¨ð °°c´ð ð ð ð ð˜#ð  cð ¨d°3¬ið ð ð ð ð*ð  3ð ¨sð ð ð ð ðPð P˜3ð P¨°¬ð PÀð Pð Pð Pð Pð, Cð ¨E°(¸3´-ÀÐ2DÔ,Eð ð ð ð ð<�Cð ˜Cð ð ð ð ðˆsð �tð ð ð ð ð˜ð  ð ð ð ð ð €GˆC�L„L€ð KVØ?Lðð  (¨1¤+ð ¸ð ÀCð Ø(0°#°¸°Ô(<ðà& q¨$° }Ô5ðð ð ð ð  GRØ"#°aØ;Hðð ˜h qœkð °Cð Àð ØðØ03ðà$,¨c¨U°C¨ZÔ$8ðð # 1 d¨D =Ô1ðð ð ð ð,	ð 	ð 	ð 	ð 	˜)ñ 	ô 	ð 	ðð ð ð ð ñ ô ð ð::˜Eð : cð :ð :ð :ð :ðA˜cð A eð Að Að Að AðA˜ð Að Að Að Að Að ArB   