o Ni@sdZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZerBdd lmZe eZgd ZGd ddZdS)z1Utility function and classes for Sphinx projects.) annotationsN)Path) TYPE_CHECKING)__)logging)_StrPath)get_matching_files)path_stabilize)Iterable)z **/_sourcesz.#*z**/.#*z *.lproj/**c@sFeZdZdZd dd Zd!d d Z d"d#ddZd$ddZd%ddZdS)&Projectz;A project is the source code set of the Sphinx document(s).srcdirstr | os.PathLike[str] source_suffix Iterable[str]returnNonecCs>t||_t||_tt|jd|_t|_i|_ i|_ dS)N) rr tuplernextiter_first_source_suffixsetdocnames_path_to_docname_docname_to_path)selfr rrB/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/project.py__init__s   zProject.__init__othercCs|j|_|j|_|j|_dS)z!Take over a result of last build.N)rrr)rrrrrrestore+s zProject.restorerz** exclude_paths include_pathsset[str]c sjjjtj|g|tD]\}|}rv|jvrMfddj|dD}t j t d|d |j |ddddqtj|tjrlj|t|}|j|<|j|<qt j t d ||d qjS) zbFind all document files in the source directory and put them in :attr:`docnames`. csg|] }t|jqSr)str relative_tor ).0frrr Bsz$Project.discover..z.*zDmultiple files found for the document "%s": %s Use %r for the build.z, T)absolute)oncezIgnored unreadable document %r.)location)rclearrrrr EXCLUDE_PATHSpath2docglobloggerwarningrjoindoc2pathosaccessR_OKaddr)rr"r#filenamedocnamefilespathrr)rdiscover1sD          zProject.discoverr: str | Nonec Csz|j|WStyJt|}|r0tt||j}Wdn1s+wY|j D]}|j |rFt | |YSq3YdSw)zReturn the docname for the filename if the file is a document. *filename* should be absolute or relative to the source directory. N)rKeyErrorr is_absolute contextlibsuppress ValueErrorr&r rnameendswithr removesuffix)rr:r=suffixrrrr0^s     zProject.path2docr;r%r+boolrcCsJz|j|}Wntyt||j}Ynw|r!t|j|St|S)zReturn the filename for the document name. If *absolute* is True, return as an absolute path. Else, return as a relative path to the source directory. )rr@rrrr )rr;r+r:rrrr5rs zProject.doc2pathN)r r rrrr)rr rr)rr!)r"rr#rrr$)r:r rr?)r;r%r+rIrr) __name__ __module__ __qualname____doc__rr r>r0r5rrrrr s   -r )rM __future__rrBr6pathlibrtypingr sphinx.localer sphinx.utilrsphinx.util._pathlibrsphinx.util.matchingrsphinx.util.osutilr collections.abcr getLoggerrJr2r/r rrrrs