Qjf%dZddlmZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z dd lmZmZerdd lmZe j&eZgd ZGd d Zy)z1Utility function and classes for Sphinx projects.) annotationsN)glob) TYPE_CHECKING)__)logging)get_matching_files)path_stabilizerelpath)Iterable)z **/_sourcesz.#*z**/.#*z *.lproj/**cFeZdZdZddZd dZ d d dZd dZd dZy)Projectz;A project is the source code set of the Sphinx document(s).c||_t||_tt |jd|_t |_i|_i|_ y)N) srcdirtuple source_suffixnextiter_first_source_suffixsetdocnames_path_to_docname_docname_to_path)selfrrs .lib/python3.12/site-packages/sphinx/project.py__init__zProject.__init__sO #=1$(d.@.@)A2$F!#&% 1302cj|j|_|j|_|j|_y)z!Take over a result of last build.N)rrr)rothers rrestorezProject.restore(s) % 6 6 % 6 6rc |jj|jj|jjt |j |g|t D][}|j|x}s||jvrtjj|j |dz}t|Dcgc]}t||j }}tjtd|||j!|ddtj"tjj|j |tj$r;|jj'|||j|<||j|<;tjtd||^|jScc}w)zbFind all document files in the source directory and put them in :attr:`docnames`. z.*zDmultiple files found for the document "%s": %r Use %r for the build.T)absolute)oncezIgnored unreadable document %r.)location)rclearrrrr EXCLUDE_PATHSpath2docospathjoinrr loggerwarningrdoc2pathaccessR_OKadd)r exclude_paths include_pathsfilenamedocnamepatternffiless rdiscoverzProject.discover.s  ##% ##%* KK  ,m ,m ,  H --11w1dmm+ ggll4;;@4GG>B7mLWQ 4LELNN4  g =!# YYrww||DKKBBGGLMM%%g.6=D))(35=D))'2NN<=xRY#1 8}})MsGc |j|S#t$rtjj |rYt j t5tjj||j}dddn #1swYnxYw|jD]N}tjj|j|s2t|j|ccYSYywxYw)zReturn the docname for the filename if the file is a document. *filename* should be absolute or relative to the source directory. N)rKeyErrorr(r)isabs contextlibsuppress ValueErrorr rrbasenameendswithr removesuffix)rr3suffixs rr'zProject.path2docVs ((2 2 ww}}X&((4F!wwxEHFFF,, I77##H-66v>)(3@@HH I  s5AC2+B= C2B AC2C2.C21C2c |j|}|r*tjj |j |S|S#t$r||jz}YHwxYw)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:rr(r)r*r)rr4r"r3s rr-zProject.doc2pathis[  ;,,W5H 77<< X6 6  ;!:!::H ;s?AAN)rstr | os.PathLike[str]r Iterable[str]returnNone)rr rFrG))z**)r1rEr2rErFzset[str])r3rDrFz str | None)r4strr"boolrFrI) __name__ __module__ __qualname____doc__rr r8r'r-rHrrr r s>E 37QX&*&@M& &P&rr )rN __future__rr<r(rtypingr sphinx.localer sphinx.utilrsphinx.util.matchingrsphinx.util.osutilr r collections.abcr getLoggerrKr+r&r rHrrrWsL7"  36(   8 $> aar