U \Shh @sdZddlmZddlZddlmZddlmZddlmZddl m Z ddl m Z dd l mZmZmZe eZd d d d gZGdddZdS)z1Utility function and classes for Sphinx projects.) annotationsN)glob)Iterable)__)logging)get_matching_files)SEPpath_stabilizerelpathz **/_sourcesz.#*z**/.#*z *.lproj/**c@sjeZdZdZddddddZdddd d Zdd d ddddZdddddZdddddddZdS)Projectz;A project is the source code set of the Sphinx document(s).strzdict[str, str]None)srcdir source_suffixreturncCs||_||_t|_dS)N)rrsetdocnames)selfrrrA/root/rtd-docs/venv/lib/python3.8/site-packages/sphinx/project.py__init__szProject.__init__)otherrcCs |j|_dS)z!Take over a result of last build.N)r)rrrrrrestoreszProject.restorerz**z Iterable[str]zset[str]) exclude_paths include_pathsrcst_tj||tD]}|}|r|jkrtjj|d}fddt |D}t j t d|| |ddqttjj|tjrj|qt j t d|dqjS) zbFind all document files in the source directory and put them in :attr:`docnames`. z.*csg|]}t|jqSr)r r).0frrr 2sz$Project.discover..zDmultiple files found for the document "%s": %r Use %r for the build.T)oncezdocument not readable. Ignored.)location)rrrr EXCLUDE_PATHSpath2docospathjoinrloggerwarningrdoc2pathaccessR_OKadd)rrrfilenamedocnamepatternfilesrrrdiscover#s*   zProject.discoverz str | None)r-rcCsP||jrt||j}|jD],}||rt|}|dt| SqdS)zReturn the docname for the filename if the file is a document. *filename* should be absolute or relative to the source directory. N) startswithrr rendswithr len)rr-suffixrrrr#=s    zProject.path2docTbool)r.basedirrcCsf|ttjj}tj|j|}|jD]}tj||r&qNq&t |jd}|rZ||S||SdS)zReturn 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. rN) replacerr$r%sepr&rrisfilelist)rr.r7basenamer5rrrr)Ls zProject.doc2pathN)rr)T) __name__ __module__ __qualname____doc__rrr1r#r)rrrrr s r )r@ __future__rr$rtypingrZ sphinx.localerZ sphinx.utilrZsphinx.util.matchingrZsphinx.util.osutilrr r getLoggerr=r'r"r rrrrs