§
    _÷#d}T  ã                   óØ  — d Z ddlZddlZddl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 ddlmZmZ ddlmZ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& e
rddl'm(Z( ddl)m*Z*  ej+        e,¦  «        Z-dZ.e/ej0        ej1        fZ2 ej3        d¦  «        Z4 G d„ de¦  «        Z5dede6fd„Z7 G d„ d¦  «        Z8 G d„ d¦  «        Z9de:dee$         dee:ef         fd„Z;ddde9ddfd „Z<ddde9ddfd!„Z=ddde9ddfd"„Z>ddde9ddfd#„Z?ded         de9ddfd$„Z@ddde9ddfd%„ZAddd&d'd(ee:         d)ee:         d*ee:         dee:         fd+„ZBdddee:ef         fd,„ZCdS )-z"Build configuration file handling.é    N)ÚOrderedDict)ÚgetenvÚpath)ÚTYPE_CHECKINGÚAnyÚCallableÚDictÚ	GeneratorÚIteratorÚListÚ
NamedTupleÚOptionalÚSetÚTupleÚUnion)ÚConfigErrorÚExtensionError)Ú_Ú__)Úlogging)Úformat_date)ÚcdÚfs_encoding)ÚTags)ÚNoneType)ÚSphinx)ÚBuildEnvironmentzconf.pyz^((\d{4}-)?)(\d{4})(?=[ ,])c                   ó>   — e Zd ZU eed<   eed<   eeef         ed<   dS )ÚConfigValueÚnameÚvalueÚrebuildN)Ú__name__Ú
__module__Ú__qualname__ÚstrÚ__annotations__r   r   Úbool© ó    ú//usr/lib/python3/dist-packages/sphinx/config.pyr   r      s9   € € € € € € Ø
€I€I�IØ€J€J�JØ�4˜�9ÔÐÐÑÐÐr*   r   ÚobjÚreturnc                 óL  — t          | t          ¦  «        rdS t          | t          ¦  «        r<|                      ¦   «         D ]&\  }}t	          |¦  «        rt	          |¦  «        s dS Œ'n;t          | t
          t          t          f¦  «        rt          d„ | D ¦   «         ¦  «        S dS )z'Check if object is serializable or not.Fc              3   ó4   K  — | ]}t          |¦  «        V — Œd S ©N)Úis_serializable)Ú.0Úis     r+   ú	<genexpr>z"is_serializable.<locals>.<genexpr>-   s*   è è € Ð3Ð3¨!•? 1Ñ%Ô%Ð3Ð3Ð3Ð3Ð3Ð3r*   T)	Ú
isinstanceÚUNSERIALIZABLE_TYPESÚdictÚitemsr1   ÚlistÚtupleÚsetÚall)r,   Úkeyr!   s      r+   r1   r1   $   s´   € å�#Õ+Ñ,Ô,ð 4ØˆuÝ	�C�Ñ	Ô	ð 4ØŸ)š)™+œ+ð 	ð 	‰JˆC�Ý" 3Ñ'Ô'ð ­¸uÑ/EÔ/Eð Ø�u�uðð	õ 
�C�$¥¥sÐ+Ñ	,Ô	,ð 4ÝÐ3Ð3¨sÐ3Ñ3Ô3Ñ3Ô3Ð3àˆ4r*   c                   óD   — e Zd ZdZdeddfd„Zdeeeef         de	fd„Z
dS )ÚENUMz±Represents the candidates which a config value should be one of.

    Example:
        app.add_config_value('latex_show_urls', 'no', None, ENUM('no', 'footnote', 'inline'))
    Ú
candidatesr-   Nc                 ó   — || _         d S r0   ©r@   )Úselfr@   s     r+   Ú__init__zENUM.__init__8   s   € Ø$ˆŒˆˆr*   r!   c                 ó„   ‡ — t          |t          t          f¦  «        rt          ˆ fd„|D ¦   «         ¦  «        S |‰ j        v S )Nc              3   ó*   •K  — | ]}|‰j         v V — Œd S r0   rB   )r2   ÚitemrC   s     €r+   r4   zENUM.match.<locals>.<genexpr>=   s*   øè è € ÐAÐA°4�t˜tœÐ.ÐAÐAÐAÐAÐAÐAr*   )r5   r9   r:   r<   r@   )rC   r!   s   ` r+   Úmatchz
ENUM.match;   sI   ø€ Ý�e�d¥E˜]Ñ+Ô+ð 	,ÝÐAÐAÐAÐA¸5ÐAÑAÔAÑAÔAÐAà˜DœOÐ+Ð+r*   )r#   r$   r%   Ú__doc__r&   rD   r   r   r   r(   rH   r)   r*   r+   r?   r?   2   sn   € € € € € ðð ð
% Cð %¨Dð %ð %ð %ð %ð,˜5  d¨EÐ!1Ô2ð ,°tð ,ð ,ð ,ð ,ð ,ð ,r*   r?   c            
       ó¸  — e Zd ZU dZi dddg f“dddg f“ddd	egf“d
d„ d	egf“dddg f“dddg f“dddg f“dddegf“dddegf“ddgdg f“dddegf“dddg f“dddg f“dd„ dg f“ddd idef“d!d"dg f“d#g degf“i d$d%gdegf“d&ddegf“d'd(dg f“d)d(dg f“d*d(degf“d+d,d ed,d-d.¦  «        f“d/ddg f“d0ddg f“d1dd	egf“d2d3dg f“d4i dg f“d5g d	g f“d6dd	egf“d7ddg f“d8g dg f“d9g d	g f“d:ddegf“¥i d;ddegf“d<d(dg f“d=d>degf“d?ddegf“d@i dg f“dAddg f“dBddg f“dCg dg f“dDg dg f“dEddg f“dFdGdg f“dHi dg f“dIddg f“dJddegf“dKd(dg f“dLd(dg f“dMddg f“¥ddegfd(dg fdNdg fdOgdPdQgdRœdg fddg fdSœ¥Z	e
eef         edT<   i i fdUe
eef         dVe
eef         dWdfdX„Ze	 dodYedVee
         dZee         dWd fd[„¦   «         Zd\ed]edWefd^„Zdpd_„Zdpd`„Zdpda„Zd\edWefdb„Zd\edWefdc„Zd\ed]edWdfdd„Zd\edWdfde„Zd\edWefdf„ZdWeeddf         fdg„Zd\ed3edheeef         diedWdf
