o Ni@sdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddlm Z ddl mZddlmZddlmZerPdd lmZdd lmZd ZdAddZdBddZdCddZdDddZdEddZdFd"d#ZdGd%d&Zd'd(dHd+d,Zed-Z dId/d0Z!dJd2d3Z"ej#fdKd7d8Z$e$Z%e&pe'Z(e j)Z)Gd9d:d:Z*ej+dd;dd>Z-dLd?d@Z.dS)Mz6Operating system-related utility functions for Sphinx.) annotationsN)StringIOpath)Path) TYPE_CHECKING)__) TracebackType)Any/canonical_pathstrreturncCs|ttjSN)replaceSEPrsep)r rF/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/util/osutil.pyos_pathsr native_pathstr | os.PathLike[str]cCst|tjtS)z"Return path in OS-independent form)osfspathrrrr)rrrr canon_path#srfilepathcCst|}td|S)z+Normalize path separator and unicode stringNFC)r unicodedata normalize)rnew_pathrrrpath_stabilize(s r basetocCs|tr|S|ddt}|ddt}t|dd|ddddD]\}}||kr4n |d|dq*||krEdSt|dkrT|dgkrTd tSd tt|dt|S) z.Return a relative URL from ``base`` to ``to``.#rNF)strict.z..) startswithrsplitzippoplenjoin)r!r"b2t2xyrrr relative_uri.s &  r3fileNonecCstj|dddS)zEnsure that a path exists.T)exist_okN)rmakedirs)r4rrr ensuredirEsr8sourceintcCs*t|tjr |nt|}|jd 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)r9strrr_last_modified_timeJs r@destcCs8t|tjr |nt|}tj||j|jfddS)z!Copy a file's modification times.)nsN)r;rr<r=utime st_atime_nsr>)r9rAr?rrr _copy_timesYsrEF)forcerFboolcCst|}t|}|s|d}t||}r#tj||ddse|sB|rBddlm}|t}t d}|j |||ddd d St ||t tt||Wd d S1s^wYd 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)typesubtypeN)rexistsFileNotFoundErrorfilecmpcmp sphinx.utilrI getLogger__name__rwarningshutilcopyfile contextlibsuppressOSErrorrE)r9rArFmsg dest_existsrIloggerrrrrW_s,       "rWz[^a-zA-Z0-9_-]stringcCstd|pdS)Nr&sphinx) _no_fn_resub)r^rrr make_filenamesrbprojectcCst|dS)Nz Documentation)rb removesuffixlower)rcrrrmake_filename_from_projectsrfrstartstr | os.PathLike[str] | NonecCs,ztj||WStyt|YSw)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 )rrgrrrris    ric@s.eZdZdZdddZddd ZdddZdS)_chdirz>Remove this fall-back once support for Python 3.10 is removed. target_dirr rr5cCs||_g|_dSr)r_dirs)selfrlrrr__init__ z_chdir.__init__cCs |jtt|jdSr)rmappendrgetcwdchdirrrnrrr __enter__sz_chdir.__enter__rLtype[BaseException] | NonevalueBaseException | None tracebackTracebackType | NonecCst|jdSr)rrsrmr,)rnrLrwryrrr__exit__sz_chdir.__exit__N)rlr rr5rr5)rLrvrwrxryrzrr5)rT __module__ __qualname____doc__rorur{rrrrrks   rk) c@sLeZdZdZdddZdd d Zdd d Zd ddZd!ddZd"ddZ 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 | Pathrr5cCs||_d|_dSr)_path_io)rnrrrrrorpzFileAvoidWrite.__init__datar cCs|jst|_|j|dSr)rrwrite)rnrrrrrszFileAvoidWrite.writecCs|js d}t||}|jz+t|jdd}|}||kr- WdWdSWdn1s7wYWn tyFYnwt|jddd}||WddS1s`wYdS)z0Stop accepting writes and write file, if needed.z,FileAvoidWrite does not support empty files.zutf-8)encodingNw) r ExceptiongetvaluecloseopenrreadrZr)rnr[bufold_f old_contentfrrrrs(   "zFileAvoidWrite.closecCs|SrrrtrrrruszFileAvoidWrite.__enter__exc_typetype[Exception] exc_valuerryr rGcCs |dS)NT)r)rnrrryrrrr{szFileAvoidWrite.__exit__namecCs|js d}t|t|j|S)Nz=Must write to FileAvoidWrite before other methods can be used)rrgetattr)rnrr[rrr __getattr__s zFileAvoidWrite.__getattr__N)rrrr5)rr rr5r|)rr)rrrrryr rrG)rr rr ) rTr}r~rrorrrur{rrrrrrs    rcCs(tj|r t|dSt|dSr)rrisdirrVrmtreeremoverrrrrs r)r r rr )rrrr )rrrr )r!r r"r rr )r4rrr5)r9rrr:)r9rrArrr5)r9rrArrFrGrr5)r^r rr )rcr rr )rrrgrhrr )rr rr5)/r __future__rrXrPrrerVsysriorrpathlibrtypingr sphinx.localertypesr r rrrr r3r8r@rErWcompiler`rbrfcurdirri safe_relpathgetfilesystemencodinggetdefaultencoding fs_encodingabspathrk version_infocdrrrrrrsP                 0   <