}c, dZddlZddlmZddlmZmZmZmZddlm Z ddl m Z m Z m Z ddlmZddlmZmZe jeZgd ZGd d ZdS) z1Utility function and classes for Sphinx projects.N)glob)DictListOptionalSet)__)get_matching_filesloggingpath_stabilize)compile_matchers)SEPrelpath)z **/_sourcesz.#*z**/.#*z *.lproj/**ceZdZdZdedeeefddfdZddZgfd eede efd Z d ede efd Z ddede defdZdS)Projectz;A project is the source code set of the Sphinx document(s).srcdir source_suffixreturnNcH||_||_t|_dS)N)rrsetdocnames)selfrrs .lib/python3.11/site-packages/sphinx/project.py__init__zProject.__init__s$ +#&%% otherc|j|_dS)z!Take over a result of last build.N)r)rrs rrestorezProject.restores r exclude_pathsc t_t|tz}t j|D].}|}|r|jvrtj j|dz}fdt|D}t td|||dtjtj j|tjrj|t td|0jS)zbFind all document files in the source directory and put them in :attr:`docnames`. z.*c:g|]}t|jS)rr).0frs r z$Project.discover..,s%LLLWQ 44LLLrzDmultiple files found for the document "%s": %r Use %r for the build.T)oncezdocument not readable. Ignored.)location)rrr EXCLUDE_PATHSr rpath2docospathjoinrloggerwarningrdoc2pathaccessR_OKadd)rrexcludesfilenamedocnamepatternfiless` rdiscoverzProject.discover!s\ #MM$ABB*4;AA \ \HmmH--G \dm+ \ gll4;@@4GGLLLLd7mmLLLENN2'>$?$?#*E4==3I3IPT#VVVVYrw||DKBBBGLL\M%%g....NN2&G#H#HSZN[[[}rr3c||jrt||j}|jD]@}||r)t |}|dt | cSAdS)zReturn the docname for the filename if the file is a document. *filename* should be absolute or relative to the source directory. N) startswithrrrendswithr len)rr3suffixs rr(zProject.path2doc7s   t{ + + 6x55H( / /F  (( /)(33 #f++ .... / trTr4basedircH|ttjj}tj|j|}|jD]&}tj||zrn't|jd}|r||zS||zS)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. r) replacer r)r*sepr+rrisfilelist)rr4r=basenamer<s rr.zProject.doc2pathFs //#rw{337<< W55( 1 1Fw~~h/00  $,--a0F  $f$ $V# #r)rrrN)T)__name__ __module__ __qualname____doc__strrrrrrr7rr(boolr.r!rrrrsEE(s(4S>(d((((''''35d3iS,  #    $$$d$c$$$$$$rr)rGr)rtypingrrrr sphinx.localer sphinx.utilr r r sphinx.util.matchingr sphinx.util.osutilr r getLoggerrDr,r'rr!rrrPs77 ,,,,,,,,,,,,CCCCCCCCCC111111++++++++  8 $ $>>> H$H$H$H$H$H$H$H$H$H$r