B \@s\dZddlZddlZddlZddlmZddlmZmZe pFe Z GdddeZ dS)z sphinx.testing.path ~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. N)open)PY2 text_typec@seZdZdZeredfddZeddZddZ d d Z d d Z d dZ ddZ ddZddZdd$d%Zd?d'd(Zd@d)d*Zd+d,ZdAd-d.Zd/d0Zd1d2ZdBd4d5Zd6d7Zd8d9Z eZ!Z"d:d;Z#dS)Cpathz8 Represents a path which behaves like a string. strictcCs.t|tr"|||}t||St||S)N) isinstancestrdecoder__new__)clssencodingerrorsr2lib/python3.7/site-packages/sphinx/testing/path.pyr s   z path.__new__cCs|tj|S)zH The name of the directory the file or directory is in. ) __class__osrdirname)selfrrrparent$sz path.parentcCs tj|S)N)rrbasename)rrrrr,sz path.basenamecCs|tj|S)z, Returns the absolute path. )rrrabspath)rrrrr0sz path.abspathcCs tj|S)z; Returns ``True`` if the path is absolute. )rrisabs)rrrrr7sz path.isabscCs tj|S)z> Returns ``True`` if the path is a directory. )rrisdir)rrrrr>sz path.isdircCs tj|S)z9 Returns ``True`` if the path is a file. )rrisfile)rrrrrEsz path.isfilecCs tj|S)zB Returns ``True`` if the path is a symbolic link. )rrislink)rrrrrLsz path.islinkcCs tj|S)z@ Returns ``True`` if the path is a mount point. )rrismount)rrrrrSsz path.ismountFNcCstj|||ddS)al Removes the file or directory and any files or directories it may contain. :param ignore_errors: If ``True`` errors are silently ignored, otherwise an exception is raised in case an error occurs. :param onerror: A callback which gets called with the arguments `func`, `path` and `exc_info`. `func` is one of :func:`os.listdir`, :func:`os.remove` or :func:`os.rmdir`. `path` is the argument to the function which caused it to fail and `exc_info` is a tuple as returned by :func:`sys.exc_info`. ) ignore_errorsonerrorN)shutilrmtree)rrrrrrr Zsz path.rmtreecCstj|||ddS)a~ Recursively copy a directory to the given `destination`. If the given `destination` does not exist it will be created. :param symlinks: If ``True`` symbolic links in the source tree result in symbolic links in the destination tree otherwise the contents of the files pointed to by the symbolic links are copied. )symlinksN)rcopytree)r destinationr!rrrr"ms z path.copytreecCst||dS)z Recursively move the file or directory to the given `destination` similar to the Unix "mv" command. If the `destination` is a file it may be overwritten depending on the :func:`os.rename` semantics. N)rmove)rr#rrrmovetreezs z path.movetreecCst|dS)z! Removes a file. N)runlink)rrrrr&sz path.unlinkcCs t|S)z- Returns a stat of the file. )rstat)rrrrr'sz path.statcCst||dS)N)rutime)rargrrrr(sz path.utimercKst||f|S)N)r)rmodekwargsrrrrsz path.openutf-8c KsDt|tr||}t|dfd|i|}||WdQRXdS)z6 Writes the given `text` to the file. wr N)rbytesr rwrite)rtextr r,frrr write_texts  zpath.write_textc Ks6trdnd}t|f||d| }|SQRXdS)z/ Returns the text in the file. ZrUr*)r+r N)rrread)rr r,r+r2rrrr1s z path.textc Cs t|dd }|SQRXdS)z0 Returns the bytes in the file. rb)r+N)rr4)rr2rrrr/sz path.bytesc Cs4|r d}nd}t||d}||WdQRXdS)z Writes the given `bytes` to the file. :param append: If ``True`` given `bytes` are added at the end of the file. Zabwb)r+N)rr0)rr/appendr+r2rrr write_bytess zpath.write_bytescCs tj|S)z5 Returns ``True`` if the path exist. )rrexists)rrrrr9sz path.existscCs tj|S)zb Returns ``True`` if the path exists unless it is a broken symbolic link. )rrlexists)rrrrr:sz path.lexistscCst||dS)z1 Recursively create directories. N)rmakedirs)rr+rrrr<sz path.makedirscGs |tjj|ft|j|S)zP Joins the path with the argument given and returns the result. )rrrjoinmap)rargsrrrjoinpathsz path.joinpathcCs t|S)N)rlistdir)rrrrrAsz path.listdircCsd|jjt|fS)Nz%s(%s))r__name__r__repr__)rrrrrCsz path.__repr__)FN)F)r*)r-)r-)F)r;)$rB __module__ __qualname____doc__rFILESYSTEMENCODINGr propertyrrrrrrrrr r"r%r$r&r'r(rr3r1r/r8r9r:r<r@rAZ__div__ __truediv__rCrrrrrs<        r) rFrrsysiorZsixrrgetfilesystemencodinggetdefaultencodingrGrrrrrs