§
    _÷#d^  ã                   ó°   — d 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 ddlmZ ddlmZmZmZ  ej        e¦  «        Zg d	¢Z G d
„ d¦  «        ZdS )z1Utility function and classes for Sphinx projects.é    N)Úglob)ÚDictÚIterableÚOptionalÚSet)Ú__)Úlogging)Úget_matching_files)ÚSEPÚpath_stabilizeÚrelpath)z**/_sourcesz.#*z**/.#*z
*.lproj/**c                   ó®   — e Zd ZdZdedeeef         ddfd„Zdd„Z	 	 ddee         dee         de	e         fd„Z
dedee         fd„Zddededefd„ZdS )ÚProjectz;A project is the source code set of the Sphinx document(s).ÚsrcdirÚsource_suffixÚreturnNc                 óH   — || _         || _        t          ¦   «         | _        d S )N)r   r   ÚsetÚdocnames)Úselfr   r   s      ú0/usr/lib/python3/dist-packages/sphinx/project.pyÚ__init__zProject.__init__   s$   € àˆŒð +ˆÔõ #&¡%¤%ˆŒˆˆó    Úotherc                 ó   — |j         | _         dS )z!Take over a result of last build.N)r   )r   r   s     r   ÚrestorezProject.restore   s   € àœˆŒˆˆr   © ©z**Úexclude_pathsÚinclude_pathsc           	      óØ  ‡ — t          ¦   «         ‰ _        t          ‰ j        |g |¢t          z   ¦  «        D �].}‰                      |¦  «        }|�r|‰ j        v rƒt          j                             ‰ j        |¦  «        dz   }ˆ fd„t          |¦  «        D ¦   «         }t                               t          d¦  «        ||‰                      |¦  «        d¬¦  «         Œ§t          j        t          j                             ‰ j        |¦  «        t          j        ¦  «        r‰ j                             |¦  «         �Œt                               t          d¦  «        |¬¦  «         �Œ0‰ j        S )zbFind all document files in the source directory and put them in
        :attr:`docnames`.
        z.*c                 ó:   •— g | ]}t          |‰j        ¦  «        ‘ŒS r   )r   r   )Ú.0Úfr   s     €r   ú
<listcomp>z$Project.discover.<locals>.<listcomp>0   s%   ø€ ÐLÐLÐL¸�W Q¨¬Ñ4Ô4ÐLÐLÐLr   zDmultiple files found for the document "%s": %r
Use %r for the build.T)Úoncezdocument not readable. Ignored.)Úlocation)r   r   r
   r   ÚEXCLUDE_PATHSÚpath2docÚosÚpathÚjoinr   ÚloggerÚwarningr   Údoc2pathÚaccessÚR_OKÚadd)r   r   r    ÚfilenameÚdocnameÚpatternÚfiless   `      r   ÚdiscoverzProject.discover!   s\  ø€ õ
 ™œˆŒÝ*ØŒKØØˆmÐ�}Ñ,ñ
ô 
ð 	\ñ 	\ˆHð
 —m’m HÑ-Ô-ˆGØñ 
\Ø˜dœmÐ+Ð+Ý œgŸlšl¨4¬;¸Ñ@Ô@À4ÑG�GØLÐLÐLÐL½dÀ7¹m¼mÐLÑLÔL�EÝ—N’N¥2ð '>ñ $?ô $?à#*¨E°4·=²=ÀÑ3IÔ3IÐPTð #ñ Vô Vð Vð Võ ”Y�rœwŸ|š|¨D¬K¸ÑBÔBÅBÄGÑLÔLð \Ø”M×%Ò% gÑ.Ô.Ð.Ñ.å—N’N¥2Ð&GÑ#HÔ#HÐSZ�NÑ[Ô[Ð[ùàŒ}Ðr   r3   c                 óô   — |                      | j        ¦  «        rt          || j        ¦  «        }| j        D ]@}|                     |¦  «        r)t          |¦  «        }|dt          |¦  «         …         c S ŒAdS )z“Return the docname for the filename if the file is a document.

        *filename* should be absolute or relative to the source directory.
        N)Ú
startswithr   r   r   Úendswithr   Úlen)r   r3   Úsuffixs      r   r)   zProject.path2doc;   s‹   € ð
 ×Ò˜tœ{Ñ+Ô+ð 	6Ý˜x¨¬Ñ5Ô5ˆHØÔ(ð 	/ð 	/ˆFØ× Ò  Ñ(Ô(ð /Ý)¨(Ñ3Ô3�Ø ¥# f¡+¤+  Ô.Ð.Ð.Ð.ð/ð
 ˆtr   Tr4   Úbasedirc                 óH  — |                      t          t          j        j        ¦  «        }t          j                             | j        |¦  «        }| j        D ]&}t          j                             ||z   ¦  «        r nŒ't          | j        ¦  «        d         }|r||z   S ||z   S )z¯Return the filename for the document name.

        If *basedir* is True, return as an absolute path.
        Else, return as a relative path to the source directory.
        r   )
Úreplacer   r*   r+   Úsepr,   r   r   ÚisfileÚlist)r   r4   r=   Úbasenamer<   s        r   r/   zProject.doc2pathJ   sž   € ð —/’/¥#¥r¤w¤{Ñ3Ô3ˆÝ”7—<’< ¤¨WÑ5Ô5ˆØÔ(ð 	1ð 	1ˆFÝŒw�~Š~˜h¨Ñ/Ñ0Ô0ð Ø�ðõ ˜$Ô,Ñ-Ô-¨aÔ0ˆFàð 	$Ø˜fÑ$Ð$à˜VÑ#Ð#r   )r   r   r   N)r   r   )T)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ústrr   r   r   r   r   r7   r   r)   Úboolr/   r   r   r   r   r      s÷   € € € € € ØEÐEð(˜sð (°4¸¸S¸´>ð (Àdð (ð (ð (ð (ð'ð 'ð 'ð 'ð 79Ø07ðð  h¨s¤mð Ø (¨¤ðØ<?À¼Hðð ð ð ð4 ð ¨°#¬ð ð ð ð ð$ð $ ð $¨dð $¸cð $ð $ð $ð $ð $ð $r   r   )rG   r*   r   Útypingr   r   r   r   Úsphinx.localer   Úsphinx.utilr	   Úsphinx.util.matchingr
   Úsphinx.util.osutilr   r   r   Ú	getLoggerrD   r-   r(   r   r   r   r   ú<module>rP      s÷   ðØ 7Ð 7à 	€	€	€	Ø Ð Ð Ð Ð Ð Ø 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0Ð 0à Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ø ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;Ð ;à	ˆÔ	˜8Ñ	$Ô	$€Ø>Ð>Ð>€ðL$ð L$ð L$ð L$ð L$ñ L$ô L$ð L$ð L$ð L$r   