§
    _÷#dW  ã                   óŽ  — 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m	Z	 ddlm
Z
 ddlmZmZmZmZmZmZ 	 ddlm
Z n# e$ r dZY nw xY wdZdedefd	„Zd
edefd„Zdedefd„Zdededefd„Zdeddfd„Zdee         dedee         fd„Zdededdfd„Zdededdfd„Z ej         d¦  «        Z! ej         d¦  «        Z"dedefd„Z#dedefd„Z$ej%        fded ee         defd!„Z&e&Z' ej(        ¦   «         p ej)        ¦   «         Z*d"edefd#„Z+ej,        d$eded%         fd&„¦   «         Z- G d'„ d(¦  «        Z.deddfd)„Z/dS )*z6Operating system-related utility functions for Sphinx.é    N)ÚStringIO©Úpath)ÚAnyÚ	GeneratorÚIteratorÚListÚOptionalÚTypeú/ÚcanonicalpathÚreturnc                 óL   — |                       t          t          j        ¦  «        S ©N)ÚreplaceÚSEPr   Úsep)r   s    ú4/usr/lib/python3/dist-packages/sphinx/util/osutil.pyÚos_pathr      s   € Ø× Ò ¥¥d¤hÑ/Ô/Ð/ó    Ú
nativepathc                 óL   — |                       t          j        t          ¦  «        S )z"Return path in OS-independent form)r   r   r   r   )r   s    r   Ú
canon_pathr   !   s   € à×Ò�dœh­Ñ,Ô,Ð,r   Úfilepathc                 óJ   — t          | ¦  «        }t          j        d|¦  «        S )z+Normalize path separator and unicode stringÚNFC)r   ÚunicodedataÚ	normalize)r   Únew_paths     r   Úpath_stabilizer    &   s"   € å˜(Ñ#Ô#€HÝÔ  ¨Ñ1Ô1Ð1r   ÚbaseÚtoc                 ó~  — |                      t          ¦  «        r|S |                      d¦  «        d                              t          ¦  «        }|                     d¦  «        d                              t          ¦  «        }t          |dd…         |dd…         ¦  «        D ]7\  }}||k    r n+|                     d¦  «         |                     d¦  «         Œ8||k    rdS t          |¦  «        dk    r|dgk    r
dt          z   S dt          z   t          |¦  «        dz
  z  t                               |¦  «        z   S )	z.Return a relative URL from ``base`` to ``to``.ú#r   NéÿÿÿÿÚ é   ú.z..)Ú
