§
    _÷#dV'  ã                   ó–  — d 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	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mZ dd
lmZmZmZ ddlmZ  ej        e ¦  «        Z!dZ" ej#        d¦  «        Z$ G d„ de¦  «        Z% G d„ de%¦  «        Z& G d„ de%¦  «        Z'de(de(de(fd„Z) G d„ de%¦  «        Z*dedee(ef         fd„Z+dS )z#Docutils transforms used by Sphinx.é    N)Úceil)ÚAnyÚDictÚListÚOptionalÚTuple)Únodes)ÚSphinx)Ú__)ÚSphinxTransform)Úepoch_to_rfc1123ÚloggingÚrequestsÚrfc1123_to_epochÚsha1)Úget_image_extensionÚguess_mimetypeÚparse_data_uri)Ú	ensurediré    z
[:;<>|*" ]c                   ón   — e Zd Zdeddfd„Zdej        defd„Zdej        ddfd„Z	e
defd„¦   «         ZdS )	ÚBaseImageConverterÚkwargsÚreturnNc                 ó¨   — | j                              t          j        ¦  «        D ],}|                      |¦  «        r|                      |¦  «         Œ-d S ©N)ÚdocumentÚfindallr	   ÚimageÚmatchÚhandle)Úselfr   Únodes      úJ/usr/lib/python3/dist-packages/sphinx/transforms/post_transforms/images.pyÚapplyzBaseImageConverter.apply   sT   € Ø”M×)Ò)­%¬+Ñ6Ô6ð 	"ð 	"ˆDØ�zŠz˜$ÑÔð "Ø—’˜DÑ!Ô!Ð!øð	"ð 	"ó    r#   c                 ó   — dS )NT© ©r"   r#   s     r$   r    zBaseImageConverter.match   s   € Øˆtr&   c                 ó   — d S r   r(   r)   s     r$   r!   zBaseImageConverter.handle    s   € Øˆr&   c                 óV   — t           j                             | j        j        d¦  «        S )NÚimages)ÚosÚpathÚjoinÚappÚ
doctreedir©r"   s    r$   ÚimagedirzBaseImageConverter.imagedir#   s   € åŒw�|Š|˜DœHÔ/°Ñ:Ô:Ð:r&   )Ú__name__Ú
__module__Ú__qualname__r   r%   r	   r   Úboolr    r!   ÚpropertyÚstrr3   r(   r&   r$   r   r      s¥   € € € € € ð"˜cð " dð "ð "ð "ð "ð
˜%œ+ð ¨$ð ð ð ð ð˜5œ;ð ¨4ð ð ð ð ð ð;˜#ð ;ð ;ð ;ñ „Xð;ð ;ð ;r&   r   c                   óF   — e Zd ZdZdej        defd„Zdej        ddfd„ZdS )ÚImageDownloaderéd   r#   r   c                 ój   — | j         j        j        g k    rdS | j         j        j        rdS d|d         v S )NFú://Úuri)r0   ÚbuilderÚsupported_image_typesÚsupported_remote_imagesr)   s     r$   r    zImageDownloader.match+   s>   € ØŒ8ÔÔ1°RÒ7Ð7Ø�5ØŒXÔÔ5ð 	(Ø�5à˜D œKÐ'Ð'r&   Nc                 óD	  — 	 t           j                             |d         ¦  «        }d|v r|                     d¦  «        d         }|dk    st	          |¦  «        t
          k    r^t           j                             |d         ¦  «        \  }}t          |                     ¦   «         ¦  «         	                    ¦   «         |z   }t          j        t          d|¦  «        }|d                              dd¦  «                             t          d¦  «        dt          d¦  «        di¦  «        }t	          |¦  «        t
          k    r3t          |                     ¦   «         ¦  «         	                    ¦   «         }t!          t           j                             | j        |¦  «        ¦  «         t           j                             | j        ||¦  «        }i }t           j                             |¦  «        r8t)          t          j        |¦  «        j        ¦  «        }t/          |¦  «        |d	<   t1          j        |d         |¬
