-Phb dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZddlmZddlmZerddlmZdd lmZmZd Zd3dZd4dZd5dZd6dZd7dZd8dZd9dZdd d:d#Zej d$Z!d;d&Z"dd/Z&e%Z'e j(pe j)Z*ej+j,Z,Gd0d1Z-d?d2Z.dS)@z6Operating system-related utility functions for Sphinx.) annotationsN)StringIO)Path) TYPE_CHECKING)__) TracebackType)AnySelf/canonical_pathstrreturncV|ttjjSN)replaceSEPospathsep)r s R/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/util/osutil.pyos_pathrs  ! !#rw{ 3 33 native_pathstr | os.PathLike[str]cztj|tjjt S)z"Return path in OS-independent form)rfspathrrrr)rs r canon_pathr#s& 9[ ! ! ) )"'+s ; ;;rfilepathcJt|}tjd|S)z+Normalize path separator and unicode stringNFC)r unicodedata normalize)rnew_paths rpath_stabilizer$(s"(##H   1 11rbasetoc|tr|S|ddt}|ddt}t|dd|dddD]7\}}||krn+|d|d8||krdSt |dkr|dgkr d tzSd tzt |dz zt|zS) z.Return a relative URL from ``base`` to ``to``.#rNF)strict...) startswithrsplitzippoplenjoin)r%r&b2t2xys r relative_urir9.s }}S C  ! !# & &B #q    $ $BBssGRWU3331 66 E q  q  Rxxr 2ww!||rd Sy 3J3r77Q; '#((2,, 66rfileNonec2tj|ddS)zEnsure that a path exists.T)exist_okN)rmakedirs)r:s r ensuredirr?EsKt$$$$$$rsourceintct|tjr|ntj|}|jdz S)a5Return the last modified time of ``filename``. The time is returned as integer microseconds. The lowest common denominator of modern file-systems seems to be microsecond-level precision. We prefer to err on the side of re-rendering a file, so we round up to the nearest microsecond. i) isinstancerDirEntrystat st_mtime_ns)r@sts r_last_modified_timerHJs>%VR[99 NrwvB ^v % &&rdestct|tjr|ntj|}tj||j|jfdS)z!Copy a file's modification times.)nsN)rCrrDrEutime st_atime_nsrF)r@rIrGs r _copy_timesrNYsP$VR[99 NrwvBHTr~r~6777777rF)forcerOboolct|}t|}|s|d}t||x}rtj||ds|sM|rKddlm}|t}td}| |||dd d Stj d krtj||d Stj||t!jt$5t'||d d d d S#1swxYwYd Sd S) aeCopy a file and its modification times, if possible. :param source: An existing source to copy. :param dest: The destination path. :param bool force: Overwrite the destination file even if it exists. :raise FileNotFoundError: The *source* does not exist. .. note:: :func:`copyfile` is a no-op if *source* and *dest* are identical. z does not existF)shallowr)loggingzNAborted attempted copy from %s to %s (the destination path has existing data).misccopy_overwrite)typesubtypeNwin32)rexistsFileNotFoundErrorfilecmpcmp sphinx.utilrS getLogger__name__rwarningsysplatformshutilcopy2copyfile contextlibsuppressOSErrorrN)r@rIrOmsg dest_existsrSloggers rrere_s &\\F ::D ==??%((($$$!KKMM )[*{64777 *    , + + + + +&&x00F<C NN36CSN T T T F <7 " " L & & & & & OFD ) ) )$W-- * *FD))) * * * * * * * * * * * * * * * * * *3**sD66D:=D:z[^a-zA-Z0-9_-]stringc<td|pdS)Nr+sphinx) _no_fn_resub)rls r make_filenamerqs ==V $ $ 00rprojectcjt|dS)Nz Documentation)rq removesuffixlower)rrs rmake_filename_from_projectrvs+ --.>?? @ @ F F H HHrrstartstr | os.PathLike[str] | Nonec tj||S#t$rt |cYSwxYw)aReturn a relative filepath to *path* either from the current directory or from an optional *start* directory. This is an alternative of ``os.path.relpath()``. This returns original path if *path* and *start* are on different drives (for Windows platform). )rrrelpath ValueErrorr )rrws rrzrzsJwtU+++ 4yys ">>rrootcdd|jvr|}d|jvr|}|j|jks d|jvr|Stjdddkr-t t j||S| |dS)zReturn a relative filepath to *path* from the given *root* directory. This is an alternative of ``Path.relative_to``. It returns the original path if *path* and *root* are on different drives, which may happen on Windows. r.N) T)walk_up) partsresolveanchorra version_inforrrrz relative_to)rr|s r_relative_pathrs tz||~~ tz||~~ {dk!!TTZ%7%7  g%%BGOOD$//000   D$  / //rcBeZdZdZddZdd Zdd Zdd ZddZddZ dS)FileAvoidWriteaFile-like object that buffers output and only writes if content changed. Use this class like when writing to a file to avoid touching the original file if the content hasn't changed. This is useful in scenarios where file mtime is used to invalidate caches or trigger new behavior. When writing to this file handle, all writes are buffered until the object is closed. Objects can be used as context managers. r str | Pathrr;c"||_d|_dSr)_path_io)selfrs r__init__zFileAvoidWrite.__init__s $(rdatar cn|jst|_|j|dSr)rrwrite)rrs rrzFileAvoidWrite.writes1x "zzDH trc|jsd}t||}|j t |jd5}|}dddn #1swxYwY||krdSn#t$rYnwxYwt |jdd5}||ddddS#1swxYwYdS)z0Stop accepting writes and write file, if needed.z,FileAvoidWrite does not support empty files.zutf-8)encodingNw) r Exceptiongetvaluecloseopenrreadrhr)rribufold_f old_contentfs rrzFileAvoidWrite.closessx !@CC.. mmoo  dj7333 +u#jjll  + + + + + + + + + + + + + + +c!!"    D $*cG 4 4 4  GGCLLL                  sHBA>2 B>BBB B BB9CC #C r c|Sr)rs r __enter__zFileAvoidWrite.__enter__s rexc_typetype[BaseException] | None exc_valueBaseException | None tracebackTracebackType | NonerPc.|dS)NT)r)rrrrs r__exit__zFileAvoidWrite.__exit__s trnamer c\|jsd}t|t|j|S)Nz=Must write to FileAvoidWrite before other methods can be used)rrgetattr)rrris r __getattr__zFileAvoidWrite.__getattr__s/x !QCC.. tx&&&rN)rrrr;)rr rr;)rr;)rr )rrrrrrrrP)rr rr ) r_ __module__ __qualname____doc__rrrrrrrrrrrs  )))) (''''''rrct|}|rtj|dSt j|dSr)ris_dirrcrmtreerremove)rs rrrsD ::D {{}} d $r)r r rr )rrrr )rrrr )r%r r&r rr )r:rrr;)r@rrrA)r@rrIrrr;)r@rrIrrOrPrr;)rlr rr )rrr rr )rrrwrxrr )rrr|rrr)rrrr;)/r __future__rrfr[ros.pathrercrar!iorpathlibrtypingr sphinx.localertypesrr r rrrr$r9r?rHrNrecompilerorqrvcurdirrzr safe_relpathgetfilesystemencodinggetdefaultencoding fs_encodingrabspathrrrrrrs<<""""""   !######         4444<<<< 2222 7777.%%%% ' ' ' '8888 1*1*1*1*1*1*h BJ( ) ) 1111IIII JL     0000* 'c'))E-CS-C-E-E  '/<'<'<'<'<'<'<'<'~r