§
    _÷#d¦!  ã                   óh  — d Z ddlZddlZddlZddlZddlmZ ddlmZmZm	Z	m
Z
 ddlmZ 	 ddlmZ n# e$ r	 ddlmZ Y nw xY w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 erddlmZ  ej        e¦  «        Z e ¦   «         Z!dZ"de#de#ddfd„Z$ G d„ d¦  «        Z%de#de&fd„Z' G d„ d¦  «        Z(dS )z"Theming support for HTML builders.é    N)Úpath)ÚTYPE_CHECKINGÚAnyÚDictÚList)ÚZipFile)Úentry_points)Úpackage_dir)Ú
ThemeError)Ú__)Úlogging)Ú	ensuredir)ÚSphinxz
theme.confÚfilenameÚ	targetdirÚreturnc                 ó   — t          |¦  «         t          | ¦  «        5 }|                     ¦   «         D ]°}|                     d¦  «        rŒt	          j        ||¦  «        }t          t	          j        |¦  «        ¦  «         t          t	          j        |¦  «        d¦  «        5 }|                     | 	                    |¦  «        ¦  «         ddd¦  «         n# 1 swxY w Y   Œ±	 ddd¦  «         dS # 1 swxY w Y   dS )z%Extract zip file to target directory.ú/ÚwbN)
r   r   ÚnamelistÚendswithr   ÚjoinÚdirnameÚopenÚwriteÚread)r   r   ÚarchiveÚnameÚentryÚfps         ú0/usr/lib/python3/dist-packages/sphinx/theming.pyÚextract_zipr"       sj  € åˆiÑÔÐå	�Ñ	Ô	ð -˜gØ×$Ò$Ñ&Ô&ð 	-ð 	-ˆDØ�}Š}˜SÑ!Ô!ð ØÝ”I˜i¨Ñ.Ô.ˆEÝ•d”l 5Ñ)Ô)Ñ*Ô*Ð*Ý•d”i Ñ&Ô&¨Ñ-Ô-ð -°Ø—’˜Ÿš dÑ+Ô+Ñ,Ô,Ð,ð-ð -ð -ñ -ô -ð -ð -ð -ð -ð -ð -øøøð -ð -ð -ð -øð	-ð-ð -ð -ñ -ô -ð -ð -ð -ð -ð -ð -ð -øøøð -ð -ð -ð -ð -ð -s6   ŸBC3Â$)CÃC3ÃCÃC3Ã CÃ!C3Ã3C7Ã:C7c            	       óš   — e Zd ZdZdededdddfd„Zdee         fd	„Zefd
edede	de	fd„Z
i fdeee	f         deee	f         fd„Zdd„ZdS )ÚThemez†A Theme is a set of HTML templates and configurations.

    This class supports both theme directory and theme archive (zipped theme).r   Ú
