}cjdZddlZddlZddlZddlZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZmZmZ ddlm Zn #e$rdZYnwxYwdZdedefd Zd edefd Zd ed edefdZdeddfdZdeedede efdZdededdfdZdededdfdZejdZejdZ dedefdZ!dedefdZ"ej#fdededefdZ$e$Z%ej&pej'Z(d edefd!Z)ej*d"ede d#fd$Z+Gd%d&Z,deddfd'Z-dS)(z6Operating system-related utility functions for Sphinx.N)StringIOpath)Any GeneratorIteratorListOptionalType/ canonicalpathreturncL|ttjSN)replaceSEPrsep)r s 2lib/python3.11/site-packages/sphinx/util/osutil.pyos_pathrs  dh / // nativepathcL|tjtS)z"Return path in OS-independent form)rrrr)rs r canon_pathr s   dh , ,,rbasetoc~|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)rrb2t2xys r relative_urir,%s# }}S C  ! !# & &B #q    $ $BBssGRW%%1 6  E q  q  Rxr 2ww!|rd Sy 3J3r77Q; '#((2,, 66rrc2tj|ddS)zEnsure that a path exists.T)exist_okN)osmakedirsrs r ensuredirr1<sKt$$$$$$rdirnamessuffixc #K|D]r}tj|D][\}}}|D]R}||r; tjtj||VB#t $rYNwxYwS\sdSr)r/walkendswithrgetmtimer'OSError)r2r3dirnameroot_dirsfilessfiles rmtimes_of_filesr>As"$''"2"2   D%  >>&))"mDIdE,B,BCCCCCC"  s)A%% A2 1A2 sourcedestctj|}ttdr#tj||j|jfdSdS)z!Copy a file's modification times.utimeN)r/stathasattrrBst_atimest_mtime)r?r@sts r copytimesrHLsL Br73  R[12222233rctj|rtj||s9t j|| t ||dS#t$rYdSwxYwdS)z{Copy a file and its modification times, if possible. Note: ``copyfile`` skips copying if the file has not been changedN)rexistsfilecmpcmpshutilcopyfilerHr8)r?r@s rrNrNSs ;t  GK$=$=%%%  fd # # # # #    DD  sA A A z[^a-zA-Z0-9_-]z Documentation$stringc<td|pdS)Nrsphinx)no_fn_resub)rOs r make_filenamerTds <<F # # /x/rprojectcvttd|S)Nr)rTproject_suffix_rerSlower)rUs rmake_filename_from_projectrYhs- *..r7;; < < B B D DDrstartch tj||S#t$r|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). )r/rrelpath ValueError)rrZs rr\r\lsAwtU+++  s " 11pathdircDt)t|tr|Stj|}t|trF |t }n*#t$r}tdt z|d}~wwxYw|S)NzAmultibyte filename not supported on this filesystem encoding (%r))Path isinstanceabspathrbytesdecode fs_encodingUnicodeDecodeError)r^excs rrbrb}s Jw55    ,w'' gu % % H H!..55% H H H(*02=*>??DGH HsA66 BBB target_dir)NNNc#Ktj} tj|dVtj|dS#tj|wxYwr)r/getcwdchdir)rhcwds rcdrmsR )++C     s AAcveZdZdZdeddfdZdeddfdZddZdd Zd e e d e d e de fd Z dede fdZdS)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. rrNc"||_d|_dSr)_path_io)selfrs r__init__zFileAvoidWrite.__init__s '+rdatacn|jst|_|j|dSr)rrrwrite)rsrus rrwzFileAvoidWrite.writes1x "zzDH trc|jstd|}|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) rr Exceptiongetvaluecloseopenrqreadr8rw)rsbufold_f old_contentfs rr}zFileAvoidWrite.closesx LJKK Kmmoo  dj7333 u#jjll #%                           D $*cG 4 4 4  GGCLLL                  sNBB7 B BBBBB B*)B*C''C+.C+c|Sr)rss r __enter__zFileAvoidWrite.__enter__s rexc_type exc_value tracebackc.|dS)NT)r})rsrrrs r__exit__zFileAvoidWrite.__exit__s trnamecX|jstdt|j|S)Nz=Must write to FileAvoidWrite before other methods can be used)rrr{getattr)rsrs r __getattr__zFileAvoidWrite.__getattr__s7x 3233 3tx&&&r)rN)rro)__name__ __module__ __qualname____doc__strrtrwr}rr r{rboolrrrrrroros  ,S,T,,,,#$ &iYSV[_''''''''rroctj|rtj|dStj|dSr)r/risdirrMrmtreeremovers rrrs? w}}T d $r).r contextlibrKr/rerMsysiorrtypingrrrr r r sphinx.testing.pathr` ImportErrorrrrrr,r1floatr>rHrNcompilerRrWrTrYcurdirr\ safe_relpathgetfilesystemencodinggetdefaultencodingrerbcontextmanagerrmrorrrrrsl<< AAAAAAAAAAAAAAAA0000000 DDD 03030000-3-3---- 7s777777.%C%D%%%% d3i%3c333333 S       2:' ( (BJ0110#0#0000EEEEEE%'I  # c #     'c'))E-CS-C-E-E  S S     39%565'5'5'5'5'5'5'5'ps?A A