7 fdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddlm Z ddl mZmZddlmZerddlmZd Zd4d Zd5dZd6dZd7dZd8dZd9dZd:d Zd:d!Zejd"Zejd#Zd;d%Z dd0Z+Gd1d2Z,d?d3Z-dS)@z6Operating system-related utility functions for Sphinx.) annotationsN)StringIOpath) TYPE_CHECKINGAny)_deprecation_warning)Iterator/canonical_pathstrreturncL|ttjSN)replaceSEPrsep)r s H/var/www/equiseq/venv/lib/python3.11/site-packages/sphinx/util/osutil.pyos_pathrs  ! !#tx 0 00 native_pathstr | os.PathLike[str]cptj|tjt S)z"Return path in OS-independent form)osfspathrrrr)rs r canon_pathr!s$ 9[ ! ! ) )$(C 8 88rfilepathcJt|}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|ddD]7\}}||krn+|d|d8||krdSt |dkr|dgkr dtzSdtzt |dz zt|zS) z.Return a relative URL from ``base`` to ``to``.#rN.z..) startswithrsplitzippoplenjoin)r$r%b2t2xys r relative_urir6,s }}S C  ! !# & &B #q    $ $BBssGRW%%1 66 E q  q  Rxxr 2ww!||rd Sy 3J3r77Q; '#((2,, 66rfileNonec2tj|ddS)zEnsure that a path exists.T)exist_okN)rmakedirs)r7s r ensuredirr<CsKt$$$$$$rdirnames list[str]suffixIterator[float]c #2K|D]}tj|D]z\}}}|D]q}||rZtjt 5t jt j||Vdddn #1swxYwYr{dSr) rwalkendswith contextlibsuppressOSErrorrgetmtimer1)r=r?dirnameroot_dirsfilessfiles rmtimes_of_filesrMHsDD"$''"2"2 D D D% D D>>&))D#,W55DD"mDIdE,B,BCCCCCDDDDDDDDDDDDDDD D DDDs*B B B sourcedestctj|}ttdr#tj||j|jfdSdS)z!Copy a file's modification times.utimeN)rstathasattrrQst_atimest_mtime)rNrOsts r copytimesrWQsL Br73  R[12222233rc tj|rtj||sYt j||t jt5t||ddddS#1swxYwYdSdS)z{Copy a file and its modification times, if possible. Note: ``copyfile`` skips copying if the file has not been changedN) rexistsfilecmpcmpshutilcopyfilerDrErFrW)rNrOs rr]r]Xs ;t  $GK$=$=$%%%   ) ) $ $ fd # # # $ $ $ $ $ $ $ $ $ $ $ $ $ $ $ $ $ $$$sA66A:=A:z[^a-zA-Z0-9_-]z Documentation$stringc<td|pdS)Nr)sphinx)no_fn_resub)r^s r make_filenamercgs <<F # # /x/rprojectcvttd|S)Nr))rcproject_suffix_rerblower)rds rmake_filename_from_projectrhks- *..r7;; < < B B D DDrrstartstr | 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 )rris rrlrlosJwtU+++ 4yys ">>c&eZdZdZddZdZdZdS) _chdirz>Remove this fall-back once support for Python 3.10 is removed. target_dirr c"||_g|_dSr)rrJ)selfrps r__init__z_chdir.__init__s " rc|jtjtj|jdSr)rJappendrgetcwdchdirrrrs r __enter__z_chdir.__enter__s6 ")++&&& rc\tj|jdSr)rrwrJr/)rr _exc_type _exc_value _tracebacks r__exit__z_chdir.__exit__s$ !!"""""rN)rpr )__name__ __module__ __qualname____doc__rsryr~rrrorosLHH#########rrorpIterator[None]c#Ktjdddkrttdddt |5dVddddS#1swxYwYdS)N) cdzcontextlib.chdir)r)remove)sys version_infor rro)rps rrrs w&&Xt-?OOOO    sAAAcBeZdZdZddZddZdd 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. rr rr8c"||_d|_dSr)_path_io)rrrs rrszFileAvoidWrite.__init__s $(rdatacn|jst|_|j|dSr)rrwrite)rrrs rrzFileAvoidWrite.writes1x "zzDH trc|jsd}t||}|j t |jd5}|}||kr ddddS dddn #1swxYwYn#t$rYnwxYwt |jdd5}||ddddS#1swxYwYdS)z0Stop accepting writes and write file, if needed.z,FileAvoidWrite does not support empty files.zutf-8)encodingNw) r ExceptiongetvaluecloseopenrreadrFr)rrmsgbufold_f old_contentfs rrzFileAvoidWrite.closesx !@CC.. mmoo  dj7333 u#jjll #%%        %                   D $*cG 4 4 4  GGCLLL                  sNBB9 B BBBBB B,+B,C))C-0C-c|Srrrxs rryzFileAvoidWrite.__enter__s rexc_typetype[Exception] exc_valuer tracebackrboolc.|dS)NT)r)rrrrrs rr~zFileAvoidWrite.__exit__s trnamec\|jsd}t|t|j|S)Nz=Must write to FileAvoidWrite before other methods can be used)rrgetattr)rrrrs r __getattr__zFileAvoidWrite.__getattr__s/x !QCC.. tx&&&rNrr rr8)rr rr8)rr8)rr)rrrrrrrr)rr rr) rrrrrsrrryr~rrrrrrs  )))) ( ''''''rrctj|rtj|dStj|dSr)rrisdirr\rmtreerrs rrrs? w}}T d $r)r r rr )rrrr )rrrr )r$r r%r rr )r7rrr8)r=r>r?r rr@)rNrrOrrr8)r^r rr )rdr rr )rrrirjrr )rpr rrr).r __future__rrDrZrrer\rr iorrtypingrrsphinx.deprecationr collections.abcr rrrr#r6r<rMrWr]compilerarfrcrhcurdirrl safe_relpathgetfilesystemencodinggetdefaultencoding fs_encodingabspathrocontextmanagerrrrrrrrs<<"""""" %%%%%%%%333333)(((((( 11119999 2222 7777.%%%% DDDD3333$$$$ 2:' ( (BJ0110000EEEE 469      'c'))E-CS-C-E-E  , # # # # # # # # 8'8'8'8'8'8'8'8'vr