theme_pathÚfactoryÚHTMLThemeFactoryr   Nc                 ól  — || _         d | _        d | _        t          j        |¦  «        rd | _        || _        nMt          j        d¦  «        | _        t          j        | j        |¦  «        | _        t          || j        ¦  «         t          j        ¦   «         | _        | j                             t          j        | j        t          ¦  «        d¬¦  «         	 | j                             dd¦  «        }ni# t          j        $ r%}t#          t%          d¦  «        |z  ¦  «        |‚d }~wt          j        $ r%}t#          t%          d¦  «        |z  ¦  «        |‚d }~ww xY w|dk    rQ	 |                     |¦  «        | _        d S # t"          $ r'}t#          t%          d	¦  «        ||fz  ¦  «        |‚d }~ww xY wd S )
NÚsxtzutf-8)ÚencodingÚthemeÚinheritz%theme %r doesn't have "theme" settingz'theme %r doesn't have "inherit" settingÚnonez(no theme named %r found, inherited by %r)r   ÚbaseÚrootdirr   ÚisdirÚthemedirÚtempfileÚmkdtempr   r"   ÚconfigparserÚRawConfigParserÚconfigr   Ú	THEMECONFÚgetÚNoSectionErrorr   r   ÚNoOptionErrorÚcreate)Úselfr   r%   r&   r,   Úexcs         r!   Ú__init__zTheme.__init__3   sÆ  € ØˆŒ	ØˆŒ	ØˆŒåŒ:�jÑ!Ô!ð 	3àˆDŒLØ&ˆDŒMˆMõ $Ô+¨EÑ2Ô2ˆDŒLÝ œI d¤l°DÑ9Ô9ˆDŒMÝ˜
 D¤MÑ2Ô2Ð2å"Ô2Ñ4Ô4ˆŒØŒ×Ò�œ 4¤=µ)Ñ<Ô<ÀwÐÑOÔOÐOð	]Ø”k—o’o g¨yÑ9Ô9ˆGˆGøÝÔ*ð 	[ð 	[ð 	[Ý�RÐ HÑIÔIÈDÑPÑQÔQÐWZÐZøøøøÝÔ)ð 	]ð 	]ð 	]Ý�RÐ JÑKÔKÈdÑRÑSÔSÐY\Ð\øøøøð	]øøøð �fÒÐð;Ø#ŸNšN¨7Ñ3Ô3�”	�	�	øÝð ;ð ;ð ;Ý ¥Ð$NÑ!OÔ!OØ")¨4 ñ"1ñ 2ô 2Ø7:ð;øøøøð;øøøð Ðs<   ÃC4 Ã4EÄ D#Ä#EÄ5 EÅEÅ$F  Æ 
F1Æ
"F,Æ,F1c                 ód   — | j         €| j        gS | j        g| j                              ¦   «         z   S )z‹Return a list of theme directories, beginning with this theme's,
        then the base theme's, then that one's base theme's, etc.
        )r.   r1   Úget_theme_dirs©r<   s    r!   r@   zTheme.get_theme_dirsS   s3   € ð Œ9ÐØ”M�?Ð"à”M�? T¤Y×%=Ò%=Ñ%?Ô%?Ñ?Ð?ó    ÚsectionÚdefaultc                 ó4  — 	 | j                              ||¦  «        S # t          j        t          j        f$ r_}| j        r!| j                             |||¦  «        cY d}~S |t          u r"t          t          d¦  «        ||fz  ¦  «        |‚|cY d}~S d}~ww xY w)zdReturn the value for a theme configuration setting, searching the
        base theme chain.
        Nz:setting %s.%s occurs in none of the searched theme configs)
r6   r8   r4   r:   r9   r.   Ú
get_configÚ	NODEFAULTr   r   )r<   rC   r   rD   r=   s        r!   rF   zTheme.get_config\   sÍ   € ð
	Ø”;—?’? 7¨DÑ1Ô1Ð1øÝÔ*­LÔ,GÐHð 	ð 	ð 	ØŒyð DØ”y×+Ò+¨G°T¸7ÑCÔCÐCÐCÐCÐCÐCÐCà�)Ð#Ð#Ý ¥ð %=ñ ">ô ">ØAHÈ$Àñ"Pñ Qô QØVYðZð ������øøøøð	øøøs&   ‚ �B¸"BÁBÁ ,BÂBÂBÚ	overridesc                 óp  — | j         r| j                              ¦   «         }ni }	 |                     | j                             d¦  «        ¦  «         n# t
          j        $ r Y nw xY w|                     ¦   «         D ]9\  }}||vr+t                               t          d¦  «        |z  ¦  «         Œ4|||<   Œ:|S )z6Return a dictionary of theme options and their values.Úoptionsz!unsupported theme option %r given)
