RiK*dZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZmZmZerdd lmZdd lmZdd lmZdd lmZe j0eZdd Z ddd ddZddddfdd ddZy)z"File utility functions for Sphinx.) annotationsN)Path) TYPE_CHECKING)__)logging)_relative_pathcopyfile ensuredir)Callable)Any) BaseRenderer) PathMatcherc|jj}|jdr|j|jddS|jdr|j|jddSy)zGiven an input filename: If the input looks like a template, then return the filename output should be written to. Otherwise, return no result (None). _tNz.jinjai)namelowerendswith with_name)filenamebasenames L/home/agent/.friday_env/lib/python3.12/site-packages/sphinx/util/fileutil.py_template_basenamersm }}""$H!!(--"455   8 $!!(--"455 Fforcect|}|jsyt|}|jr||jz}t |r|| ddlm}|}|jd}|j||}|sa|jrQ||k7rLtd}tj|tj|tj|dd yt |xs|}td }tj|tj|dd |j|dyt!||| y) a Copy an asset file to destination. On copying, it expands the template variables if context argument is given and the asset is a template file. :param source: The path to source file :param destination: The path to destination file or directory :param context: The template variables. If not given, template files are simply copied :param renderer: The template engine. If not given, SphinxRenderer is used by default :param bool force: Overwrite the destination file even if it exists. NrSphinxRendererzutf-8)encodingz`Aborted attempted copy from rendered template %s to %s (the destination path has existing data).misccopy_overwrite)typesubtypez'Writing evaluated template result to %stemplate_evaluationr)rexistsis_dirrrsphinx.util.templater read_text render_stringrloggerwarningosfsdecodeinfo write_textr ) source destinationcontextrendererrrtemplate_contentrendered_templatemsgs rcopy_asset_filer8%sD&&\F ==?{#Kv{{" &!g&9   ;%'H!++W+=$223CWM++-2BFW2W<C NN F# K((   (5D :;  KK $)  07CE2rcy)NF)paths rr<hsrc *t|}|jsy| ddlm}|}t ||j rt |||||ytj|dD]\}} } t|} t| |j} | jD]P} |tj| | r| j| 1t tj|| | R| D]X}|tj| |r t tj||tj|| |||Zy#t$r+}|r|tj|||nYd}~d}~wwxYw)a.Copy asset files to destination recursively. On copying, it expands the template variables if context argument is given and the asset is a template file. Use ``copy_asset_file`` instead to copy a single file. Use ``app.add_static_dir()`` instead to copy static files to the output directory. :param source: The path to source file or directory :param destination: The path to destination directory :param excluded: The matcher to determine the given path should be copied or not :param context: The template variables. If not given, template files are simply copied :param renderer: The template engine. If not given, SphinxRenderer is used by default :param onerror: The error handler. :param bool force: Overwrite the destination file even if it exists. Nrr)r3r4rT) followlinks)rr&r(rr is_filer8r-walkras_posixcopy posixpathjoinremove Exception)r1r2excludedr3r4onerrorrrrootdirsfilesroot_preldirdirrexcs r copy_assetrPesg8&\F ==?7!# k ~~ K85  WWV>dEd/88:99; DC vs34 C )..fcBC  D  HINN68<= #!tX6!{F; '!)#  &! tX >DEs!8E F'!F  F)rrreturnz Path | None)NN) r1str | os.PathLike[str]r2rRr3dict[str, Any] | Noner4BaseRenderer | NonerboolrQNone)r1rRr2rRrGrr3rSr4rTrHz'Callable[[str, Exception], None] | NonerrUrQrV)__doc__ __future__rr-rCpathlibrtypingr sphinx.localer sphinx.utilrsphinx.util.osutilrr r collections.abcr r r(r sphinx.util.typingr getLogger__name__r+rr8rPr:rrrbs ("  BB(1.   8 $  &*$( =3  =3 "=3'=3#=3" =3  =3 =3F/%)$(7; CC "C'CC# C " C 5 C C Cr