dj„Zdheee e         f         dWe!e         fdk„Z"dWe
fdl„Z#dme
dWdfdn„Z$dS )qÚConfigaŒ  Configuration file abstraction.

    The config object makes the values of all config values available as
    attributes.

    It is exposed via the :py:attr:`sphinx.application.Application.config` and
    :py:attr:`sphinx.environment.Environment.config` attributes. For example,
    to get the value of :confval:`language`, use either ``app.config.language``
    or ``env.config.language``.
    ÚprojectÚPythonÚenvÚauthorÚunknownÚproject_copyrightÚ ÚhtmlÚ	copyrightc                 ó   — | j         S r0   )rQ   )Úcs    r+   ú<lambda>zConfig.<lambda>X   s	   €  Ô 3€ r*   ÚversionÚreleaseÚtodayÚ	today_fmtNÚlanguageÚenÚlocale_dirsÚlocalesÚfigure_language_filenamez{root}.{language}{ext}Ú gettext_allow_fuzzy_translationsFÚgettextÚ
master_docÚindexÚroot_docc                 ó   — | j         S r0   )rc   )Úconfigs    r+   rW   zConfig.<lambda>e   s	   €  FÔ$5€ r*   Úsource_suffixz.rstÚrestructuredtextÚsource_encodingz	utf-8-sigÚexclude_patternsÚinclude_patternsz**Údefault_roleÚadd_function_parenthesesTÚadd_module_namesÚtoc_object_entriesÚtoc_object_entries_show_parentsÚdomainr<   ÚhideÚtrim_footnote_reference_spaceÚshow_authorsÚpygments_styleÚhighlight_languageÚdefaultÚhighlight_optionsÚtemplates_pathÚtemplate_bridgeÚkeep_warningsÚsuppress_warningsÚmodindex_common_prefixÚ
rst_epilogÚ
rst_prologÚtrim_doctest_flagsÚprimary_domainÚpyÚneeds_sphinxÚneeds_extensionsÚmanpages_urlÚnitpickyÚnitpick_ignoreÚnitpick_ignore_regexÚnumfigÚnumfig_secnum_depthé   Únumfig_formatÚmath_number_allÚmath_eqref_formatÚmath_numfigÚ
tls_verifyÚtls_cacertsÚqDeÚjaÚmanÚtext)Ú	languagesÚbuilders)Ú
user_agentÚsmartquotesÚsmartquotes_actionÚsmartquotes_excludesÚoption_emphasise_placeholdersÚconfig_valuesrg   Ú	overridesr-   c                 óÜ  — t          |¦  «        | _        t          j                             ¦   «         | _        || _        |                     dd ¦  «        | _        d| j        v rnt          | j        d         t          ¦  «        r1| j                             d¦  «                             d¦  «        |d<   n| j                             d¦  «        |d<   |                     dg ¦  «        | _        d S )NÚsetupÚ
extensionsú,)r7   rŸ   rK   rž   ÚcopyÚvaluesÚ_raw_configÚgetr¡   r5   r&   ÚpopÚsplitr¢   )rC   rg   rŸ   s      r+   rD   zConfig.__init__–   sÇ   € Ý˜i™œˆŒÝÔ*×/Ò/Ñ1Ô1ˆŒØ!ˆÔØ)/¯ª°G¸TÑ)BÔ)BˆŒ
à˜4œ>Ð)Ð)Ý˜$œ.¨Ô6½Ñ<Ô<ð HØ'+¤~×'9Ò'9¸,Ñ'GÔ'G×'MÒ'MÈcÑ'RÔ'R��|Ñ$Ð$à'+¤~×'9Ò'9¸,Ñ'GÔ'G��|Ñ$Ø%+§Z¢Z°¸bÑ%AÔ%AˆŒˆˆr*   ÚconfdirÚtagsc                 ó\  — t          j        |t          ¦  «        }t          j        |¦  «        st	          t          d¦  «        |z  ¦  «        ‚t          ||¦  «        }|                     dd¦  «        €,t           	                    t          d¦  «        ¦  «         d|d<    | ||pi ¦  «        S )z/Create a Config object from configuration file.z4config directory doesn't contain a conf.py file (%s)r\   .Nz‰Invalid configuration value found: 'language = None'. Update your configuration to a valid language code. Falling back to 'en' (English).r]   )
r   ÚjoinÚCONFIG_FILENAMEÚisfiler   r   Úeval_config_filer§   ÚloggerÚwarning)Úclsrª   rŸ   r«   ÚfilenameÚ	namespaces         r+   ÚreadzConfig.read£   sÀ   € õ
 ”9˜W¥oÑ6Ô6ˆÝŒ{˜8Ñ$Ô$ð 	'Ý�bÐ!WÑXÔXØ%ñ&ñ 'ô 'ð 'å$ X¨tÑ4Ô4ˆ	ð �=Š=˜ SÑ)Ô)Ð1Ý�NŠN�2ð @ñ Aô Añ Bô Bð Bð %)ˆI�jÑ!àˆs�9˜i˜o¨2Ñ.Ô.Ð.r*   r    r!   c                 óš  — t          |t          ¦  «        s|S | j        |         d         }| j        |         d         t          k    r|S | j        |         d         t          t          hk    r|dk    rdS |dk    rdS |S t          |¦  «        t          u s| j        |         d         t          gk    r|dk    rdS t	          |¦  «        S t          |t          ¦  «        r$t          t          d¦  «        ||dz   fz  ¦  «        ‚t          |t          ¦  «        r| 
                    d	¦  «        S t          |t          ¦  «        rD	 t          |¦  «        S # t          $ r'}t          t          d
