3
T'íc ã @ s d dl Z d dlZd dlZd dlZd dlZd dlmZmZmZm Z d dl
m Z ej pZej
ZedddZe ZG dd deZdS ) é N)ÚIOÚAnyÚCallableÚList)ÚRemovedInSphinx50Warning)Úreturnc C s t jd} t j| | S )zGet current umask valuer )ÚosÚumask)r © r
ú5/tmp/pip-build-gk9425m9/sphinx/sphinx/testing/path.pyÚgetumask
s
r c sâ e Zd ZdZed dddZedddZd dddZe dd d
Z
e dd d Z e dd
dZ e dddZ
e dddZdHe eddddZdIee ddddZeddd d ZeZddd d Zedd d!Zedd"d#d$ZdJeeed&d'd(ZdKeeedd*d+d,ZdLeeed-d.d/ZdMeeed-d0d1Z e j dd2d3Z e j dd4d5Z dNee dd6d7d8Z e dd9d:Z!e dd;d<Z"dOe#e dd>d?d@Z$ed dAdBdCZ%e&e ddDdEZ'e% Z(Z)ed fdFdG Z* Z+S )PÚpathz8
Represents a path which behaves like a string.
)r c C s | j tjj| S )zH
The name of the directory the file or directory is in.
)Ú __class__r r
Údirname)Úselfr
r
r Úparent s z path.parentc C s t jj| S )N)r r
Úbasename)r r
r
r r $ s z
path.basenamec C s | j tjj| S )z,
Returns the absolute path.
)r r r
Úabspath)r r
r
r r ' s z path.abspathc C s t jj| S )z;
Returns ``True`` if the path is absolute.
)r r
Úisabs)r r
r
r r - s z
path.isabsc C s t jj| S )z>
Returns ``True`` if the path is a directory.
)r r
Úisdir)r r
r
r r 3 s z
path.isdirc C s t jj| S )z9
Returns ``True`` if the path is a file.
)r r
Úisfile)r r
r
r r 9 s z path.isfilec C s t jj| S )zB
Returns ``True`` if the path is a symbolic link.
)r r
Úislink)r r
r
r r ? s z path.islinkc C s t jj| S )z@
Returns ``True`` if the path is a mount point.
)r r
Úismount)r r
r
r r E s z path.ismountFN)Ú
ignore_errorsÚonerrorr c C s t j| ||d dS )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`.
)r r N)ÚshutilÚrmtree)r r r r
r
r r K s z path.rmtree)Ú destinationÚsymlinksr c C sv t j| ||d tjjdrrxTtj|D ]F\}}}tj|dt @ x(|D ] }tjtjj ||dt @ qJW q(W dS )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.
)r ZSPHINX_READONLY_TESTDIRií i¤ N)
r Úcopytreer ÚenvironÚgetÚwalkÚchmodÚUMASKr
Újoin)r r r ÚrootZ_dirsÚfilesÚnamer
r
r r ] s
z
path.copytree)r r c C s t j| | 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)r Úmove)r r r
r
r Úmovetrees s z
path.movetreec C s t j| dS )z!
Removes a file.
N)r Úunlink)r r
r
r r+ s z path.unlinkc C s
t j| S )z-
Returns a stat of the file.
)r Ústat)r r
r
r r,
s z path.stat)Úargr c C s t j| | d S )N)r Úutime)r r- r
r
r r. s z
path.utimeÚr)ÚmodeÚkwargsr c K s t | |f|S )N)Úopen)r r0 r1 r
r
r r2 s z path.openúutf-8)ÚtextÚencodingr1 r c K s0 t | dfd|i|}|j| W dQ R X dS )z6
Writes the given `text` to the file.
Úwr5 N)r2 Úwrite)r r4 r5 r1 Úfr
r
r Ú
write_text s zpath.write_text)r5 r1 r c K s t jdtdd | j|f|S )z/
Returns the text in the file.
z;Path.text() is deprecated. Please use read_text() instead.é )Ú
stacklevel)ÚwarningsÚwarnr Ú read_text)r r5 r1 r
r
r r4 s
z path.textc K s( t | fd|i|
}|j S Q R X dS )z/
Returns the text in the file.
r5 N)r2 Úread)r r5 r1 r8 r
r
r r> s zpath.read_textc C s t jdtdd | j S )z0
Returns the bytes in the file.
z=Path.bytes() is deprecated. Please use read_bytes() instead.r: )r; )r< r= r Ú
read_bytes)r r
r
r Úbytes§ s
z
path.bytesc C s t | dd
}|j S Q R X dS )z0
Returns the bytes in the file.
Úrb)r0 N)r2 r? )r r8 r
r
r r@ ¯ s zpath.read_bytes)rA Úappendr c C s4 |r
d}nd}t | |d}|j| W dQ R X dS )z
Writes the given `bytes` to the file.
:param append:
If ``True`` given `bytes` are added at the end of the file.
ÚabÚwb)r0 N)r2 r7 )r rA rC r0 r8 r
r
r Ú write_bytes¶ s
zpath.write_bytesc C s t jj| S )z5
Returns ``True`` if the path exist.
)r r
Úexists)r r
r
r rG Ä s z path.existsc C s t jj| S )zb
Returns ``True`` if the path exists unless it is a broken symbolic
link.
)r r
Úlexists)r r
r
r rH Ê s z path.lexistséÿ )r0 Úexist_okr c C s t j| ||d dS )z1
Recursively create directories.
)rJ N)r Úmakedirs)r r0 rJ r
r
r rK Ñ s z
path.makedirs)Úargsr c G s | j tjj| ft| j | S )zP
Joins the path with the argument given and returns the result.
)r r r
r% Úmap)r rL r
r
r Újoinpath× s z
path.joinpathc C s
t j| S )N)r Úlistdir)r r
r
r rO Ý s z path.listdirc s d| j jt j f S )Nz%s(%s))r Ú__name__ÚsuperÚ__repr__)r )r r
r rR â s z
path.__repr__)FN)F)r/ )r3 )r3 )r3 )F)rI F),rP Ú
__module__Ú __qualname__Ú__doc__Úpropertyr Ústrr r Úboolr r r r r r r r r* r) r+ r r, r. r r2 r9 r4 r> ÚbuiltinsrA r@ rF rG rH ÚintrK rN r rO Z__div__Ú __truediv__rR Ú
__classcell__r
r
)r r r
s>
r
)rY r r Úsysr< Útypingr r r r Zsphinx.deprecationr ÚgetfilesystemencodingÚgetdefaultencodingZFILESYSTEMENCODINGrZ r r$ rW r
r
r
r
r Ú<module> s