ó öĄ„\c@sZdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZmZddlmZddlmZmZmZddlmZerddlmZmZmZmZmZneed d ƒZeed d ƒZ eed d ƒZ!eed d ƒZ"erhe#Z$ndZ%d„Z&d„Z'd„Z(d„Z)e*ed„Z+d„Z,d„Z-d„Z.d„Z/ej0dƒZ1d„Z2d„Z3ej4d„Z5e5Z6e j7ƒpe j8ƒZ9d„Z:d„Z;ej<d„ƒZ=de>fd „ƒYZ?d!„Z@dS("sŻ 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. i’’’’(tprint_functionN(tBytesIOtStringIO(tpath(tPY2tPY3t text_type(tRemovedInSphinx30Warning(tAnytIteratortListtTupletUniontEEXISTitENOENTtEPIPEtEINVALt/cCs|jttjƒS(N(treplacetSEPRtsep(t canonicalpath((s1lib/python2.7/site-packages/sphinx/util/osutil.pytos_path3scCs|jtjtƒS(s"Return path in OS-independent form(RRRR(t nativepath((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt canon_path8scCsß|jtƒr|S|jtƒ}|jtƒ}xOt|d |d ƒD]6\}}||krePn|jdƒ|jdƒqIW||kr“dSt|ƒdkr¼|dgkr¼dtSdtt|ƒdtj|ƒS(s.Return a relative URL from ``base`` to ``to``.i’’’’itit.s..(t startswithRtsplittziptpoptlentjoin(tbasettotb2tt2txty((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt relative_uri>s$   !cCsAytj|ƒWn)tk r<tjj|ƒs=‚q=nXdS(sEnsure that a path exists.N(tostmakedirstOSErrorRtisdir(R((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt ensuredirVs  c cs3tj|ƒ}gg}}x„|D]|}ytj||ƒ}Wn1tk rrtd|tfdtjƒq#nXtj |ƒr’|j |ƒq#|j |ƒq#W|rŗ|||fVnx[|D]S}tj||ƒ}|sļtj |ƒ rĮx"t |||ƒD] }|VqWqĮqĮW|s/|||fVndS(sRBackport of os.walk from 2.6, where the *followlinks* argument was added. sU%s:: ERROR: non-ASCII filename not supported on this filesystem encoding %r, skipped.tfileN( R(tlistdirRR t UnicodeErrortprintt fs_encodingtsyststderrR+tappendtislinktwalk( ttopttopdownt followlinkstnamestdirstnondirstnametfullpathR%((s1lib/python2.7/site-packages/sphinx/util/osutil.pyR6es,      ccsx†|D]~}xutj|ƒD]d\}}}xR|D]J}|j|ƒr3ytjtj||ƒƒVWq}tk ryq}Xq3q3WqWqWdS(N(R(R6tendswithRtgetmtimeR tEnvironmentError(tdirnamestsuffixtdirnametrootR;tfilestsfile((s1lib/python2.7/site-packages/sphinx/util/osutil.pytmtimes_of_files…s   cCsNtjj|ƒr:ytj|ƒWq:tk r6q:Xntj||ƒdS(s3Move a file, removing the destination if it exists.N(R(RtexiststunlinkR*trename(tsourcetdest((s1lib/python2.7/site-packages/sphinx/util/osutil.pytmovefile‘s  cCsAtj|ƒ}ttdƒr=tj||j|jfƒndS(s!Copy a file's modification times.tutimeN(R(tstatthasattrROtst_atimetst_mtime(RLRMtst((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt copytimesœscCs_tj|ƒ s#tj||ƒ r[tj||ƒyt||ƒWq[tk rWq[XndS(s{Copy a file and its modification times, if possible. Note: ``copyfile`` skips copying if the file has not been changedN(RRItfilecmptcmptshutiltcopyfileRUR*(RLRM((s1lib/python2.7/site-packages/sphinx/util/osutil.pyRY¤s # s[^a-zA-Z0-9_-]cCstjd|ƒpdS(NRtsphinx(tno_fn_retsub(tstring((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt make_filenameµscGstjdtddƒ|s[tjdƒ}|dk r[tjt|ƒƒ}|g}q[nt r„t j t j ƒdpzd}tj t|ƒj|ƒ|Œj|ƒSytj ||ŒSWnBtk rżtj |jdƒjƒ|Œ}|jƒjdƒSXdS( s*[DEPRECATED] strftime for unicode strings.s5sphinx.util.osutil.ustrtime is deprecated for removalt stacklevelitSOURCE_DATE_EPOCHisutf-8sunicode-escapeN(twarningstwarnRR(tgetenvtNonettimetgmtimetfloatRtlocalet getlocaletLC_TIMEtstrftimeRtencodetdecodetUnicodeEncodeError(tformattargstsource_date_epocht time_structtenctr((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt ustrftimeŗs   ( !cCs0ytjj||ƒSWntk r+|SXdS(sReturn 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(Rtrelpatht ValueError(Rtstart((s1lib/python2.7/site-packages/sphinx/util/osutil.pyRvÖs cCs\tj|ƒ}t|tƒrXy|jtƒ}WqXtk rTtdtƒ‚qXXn|S(NsAmultibyte filename not supported on this filesystem encoding (%r)(Rtabspatht isinstancetbytesRmR1tUnicodeDecodeError(tpathdir((s1lib/python2.7/site-packages/sphinx/util/osutil.pyRyčs cCs#ttdƒrtjƒStjƒS(Ntgetcwdu(RQR(R~tgetcwd(((s1lib/python2.7/site-packages/sphinx/util/osutil.pyRõs ccs4tƒ}ztj|ƒdVWdtj|ƒXdS(N(RR(tchdir(t target_dirtcwd((s1lib/python2.7/site-packages/sphinx/util/osutil.pytcdüs    tFileAvoidWritecBsDeZdZd„Zd„Zd„Zd„Zd„Zd„ZRS(søFile-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(t_pathRdt_io(tselfR((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt__init__s cCsJ|js6t|tƒr'tƒ|_q6tƒ|_n|jj|ƒdS(N(R†RzRRRtwrite(R‡tdata((s1lib/python2.7/site-packages/sphinx/util/osutil.pyR‰s  cCsß|jstdƒ‚n|jƒ}|jjƒd}d}t|jtƒr^d}d}nd}y;t|j|ƒ#}|j ƒ}||kr˜dSWdQXWnt k r²nXt|j|ƒ}|j |ƒWdQXdS(s0Stop accepting writes and write file, if needed.s,FileAvoidWrite does not support empty files.RttwtrbtwbN( R†t ExceptiontgetvaluetcloseRzRRdtopenR…treadtIOErrorR‰(R‡tbuftr_modetw_modet old_contenttold_ftf((s1lib/python2.7/site-packages/sphinx/util/osutil.pyR"s&       cCs|S(N((R‡((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt __enter__>scCs|jƒdS(N(R(R‡ttypetvaluet traceback((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt__exit__BscCs(|jstdƒ‚nt|j|ƒS(Ns=Must write to FileAvoidWrite before other methods can be used(R†RŽtgetattr(R‡R=((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt __getattr__Fs ( t__name__t __module__t__doc__RˆR‰RRšRžR (((s1lib/python2.7/site-packages/sphinx/util/osutil.pyR„s     cCs3tjj|ƒr"tj|ƒn tj|ƒdS(N(R(RR+RXtrmtreetremove(R((s1lib/python2.7/site-packages/sphinx/util/osutil.pyR¤Ps(AR£t __future__Rt contextlibterrnoRVRhR(treRXR2ReRatioRRRtsixRRRtsphinx.deprecationRtFalsettypingRR R R R RŸR RRRtstrtunicodeRRRR'R,tTrueR6RHRNRURYtcompileR[R^RutcurdirRvt safe_relpathtgetfilesystemencodingtgetdefaultencodingR1RyRtcontextmanagerRƒtobjectR„R¤(((s1lib/python2.7/site-packages/sphinx/util/osutil.pyt sX          +           I