startswithr   ÚsplitÚzipÚpopÚlenÚjoin)r!   r"   Úb2Út2ÚxÚys         r   Úrelative_urir3   ,   s  € à	‡}‚}•SÑÔð Øˆ	Ø	�Š�C‰Œ˜Ô	×	!Ò	!¥#Ñ	&Ô	&€BØ	�Š�#‰Œ�qÔ	×	Ò	¥Ñ	$Ô	$€Bå�B�s˜�s”G˜R   œWÑ%Ô%ð ð ‰ˆˆ1Ø�Š6ˆ6ØˆEØ
�Šˆq‰	Œ	ˆ	Ø
�Šˆq‰	Œ	ˆ	ˆ	Ø	ˆR‚x€xð ˆrÝ
ˆ2�w„w�!‚|€|˜˜r˜dš
˜
ð •S‰yÐØ•3‰J�3˜r™7œ7 Q™;Ñ'­#¯(ª(°2©,¬,Ñ6Ð6r   r   c                 ó2   — t          j        | d¬¦  «         dS )zEnsure that a path exists.T)Úexist_okN)ÚosÚmakedirsr   s    r   Ú	ensuredirr8   C   s   € å„K�˜tÐ$Ñ$Ô$Ð$Ð$Ð$r   ÚdirnamesÚsuffixc           	   #   óô   K  — | D ]r}t          j        |¦  «        D ][\  }}}|D ]R}|                     |¦  «        r;	 t          j        t          j        ||¦  «        ¦  «        V — ŒB# t          $ r Y ŒNw xY wŒSŒ\Œsd S r   )r6   ÚwalkÚendswithr   Úgetmtimer.   ÚOSError)r9   r:   ÚdirnameÚrootÚ_dirsÚfilesÚsfiles          r   Úmtimes_of_filesrE   H   s»   è è € Øð ð ˆÝ"$¤'¨'Ñ"2Ô"2ð 	ð 	ÑˆD�%˜Øð ð �Ø—>’> &Ñ)Ô)ð ðÝ"œm­D¬I°d¸EÑ,BÔ,BÑCÔCÐCÐCÐCÐCøÝ"ð ð ð Ø˜ðøøøððð	ðð s   »)A%Á%
A2	Á1A2	ÚsourceÚdestc                 óž   — t          j        | ¦  «        }t          t           d¦  «        r#t          j        ||j        |j        f¦  «         dS dS )z!Copy a file's modification times.ÚutimeN)r6   ÚstatÚhasattrrI   Úst_atimeÚst_mtime)rF   rG   Ústs      r   Ú	copytimesrO   S   sL   € å	Œ�‰Œ€BÝ�r�7ÑÔð 3Ý
Œ�˜œ R¤[Ð1Ñ2Ô2Ð2Ð2Ð2ð3ð 3r   c                 óÊ   — t          j        |¦  «        rt          j        | |¦  «        s9t	          j        | |¦  «         	 t          | |¦  «         dS # t          $ r Y dS w xY wdS )z{Copy a file and its modification times, if possible.

    Note: ``copyfile`` skips copying if the file has not been changedN)r   ÚexistsÚfilecmpÚcmpÚshutilÚcopyfilerO   r?   )rF   rG   s     r   rU   rU   Z   s‚   € õ Œ;�tÑÔð ¥G¤K°¸Ñ$=Ô$=ð ÝŒ˜ Ñ%Ô%Ð%ð	å�f˜dÑ#Ô#Ð#Ð#Ð#øÝð 	ð 	ð 	ØˆDˆDð	øøøðð s   Á A Á
A ÁA z[^a-zA-Z0-9_-]z Documentation$Ústringc                 ó<   — t                                d| ¦  «        pdS )Nr&   Úsphinx)Úno_fn_reÚsub)rV   s    r   Úmake_filenamer[   k   s   € Ý�<Š<˜˜FÑ#Ô#Ð/ xÐ/r   Úprojectc                 óv   — t          t                               d| ¦  «        ¦  «                             ¦   «         S )Nr&   )r[   Úproject_suffix_rerZ   Úlower)r\   s    r   Úmake_filename_from_projectr`   o   s-   € ÝÕ*×.Ò.¨r°7Ñ;Ô;Ñ<Ô<×BÒBÑDÔDÐDr   Ústartc                 óh   — 	 t           j                             | |¦  «        S # t          $ r | cY S w xY w)a  Return a relative filepath to *path* either from the current directory or
    from an optional *start* directory.

    This is an alternative of ``os.path.relpath()``.  This returns original path
    if *path* and *start* are on different drives (for Windows platform).
    )r6   r   ÚrelpathÚ