¦  «        ||fz  ¦  «        |‚d }~ww xY wt          |¦  «        r|S |�4t          |t          ¦  «        st          t          d¦  «        |z  ¦  «        ‚|S )Nr   é   Ú0FÚ1TzZcannot override dictionary config setting %r, ignoring (use %r to set individual elements)z
.key=valuer£   z/invalid number %r for config value %r, ignoringzAcannot override config setting %r with unsupported type, ignoring)r5   r&   r¥   r   r(   Útyper7   Ú
ValueErrorr   r9   r©   ÚintÚcallable)rC   r    r!   ÚdefvalueÚexcs        r+   Úconvert_overrideszConfig.convert_overridesº   s  € Ý˜%¥Ñ%Ô%ð &	ØˆLà”{ 4Ô(¨Ô+ˆHØŒ{˜4Ô  Ô#¥sÒ*Ð*Ø�Ø”˜TÔ" 1Ô%­$µ¨Ò4Ð4Ø˜C’<�<à ˜5Ø˜c’\�\Ø˜4à �LÝ�h‘”¥4Ð'Ð'¨4¬;°tÔ+<¸QÔ+?ÅDÀ6Ò+IÐ+IØ˜C’<�<à ˜5å ™;œ;Ð&Ý˜H¥dÑ+Ô+ð Ý ¥ð %Sñ "Tô "Tà"&¨¨|Ñ(;Ð!<ñ"=ñ >ô >ð >õ ˜H¥dÑ+Ô+ð Ø—{’{ 3Ñ'Ô'Ð'Ý˜H¥cÑ*Ô*ð ð=Ý˜u™:œ:Ð%øÝ!ð =ð =ð =Ý$¥RÐ(YÑ%ZÔ%ZØ&+¨T ]ñ&3ñ 4ô 4Ø9<ð=øøøøð=øøøõ ˜(Ñ#Ô#ð Ø�ØÐ%­j¸Å3Ñ.GÔ.GÐ%Ý ¥ð %5ñ "6ô "6Ø8<ñ"=ñ >ô >ð >ð �s   ÅE Å
FÅ"E<Å<Fc                 ó   — g d¢}|D ]†}	 || j         v r*|                      || j         |         ¦  «        | j        |<   n|| j        v r| j        |         | j        |<   ŒU# t          $ r%}t
                               d|¦  «         Y d}~Œd}~ww xY wdS )zs
        Initialize some limited config variables before initializing i18n and loading
        extensions.
        )r„   r}   r\   r^   ú%sN)rŸ   rÁ   Ú__dict__r¦   r¼   r±   r²   )rC   Ú	variablesr    rÀ   s       r+   Úpre_init_valueszConfig.pre_init_valuesã   sÇ   € ð
 UÐTÐTˆ	Øð 	*ð 	*ˆDð*Ø˜4œ>Ð)Ð)Ø*.×*@Ò*@ÀÀtÄ~ÐVZÔG[Ñ*\Ô*\�D”M $Ñ'Ð'Ø˜TÔ-Ð-Ð-Ø*.Ô*:¸4Ô*@�D”M $Ñ'øøÝð *ð *ð *Ý—’˜t SÑ)Ô)Ð)Ð)Ð)Ð)Ð)Ð)øøøøð*øøøð	*ð 	*s   ŠAAÁ
BÁ&BÂBc                 ó.  — | j         }| j                             ¦   «         D ]Õ\  }}	 d|v r3|                     dd¦  «        \  }}||                     |i ¦  «        |<   Œ=|| j        vr)t                               t          d¦  «        |¦  «         Œot          |t          ¦  «        r|                      ||¦  «        ||<   n|||<   Œ¤# t          $ r%}t                               d|¦  «         Y d }~ŒÎd }~ww xY w|D ]}|| j        v r||         | j        |<   Œd S )Nú.rŒ   z-unknown config value %r in override, ignoringrÃ   )r¦   rŸ   r8   r©   Ú
setdefaultr¥   r±   r²   r   r5   r&   rÁ   r¼   rÄ   )rC   rg   Úvalnamer!   Úrealvalnamer=   rÀ   r    s           r+   Úinit_valueszConfig.init_valuesò   sR  € ØÔ!ˆØ"œn×2Ò2Ñ4Ô4ð 	*ð 	*‰NˆG�Uð*Ø˜'�>�>Ø'.§}¢}°S¸!Ñ'<Ô'<Ñ$�K Ø>C�F×%Ò% k°2Ñ6Ô6°sÑ;ØØ D¤KÐ/Ð/Ý—N’N¥2Ð&UÑ#VÔ#VØ#*ñ,ô ,ð ,àÝ˜e¥SÑ)Ô)ð ,Ø&*×&<Ò&<¸WÀeÑ&LÔ&L�F˜7‘O�Oà&+�F˜7‘OøøÝð *ð *ð *Ý—’˜t SÑ)Ô)Ð)Ð)Ð)Ð)Ð)Ð)øøøøð*øøøàð 	3ð 	3ˆDØ�t”{Ð"Ð"Ø&,¨T¤l�”˜dÑ#øð	3ð 	3s#   §6CÁ1CÂ4CÃ
C4ÃC/Ã/C4c                 ó‚   — | j         }|D ]$}|| j        vr|| j        v r||         | j        |<   Œ%t          d| ¦  «         dS )zc
        Initialize additional config variables that are added after init_values() called.
        N)r¦   rÄ   r¥   Úcheck_confval_types)rC   rg   r    s      r+   Úpost_init_valueszConfig.post_init_values  s[   € ð Ô!ˆØð 	3ð 	3ˆDØ˜4œ=Ð(Ð(¨T°T´[Ð-@Ð-@Ø&,¨T¤l�”˜dÑ#øå˜D $Ñ'Ô'Ð'Ð'Ð'r*   c                 óø   — |                      d¦  «        rt          |¦  «        ‚|| j        vrt          t          d¦  «        |z  ¦  «        ‚| j        |         d         }t	          |¦  «        r || ¦  «        S |S )Nr   zNo such config value: %sr   )Ú
startswithÚAttributeErrorr¥   r   r¾   )rC   r    rx   s      r+   Ú__getattr__zConfig.__getattr__  s�   € Ø�?Š?˜3ÑÔð 	'Ý  Ñ&Ô&Ð&Ø�t”{Ð"Ð"Ý ¥Ð$>Ñ!?Ô!?À$Ñ!FÑGÔGÐGØ”+˜dÔ# AÔ&ˆÝ�GÑÔð 	!Ø�7˜4‘=”=Ð Øˆr*   c                 ó"   — t          | |¦  «        S r0   )Úgetattr©rC   r    s     r+   Ú__getitem__zConfig.__getitem__  s   € Ý�t˜TÑ"Ô"Ð"r*   c                 ó(   — t          | ||¦  «         d S r0   )Úsetattr©rC   r    r!   s      r+   Ú__setitem__zConfig.__setitem__   s   € Ý��d˜EÑ"Ô"Ð"Ð"Ð"r*   c                 ó&   — t          | |¦  «         d S r0   )ÚdelattrrÖ   s     r+   Ú__delitem__zConfig.__delitem__#  s   € Ý��dÑÔÐÐÐr*   c                 ó   — || j         v S r0   )r¥   rÖ   s     r+   Ú__contains__zConfig.__contains__&  s   € Ø�t”{Ð"Ð"r*   c              #   ó–   K  — | j                              ¦   «         D ],\  }}t          |t          | |¦  «        |d         ¦  «        V — Œ-d S )NrŒ   )r¥   r8   r   rÕ   rÚ   s      r+   Ú__iter__zConfig.__iter__)  s^   è è € Øœ;×,Ò,Ñ.Ô.ð 	Cð 	C‰KˆD�%Ý˜d¥G¨D°$Ñ$7Ô$7¸¸q¼ÑBÔBÐBÐBÐBÐBð	Cð 	Cr*   r"   Útypesc                 óp   — || j         v rt          t          d¦  «        |z  ¦  «        ‚|||f| j         |<   d S )NzConfig value %r already present)r¥   r   r   )rC   r    rx   r"   rã   s        r+   Úaddz
Config.add-  sD   € Ø�4”;ÐÐÝ ¥Ð$EÑ!FÔ!FÈÑ!MÑNÔNÐNà!(¨'°5Ð 9ˆDŒK˜ÑÐÐr*   c                 óP   ‡— t          ‰t          ¦  «        r‰gŠˆfd„| D ¦   «         S )Nc              3   ó.   •K  — | ]}|j         ‰v ¯|V — Œd S r0   )r"   )r2   r!   r"   s     €r+   r4   z Config.filter.<locals>.<genexpr>6  s/   øè è € ÐDÐD˜%¨5¬=¸GÐ+CÐ+C�Ð+CÐ+CÐ+CÐ+CÐDÐDr*   )r5   r&   )rC   r"   s    `r+   ÚfilterzConfig.filter3  s6   ø€ Ý�g�sÑ#Ô#ð 	 Ø�iˆGØDÐDÐDÐD 4ÐDÑDÔDÐDr*   c                 óN  — i }| j                              ¦   «         D ]/\  }}|                     d¦  «        st          |¦  «        sŒ*|||<   Œ0i |d<   | j                             ¦   «         D ]:\  }}t          | |¦  «        }t          |¦  «        sd}||d         df|d         |<   Œ;|S )z'Obtains serializable data for pickling.r   r¥   NrŒ   )rÄ   r8   rÑ   r1   r¥   rÕ   )rC   rÄ   r=   r!   Ú
real_values        r+   Ú__getstate__zConfig.__getstate__8  sÒ   € ð ˆØœ-×-Ò-Ñ/Ô/ð 	&ð 	&‰JˆC�Ø�~Š~˜cÑ"Ô"ð &­/¸%Ñ*@Ô*@ð &Øà %�˜‘�ð  ˆ�ÑØœ+×+Ò+Ñ-Ô-ð 	Cð 	C‰JˆC�Ý   sÑ+Ô+ˆJÝ" :Ñ.Ô.ð "à!�
ð (2°5¸´8¸TÐ&BˆH�XÔ˜sÑ#Ð#àˆr*   Ústatec                 ó:   — | j                              |¦  «         d S r0   )rÄ   Úupdate)rC   rì   s     r+   Ú__setstate__zConfig.__setstate__O  s   € ØŒ×Ò˜UÑ#Ô#Ð#Ð#Ð#r*   )NN)r-   N)%r#   r$   r%   rI   r&   r   r(   r?   r   rž   r	   r   r'   rD   Úclassmethodr   r   r¶   rÁ   rÆ   rÌ   rÏ   rÓ   r×   rÛ   rÞ   rà   r
   r   râ   r   rå   r   r   rè   rë   rï   r)   r*   r+   rK   rK   B   sÁ  € € € € € € ð	ð 	ð A'à�H˜e RÐ(ðA'ð 	�9˜e RÐ(ðA'ð 	˜b &¨3¨%Ð0ð	A'ð
 	Ð3Ð3°V¸c¸UÐCðA'ð 	�B˜˜r�?ðA'ð 	�B˜˜r�?ðA'ð 	�"�e˜R�ðA'ð 	�d˜E C 5Ð)ðA'ð 	�T˜5 3 %Ð(ðA'ð 	˜˜ U¨BÐ/ðA'ð 	#Ð%=¸uÀsÀeÐ$LðA'ð 	+¨U°I¸rÐ,BðA'ð" 	�w  rÐ*ð#A'ð$ 	Ð5Ð5°u¸bÐAð%A'ð& 	˜6Ð#5Ð6¸¸sÐCð'A'ð( 	˜K¨°Ð3ð)A'ð* 	˜R ¨¨Ð.ð+A'ð A'ð, 	˜d˜V U¨S¨EÐ2ð-A'ð. 	˜˜u s eÐ,ð/A'ð0 	# T¨5°"Ð$5ð1A'ð2 	˜T 5¨"Ð-ð3A'ð4 	˜t U¨T¨FÐ3ð5A'ð6 	*¨H°eØ,0¨D°¸5À&Ñ,IÔ,Ið,Kð7A'ð: 	(¨%°¸Ð);ð;A'ð< 	˜  rÐ*ð=A'ð> 	˜4 ¨#¨Ð/ð?A'ð@ 	˜y¨%°Ð4ðAA'ðB 	˜b %¨˜_ðCA'ðD 	˜2˜v rÐ*ðEA'ðF 	˜D &¨3¨%Ð0ðGA'ðH 	˜% ¨Ð+ðIA'ðJ 	˜b %¨˜_ðKA'ðL 	! 2 v¨rÐ"2ðMA'ðN 	�t˜U S EÐ*ðOA'ð A'ð A'ðP 	�t˜U S EÐ*ðQA'ðR 	˜t U¨BÐ/ðSA'ðT 	˜4 ¨¨
Ð3ðUA'ðV 	˜˜t c UÐ+ðWA'ðX 	˜R  r˜NðYA'ðZ 	˜˜u bÐ)ð[A'ð\ 	�U˜D "Ð%ð]A'ð^ 	˜2˜t R˜.ð_A'ð` 	  T¨2 ðaA'ðb 	�5˜% Ð$ðcA'ðd 	  5¨"˜~ðeA'ðf 	˜"˜e R˜ðgA'ðj 	˜E 5¨"Ð-ðkA'ðl 	˜d E¨C¨5Ð1ðmA'ðn 	˜˜e RÐ(ðoA'ðp 	�t˜U BÐ'ðqA'ðr 	˜˜e RÐ(ðsA'ð A'ðt ˜U S EÐ*Ø˜e RÐ(Ø$ e¨RÐ0Ø04¨vØ/4°f¨oð"?ð "?à!&¨ð!,ð +0°¸Ð);ðAA'ð A'ð A'€M�4˜˜U˜
Ô#ð Að Añ AðF 13ÐPRð Bð B˜t C¨ Hœ~ð B¸tÀCÈÀH¼~ð BÐW[ð Bð Bð Bð Bð àTXð/ð /Øð/Ø&.¨t¤nð/ØCKÈDÄ>ð/à	ð/ð /ð /ñ „[ð/ð,' cð '°#ð '¸#ð 'ð 'ð 'ð 'ðR*ð *ð *ð *ð3ð 3ð 3ð 3ð,	(ð 	(ð 	(ð 	(ð ð ¨ð ð ð ð ð# ð #¨ð #ð #ð #ð #ð# ð #¨Cð #°Dð #ð #ð #ð #ð ð ¨ð ð ð ð ð# ð #¨ð #ð #ð #ð #ðC˜) K°°tÐ$;Ô<ð Cð Cð Cð Cð:˜ð : cð :°E¸$À¸)Ô4Dð :ÈSð :ÐUYð :ð :ð :ð :ðE˜e C¨¨c¬ NÔ3ð E¸ÀÔ8Mð Eð Eð Eð Eð
˜dð ð ð ð ð.$ $ð $¨4ð $ð $ð $ð $ð $ð $r*   rK   r´   r«   c                 óÎ  — i }| |d<   ||d<   t          t          j        | ¦  «        ¦  «        5  	 t          | d¦  «        5 }t	          |                     ¦   «         |                      t          ¦  «        d¦  «        }t          ||¦  «         ddd¦  «         n# 1 swxY w Y   nª# t          $ r'}t          d¦  «        }t          ||z  ¦  «        |‚d}~wt          $ r$}t          d¦  «        }t          |¦  «        |‚d}~wt          $ r ‚ t          $ r8}t          d¦  «        }t          |t          j        ¦   «         z  ¦  «        |‚d}~ww xY wddd¦  «         n# 1 swxY w Y   |S )	zEvaluate a config file.Ú__file__r«   ÚrbÚexecNz7There is a syntax error in your configuration file: %s
zKThe configuration file (or one of the modules it imports) called sys.exit()z=There is a programmable error in your configuration file:

