B \'@sdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZmZddlmZddlmZmZmZddlmZeeddZeed dZeed dZeed dZereZd Zd dZddZ ddZ!ddZ"d2ddZ#ddZ$ddZ%ddZ&dd Z'e(d!Z)d"d#Z*d$d%Z+ej,fd&d'Z-e-Z.e /p^e 0Z1d(d)Z2d*d+Z3ej4d,d-Z5Gd.d/d/e6Z7d0d1Z8dS)3z sphinx.util.osutil ~~~~~~~~~~~~~~~~~~ Operating system-related utility functions for Sphinx. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. )print_functionN)BytesIOStringIO)path)PY2PY3 text_type)RemovedInSphinx30WarningEEXISTENOENTEPIPEEINVAL/cCs|ttjS)N)replaceSEPrsep)Z canonicalpathr1lib/python3.7/site-packages/sphinx/util/osutil.pyos_path3srcCs|tjtS)z"Return path in OS-independent form)rrrr)Z nativepathrrr canon_path8srcCs|tr|S|t}|t}xDt|dd|ddD]&\}}||krPP|d|dq>W||krtdSt|dkr|dgkrdtSdtt|dt|S)z.Return a relative URL from ``base`` to ``to``.Nr.z..) startswithrsplitzippoplenjoin)basetoZb2Zt2xyrrr relative_uri>s   $ r$cCs6yt|Wn"tk r0tj|s,YnXdS)zEnsure that a path exists.N)osmakedirsOSErrorrisdir)rrrr ensuredirVs  r)TFc cst|}gg}}xj|D]b}yt||}Wn,tk rZtd|tftjdwYnXt |rr| |q| |qW|r|||fVxB|D]:}t||}|st |sxt |||D] }|VqWqW|s|||fVdS)zRBackport of os.walk from 2.6, where the *followlinks* argument was added. zU%s:: ERROR: non-ASCII filename not supported on this filesystem encoding %r, skipped.)fileN) r%listdirrr UnicodeErrorprint fs_encodingsysstderrr(appendislinkwalk) toptopdown followlinksnamesdirsnondirsnameZfullpathr"rrrr3es,         r3c csrxl|D]d}x^t|D]P\}}}xD|D]<}||r&ytt||VWq&tk r`Yq&Xq&WqWqWdS)N)r%r3endswithrgetmtimerEnvironmentError)Zdirnamessuffixdirnamerootr8filesZsfilerrrmtimes_of_filess   rBcCs@tj|r0yt|Wntk r.YnXt||dS)z3Move a file, removing the destination if it exists.N)r%rexistsunlinkr'rename)sourcedestrrrmovefiles  rHcCs,t|}ttdr(t||j|jfdS)z!Copy a file's modification times.utimeN)r%stathasattrrIst_atimest_mtime)rFrGstrrr copytimess  rOcCsJt|rt||sFt||yt||Wntk rDYnXdS)z{Copy a file and its modification times, if possible. Note: ``copyfile`` skips copying if the file has not been changedN)rrCfilecmpZcmpshutilcopyfilerOr')rFrGrrrrRs  rRz[^a-zA-Z0-9_-]cCstd|pdS)NrZsphinx)no_fn_resub)stringrrr make_filenamesrVcGstjdtdd|s:td}|dk r:tt|}|g}trrt t j dpPd}tj t ||f||Sytj |f|Stk rtj |df|}|dSXdS) z*[DEPRECATED] strftime for unicode strings.z5sphinx.util.osutil.ustrtime is deprecated for removal) stacklevelSOURCE_DATE_EPOCHNrzutf-8zunicode-escape)warningswarnr r%getenvtimeZgmtimefloatrlocaleZ getlocaleLC_TIMEZstrftimerencodedecodeUnicodeEncodeError)formatargsZsource_date_epochZ time_structencrrrr ustrftimes   rhcCs(ytj||Stk r"|SXdS)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). N)r%rrelpath ValueError)rstartrrrrisricCsHt|}t|trDy|t}Wn tk rBtdtYnX|S)NzAmultibyte filename not supported on this filesystem encoding (%r))rabspath isinstancebytesrbr.UnicodeDecodeError)Zpathdirrrrrls  rlcCsttdrtStS)Ngetcwdu)rKr%rpgetcwdrrrrrqs rqc cs,t}zt|dVWdt|XdS)N)rqr%chdir)Z target_dircwdrrrcds   rtc@s@eZdZdZddZddZddZdd Zd d Zd d Z 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. cCs||_d|_dS)N)_path_io)selfrrrr__init__szFileAvoidWrite.__init__cCs2|js"t|trt|_nt|_|j|dS)N)rwrmrrrwrite)rxdatarrrrzs   zFileAvoidWrite.writec Cs|jstd|}|jd}d}t|jtrszFileAvoidWrite.__enter__cCs |dS)N)r)rxtypevalue tracebackrrr__exit__BszFileAvoidWrite.__exit__cCs|jstdt|j|S)Nz=Must write to FileAvoidWrite before other methods can be used)rwrgetattr)rxr:rrr __getattr__FszFileAvoidWrite.__getattr__N) __name__ __module__ __qualname____doc__ryrzrrrrrrrrrus  rucCs&tj|rt|n t|dS)N)r%rr(rQrmtreeremove)rrrrrPs  r)TF)9rZ __future__r contextliberrnorPr_r%rerQr/r]rZiorrrZsixrrrZsphinx.deprecationr rr r r r strZunicoderrrr$r)r3rBrHrOrRcompilerSrVrhcurdirriZ safe_relpathgetfilesystemencodinggetdefaultencodingr.rlrqcontextmanagerrtobjectrurrrrr sT             I