¦  «        }	|	j        dk    r9t6                               t;          d¦  «        |d         |	j        fz  ¦  «         d S |d         | j        j        j         |<   |	j        dk    rBtC          |d¦  «        5 }
|
 "                    |	j#        ¦  «         d d d ¦  «         n# 1 swxY w Y   |	j$                             d¦  «        }|r&tK          |¦  «        }t          j&        |||f¦  «         tO          |d¬¦  «        }|dk    r¶t           j                             |¦  «        d         dk    r�tQ          |¦  «        }t           j                             | j        |||z   ¦  «        }t          j        ||¦  «         | j        j        j          )                    |¦  «         |d         | j        j        j         |<   |}|d          )                    d¦  «         ||d         |<   ||d<   | j        j        j*         +                    | j        j,        |¦  «         d S # tZ          $ r=}t6                               t;          d¦  «        |d         |fz  ¦  «         Y d }~d S d }~ww xY w)Nr?   ú?r   Ú Ú_r>   ú/ú&zIf-Modified-Since)Úheadersi�  z%Could not fetch remote image: %s [%d]éÈ   Úwbzlast-modifiedÚ*)Údefaulté   Ú
candidatesz%Could not fetch remote image: %s [%s]).r-   r.   ÚbasenameÚsplitÚlenÚMAX_FILENAME_LENÚsplitextr   ÚencodeÚ	hexdigestÚreÚsubÚCRITICAL_PATH_CHAR_REÚreplaceÚ	translateÚordr   r/   r3   Úexistsr   ÚstatÚst_mtimer   r   ÚgetÚstatus_codeÚloggerÚwarningr   r0   ÚenvÚoriginal_image_uriÚopenÚwriteÚcontentrI   r   Úutimer   r   Úpopr,   Úadd_fileÚdocnameÚ	Exception)r"   r#   rP   ÚfilenameÚextÚdirnamer.   rI   Ú	timestampÚrÚfÚlast_modifiedÚmimetypeÚnewpathÚexcs                  r$   r!   zImageDownloader.handle3   sP  € ð3	]Ý”w×'Ò'¨¨U¬Ñ4Ô4ˆHØ�hˆˆØ#Ÿ>š>¨#Ñ.Ô.¨qÔ1�Ø˜2Š~ˆ~¥ X¡¤Õ1AÒ!AÐ!AÝ "¤× 0Ò 0°°e´Ñ =Ô =‘�˜#Ý §¢Ñ 1Ô 1Ñ2Ô2×<Ò<Ñ>Ô>ÀÑD�Ý”vÕ3°S¸(ÑCÔCˆHà˜5”k×)Ò)¨%°Ñ5Ô5×?Ò?ÅÀSÁÄÈ3ÝADÀSÁÄÈ3ðAPñ Qô QˆGå�7‰|Œ|Õ.Ò.Ð.Ý˜wŸ~š~Ñ/Ô/Ñ0Ô0×:Ò:Ñ<Ô<�Ý•b”g—l’l 4¤=°'Ñ:Ô:Ñ;Ô;Ð;Ý”7—<’< ¤¨w¸ÑAÔAˆDàˆGÝŒw�~Š~˜dÑ#Ô#ð KÝ#'­¬°©¬Ô(>Ñ#?Ô#?�	Ý/?À	Ñ/JÔ/J�Ð+Ñ,å”˜T %œ[°'Ð:Ñ:Ô:ˆAØŒ} Ò#Ð#Ý—’�rÐ"IÑJÔJØ $ U¤¨Q¬]Ð;ñ <ñ =ô =ð =ð =ð =ð 9=¸U¼�””Ô/°Ñ5à”= CÒ'Ð'Ý˜d DÑ)Ô)ð +¨QØŸš ¤	Ñ*Ô*Ð*ð+ð +ð +ñ +ô +ð +ð +ð +ð +ð +ð +øøøð +ð +ð +ð +ð !"¤	§¢¨oÑ >Ô >�Ø ð ;Ý 0°Ñ ?Ô ?�IÝ”H˜T I¨yÐ#9Ñ:Ô:Ð:å)¨$¸Ð<Ñ<Ô<�Ø˜s’?�?¥r¤w×'7Ò'7¸Ñ'AÔ'AÀ!Ô'DÈÒ'JÐ'Jå-¨hÑ7Ô7�CÝ œgŸlšl¨4¬=¸'À8ÈcÁ>ÑRÔR�GÝ”J˜t WÑ-Ô-Ð-Ø”H”LÔ3×7Ò7¸Ñ=Ô=Ð=Ø?CÀE¼{�D”H”LÔ3°GÑ<Ø"�DØ�\Ô"×&Ò& sÑ+Ô+Ð+Ø/3��\Ô" 8Ñ,Ø"��U‘Ø””Ô#×,Ò,¨T¬XÔ-=¸tÑDÔDÐDÐDÐDøÝð 	]ð 	]ð 	]Ý�NŠN�2ÐEÑFÔFÈ$ÈuÌ+ÐWZÐI[Ñ[Ñ\Ô\Ð\Ð\Ð\Ð\Ð\Ð\Ð\øøøøð	]øøøsC   ‚JQ Ê5Q Ê;K"ËQ Ë"K&Ë&Q Ë)K&Ë*E,Q Ñ
RÑ"2RÒR©	r4   r5   r6   Údefault_priorityr	   r   r7   r    r!   r(   r&   r$   r;   r;   (   sj   € € € € € ØÐð(˜%œ+ð (¨$ð (ð (ð (ð (ð4]˜5œ;ð 4]¨4ð 4]ð 4]ð 4]ð 4]ð 4]ð 4]r&   r;   c                   óF   — e Zd ZdZdej        defd„Zdej        ddfd„ZdS )ÚDataURIExtractoré–   r#   r   c                 ó�   — | j         j        j        g k    rdS | j         j        j        du rdS |d                              d¦  «        S )NFTr?   zdata:)r0   r@   rB   Úsupported_data_uri_imagesÚ
startswithr)   s     r$   r    zDataURIExtractor.matchm   sJ   € ØŒ8ÔÔ3°rÒ9Ð9Ø�5ØŒXÔÔ7¸4Ð?Ð?Ø�5à˜”;×)Ò)¨'Ñ2Ô2Ð2r&   Nc                 óH  — t          |d         ¦  «        }t          |j        ¦  «        }|€:t                               t          d¦  «        |d         d d…         |¬¦  «         d S t          t          j         	                    | j
        d¦  «        ¦  «         t          |j        ¦  «                             ¦   «         }t          j         	                    | j
        d||z   ¦  «        }|d         | j        j        j        |<   t#          |d¦  «        5 }|                     |j        ¦  «         d d d ¦  «         n# 1 swxY w Y   |d                              d¦  «         ||d         |j        <   ||d<   | j        j        j                             | j        j        |¦  «         d S )	Nr?   zUnknown image format: %s...r   )ÚlocationÚembededrK   rO   rD   )r   r   ru   rb   rc   r   r   r-   r.   r/   r3   r   ÚdatarV   r0   rd   re   rf   rg   rj   r,   rk   rl   )r"   r#   r   ro   Údigestr.   rs   s          r$   r!   zDataURIExtractor.handleu   s¤  € Ý˜t Eœ{Ñ+Ô+ˆÝ! %¤.Ñ1Ô1ˆØˆ;Ý�NŠN�2Ð;Ñ<Ô<¸dÀ5¼kÈ#È2È#Ô>NØ$(ð ñ *ô *ð *àˆFå•"”'—,’,˜tœ}¨iÑ8Ô8Ñ9Ô9Ð9Ý�e”jÑ!Ô!×+Ò+Ñ-Ô-ˆÝŒw�|Š|˜DœM¨9°f¸s±lÑCÔCˆØ04°U´ˆŒŒÔ'¨Ñ-å�$˜ÑÔð 	  Ø�GŠG�E”JÑÔÐð	 ð 	 ð 	 ñ 	 ô 	 ð 	 ð 	 ð 	 ð 	 ð 	 ð 	 øøøð 	 ð 	 ð 	 ð 	 ð 	ˆ\Ô×Ò˜sÑ#Ô#Ð#Ø-1ˆˆ\Ô˜5œ>Ñ*ØˆˆU‰ØŒŒÔ×$Ò$ T¤XÔ%5°tÑ<Ô<Ð<Ð<Ð<s   ÄD8Ä8D<Ä?D<rx   r(   r&   r$   r{   r{   j   sb   € € € € € ØÐð3˜%œ+ð 3¨$ð 3ð 3ð 3ð 3ð=˜5œ;ð =¨4ð =ð =ð =ð =ð =ð =r&   r{   rn   ru   r   c                 óà   — t           j                             | ¦  «        }t          j        t
          d|¦  «        }t           j                             |¦  «        d         t          |¦  «        z   S )NrF   r   )r-   r.   rP   rW   rX   rY   rT   r   )rn   ru   rP   s      r$   Úget_filename_forr†   ‹   sT   € ÝŒw×Ò Ñ)Ô)€HÝŒvÕ+¨S°(Ñ;Ô;€HÝŒ7×Ò˜HÑ%Ô% aÔ(Õ+>¸xÑ+HÔ+HÑHÐHr&   c                   ó  ‡ — e Zd ZU dZdZdZee         ed<   g Z	e
eeef                  ed<   dededdfˆ fd	„Zd
ej        defd„Zd
ej        deeef         fd„Zdefd„Zd
ej        de
e         fd„Zd
ej        ddfd„Zdededefd„Zˆ xZS )ÚImageConvertera¥  A base class for image converters.

    An image converter is kind of Docutils transform module.  It is used to
    convert image files which are not supported by a builder to the
    appropriate format for that builder.

    For example, :py:class:`LaTeX builder <.LaTeXBuilder>` supports PDF,
    PNG and JPEG as image formats.  However it does not support SVG images.
    For such case, using image converters allows to embed these
    unsupported images into the document.  One of the image converters;
    :ref:`sphinx.ext.imgconverter <sphinx.ext.imgconverter>` can convert
    a SVG image to PNG format using Imagemagick internally.

    There are three steps to make your custom image converter:

    1. Make a subclass of ``ImageConverter`` class
    2. Override ``conversion_rules``, ``is_available()`` and ``convert()``
    3. Register your image converter to Sphinx using
       :py:meth:`.Sphinx.add_post_transform`
    rJ   NÚ	availableÚconversion_rulesÚargsr   r   c                 ó:   •—  t          ¦   «         j        |i |¤Ž d S r   )ÚsuperÚ__init__)r"   r‹   r   Ú	__class__s      €r$   rŽ   zImageConverter.__init__º   s%   ø€ Ø�‰ŒÔ˜$Ð) &Ð)Ð)Ð)Ð)Ð)r&   r#   c                 óX  — | j         j        j        sdS d|d         v rdS t          |                      |¦  «        ¦  «        t          | j         j        j        ¦  «        z  rdS | j        €|                      ¦   «         | j        _        | j        sdS |                      |¦  «        }|rdS dS )NFrD   rO   T)	r0   r@   rA   ÚsetÚguess_mimetypesr‰   Úis_availabler�   Úget_conversion_rule)r"   r#   Úrules      r$   r    zImageConverter.match½   s¶   € ØŒxÔÔ5ð 		;Ø�5Ø�D˜Ô&Ð&Ð&Ø�5Ý�×%Ò% dÑ+Ô+Ñ,Ô,­s°4´8Ô3CÔ3YÑ/ZÔ/ZÑZð 	;à�5ØŒ^Ð#à'+×'8Ò'8Ñ':Ô':ˆDŒNÔ$àŒ~ð 	Ø�5à×+Ò+¨DÑ1Ô1ˆDØð Ø�tà�ur&   c                 ó„   — |                       |¦  «        D ])}| j        j        j        D ]}||f}|| j        v r|c c S ŒŒ*d S r   )r’   r0   r@   rA   rŠ   )r"   r#   Ú	candidateÚ	supportedr•   s        r$   r”   z"ImageConverter.get_conversion_ruleÒ   sl   € Ø×-Ò-¨dÑ3Ô3ð 	 ð 	 ˆIØ!œXÔ-ÔCð  ð  �	Ø! 9Ð-�Ø˜4Ô0Ð0Ð0Ø�K�K�K�K�Kð 1ð ð
 ˆtr&   c                 ó   — t          ¦   «         ‚)z/Return the image converter is available or not.©ÚNotImplementedErrorr2   s    r$   r“   zImageConverter.is_availableÛ   s   € å!Ñ#Ô#Ð#r&   c                 óŽ   — d|d         v rg S d|d         v rt          |d         ¦  «        gS |d                              ¦   «         S )NrD   rO   rL   r?   )r   Úkeysr)   s     r$   r’   zImageConverter.guess_mimetypesß   sS   € Ø�$�|Ô$Ð$Ð$ØˆIØ�D˜Ô&Ð&Ð&Ý" 4¨¤;Ñ/Ô/Ð0Ð0à˜Ô%×*Ò*Ñ,Ô,Ð,r&   c                 óX  — |                       |¦  «        \  }}||d         v r|d         |         }n|d         d         }t          ||¦  «        }t          | j        ¦  «         t          j                             | j        |¦  «        }t          j                             | j        j        |¦  «        }|  	                    ||¦  «        rad|d         v r||d         d<   n||d         |<   ||d<   || j
        j        |<   | j
        j                             | j
        j        |¦  «         d S d S )NrO   rL   r?   )r”   r†   r   r3   r-   r.   r/   r0   ÚsrcdirÚconvertrd   re   r,   rk   rl   )r"   r#   Ú_fromÚ_toÚsrcpathrn   ÚdestpathÚabs_srcpaths           r$   r!   zImageConverter.handleç   s)  € Ø×-Ò-¨dÑ3Ô3‰