%s)r   r   ÚdirnameÚopenÚcompiler¶   Úencoder   rô   ÚSyntaxErrorr   r   Ú
SystemExitÚ	ExceptionÚ	tracebackÚ
format_exc)r´   r«   rµ   ÚfÚcodeÚerrÚmsgrÀ   s           r+   r°   r°   S  s  € à "€IØ$€IˆjÑØ€IˆfÑå	�DŒL˜Ñ"Ô"Ñ	#Ô	#ð Eð Eð	EÝ�h Ñ%Ô%ð &¨Ý˜qŸvšv™xœx¨¯ª½Ñ)EÔ)EÀvÑNÔN�Ý�T˜9Ñ%Ô%Ð%ð&ð &ð &ñ &ô &ð &ð &ð &ð &ð &ð &øøøð &ð &ð &ð &øøõ ð 	2ð 	2ð 	2ÝÐOÑPÔPˆCÝ˜c C™iÑ(Ô(¨cÐ1øøøøÝð 	,ð 	,ð 	,Ýð )ñ *ô *ˆCå˜cÑ"Ô"¨Ð+øøøøÝð 	ð 	ð 	àÝð 	Eð 	Eð 	EÝÐVÑWÔWˆCÝ˜c¥IÔ$8Ñ$:Ô$:Ñ:Ñ;Ô;ÀÐDøøøøð	Eøøøð!Eð Eð Eñ Eô Eð Eð Eð Eð Eð Eð Eøøøð Eð Eð Eð Eð( Ðsq   ®E°B$Á ABÂB$ÂB	ÂB$ÂB	Â B$Â#EÂ$
EÂ."CÃEÃC<Ã<EÄ3EÅEÅEÅEÅ!EÚappr   rg   c                 óš  — |j         }t          |t          ¦  «        rt          |di¦  «        |_         dS t          |t          t
          f¦  «        r t          d„ |D ¦   «         ¦  «        |_         dS t          |t          ¦  «        rt          |j         ¦  «        |_         dS t                               t          d|z  ¦  «        ¦  «         dS )z’Convert old styled source_suffix to new styled one.

    * old style: str or list
    * new style: a dict which maps from fileext to filetype
    Nc                 ó   — g | ]}|d f‘ŒS r0   r)   )r2   Úss     r+   ú
