3
T'íc,
ã @ s d Z ddlZddlmZ ddlmZmZmZmZ ddlm Z ddl
m Z m Z m
Z
ddlmZ ddlmZmZ e jeZd d
d d gZG d
d dZdS )z1Utility function and classes for Sphinx projects.é N)Úglob)ÚDictÚListÚOptionalÚSet)Ú__)Úget_matching_filesÚloggingÚpath_stabilize)Úcompile_matchers)ÚSEPÚrelpathz **/_sourcesz.#*z**/.#*z
*.lproj/**c @ s~ e Zd ZdZeeeef ddddZd ddddZg fee e e d d
d Z
ee e d d
dZ dee
edddZdS )ÚProjectz;A project is the source code set of the Sphinx document(s).N)ÚsrcdirÚ
source_suffixÚreturnc C s || _ || _t | _d S )N)r r ÚsetÚdocnames)Úselfr r © r ú0/tmp/pip-build-gk9425m9/sphinx/sphinx/project.pyÚ__init__ s zProject.__init__)Úotherr c C s |j | _ dS )z!Take over a result of last build.N)r )r r r r r Úrestore s zProject.restore)Ú
exclude_pathsr c sÌ t _t|t }x°t j|D ] } j|}|r"| jkrtjj j|d } fddt
|D }t j t
d|| j|dd q"tjtjj j|tjr° jj| q"t j t
d|d q"W jS ) zbFind all document files in the source directory and put them in
:attr:`docnames`.
z.*c s g | ]}t | jqS r )r
r )Ú.0Úf)r r r ú
<listcomp>, s z$Project.discover.<locals>.<listcomp>zDmultiple files found for the document "%s": %r
Use %r for the build.T)Úoncez document not readable. Ignored.)Úlocation)r r r Ú
EXCLUDE_PATHSr r Úpath2docÚosÚpathÚjoinr ÚloggerÚwarningr Údoc2pathÚaccessÚR_OKÚadd)r r ZexcludesÚfilenameÚdocnameÚpatternÚfilesr )r r Údiscover! s
zProject.discover)r+ r c C sP |j | jrt|| j}x2| jD ](}|j|r t|}|dt|
S q W dS )zReturn 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 r+ Úsuffixr r r r! 7 s
zProject.path2docT)r, Úbasedirr c C sh |j ttjj}tjj| j|}x.| jD ]}tjj|| r(P q(W t | jd }|r\|| S || S dS )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 N)
Úreplacer r" r# Úsepr$ r r ÚisfileÚlist)r r, r4 Úbasenamer3 r r r r' F s zProject.doc2path)T)Ú__name__Ú
__module__Ú __qualname__Ú__doc__Ústrr r r r r r/ r r! Úboolr' r r r r r s
r )r= r" r Útypingr r r r Z
sphinx.localer Z sphinx.utilr r r
Zsphinx.util.matchingr Zsphinx.util.osutilr r
Ú getLoggerr: r% r r r r r r Ú<module> s