ˆˆsà�D˜Ô&Ð&Ð&Ø˜<Ô(¨Ô/ˆGˆGà˜<Ô(¨Ô-ˆGå# G¨SÑ1Ô1ˆÝ�$”-Ñ Ô Ð Ý”7—<’< ¤¨xÑ8Ô8ˆå”g—l’l 4¤8¤?°GÑ<Ô<ˆØ�<Š<˜ XÑ.Ô.ð 	AØ�d˜<Ô(Ð(Ð(Ø*2��\Ô" 3Ñ'Ð'à*2��\Ô" 3Ñ'Ø"ˆD�‰Kà4;ˆDŒHÔ'¨Ñ1ØŒHŒO×$Ò$ T¤XÔ%5°xÑ@Ô@Ð@Ð@Ð@ð	Að 	Ar&   r¡   r¢   c                 ó   — t          ¦   «         ‚)z Convert an image file to the expected format.

        *_from* is a path of the source image file, and *_to* is a path
        of the destination file.
        rš   )r"   r¡   r¢   s      r$   r    zImageConverter.convertþ   s   € õ "Ñ#Ô#Ð#r&   )r4   r5   r6   Ú__doc__ry   r‰   r   r7   Ú__annotations__rŠ   r   r   r9   r   rŽ   r	   r   r    r”   r“   r’   r!   r    Ú__classcell__)r�   s   @r$   rˆ   rˆ   ‘   s‚  ø€ € € € € € ðð ð( Ðð !%€Iˆx˜Œ~Ð$Ð$Ñ$ð /1Ð�d˜5  c œ?Ô+Ð0Ð0Ñ0ð*˜cð *¨Sð *°Tð *ð *ð *ð *ð *ð *ð˜%œ+ð ¨$ð ð ð ð ð*¨¬ð ¸¸cÀ3¸h¼ð ð ð ð ð$˜dð $ð $ð $ð $ð- E¤Kð -°D¸´Ið -ð -ð -ð -ðA˜5œ;ð A¨4ð Að Að Að Að.$˜Sð $ sð $¨tð $ð $ð $ð $ð $ð $ð $ð $r&   rˆ   r0   c                 óv   — |                       t          ¦  «         |                       t          ¦  «         ddddœS )NÚbuiltinT)ÚversionÚparallel_read_safeÚparallel_write_safe)Úadd_post_transformr;   r{   )r0   s    r$   Úsetupr°     sE   € Ø×Ò�?Ñ+Ô+Ð+Ø×ÒÕ+Ñ,Ô,Ð,ð Ø"Ø#ðð ð r&   ),r§   r-   rW   Úmathr   Útypingr   r   r   r   r   Údocutilsr	   Úsphinx.applicationr
   Úsphinx.localer   Úsphinx.transformsr   Úsphinx.utilr   r   r   r   r   Úsphinx.util.imagesr   r   r   Úsphinx.util.osutilr   Ú	getLoggerr4   rb   rS   ÚcompilerY   r   r;   r{   r9   r†   rˆ   r°   r(   r&   r$   ú<module>r¼      sG  ðØ )Ð )à 	€	€	€	Ø 	€	€	€	Ø Ð Ð Ð Ð Ð Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3à Ð Ð Ð Ð Ð à %Ð %Ð %Ð %Ð %Ð %Ø Ð Ð Ð Ð Ð Ø -Ð -Ð -Ð -Ð -Ð -Ø SÐ SÐ SÐ SÐ SÐ SÐ SÐ SÐ SÐ SÐ SÐ SÐ SÐ SØ RÐ RÐ RÐ RÐ RÐ RÐ RÐ RÐ RÐ RØ (Ð (Ð (Ð (Ð (Ð (à	ˆÔ	˜8Ñ	$Ô	$€àÐ Ø"˜œ
 <Ñ0Ô0Ð ð;ð ;ð ;ð ;ð ;˜ñ ;ô ;ð ;ð"?]ð ?]ð ?]ð ?]ð ?]Ð(ñ ?]ô ?]ð ?]ðD=ð =ð =ð =ð =Ð)ñ =ô =ð =ðBI˜sð I¨cð I°cð Ið Ið Ið Iðs$ð s$ð s$ð s$ð s$Ð'ñ s$ô s$ð s$ðlˆvð ˜$˜s C˜xœ.ð ð ð ð ð ð r&   