<listcomp>z)convert_source_suffix.<locals>.<listcomp>  s   € Ð+MÐ+MÐ+M¸!¨Q°¨IÐ+MÐ+MÐ+Mr*   zeThe config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.)
rh   r5   r&   r   r9   r:   r7   r±   r²   r   )r  rg   rh   s      r+   Úconvert_source_suffixr  p  sä   € ð Ô(€MÝ�-¥Ñ%Ô%ð Aõ
  +¨M¸4Ð+@ÑAÔAˆÔÐÐÝ	�M¥D­% =Ñ	1Ô	1ð 	Aå*Ð+MÐ+M¸}Ð+MÑ+MÔ+MÑNÔNˆÔÐÐÝ	�M¥4Ñ	(Ô	(ð Aå*¨6Ô+?Ñ@Ô@ˆÔÐÐå�Š•rð /à1>ñ?ñ @ô @ñ 	Aô 	Að 	Að 	Að 	Ar*   c                 ó’   — |j         }|r;t          d„ |                     ¦   «         D ¦   «         ¦  «        s|j        |i|_         dS dS dS )z—Convert old styled highlight_options to new styled one.

    * old style: options
    * new style: a dict which maps from language name to options
    c              3   ó@   K  — | ]}t          |t          ¦  «        V — Œd S r0   )r5   r7   )r2   Úvs     r+   r4   z,convert_highlight_options.<locals>.<genexpr>�  s,   è è € ÐIÐI°1�: a­Ñ.Ô.ÐIÐIÐIÐIÐIÐIr*   N)ry   r<   r¥   rw   )r  rg   Úoptionss      r+   Úconvert_highlight_optionsr  ‰  sl   € ð Ô&€GØð H•sÐIÐI¸¿ºÑ8HÔ8HÐIÑIÔIÑIÔIð Hà$*Ô$=¸wÐ#GˆÔ Ð Ð ðHð Hð Hð Hr*   c                 ó¾   — t          d¦  «        t          d¦  «        t          d¦  «        t          d¦  «        dœ}|                     |j        ¦  «         ||_        dS )z$Initialize :confval:`numfig_format`.z