ValueError)r   ra   s     r   rc   rc   s   sA   € ðÝŒw�Š˜t UÑ+Ô+Ð+øÝð ð ð Øˆˆˆðøøøs   ‚" ¢1°1Úpathdirc                 óD  — t           �)t          | t           ¦  «        r|                      ¦   «         S t          j        | ¦  «        } t          | t          ¦  «        rF	 |                      t          ¦  «        } n*# t          $ r}t          dt          z  ¦  «        |‚d }~ww xY w| S )NzAmultibyte filename not supported on this filesystem encoding (%r))ÚPathÚ
isinstanceÚabspathr   ÚbytesÚdecodeÚfs_encodingÚUnicodeDecodeError)re   Úexcs     r   ri   ri   „   s¯   € ÝÐ�J wµÑ5Ô5ÐØ�ŠÑ Ô Ð å”,˜wÑ'Ô'ˆÝ�g�uÑ%Ô%ð 	HðHØ!Ÿ.š.­Ñ5Ô5��øÝ%ð Hð Hð HÝ(ð *0å2=ñ*>ñ ?ô ?àDGðHøøøøðHøøøð ˆs   ÁA6 Á6
BÂ BÂBÚ
target_dir)NNNc              #   ó¼   K  — t          j        ¦   «         }	 t          j        | ¦  «         d V — t          j        |¦  «         d S # t          j        |¦  «         w xY wr   )r6   ÚgetcwdÚchdir)ro   Úcwds     r   Úcdrt   “   sR   è è € å
Œ)‰+Œ+€CðÝ
Œ�ÑÔÐØˆˆˆå
Œ�‰Œˆˆˆø�Œ�‰Œˆˆøøøs   —A ÁAc                   óv   — e Zd ZdZdeddfd„Zdeddfd„Zd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 )ÚFileAvoidWritea¸  File-like object that buffers output and only writes if content changed.

    Use this class like when writing to a file to avoid touching the original
    file if the content hasn't changed. This is useful in scenarios where file
    mtime is used to invalidate caches or trigger new behavior.

    When writing to this file handle, all writes are buffered until the object
    is closed.

    Objects can be used as context managers.
    r   r   Nc                 ó"   — || _         d | _        d S r   )Ú_pathÚ_io)Úselfr   s     r   Ú__init__zFileAvoidWrite.__init__©   s   € ØˆŒ
