-PhdZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZmZmZerdd lmZdd lmZdd lmZdd lmZe jeZd%dZ d&ddd'dZddddfddd(d$ZdS))z"File utility functions for Sphinx.) annotationsN)Path) TYPE_CHECKING)__)logging)_relative_pathcopyfile ensuredir)Callable)Any) BaseRenderer) PathMatcherfilenamerreturn Path | Nonec|j}|dr"||jddS|dr"||jddSdS)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)rbasenames T/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/util/fileutil.py_template_basenamers }""$$H6!!(-"4555   8 $ $6!!(-"4555 4Fforcesourcestr | os.PathLike[str] destinationcontextdict[str, Any] | NonerendererBaseRenderer | NonerboolNonec"t|}|sdSt|}|r ||jz}t |r||ddlm}|}|d}|||}|sn|rZ||krTtd}t |tj |tj |dd dSt |p|}td }t|tj |dd ||ddSt!||| dS) 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 ) rr!r"r$rr*template_contentrendered_templatemsgs rcopy_asset_filer?%s&&\\F ==??{##K#v{" &!!!3g&9   ; ; ; ; ; ;%~''H!++W+==$223CWMM ++-- 2BFW2W2W<C NN F## K(((     F(55D :;;  K $ $)    07CCCCCE222222rcdS)NF)paths rrChsrexcludedronerror'Callable[[str, Exception], None] | Nonec t|}|sdS|ddlm}|}t ||rt |||||dStj|dD]?\}} } t|} t| | } | D]Y} |tj | | r| | 6t tj || | Z| D]}|tj | |sv t tj ||tj || |||\#t$r-}|r |tj |||nYd}~d}~wwxYwAdS)aCopy 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. :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))r"r$rT) followlinks)rr1r3r*r is_filer?r8walkras_posixcopy posixpathjoinremove Exception)rr!rDr"r$rErr*rootdirsfilesroot_preldirdirrexcs r copy_assetrXes12&\\F ==??777777!>## k ~~ K85     WV>>>dEd//88::99;; D DCx vs3344 D C    ).fcBBCCCC  H8IN68<<==  #!tX66!{F;; '!)# ! tX > >DDDDEDDDD  s:F  G#F==G)rrrr)NN) rr r!r r"r#r$r%rr&rr')rr r!r rDrr"r#r$r%rErFrr&rr')__doc__ __future__rr8rMpathlibrtypingr sphinx.localer sphinx.utilrsphinx.util.osutilrr r collections.abcr r r3r sphinx.util.typingr getLogger__name__r6rr?rXrArrrds((""""""  BBBBBBBBBB/((((((111111......  8 $ $     &*$( =3  =3=3=3=3=3=3F/.%)$(7; @@@@@@@@@r