Section %szFig. %szTable %sz
Listing %s)ÚsectionÚfigureÚtablez
code-blockN)r   rî   r�   )r  rg   r�   s      r+   Úinit_numfig_formatr  •  sY   € å ! ,¡¤Ý  ™|œ|Ý 
™mœmÝ#$ \¡?¤?ð4ð 4€Mð ×Ò˜Ô-Ñ.Ô.Ð.Ø(€FÔÐÐr*   c                 óª   — t          d¦  «        �AdD ]@}||v r8dt          dd¬¦  «        z  }t                               |||         ¦  «        ||<   Œ?dS dS )zºCorrect values of copyright year that are not coherent with
    the SOURCE_DATE_EPOCH environment variable (if set)

    See https://reproducible-builds.org/specs/source-date-epoch/
    ÚSOURCE_DATE_EPOCHN)rT   Úepub_copyrightz\g<1>%sz%Yr]   )r\   )r   r   Úcopyright_year_reÚsub)r  rg   ÚkÚreplaces       r+   Úcorrect_copyright_yearr  ¡  sv   € õ Ð!Ñ"Ô"Ð.Ø0ð 	Fð 	FˆAØ�Fˆ{ˆ{Ø$¥{°4À$Ð'GÑ'GÔ'GÑG�Ý-×1Ò1°'¸6À!¼9ÑEÔE��q‘	øð	 /Ð.ð	Fð 	Fr*   c           
      óZ  — |D �]¦}|j         |j                 \  }}}t          |¦  «        r ||¦  «        }|€|sŒ8|t          u rŒBt	          |t
          ¦  «        rk|                     |j        ¦  «        sPt          d¦  «        }t           
                    |                     |j        |j        |j        ¬¦  «        d¬¦  «         ŒÂt          |j        ¦  «        t          |¦  «        u rŒæt          |j        ¦  «        |v rŒýt          t          |j        ¦  «        j        t          |j        ¦  «        fz   ¦  «        t          t          |¦  «        j        ¦  «        z  }|                     t"          ¦  «         |r�Œy|rÆt          d¦  «        }d„ |D ¦   «         }t%          |¦  «        dk    r8d	                     d
                     |dd…         ¦  «        |d         ¦  «        }	nd                     |¦  «        }	t           
                    |                     |j        t          |j        ¦  «        |	¬¦  «        d¬¦  «         �ŒAt          d¦  «        }t           
                    |                     |j        t          |j        ¦  «        t          |¦  «        ¬¦  «        d¬¦  «         �Œ¨dS )z�Check all values for deviation from the default value's type, since
    that can result in TypeErrors all over the place NB.
    NzTThe config value `{name}` has to be a one of {candidates}, but `{current}` is given.)r    Úcurrentr@   T)ÚoncezNThe config value `{name}' has type `{current.__name__}'; expected {permitted}.c                 óB   — g | ]}d                       |j        ¦  «        ‘ŒS )z`{}')Úformatr#   )r2   rV   s     r+   r  z'check_confval_types.<locals>.<listcomp>Ó  s&   € Ð&VÐ&VÐ&VÀQ v§}¢}°Q´ZÑ'@Ô'@Ð&VÐ&VÐ&Vr*   r¸   z	{}, or {}z, éÿÿÿÿz or )r    r  Ú	permittedzZThe config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.)r    r  rx   )r¥   r    r¾   r   r5   r?   rH   r!   r   r±   r²   r  r@   r»   r;   Ú	__bases__ÚdiscardÚobjectÚlenr­   )
