B d^ @sdZddlZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZmZe eZd d d d gZGd ddZdS)z1Utility function and classes for Sphinx projects.N)glob)DictIterableOptionalSet)__)logging)get_matching_files)SEPpath_stabilizerelpathz **/_sourcesz.#*z**/.#*z *.lproj/**c@seZdZdZeeeefddddZdddddZdeeeee ed d d Z ee edddZ dee edddZdS)Projectz;A project is the source code set of the Sphinx document(s).N)srcdir source_suffixreturncCs||_||_t|_dS)N)rrsetdocnames)selfrrr[/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/sphinx/project.py__init__szProject.__init__)otherrcCs |j|_dS)z!Take over a result of last build.N)r)rrrrrrestoreszProject.restorerz**) exclude_paths include_pathsrcst_xtj||tD]}|}|r|jkrtjj|d}fddt |D}t j t d|| |ddqttjj|tjrj|qt j t d|dqWjS) zbFind all document files in the source directory and put them in :attr:`docnames`. z.*csg|]}t|jqSr)r r).0f)rrr 0sz$Project.discover..zDmultiple files found for the document "%s": %r Use %r for the build.T)oncezdocument not readable. Ignored.)location)rrr r EXCLUDE_PATHSpath2docospathjoinrloggerwarningrdoc2pathaccessR_OKadd)rrrfilenamedocnamepatternfilesr)rrdiscover!s    zProject.discover)r,rcCsP||jrt||j}x2|jD](}||r t|}|dt| Sq WdS)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.path2docT)r-basedirrcCsh|ttjj}tj|j|}x.|jD]}tj||r(Pq(Wt |jd}|r\||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) replacer r#r$sepr%rrisfilelist)rr-r5basenamer4rrrr(Js zProject.doc2path)rr)T)__name__ __module__ __qualname____doc__strrrrrrr0rr"boolr(rrrrr s  r )r>r#rtypingrrrrZ sphinx.localerZ sphinx.utilrZsphinx.util.matchingr Zsphinx.util.osutilr r r getLoggerr;r&r!r rrrrs