o Ni@sdZddlmZddlZddlZddlmZddlmZm Z ddl m Z ddl m Z ddlmZdd lmZmZerLdd lmZdd lmZdd lmZeeZd(ddZ  d)ddd*ddZd d!dddfddd+d&d'ZdS),z"File utility functions for Sphinx.) annotationsN)Path) TYPE_CHECKINGAny) relative_path)__)logging)copyfile ensuredir)Callable) BaseRenderer) PathMatcherfilenamestr | os.PathLike[str]return str | NonecCsLtj|}|drt|ddS|dr$t|ddSdS)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)ospathbasenamelowerendswithstr)rrrH/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/util/fileutil.py_template_basenames rFforcesource destinationcontextdict[str, Any] | NonerendererBaseRenderer | NonerboolNonec CsVtj|sdSt|}|r|tj|}t|r|dur|dur-ddlm}|}t |dd }| }Wdn1sBwY| ||}|sm|rm||krmt d} t j| t|t|ddd dSt|pr|}t |d dd} t d } t j| t|dd d | |WddS1swYdSt|||d 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)typesubtypewz'Writing evaluated template result to %stemplate_evaluationr)rrexistsris_dirrrsphinx.util.templater(openread render_stringrloggerwarningfsdecodeinfowriter ) rr r!r#rr(fsrctemplate_contentrendered_templatemsgfdstrrrcopy_asset_file&sJ      " r@cCsdS)NFr)rrrrjsrAexcludedr onerror'Callable[[str, Exception], None] | Nonec Cs8tj|sdS|durddlm}|}t|tj|r*t|||||ddStj|ddD]h\}} } t ||} | D]} |t | | rO| | q?tt || | q?| D]=} |t | | sztt || t || |||dWq[ty}z|r|t || |nWYd}~q[d}~wwq[q1dS)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)rrr0r2r(r isfiler@walkrcopy posixpathjoinremove Exception)rr rBr!r#rCrr(rootdirsfilesreldirdirrexcrrr copy_assetgsJ           rS)rrrr)NN) rrr rr!r"r#r$rr%rr&)rrr rrBr r!r"r#r$rCrDrr%rr&)__doc__ __future__rrrIpathlibrtypingrrdocutils.utilsr sphinx.localer sphinx.utilrsphinx.util.osutilr r collections.abcr r2r sphinx.util.typingr getLogger__name__r6rr@rSrrrrs8          D