r  rg   Úconfvalrx   r"   Úannotationsr  Úcommon_basesÚwrapped_annotationsr   s
             r+   rÎ   rÎ   ®  sá  € ð ð 0Mñ 0MˆØ(.¬°g´lÔ(CÑ%ˆ�˜+å�GÑÔð 	&Ø�g˜f‘o”oˆGØˆ? ;ˆ?Øà�#ÐÐàÝ˜¥TÑ*Ô*ð %	MØ×$Ò$ W¤]Ñ3Ô3ð YÝð 5ñ 6ô 6�å—’˜sŸzšz¨w¬|Ø29´-Ø5@Ô5Kð  *ñ  Mô  MàSWð ñ Yô Yð Yøõ �G”MÑ"Ô"¥d¨7¡m¤mÐ3Ð3ØÝ�G”MÑ"Ô" kÐ1Ð1Øå¥ W¤]Ñ 3Ô 3Ô =ÅÀgÄmÑATÔATÐ@VÑ VÑWÔWÝ¥ W¡¤Ô 7Ñ8Ô8ñ9ˆLà× Ò ¥Ñ(Ô(Ð(Øð Ùàð MÝð 1ñ 2ô 2�à&VÐ&VÈ+Ð&VÑ&VÔ&VÐ#ÝÐ*Ñ+Ô+¨aÒ/Ð/Ø +× 2Ò 2ØŸ	š	Ð"5°c°r°cÔ":Ñ;Ô;Ø+¨BÔ/ñ!1ô !1�I�Ið !'§¢Ð,?Ñ @Ô @�IÝ—’˜sŸzšz¨w¬|Ý26°w´}Ñ2EÔ2EØ4=ð  *ñ  ?ô  ?àEIð ñ Kô Kð Kñ Kõ ð =ñ >ô >�å—’˜sŸzšz¨w¬|Ý26°w´}Ñ2EÔ2EÝ26°w±-´-ð  *ñ  Aô  AàGKð ñ Mô Mð Mñ Mð]0Mð 0Mr*   c                 ó²   — |j         }|rK| j                             |¦  «        s3t                               t          d¦  «        |¦  «         d |_         d S d S d S )Nz%primary_domain %r not found, ignored.)r‚   ÚregistryÚ
has_domainr±   r²   r   )r  rg   r‚   s      r+   Úcheck_primary_domainr,  å  sh   € ØÔ*€NØð %˜cœl×5Ò5°nÑEÔEð %Ý�Š•rÐAÑBÔBÀNÑSÔSÐSØ $ˆÔÐÐð%ð %ð %ð %r*   rN   r   ÚaddedÚchangedÚremovedc                 óÄ   — | j         j        dk    rOd| j        j        vrAd| j        j        v r3t                               t          d¦  «        ¦  «         d| j         _        |S )zjAdjust root_doc to 'contents' to support an old project which does not have
    any root_doc setting.
    rd   ÚcontentszkSince v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.)rg   re   rL   Údocnamesr±   r²   r   )r  rN   r-  r.  r/  s        r+   Úcheck_root_docr3  ì  sp   € ð
 	Œ