r.   Úget_optionsÚupdater6   Úitemsr4   r9   ÚloggerÚwarningr   )r<   rH   rJ   ÚoptionÚvalues        r!   rK   zTheme.get_optionsl   sÐ   € àŒ9ð 	Ø”i×+Ò+Ñ-Ô-ˆGˆGàˆGð	Ø�NŠN˜4œ;×,Ò,¨YÑ7Ô7Ñ8Ô8Ð8Ð8øÝÔ*ð 	ð 	ð 	ØˆDð	øøøð 'Ÿ_š_Ñ.Ô.ð 	(ð 	(‰MˆF�EØ˜WÐ$Ð$Ý—’�rÐ"EÑFÔFÈÑOÑPÔPÐPÐPà"'�˜‘�àˆs   ¥-A ÁA%Á$A%c                 ó®   — | j         r+	 t          j        | j         ¦  «         n# t          $ r Y nw xY w| j        r| j                             ¦   «          dS dS )zRemove temporary directories.N)r/   ÚshutilÚrmtreeÚ	Exceptionr.   ÚcleanuprA   s    r!   rV   zTheme.cleanup€   st   € àŒ<ð 	ðÝ”˜dœlÑ+Ô+Ð+Ð+øÝð ð ð Ø�ðøøøàŒ9ð 	 ØŒI×ÒÑÔÐÐÐð	 ð 	 s   ‰# £
0¯0©r   N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ústrr>   r   r@   rG   r   rF   r   rK   rV   © rB   r!   r$   r$   .   s  € € € € € ðRð Rð;˜Sð ;¨cð ;Ð<Nð ;ÐSWð ;ð ;ð ;ð ;ð@@  S¤	ð @ð @ð @ð @ð BKð ð  #ð ¨Sð ¸3ð Èsð ð ð ð ð  79ð ð  T¨#¨s¨(¤^ð ¸TÀ#ÀsÀ(¼^ð ð ð ð ð( ð  ð  ð  ð  ð  rB   r$   c                 ó®   — 	 t          | ¦  «        5 }t          |                     ¦   «         v cddd¦  «         S # 1 swxY w Y   dS # t          $ r Y dS w xY w)zBCheck whether the specified file is an archived theme file or not.NF)r   r7   r   rU   )r   Úfs     r!   Úis_archived_themer`   ‹   s¨   € ðÝ�XÑÔð 	- !Ý §
¢
¡¤Ð,ð	-ð 	-ð 	-ð 	-ñ 	-ô 	-ð 	-ð 	-ð 	-ð 	-ð 	-ð 	-øøøð 	-ð 	-ð 	-ð 	-ð 	-ð 	-øåð ð ð Øˆuˆuðøøøs.   ‚A ‘9¬A ¹=½A Á =ÁA Á
AÁAc                   ó’   — e Zd ZdZdd„Zdd„Zdeddfd	„Zd
eddfd„Zdd„Z	dd„Z
d
eddfd„Zdedeeef         fd„Zd
edefd„ZdS )r'   z A factory class for HTML Themes.Úappr   r   Nc                 óÌ   — || _         |j        j        | _        |                      ¦   «          t          |j        dd ¦  «        r!|                      |j        j        ¦  «         d S d S )NÚhtml_theme_path)	rb   ÚregistryÚhtml_themesÚthemesÚload_builtin_themesÚgetattrr6   Úload_additional_themesrd   )r<   rb   s     r!   r>   zHTMLThemeFactory.__init__—   sj   € ØˆŒØ”lÔ.ˆŒØ× Ò Ñ"Ô"Ð"Ý�3”:Ð0°$Ñ7Ô7ð 	DØ×'Ò'¨¬
Ô(BÑCÔCÐCÐCÐCð	Dð 	DrB   c                 ó¨   — |                       t          j        t          d¦  «        ¦  «        }|                     ¦   «         D ]\  }}|| j        |<   ŒdS )zLoad built-in themes.rg   N)Úfind_themesr   r   r
   rM   rg   )r<   rg   r   r+   s       r!   rh   z$HTMLThemeFactory.load_builtin_themesž   sU   € à×!Ò!¥$¤)­K¸Ñ"BÔ"BÑCÔCˆØ!Ÿ<š<™>œ>ð 	&ð 	&‰KˆD�%Ø %ˆDŒK˜ÑÐð	&ð 	&rB   Útheme_pathsc                 óä   — |D ]l}t          j        t          j        | j        j        |¦  «        ¦  «        }|                      |¦  «        }|                     ¦   «         D ]\  }}|| j        |<   ŒŒmdS )z7Load additional themes placed at specified directories.N)r   Úabspathr   rb   Úconfdirrl   rM   rg   )r<   rm   r%   Úabs_theme_pathrg   r   r+   s          r!   rj   z'HTMLThemeFactory.load_additional_themes¤   s}   € à%ð 	*ð 	*ˆJÝ!œ\­$¬)°D´HÔ4DÀjÑ*QÔ*QÑRÔRˆNØ×%Ò% nÑ5Ô5ˆFØ%Ÿ|š|™~œ~ð *ð *‘��eØ$)�”˜DÑ!Ð!ð*ð	*ð 	*rB   r   c                 óh   — |dk    r|                       ¦   «          dS |                      |¦  «         dS )z,Try to load a theme with the specified name.Ú	alabasterN)Úload_alabaster_themeÚload_external_theme©r<   r   s     r!   Úload_extra_themez!HTMLThemeFactory.load_extra_theme¬   s?   € à�;ÒÐØ×%Ò%Ñ'Ô'Ð'Ð'Ð'à×$Ò$ TÑ*Ô*Ð*Ð*Ð*rB   c                 ól   — ddl }t          j        |                     ¦   «         d¦  «        | j        d<   dS )zLoad alabaster theme.r   Nrs   )rs   r   r   Úget_pathrg   )r<   rs   s     r!   rt   z%HTMLThemeFactory.load_alabaster_theme³   s8   € àÐÐÐÝ#'¤9¨Y×-?Ò-?Ñ-AÔ-AÀ;Ñ#OÔ#OˆŒ�KÑ Ð Ð rB   c                 ó”   — 	 ddl }|                     ¦   «         }t          j        |d¦  «        | j        d<   dS # t
          $ r Y dS w xY w)z+Load sphinx_rtd_theme theme (if installed).r   NÚsphinx_rtd_theme)r{   Úget_html_theme_pathr   r   rg   ÚImportError)r<   r{   r%   s      r!   Úload_sphinx_rtd_themez&HTMLThemeFactory.load_sphinx_rtd_theme¸   sf   € ð	Ø#Ð#Ð#Ð#Ø)×=Ò=Ñ?Ô?ˆJÝ.2¬i¸
ÐDVÑ.WÔ.WˆDŒKÐ*Ñ+Ð+Ð+øÝð 	ð 	ð 	ØˆDˆDð	øøøs   ‚59 ¹
AÁAc                 óê   — t          d¬¦  «        }	 ||         }| j        j                             | j        |j        ¦  «         | j        j                             ¦   «          dS # t          $ r Y dS w xY w)zjTry to load a theme using entry_points.

        Sphinx refers to ``sphinx_themes`` entry_points.
        zsphinx.html_themes)ÚgroupN)r	   rb   re   Úload_extensionÚmoduler6   Úpost_init_valuesÚKeyError)r<   r   Útheme_entry_pointsÚentry_points       r!   ru   z$HTMLThemeFactory.load_external_themeÁ   s‚   € õ *Ð0DÐEÑEÔEÐð	Ø,¨TÔ2ˆKØŒHÔ×,Ò,¨T¬X°{Ô7IÑJÔJÐJØŒHŒO×,Ò,Ñ.Ô.Ð.ØˆFøÝð 	ð 	ð 	ØˆDˆDð	øøøs   ’AA$ Á$
A2Á1A2r%   c                 óö  — i }t          j        |¦  «        s|S t          j        |¦  «        D ]Ë}t          j        ||¦  «        }t          j        |¦  «        ro|                     ¦   «                              d¦  «        rHt          |¦  «        r|dd…         }|||<   Œqt           
                    t          d¦  «        |¦  «         Œšt          j        t          j        |t          ¦  «        ¦  «        r|||<   ŒÌ|S )z'Search themes from specified directory.z.zipNéüÿÿÿzAfile %r on theme path is not a valid zipfile or contains no theme)r   r0   ÚosÚlistdirr   ÚisfileÚlowerr   r`   rN   rO   r   r7   )r<   r%   rg   r   Úpathnamer   s         r!   rl   zHTMLThemeFactory.find_themesÐ   s  € à!#ˆÝŒz˜*Ñ%Ô%ð 	ØˆMå”Z 
