File: //usr/lib/python3/dist-packages/sphinx/testing/__pycache__/path.cpython-310.pyc
o
$�a� � @ s� d Z ddlZddlZddlZddlZddlZddlmZmZm Z m
Z
ddl m Z e�
� p/e�� Zdefdd�Ze� ZG dd � d e�ZdS )
z�
sphinx.testing.path
~~~~~~~~~~~~~~~~~~~
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�IO�Any�Callable�List)�RemovedInSphinx50Warning�returnc C s t �d�} t �| � | S )zGet current umask valuer )�os�umask)r � r
�5/usr/lib/python3/dist-packages/sphinx/testing/path.py�getumask s
r c s� e Zd ZdZedKdd��Zdefdd�ZdKdd�Zde fd d
�Z
de fd d �Z de fd
d�Z de fdd�Z
de fdd�ZdLde deddfdd�ZdMdede ddfdd �Zdeddfd d �ZeZdNd d �Zdefd!d"�Zd#eddfd$d%�ZdOd'ed(edefd)d*�ZdPd,ed-ed(eddfd.d/�ZdPd-ed(edefd0d1�ZdPd-ed(edefd2d3�Z de j fd4d5�Z de j fd6d7�Z dMd8ed9e ddfd:d;�Z de fd<d=�Z!de fd>d?�Z"dQd'e#dAe ddfdBdC�Z$dDedd fdEdF�Z%de&e fdGdH�Z'e% Z(Z)def� fdIdJ� Z*� Z+S )R�pathz8
Represents a path which behaves like a string.
r c C � | � tj�| ��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 � t j�| �S �N)r r
�basenamer r
r
r r , s z
path.basenamec C r )z,
Returns the absolute path.
)r r r
�abspathr r
r
r r / s z path.abspathc C r )z;
Returns ``True`` if the path is absolute.
)r r
�isabsr r
r
r r 5 � z
path.isabsc C r )z>
Returns ``True`` if the path is a directory.
)r r
�isdirr r
r
r r ; r z
path.isdirc C r )z9
Returns ``True`` if the path is a file.
)r r
�isfiler r
r
r r A r z path.isfilec C r )zB
Returns ``True`` if the path is a symbolic link.
)r r
�islinkr r
r
r r G r z path.islinkc C r )z@
Returns ``True`` if the path is a mount point.
)r r
�ismountr r
r
r r M r z path.ismountFN�
ignore_errors�onerrorc C � 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" S s z path.rmtree� destination�symlinksc C sr t j| ||d� tj�d�r5t�|�D ]#\}}}t�|dt @ � |D ]}t�tj� ||�dt @ � q#qdS 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$ �SPHINX_READONLY_TESTDIRi� i� N)
r! �copytreer �environ�get�walk�chmod�UMASKr
�join)r r# r$ �root�dirs�files�namer
r
r r& e s
��z
path.copytreec C s t �| |� 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 �movetree{ s z
path.movetreec C s t �| � dS )z!
Removes a file.
N)r �unlinkr r
r
r r3 � s z path.unlinkc C �
t �| �S )z-
Returns a stat of the file.
)r �statr r
r
r r5 � s
z path.stat�argc C s t �| |� d S r )r �utime)r r6 r
r
r r7 � s z
path.utime�r�mode�kwargsc K s t | |fi |��S r )�open)r r9 r: r
r
r r; � s z path.open�utf-8�text�encodingc K sF t | dfd|i|���}|�|� W d � dS 1 s w Y dS )z6
Writes the given `text` to the file.
�wr> N�r; �write)r r= r> r: �fr
r
r �
write_text� s "�zpath.write_textc K s" t jdtdd� | j|fi |��S )�/
Returns the text in the file.
z;Path.text() is deprecated. Please use read_text() instead.� ��
stacklevel)�warnings�warnr � read_text)r r> r: r
r
r r= � s �z path.textc K s@ t | fd|i|��� }|�� W d � S 1 sw Y dS )rD r> N�r; �read)r r> r: rB r
r
r rJ � s $�zpath.read_textc C s t jdtdd� | �� S )�0
Returns the bytes in the file.
z=Path.bytes() is deprecated. Please use read_bytes() instead.rE rF )rH rI r �
read_bytesr r
r
r �bytes� s �z
path.bytesc C s8 t | dd�� }|�� W d � S 1 sw Y dS )rM �rb�r9 NrK )r rB r
r
r rN � s $�zpath.read_bytesrO �appendc C sJ |rd}nd}t | |d��}|�|� W d � dS 1 s w Y dS )z�
Writes the given `bytes` to the file.
:param append:
If ``True`` given `bytes` are added at the end of the file.
�ab�wbrQ Nr@ )r rO rR r9 rB r
r
r � write_bytes� s "�zpath.write_bytesc C r )z5
Returns ``True`` if the path exist.
)r r
�existsr r
r
r rV � r z path.existsc C r )zb
Returns ``True`` if the path exists unless it is a broken symbolic
link.
)r r
�lexistsr r
r
r rW � s z path.lexists� �exist_okc C r )z1
Recursively create directories.
)rY N)r �makedirs)r r9 rY r
r
r rZ � s z
path.makedirs�argsc G s" | � tjj| gt| j |��R � �S )zP
Joins the path with the argument given and returns the result.
)r r r
r, �map)r r[ r
r
r �joinpath� s "z
path.joinpathc C r4 r )r �listdirr r
r
r r^ � s
z path.listdirc s d| j jt� �� f S )Nz%s(%s))r �__name__�super�__repr__r �r r
r ra � s z
path.__repr__)r r
)FN)F)r N)r8 )r< )rX F),r_ �
__module__� __qualname__�__doc__�propertyr �strr r �boolr r r r r r r" r& r2 r1 r3 r r5 r7 r r; rC r= rJ �builtinsrO rN rU rV rW �intrZ r] r r^ �__div__� __truediv__ra �
__classcell__r
r
rb r r
s@
r
)re ri r r! �sysrH �typingr r r r �sphinx.deprecationr �getfilesystemencoding�getdefaultencoding�FILESYSTEMENCODINGrj r r+ rg r
r
r
r
r �<module> s