Ô˜wÒ&Ð&Ø˜3œ;Ô/Ð/Ð/Ø˜#œ+Ô.Ð.Ð.Ý�Š•rð Rñ Sô Sñ 	Tô 	Tð 	Tà(ˆŒ
Ôà€Nr*   c                 ó   — |                       dt          d¬¦  «         |                       dt          d¬¦  «         |                       dt          d¬¦  «         |                       dt          d¬¦  «         |                       dt
          d¬¦  «         |                       dt          d¬¦  «         |                       dt          ¦  «         ddddœS )Nzconfig-initedi   )Úpriorityzenv-get-outdatedÚbuiltinT)rX   Úparallel_read_safeÚparallel_write_safe)Úconnectr  r  r  r  rÎ   r,  r3  )r  s    r+   r¡   r¡   û  sÇ   € Ø‡K‚K�Õ!6À€KÑEÔEÐEØ‡K‚K�Õ!:ÀS€KÑIÔIÐIØ‡K‚K�Õ!3¸c€KÑBÔBÐBØ‡K‚K�Õ!7À#€KÑFÔFÐFØ‡K‚K�Õ!4¸s€KÑCÔCÐCØ‡K‚K�Õ!5À€KÑDÔDÐDØ‡K‚KÐ"¥NÑ3Ô3Ð3ð Ø"Ø#ðð ð r*   )DrI   Úrerü   rã   Úcollectionsr   Úosr   r   Útypingr   r   r   r	   r
   r   r   r   r   r   r   r   Úsphinx.errorsr   r   Úsphinx.localer   r   Úsphinx.utilr   Úsphinx.util.i18nr   Úsphinx.util.osutilr   r   Úsphinx.util.tagsr   Úsphinx.util.typingr   Úsphinx.applicationr   Úsphinx.environmentr   Ú	getLoggerr#   r±   r®   r»   Ú
ModuleTypeÚFunctionTyper6   r÷   r  r   r(   r1   r?   rK   r&   r°   r  r  r  r  rÎ   r,  r3  r¡   r)   r*   r+   ú<module>rJ     sR  ðØ (Ð (à 	€	€	€	Ø Ð Ð Ð Ø €€€Ø #Ð #Ð #Ð #Ð #Ð #Ø Ð Ð Ð Ð Ð Ð Ð ð1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 6Ð 5Ð 5Ð 5Ð 5Ð 5Ð 5Ð 5Ø Ð Ð Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø (Ð (Ð (Ð (Ð (Ð (Ø .Ð .Ð .Ð .Ð .Ð .Ð .Ð .Ø !Ð !Ð !Ð !Ð !Ð !Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'àð 4Ø)Ð)Ð)Ð)Ð)Ð)Ø3Ð3Ð3Ð3Ð3Ð3à	ˆÔ	˜8Ñ	$Ô	$€à€Ø˜eÔ.°Ô0BÐCÐ Ø�B”JÐ=Ñ>Ô>Ð ðð ð ð ð �*ñ ô ð ð˜ð  ð ð ð ð ð,ð ,ð ,ð ,ð ,ñ ,ô ,ð ,ð N$ð N$ð N$ð N$ð N$ñ N$ô N$ð N$ðb˜sð ¨(°4¬.ð ¸TÀ#ÀsÀ(¼^ð ð ð ð ð:A˜xð A°ð A¸Dð Að Að Að Að2	H 8ð 	H°Vð 	HÀð 	Hð 	Hð 	Hð 	Hð	)˜Hð 	)¨fð 	)¸ð 	)ð 	)ð 	)ð 	)ð
F ð 
F°&ð 
F¸Tð 
Fð 
Fð 
Fð 
Fð4M˜X hÔ/ð 4M¸ð 4MÀDð 4Mð 4Mð 4Mð 4Mðn%˜hð %°ð %¸4ð %ð %ð %ð %ð˜ð Ð'9ð À#ÀcÄ(ð Ø œHðØ/2°3¬xðØ<?À¼Hðð ð ð ðˆxð ˜D  c œNð ð ð ð ð ð r*   