Ñ+Ô+ð 	-ð 	-ˆEÝ”y ¨UÑ3Ô3ˆHÝŒ{˜8Ñ$Ô$ð 	-¨¯ª©¬×)?Ò)?ÀÑ)GÔ)Gð 	-Ý$ XÑ.Ô.ð NØ   " œ:�DØ#+�F˜4‘L�Lå—N’N¥2ð 'Eñ $Fô $FØGLñNô Nð Nð Nõ ”;�tœy¨µ9Ñ=Ô=Ñ>Ô>ð -Ø$,�F˜5‘MøàˆrB   c                 ó\  — || j         vr|                      |¦  «         || j         vrA|dk    r;t                               t	          d¦  «        ¦  «         |                      ¦   «          || j         vrt          t	          d¦  «        |z  ¦  «        ‚t          || j         |         | ¬¦  «        S )zCreate an instance of theme.r{   zKsphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0z-no theme named %r found (missing theme.conf?))r&   )rg   rw   rN   rO   r   r~   r   r$   rv   s     r!   r;   zHTMLThemeFactory.createå   sÀ   € à�t”{Ð"Ð"Ø×!Ò! $Ñ'Ô'Ð'à�t”{Ð"Ð" tÐ/AÒ'AÐ'Aå�NŠN�2ð Jñ Kô Kñ Lô Lð Là×&Ò&Ñ(Ô(Ð(à�t”{Ð"Ð"Ý�RÐ OÑPÔPÐSWÑWÑXÔXÐXå�T˜4œ; tÔ,°dÐ;Ñ;Ô;Ð;rB   )rb   r   r   NrW   )rX   rY   rZ   r[   r>   rh   r\   rj   rw   rt   r~   ru   r   rl   r$   r;   r]   rB   r!   r'   r'   ”   s$  € € € € € Ø*Ð*ðDð Dð Dð Dð&ð &ð &ð &ð*°#ð *¸$ð *ð *ð *ð *ð+ Sð +¨Tð +ð +ð +ð +ðPð Pð Pð Pð
ð ð ð ð¨ð °ð ð ð ð ð cð ¨d°3¸°8¬nð ð ð ð ð*<˜3ð < 5ð <ð <ð <ð <ð <ð <rB   r'   ))r[   r4   r‰   rS   r2   r   Útypingr   r   r   r   Úzipfiler   Úimportlib_metadatar	   r}   Úimportlib.metadataÚsphinxr
   Úsphinx.errorsr   Úsphinx.localer   Úsphinx.utilr   Úsphinx.util.osutilr   Úsphinx.applicationr   Ú	getLoggerrX   rN   ÚobjectrG   r7   r\   r"   r$   Úboolr`   r'   r]   rB   r!   ú<module>rœ      s  ðØ (Ð (à Ð Ð Ð Ø 	€	€	€	Ø €€€Ø €€€Ø Ð Ð Ð Ð Ð Ø 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ø Ð Ð Ð Ð Ð ð0Ø/Ð/Ð/Ð/Ð/Ð/Ð/øØð 0ð 0ð 0Ø/Ð/Ð/Ð/Ð/Ð/Ð/Ð/ð0øøøð Ð Ð Ð Ð Ð Ø $Ð $Ð $Ð $Ð $Ð $Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø (Ð (Ð (Ð (Ð (Ð (àð *Ø)Ð)Ð)Ð)Ð)Ð)ð 
ˆÔ	˜8Ñ	$Ô	$€àˆF‰HŒH€	Ø€	ð-˜#ð -¨#ð -°$ð -ð -ð -ð -ðZ ð Z ð Z ð Z ð Z ñ Z ô Z ð Z ðz ð ¨ð ð ð ð ð_<ð _<ð _<ð _<ð _<ñ _<ô _<ð _<ð _<ð _<s   ¬3 ³AÁ A