Ø'+ˆŒˆˆr   Údatac                 ón   — | j         st          ¦   «         | _         | j                              |¦  «         d S r   )ry   r   Úwrite)rz   r|   s     r   r~   zFileAvoidWrite.write­   s1   € ØŒxð 	"Ý‘z”zˆDŒHØŒ�Š�tÑÔÐÐÐr   c                 óè  — | j         st          d¦  «        ‚|                      ¦   «         }| j                              ¦   «          	 t	          | j        d¬¦  «        5 }|                     ¦   «         }||k    r	 ddd¦  «         dS 	 ddd¦  «         n# 1 swxY w Y   n# t          $ r Y nw xY wt	          | j        dd¬¦  «        5 }|                     |¦  «         ddd¦  «         dS # 1 swxY w Y   dS )z0Stop accepting writes and write file, if needed.z,FileAvoidWrite does not support empty files.zutf-8)ÚencodingNÚw)	ry   Ú	ExceptionÚgetvalueÚcloseÚopenrx   Úreadr?   r~   )rz   ÚbufÚold_fÚold_contentÚfs        r   r„   zFileAvoidWrite.close²   s™  € àŒxð 	LÝÐJÑKÔKÐKà�mŠm‰oŒoˆØŒ�ŠÑÔÐð	Ý�d”j¨7Ð3Ñ3Ô3ð °uØ#Ÿjšj™lœl�Ø #Ò%Ð%Øðð ð ñ ô ð ð ð à%ðð ð ñ ô ð ð ð ð ð ð øøøð ð ð ð øøõ ð 	ð 	ð 	ØˆDð	øøøõ �$”*˜c¨GÐ4Ñ4Ô4ð 	¸Ø�GŠG�C‰LŒLˆLð	ð 	ð 	ñ 	ô 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	øøøð 	ð 	ð 	ð 	ð 	ð 	sN   ÁB ÁBÁ7B ÂB ÂBÂB ÂBÂB Â
B*Â)B*ÃC'Ã'C+Ã.C+c                 ó   — | S r   © )rz   s    r   Ú	__enter__zFileAvoidWrite.__enter__Å   s   € Øˆr   Úexc_typeÚ	exc_valueÚ	tracebackc                 ó.   — |                       ¦   «          dS )NT)r„   )rz   rŽ   r�   r�   s       r   Ú__exit__zFileAvoidWrite.__exit__È   s   € Ø�
Š
‰ŒˆØˆtr   Únamec                 óX   — | j         st          d¦  «        ‚t          | j         |¦  «        S )Nz=Must write to FileAvoidWrite before other methods can be used)ry   r‚   Úgetattr)rz   r“   s     r   Ú__getattr__zFileAvoidWrite.__getattr__Ì   s7   € àŒxð 	3Ýð 2ñ 3ô 3ð 3õ �t”x Ñ&Ô&Ð&r   )r   N)r   rv   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ústrr{   r~   r„   r�   r   r‚   r   Úboolr’   r–   rŒ   r   r   rv   rv   �   sâ   € € € € € ð
ð 
ð,˜Sð , Tð ,ð ,ð ,ð ,ð˜#ð  $ð ð ð ð ð
ð ð ð ð&ð ð ð ð  i¤ð ¸Yð ÐSVð Ð[_ð ð ð ð ð' ð '¨ð 'ð 'ð 'ð 'ð 'ð 'r   rv   c                 ó˜   — t           j                             | ¦  «        rt          j        | ¦  «         d S t          j        | ¦  «         d S r   )r6   r   ÚisdirrT   ÚrmtreeÚremover   s    r   rŸ   rŸ   Õ   s?   € Ý	„w‡}‚}�TÑÔð ÝŒ�dÑÔÐÐÐå
Œ	�$‰Œˆˆˆr   )0rš   Ú
contextlibrR   r6   ÚrerT   Úsysr   Úior   r   Útypingr   r   r   r	   r
   r   Úsphinx.testing.pathrg   ÚImportErrorr   r›   r   r   r    r3   r8   ÚfloatrE   rO   rU   ÚcompilerY   r^   r[   r`   Úcurdirrc   Úsafe_relpathÚgetfilesystemencodingÚgetdefaultencodingrl   ri   Úcontextmanagerrt   rv   rŸ   rŒ   r   r   ú<module>r¯      sž  ðØ <Ð <à Ð Ð Ð Ø €€€Ø 	€	€	€	Ø 	€	€	€	Ø €€€Ø 
€
€
€
Ø Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ AÐ Aðà0Ð0Ð0Ð0Ð0Ð0Ð0øØð ð ð Ø€D€D€Dðøøøð 
€ð0˜3ð 0 3ð 0ð 0ð 0ð 0ð-˜3ð - 3ð -ð -ð -ð -ð
2˜Sð 2 Sð 2ð 2ð 2ð 2ð7�sð 7 ð 7¨ð 7ð 7ð 7ð 7ð.%�Cð %˜Dð %ð %ð %ð %ð
˜d 3œið °ð ¸À%¼ð ð ð ð ð3�cð 3 ð 3¨ð 3ð 3ð 3ð 3ð
�Sð 
 ð 
¨ð 
ð 
ð 
ð 
ð ˆ2Œ:Ð'Ñ(Ô(€Ø�B”JÐ0Ñ1Ô1Ð ð0˜#ð 0 #ð 0ð 0ð 0ð 0ðE¨ð E°ð Eð Eð Eð Eð /1¬ið 
ð 
�#ð 
˜h sœmð 
¸Cð 
ð 
ð 
ð 
ð €Ø'ˆcÔ'Ñ)Ô)ÐEÐ-C¨SÔ-CÑ-EÔ-E€ð�Sð ˜Sð ð ð ð ð Ôð�3ð ˜9Ð%5Ô6ð ð ð ñ Ôðð5'ð 5'ð 5'ð 5'ð 5'ñ 5'ô 5'ð 5'ðp�ð ˜ð ð ð ð ð ð s   ¼A ÁAÁA