$72 GRAYBYTE WORDPRESS FILE MANAGER $84

a

XC?h&��@sndZd
dl
Z
d
dlZd
dlZd
dlZd
dlZd
dlZzd
dlZ[dZWne	y\


dZYn0zd
dl
Z
[
dZWne	y�


dZYn0zd
dlZ[dZ
Wne	y�


dZ
Yn0zd
dlmZ
Wne	y�


dZYn0zd
dlmZ
Wne	�
y


dZYn0e
jdkZdZZe
jdk�
r,d
dlZne�
r:d
dlZe�
rDd	nd
Zee
d��
o^ej�d�
ae�
oneed
�ZdZgd�
ZGdd�de�ZGdd�de�Z Gdd�de�Z!Gdd�de�Z"Gdd�de�Z#Gdd�de$�Z%Gdd�de$�Z&dd�Z'd d!�Z(ef
d"d#�
Z)d�d$d%�
Z*d&d'�Z+d(d)�Z,d*d+�Z-dd,�
d-d.�Z.dd,�
d/d0�Z/ee
d1��rbdd,�
d2d3�Z0nd4d3�Z0dd,�
d5d6�Z1dd,�
d7d8�Z2dd,�
d9d:�Z3d;d<�Z4d�d=d>�
Z5dde3ddfd?d@�
Z6ee
j7dA��r�dBdC�Z8dDdE�Z9ndFdC�Z8dGdE�Z9dHdI�Z:dJdK�Z;e
j<e
je
j=e
j>he
j?k
�o.e
j@e
jAv�o.e
je
jBvZCd�dLdM�
ZDeCeD_EdNdO�ZFe3f
dPdQ�
ZGdRdS�ZHdTdU�ZIdVdW�ZJdXdY�ZKd�d[d\�
ZLd�d]d^�
ZMd_eLd`g
dafi
ZNe�r�eLdbg
dcfeNdd<eMgdefeNdf<e�r�eLdgg
dhfeNdi<e
�r�eLdjg
dkfeNdl<dmdn�ZOd�dpdq�
ZPdrds�ZQd�dtdu�
ZRdvdw�ZSdxdy�ZTd�dzd{�
ZUd|d}�ZVd~d�ZWd�d��ZXdd��
d�d��ZYd�g
eYgdafd�g
eXgdefd��ZZe�r�d�d�geYgdcfeZdd<e�r�d�d�geYgdhfeZdi<e
�r�d�d�geYgdkfeZdl<d�d��Z[d�dd��
d�d��Z\ee
d���re�]d��

e�^d�d��Z_d�e_j`_d�e_ja_d�e_jb_d�d��Zcn$e�r8e�]d��

e�^d�d��Z_d�d��Zcd�d�d��
Zdd�d�d��
Zed�d��Zfe
jge
jhBdfd�d��
ZidS)�z�Utility functions for copying and archiving files and directory trees.

XXX The functions here don't copy the resource fork or other metadata on Mac.

�NTF)
�getpwnam)
�getgrnam�nt�posixii
�sendfileZlinux�
_fcopyfilez%.COM;.EXE;.BAT;.CMD;.VBS;.JS;.WS;.MSC)�copyfileobj�copyfile�copymode�copystat�copy�copy2�copytree�move�rmtree�Error�SpecialFileError�	ExecError�make_archive�get_archive_formats�register_archive_format�unregister_archive_format�get_unpack_formats�register_unpack_format�unregister_unpack_format�unpack_archive�ignore_patterns�chown�which�get_terminal_size�
SameFileErrorc
@seZ
dZd
S)rN)�__name__�
__module__�__qualname__�r$r$�+/opt/alt/python39/lib64/python3.9/shutil.pyrEs
rc
@seZ
dZd
ZdS)r z5Raised when source and destination are the same file.N�r!r"r#�__doc__r$r$r$r%r Hs
r c
@seZ
dZd
ZdS)rz|Raised when trying to do a kind of operation (e.g. copying) which is
    not supported on a special file (e.g. a named pipe)Nr&r$r$r$r%rKs
rc
@seZ
dZd
ZdS)rz+Raised when a command could not be executedNr&r$r$r$r%rOs
rc
@seZ
dZd
ZdS)�	ReadErrorz%Raised when an archive cannot be readNr&r$r$r$r%r(Rs
r(c
@seZ
dZd
ZdS)�
RegistryErrorzVRaised when a registry operation with the archiving
    and unpacking registries failsNr&r$r$r$r%r)Us
r)c
@seZ
dZd
ZdS)�_GiveupOnFastCopyzuRaised as a signal to fallback on using raw read()/write()
    file copy when fast-copy functions fail to do so.
    Nr&r$r$r$r%r*Ys
r*c
Cs�z|��}|
��}Wn,t
y@
}
zt|�
�
WYd
}~n
d
}~00zt�|||�
WnVty�
}
z>|j|_|
j|_|j	t	j
t	jhvr�t|�
�
n|d
�WYd
}~n
d
}~00d
S)zhCopy a regular file content or metadata by using high-performance
    fcopyfile(3) syscall (macOS).
    N)�fileno�	Exceptionr*rr�OSError�name�filename�	filename2�errno�EINVAL�ENOTSUP)�fsrc�fdst�flags�infd�outfd�errr$r$r%�_fastcopy_fcopyfile^s










r:c
CsF
z|��}|
��}Wn,t
y@
}
zt|�
�
WYd
}~n
d
}~00ztt�|�
jd�}Wntyn


d}Yn0tj	dkr�t
|d�}d}zt�||||�}Wn�t�
y(
}
zr|j|_
|
j|_|jtjkr�dat|�
�
|jtjkr�|d
�|dk�
rt�|dtj�dk�
rt|�
�
|�
WYd
}~q�d
}~00|dk�
r8�
qB||7}q�d
S)z�Copy data from one regular mmap-like fd to another by using
    high-performance sendfile(2) syscall.
    This should work on Linux >= 2.6.33 only.
    Ni�ili@r
F)r+r,r*�max�os�fstat�st_sizer-�sys�maxsize�minrr.r/r0r1ZENOTSOCK�_USE_CP_SENDFILEZENOSPC�lseek�SEEK_CUR)r4r5r7r8r9Z	blocksize�offsetZsentr$r$r%�_fastcopy_sendfilers8















 



rFc	Cs�|j}|
j
}tt|�
�
�j}||�
}|s*qtq||krj|d
|��}|
�
|�

Wd
�
qr1s^0


Y
q||�

qWd
�
n1s�0


Y
d
S)z�readinto()/memoryview() based variant of copyfileobj().
    *fsrc* must support readinto() method and both files must be
    open in binary mode.
    N)�readinto�write�
memoryview�	bytearray)r4r5�lengthZ
fsrc_readinto�
fdst_writeZmv�
nZsmvr$r$r%�_copyfileobj_readinto�s






*rNcCs0|st}|j
}|
j}||�
}|s"q,||�

qd
S)z=copy data from file-like object fsrc to file-like object fdstN)�COPY_BUFSIZE�readrH)r4r5rKZ	fsrc_readrLZbufr$r$r%r�s





rcCs�t|t
j�rHtt
jd
�rHzt
j�|��t
�|
�
�WStyF


YdS0tt
jd�rzzt
j�||
�WStyx


YdS0t
j�	t
j�
|�
�
t
j�	t
j�
|
�
�
kS)N�samestatF�samefile)�
isinstancer<�DirEntry�hasattr�pathrQ�statr-rR�normcase�abspath��src�dstr$r$r%�	_samefile�s








�r]c

Cst|t
j�r|��St
�|�
S�
N)rSr<rTrW�
�fnr$r$r%�_stat�s
rac

Cs t|t
j�r|��St
j�|�
Sr^)rSr<rT�
is_symlinkrV�islinkr_r$r$r%�_islink�s
rd�
�follow_symlinksc

Cs^t�
d
||
�
t||
�r(td�||
��
�
d}t||
g�
D]h\}}zt|�
}Wnty^


Yq80t�	|j
�
r�t|tj
�r~|jn|}td|�
�
tr8|dkr8|j}q8|s�t|�
r�t�t�|�
|
�
�
n�t|d��
�x}�
zt|
d����}t�
r4z2t||tj�
|
WWd�
WWd�
St�
y0


Yn0n�t�
r�z.t||�
|
WWd�
WWd�
St�
y|


Yn0nDt�
r�|dk�
r�t||t|t��
|
Wd�
WWd�
St ||�
Wd�
n1�
s�0


Y
WnHt!�y8
}	
z.tj�"|
�
�s"t#d|
���
|	�n�WYd}	~	n
d}	~	00Wd�
n1�sP0


Y
|
S)	z�Copy data from src to dst in the most efficient way possible.

    If follow_symlinks is not set and src is a symbolic link, a new
    symlink will be created instead of copying the file it points to.

    zshutil.copyfilez{!r} and {!r} are the same filer
z`%s` is a named pipe�rb�wbNzDirectory does not exist: )$r?�auditr]r �format�	enumeraterar-rW�S_ISFIFO�st_moderSr<rTrVr�_WINDOWSr>rd�symlink�readlink�open�_HAS_FCOPYFILEr:rZ_COPYFILE_DATAr*rBrFrNrArOr�IsADirectoryError�exists�FileNotFoundError)
r[r\rf�	file_size�
ir`�str4r5�
er$r$r%r	�sP















$





$



".

8r	c
Cspt�
d
||
�
|sFt|�
rFtj�|
�
rFttd�r@tjtj}}qRdSnt	tj
}}||�
}||
t�|j
�
�
dS)z�Copy mode bits from src to dst.

    If follow_symlinks is not set, symlinks aren't followed if and only
    if both `src` and `dst` are symlinks.  If `lchmod` isn't available
    (e.g. Linux) this method does nothing.

    zshutil.copymode�lchmodN)r?rirdr<rVrcrU�lstatrzra�chmodrW�S_IMODErm)r[r\rfZ	stat_funcZ
chmod_funcrxr$r$r%r
*
s



r
�	listxattrc
Cs�ztj
||d
�}Wn>tyP
}
z&|jtjtjtjfv
r:�WYd}~dSd}~00|D]l}z&tj|||d
�}tj|
|||d
�
WqVty�
}
z(|jtj	tjtjtjfv
r��WYd}~qVd}~00qVdS)z�Copy extended filesystem attributes from `src` to `dst`.

        Overwrite existing attributes.

        If `follow_symlinks` is false, symlinks won't be followed.

        reN)
r<r~r-r1r3ZENODATAr2�getxattr�setxattrZEPERM)r[r\rf�namesryr.�valuer$r$r%�
_copyxattr@
s	











�r�c
OsdSr^r$)�args�kwargsr$r$r%r�X
s
c
	
s`
t�
d
||
�
ddd�dd��|p6t|�
o4tj�|
�
}|rJ�f
dd�}n�f
dd�}t|tj�rp|j|d	�
}n|d
�
||d	�}t�	|j
�
}|d�
|
|j|jf|d�
t
||
|d	�
z|d�
|
||d	�
Wnty�


Yn0t|d
��
r\z|d�
|
|j|d	�
WnXt�
yZ
}
z>dD]*}tt|��
r|jtt|�k�
r
�
qF�
q�WYd}~n
d}~00dS)a�
Copy file metadata

    Copy the permission bits, last access time, last modification time, and
    flags from `src` to `dst`. On Linux, copystat() also copies the "extended
    attributes" where possible. The file contents, owner, and group are
    unaffected. `src` and `dst` are path-like objects or path names given as
    strings.

    If the optional flag `follow_symlinks` is not set, symlinks aren't
    followed if and only if both `src` and `dst` are symlinks.
    zshutil.copystatN)�nsrfc
WsdSr^r$)r�rfr�r$r$r%�_nopi
s
zcopystat.<locals>._nopc

stt
|��Sr^)�getattrr<�
r.�
r�r$r%�lookupp
s
zcopystat.<locals>.lookupc
stt
|��}
|
t
jvr|
S�Sr^)r�r<�supports_follow_symlinks)r.r`r�r$r%r�u
s




rerW�utimer|�st_flagsZchflags)Z
EOPNOTSUPPr3)r?rirdr<rVrcrSrTrWr}rm�st_atime_ns�st_mtime_nsr��NotImplementedErrorrUr�r-r1r�)	r[r\rfZfollowr�rx�mode�whyr9r$r�r%r[
s4




�










rc
CsBtj
�|
�
r"tj
�|
tj
�|�
�}
t||
|d
�
t||
|d
�
|
S)a3
Copy data and mode bits ("cp src dst"). Return the file's destination.

    The destination may be a directory.

    If follow_symlinks is false, symlinks won't be followed. This
    resembles GNU's "cp -P src dst".

    If source and destination are the same file, a SameFileError will be
    raised.

    re)r<rV�isdir�join�basenamer	r
�r[r\rfr$r$r%r�
s




rc
CsBtj
�|
�
r"tj
�|
tj
�|�
�}
t||
|d
�
t||
|d
�
|
S)a0
Copy data and metadata. Return the file's destination.

    Metadata is copied with copystat(). Please see the copystat function
    for more information.

    The destination may be a directory.

    If follow_symlinks is false, symlinks won't be followed. This
    resembles GNU's "cp -P src dst".
    re)r<rVr�r�r�r	rr�r$r$r%r
�
s




r
cs�f
d
d�}
|
S)z�Function that can be used as copytree() ignore parameter.

    Patterns is a sequence of glob-style patterns
    that are used to exclude filescs(g}�D]}|�t
�|
|��

qt|�
Sr^)�extend�fnmatch�filter�set)rVr��
ignored_names�pattern�
�patternsr$r%�_ignore_patterns�
s



z)ignore_patterns.<locals>._ignore_patternsr$)r�r�r$r�r%r�
srcCsD|du
r$|t�
|
�
d
d�|D�
�}nt�}tj||d�
g}	|tupJ|tu}
|D�
]�}|j|vrbqPtj�|
|j�}tj�||j�}
|
r�|n|}z�|�	�}|r�tjdkr�|j
dd�
}|jt
jkr�d}|�
r8t�
|�
}|r�t�||
�
t||
|d�
nBtj�|�
�
s|�
rWqP|���
r,t||
||||d�
n
|||
�
n*|���
rXt||
||||d�
n
|||
�
WqPt�
y�
}
z|	�|jd�

WYd}~qPd}~0t�
y�
}
z |	�||
t|�
f�

WYd}~qPd}~00qPzt|
|�
WnLt�y0
}
z2t|d	d�du�r|	�|
|t|�
f�

WYd}~n
d}~00|	�r@t|	�
�
|S)
Nc
Ssg|]
}
|
j�qSr$r�)�.0�
xr$r$r%�
<listcomp>�
�z_copytree.<locals>.<listcomp>)
�exist_okrFre)
�
dirs_exist_okr
Zwinerror)r<�fspathr��makedirsr
rr.rVr�rbrW�st_reparse_tag�IO_REPARSE_TAG_MOUNT_POINTrprorrt�is_dirrrr�r�r-�append�strr�)�entriesr[r\�symlinks�ignore�
copy_function�ignore_dangling_symlinksr�r��errorsZuse_srcentryZsrcentryZsrcnameZdstnameZsrcobjrbr{�linktor9r�r$r$r%�	_copytree�
s^
























�



�
$

,



*


r�c	
CsXt�
d
||
�
t�|�
�}t|�
}Wd�
n1s60


Y
t|||
|||||d�S)a'Recursively copy a directory tree and return the destination directory.

    If exception(s) occur, an Error is raised with a list of reasons.

    If the optional symlinks flag is true, symbolic links in the
    source tree result in symbolic links in the destination tree; if
    it is false, the contents of the files pointed to by symbolic
    links are copied. If the file pointed by the symlink doesn't
    exist, an exception will be added in the list of errors raised in
    an Error exception at the end of the copy process.

    You can set the optional ignore_dangling_symlinks flag to true if you
    want to silence this exception. Notice that this has no effect on
    platforms that don't support os.symlink.

    The optional ignore argument is a callable. If given, it
    is called with the `src` parameter, which is the directory
    being visited by copytree(), and `names` which is the list of
    `src` contents, as returned by os.listdir():

        callable(src, names) -> ignored_names

    Since copytree() is called recursively, the callable will be
    called once for each directory that is copied. It returns a
    list of names relative to the `src` directory that should
    not be copied.

    The optional copy_function argument is a callable that will be used
    to copy each file. It will be called with the source path and the
    destination path as arguments. By default, copy2() is used, but any
    function that supports the same signature (like copy()) can be used.

    If dirs_exist_ok is false (the default) and `dst` already exists, a
    `FileExistsError` is raised. If `dirs_exist_ok` is true, the copying
    operation will continue if it encounters existing directories, and files
    within the `dst` tree will be overwritten by corresponding files from the
    `src` tree.
    zshutil.copytreeN)r�r[r\r�r�r�r�r�)r?rir<�scandir�listr�)	r[r\r�r�r�r�r�Zitrr�r$r$r%r
s(

&




�r�st_file_attributesc
CsNz4|jd
d�
}
t�
|
j�
o2|
jtj@o0|
jtjkWStyH


Yd
S0dS�NFre)rW�S_ISDIRrmr��FILE_ATTRIBUTE_REPARSE_POINTr�r�r-)�entryrxr$r$r%�
_rmtree_isdirAs





�
r�c
CsJz0t�
|�
}
t�|
j�
p.|
jtj@o.|
jtjkWSt	yD


Yd
S0dS)NF)
r<r{rW�S_ISLNKrmr�r�r�r�r-)rVrxr$r$r%�_rmtree_islinkJs






�
r�c

Cs(z|jd
d�
WSt
y"


Yd
S0dSr�)r�r-)
r�r$r$r%r�Ss



c

Cstj
�|�
Sr^)r<rVrc)
rVr$r$r%r�Ys
c	Cs2
z6t�
|�
�}t|�
}Wd�
n1s*0


Y
Wn(ty^


|
tj
|t���
g}Yn0|D]�}|j}t|�
r�z|��r�td
�
�
Wn*ty�


|
tjj	|t���
YqdYn0t
||
�
qdzt�|�

Wqdty�


|
tj|t���
Yqd0qdzt�|�

Wn&t�
y,


|
tj|t���
Yn0dS)N�%Cannot call rmtree on a symbolic link)
r<r�r�r-r?�exc_inforVr�rbrc�_rmtree_unsafe�unlink�rmdir)rV�onerror�
scandir_itr�r��fullnamer$r$r%r�]s0


*




















r�c
Cs`z6t�
|�
�}t|�
}Wd�
n1s*0


Y
Wn>tyt
}
z&|
|_|tj
|
t���
WYd}~dSd}~00|D�
]�}tj�|
|j	�}z|j
d
d�
}Wnty�


d
}YnP0|�
rz|jd
d�
}	t�|	j
�
}Wn*t�
y


|tj|t���
YqzYn0|�rztj|j	tj|d�}
d
}Wn&t�
yN


|tj|t���
Yn�0z�tj�|	t�|
�
��
r�t|
||�
z"t�|
�

d}tj|j	|d�
Wn&t�
y�


|tj|t���
Yn0n6ztd�
�
Wn(t�
y�


|tjj|t���
Yn0W|�st�|
�

n|�st�|
�

0qzztj|j	|d�
Wqzt�yX


|tj|t���
Yqz0qzdS)NFre)
�dir_fdTr�)r<r�r�r-r/r?r�rVr�r.r�rWr�rmr{rq�O_RDONLYrQr=�_rmtree_safe_fd�closer�rcr�)�topfdrVr�r�r�r9r�r�r��orig_st�dirfdZdirfd_closedr$r$r%r�|s^


*



































�



r�c	Cs�
t�
d
|�
|
rdd�}n|dur*dd�}t�
r�t|t�rDt�|�
}zt�|�
}Wn&tyx


|tj|t�	��
YdS0zt�
|tj�}d}Wn&ty�


|tj
|t�	��
YdS0z�tj�
|t�|�
��
r"t|||�
zt�|�

d}t�|�

Wn&t�
y


|tj|t�	��
Yn0n6ztd�
�
Wn(t�
yV


|tjj|t�	��
Yn0W|�
s~t�|�

n|�
s|t�|�

0nLzt|�
�
r�td�
�
Wn*t�
y�


|tjj|t�	��
YdS0t||�SdS)	a�
Recursively delete a directory tree.

    If ignore_errors is set, errors are ignored; otherwise, if onerror
    is set, it is called to handle the error with arguments (func,
    path, exc_info) where func is platform and implementation dependent;
    path is the argument to that function that caused it to fail; and
    exc_info is a tuple returned by sys.exc_info().  If ignore_errors
    is false and onerror is None, an exception is raised.

    z
shutil.rmtreec

WsdSr^r$�
r�r$r$r%r��s
zrmtree.<locals>.onerrorNc
Ws�dSr^r$r�r$r$r%r��s
FTr�)r?ri�_use_fd_functionsrS�bytesr<�fsdecoder{r,r�rqr�rVrQr=r�r�r�r-rcr�r�)rV�
ignore_errorsr�r��fdZ	fd_closedr$r$r%r�sV





























�





rc
Cs0t�
|�
}tjjtjjpd
}
tj�|�|
�
�
S)aH
A basename() variant which first strips the trailing slash, if present.
    Thus we always get the last component of the path, even for directories.

    path: Union[PathLike, str]

    e.g.
    >>> os.path.basename('/bar/foo')
    'foo'
    >>> os.path.basename('/bar/foo/')
    ''
    >>> _basename('/bar/foo/')
    'foo'
    �)r<r�rV�sep�altsepr��rstrip)rVr�r$r$r%�	_basename�s


r�c	CsR
t�
d
||
�
|
}tj�|
�
rbt||
�r8t�||
�
dStj�|
t|�
�}tj�	|�
rbt
d|�
�
zt�||�
Wn�t�
yL


tj�|�
r�t�
|�
}t�||�
t�|�

n�tj�|�
�
r4t||
�r�t
d||
f�
�
t|�
�
s
t�|tj��
st�|�
�
rtjdk�
rtd||f�
�
t|||dd�
t|�

n|||�
t�|�

Yn0|S)	a+Recursively move a file or directory to another location. This is
    similar to the Unix "mv" command. Return the file or directory's
    destination.

    If the destination is a directory or a symlink to a directory, the source
    is moved inside the directory. The destination path must not already
    exist.

    If the destination already exists but is not a directory, it may be
    overwritten depending on os.rename() semantics.

    If the destination is on our current filesystem, then rename() is used.
    Otherwise, src is copied to the destination and then removed. Symlinks are
    recreated under the new name if os.rename() fails because of cross
    filesystem renames.

    The optional `copy_function` argument is a callable that will be used
    to copy the source or it will be delegated to `copytree`.
    By default, copy2() is used, but any function that supports the same
    signature (like copy()) can be used.

    A lot more could be done here...  A look at a mv.c shows a lot of
    the issues this implementation glosses over.

    zshutil.moveNz$Destination path '%s' already existsz.Cannot move a directory '%s' into itself '%s'.�darwinzKCannot move the non-empty directory '%s': Lacking write permission to '%s'.T)r�r�)r?rir<rVr�r]�renamer�r�rtrr-rcrpror��
_destinsrc�
_is_immutable�access�W_OK�listdir�platform�PermissionErrorrr)r[r\r�Zreal_dstr�r$r$r%rsL


















�

�
���
�



rcCsVtj
�|�
}tj
�|
�
}
|�tj
j�
s2|tj
j7}|
�tj
j�
sL|
tj
j7}
|
�|�
Sr^)r<rVrY�endswithr��
startswithrZr$r$r%r�Qs






r�c
Cs(t|�
}
t
jt
jg}t|
d
�o&|
j|vS)Nr�)rarW�UF_IMMUTABLE�SF_IMMUTABLErUr�)r[rxZimmutable_statesr$r$r%r�Zs


r�c
CsLtd
us|d
urd
Szt|�
}
Wnt
y6


d
}
Yn0|
d
u
rH|
dSd
S)z"Returns a gid, given a group name.N�)r�KeyError�r.�resultr$r$r%�_get_gid_s








r�c
CsLtd
us|d
urd
Szt|�
}
Wnt
y6


d
}
Yn0|
d
u
rH|
dSd
S)z"Returns an uid, given a user name.Nr�)rr�r�r$r$r%�_get_uidks








r��gzipcs(
|d
urd}nDtr |dkr d}n2t
r2|dkr2d}n trD|dkrDd}ntd�|�
�
�
d	d
l}	|rfd
|nd}
|d|
}tj�|�
}|r�tj�	|�
s�|d
u
r�|�
d|�
|s�t�|�

|d
u
r�|�
d
�

t��
�t
�
�
���
��fdd�}
|�
s$|	�|d|�}z|j|
|
d�
W|��
n
|��
0|S)a�
Create a (possibly compressed) tar file from all the files under
    'base_dir'.

    'compress' must be "gzip" (the default), "bzip2", "xz", or None.

    'owner' and 'group' can be used to define an owner and a group for the
    archive that is being built. If not provided, the current owner and group
    will be used.

    The output tar file will be named 'base_name' +  ".tar", possibly plus
    the appropriate compression extension (".gz", ".bz2", or ".xz").

    Returns the output filename.
    Nr�r�Zgz�bzip2�bz2�xzzCbad value for 'compress', or compression format not supported : {0}r
�
.�.tar�creating %szCreating tar archivec

s,�du
r�|_�
|_
�du
r(�|_�|_|Sr^)�gidZgname�uid�uname)
Ztarinfo�r��group�ownerr�r$r%�_set_uid_gid�s






z#_make_tarball.<locals>._set_uid_gidzw|%s�
r�)�_ZLIB_SUPPORTED�_BZ2_SUPPORTED�_LZMA_SUPPORTED�
ValueErrorrj�tarfiler<rV�dirnamert�infor�r�r�rq�addr�)�	base_name�base_dir�compress�verbose�dry_runr�r��loggerZtar_compressionr
Zcompress_extZarchive_name�archive_dirr��tarr$r�r%�
_make_tarballws>







�









	


r
c	Cs�
d
dl}|d}t
j�|�
}|rNt
j�|�
sN|du
r@|�d|�
|sNt
�|�

|du
rd|�d||
�
|�
s�|j|d|jd���}t
j�	|
�
}	|	t
j
kr�|�|	|	�
|du
r�|�d|	�
t
�|
�
D]�\}
}}t
|�
D]:}
t
j�	t
j�|
|
��
}	|�|	|	�
|du
r�|�d|	�
q�|D]L}
t
j�	t
j�|
|
��
}	t
j�|	�
�
r|�|	|	�
|du
�
r|�d|	�
�
qq�Wd�
n1�
sv0


Y
|S)	z�Create a zip file from all the files under 'base_dir'.

    The output zip file will be named 'base_name' + ".zip".  Returns the
    name of the output zip file.
    r
N�.zipr�z#creating '%s' and adding '%s' to it�
w)
Zcompressionzadding '%s')�zipfiler<rVr

rtr
r��ZipFileZZIP_DEFLATED�normpath�curdirrH�walk�sortedr��isfile)r
r
r
r
r	
r
Zzip_filenamer

ZzfrV�dirpathZdirnames�	filenamesr.r$r$r%�
_make_zipfile�sF







�

�



















2r
r
)r
Nzuncompressed tar file)r
r�zgzip'ed tar-fileZgztarzZIP file�zip)r
r�zbzip2'ed tar-fileZbztar)r
r�zxz'ed tar-fileZxztarc
Csd
d�t�
�D�
}|��
|S)z�Returns a list of supported formats for archiving and unarchiving.

    Each element of the returned sequence is a tuple (name, description)
    c
Ssg|]\}
}|
|df�qS)
r�r$)r�r.�registryr$r$r%r��r�z'get_archive_formats.<locals>.<listcomp>)�_ARCHIVE_FORMATS�items�sort�
Zformatsr$r$r%r�s

�
rr�cCst|d
urg}t|
�
s t
d|
�
�
t|ttf�s6t
d�
�
|D]&}t|ttf�rXt|�
dkr:t
d�
�
q:|
||ft|<d
S)au
Registers an archive format.

    name is the name of the format. function is the callable that will be
    used to create archives. If provided, extra_args is a sequence of
    (name, value) tuples that will be passed as arguments to the callable.
    description can be provided to describe the format, and will be returned
    by the get_archive_formats() function.
    NzThe %s object is not callablez!extra_args needs to be a sequencer�z+extra_args elements are : (arg_name, value))�callable�	TypeErrorrS�tupler��lenr
)r.�function�
extra_args�descriptionZelementr$r$r%r�s	








rc

Cs
t|=dSr^)
r
r�r$r$r%rs
rc	
CsB
t�
d
||
||�
t��}	|du
rP|du
r6|�d|�
tj�|�
}|sPt�|�

|dur^tj}||d�}
zt	|
}Wn t
y�


td|
�
d�Yn0|d}|dD]\}
}||
|
<q�|
dkr�||
d	<||
d
<z@|||fi|
�
�
}W|du
�
r>|du
�
r|�d|	�
t�|	�

n,|du
�
r<|du
�
r2|�d|	�
t�|	�

0|S)aCreate an archive file (eg. zip or tar).

    'base_name' is the name of the file to create, minus any format-specific
    extension; 'format' is the archive format: one of "zip", "tar", "gztar",
    "bztar", or "xztar".  Or any other registered format.

    'root_dir' is a directory that will be the root directory of the
    archive; ie. we typically chdir into 'root_dir' before creating the
    archive.  'base_dir' is the directory where we start archiving from;
    ie. 'base_dir' will be the common prefix of all files and
    directories in the archive.  'root_dir' and 'base_dir' both default
    to the current directory.  Returns the name of the archive file.

    'owner' and 'group' are used when creating a tar archive. By default,
    uses the current owner and group.
    zshutil.make_archiveNzchanging into '%s')r
r	
zunknown archive format '%s'r
�
r
r�r�zchanging back to '%s')r?rir<�getcwd�debugrVrY�chdirr
r
r�r�)r
rjZroot_dirr
r
r
r�r�r	
Zsave_cwdr��format_info�func�arg�valr/r$r$r%rs@























�




rc
Csd
d�t�
�D�
}|��
|S)z�Returns a list of supported formats for unpacking.

    Each element of the returned sequence is a tuple
    (name, extensions, description)
    c
Ss"g|]\}
}|
|d|d
f�qS)r
�r$)r�r.r
r$r$r%r�Ur�z&get_unpack_formats.<locals>.<listcomp>)�_UNPACK_FORMATSr
r
r
r$r$r%rOs

�
rc	Csji}t�
�D]\}}|d
D]}|||<qq|D]$}||vr0d}t||||f�
�
q0t|
�
sftd�
�
dS)z+Checks what gets registered as an unpacker.r
z!%s is already registered for "%s"z*The registered function must be a callableN)r/
r
r)r
r 
)	�
extensionsr#
r$
Zexisting_extensionsr.r
�ext�	extension�msgr$r$r%�_check_unpack_optionsZs






�

r4
cCs,|d
urg}t|
||�
|
|||ft
|<d
S)aMRegisters an unpack format.

    `name` is the name of the format. `extensions` is a list of extensions
    corresponding to the format.

    `function` is the callable that will be
    used to unpack archives. The callable will receive archives to unpack.
    If it's unable to handle an archive, it needs to raise a ReadError
    exception.

    If provided, `extra_args` is a sequence of
    (name, value) tuples that will be passed as arguments to the callable.
    description can be provided to describe the format, and will be returned
    by the get_unpack_formats() function.
    N)r4
r/
)r.r0
r#
r$
r%
r$r$r%rls


rc

Cs
t|=d
S)z*Removes the pack format from the registry.N)
r/
r�r$r$r%r�src
Cs&tj
�|�
}
tj
�|
�
s"t�|
�

d
S)z1Ensure that the parent directory of `path` existsN)r<rVr

r�r�)rVr

r$r$r%�_ensure_directory�s

r5
c	
Cs�d
dl}|�
|�
std|�
�
|�|�
}z�|��D]�}|j}|�d�
s2d|vrPq2tjj	|
g
|�
d�
�
R�}|spq2t|�

|�d�
s2|�
|d��D}t
|d��}t||�
Wd�
n1s�0


Y
Wd�
q21s�0


Y
q2W|��
n
|��
0dS)z+Unpack zip `filename` to `extract_dir`
    r
Nz%s is not a zip file�
/z..�
rrh)r
Z
is_zipfiler(r
Zinfolistr/r�r<rVr��splitr5
r�rqrr�)	r/�extract_dirr
r
r
r.Z
targetpath�source�targetr$r$r%�_unpack_zipfile�s(











�

Jr<
r�c
Csbd
dl}z|�
|�
}Wn |jy6


td|�
�
Yn0z|j|
|d�
W|��
n
|��
0dS)zAUnpack tar/tar.gz/tar.bz2/tar.xz `filename` to `extract_dir`
    r
Nz/%s is not a compressed or uncompressed tar filer�)r
rqZTarErrorr(Z
extractallr�)r/r9
r�r
Ztarobjr$r$r%�_unpack_tarfile�s




�

r=
r�r

)r
r
z.tar.gzz.tgzz.tar.bz2z.tbz2z.tar.xzz.txzc
Cs:t�
�D],\}
}|d
D]}|�|�
r|


SqqdS)Nr
)r/
r
r�)r/r.r
r2
r$r$r%�_find_unpack_format�s






r>
c
Cs�t�
d
||
|�
|
dur t��}
t�|
�
}
t�|�
}|durBi}nd|i
}|du
r�zt|}Wn"ty�


td�|�
�
d�Yn0|d}|||
fit	|d�
�
|�
�

nPt
|�
}|dur�td�|�
�
�
t|d}t	t|d�
|B}|||
fi|�
�

dS)a]Unpack an archive.

    `filename` is the name of the archive.

    `extract_dir` is the name of the target directory, where the archive
    is unpacked. If not provided, the current working directory is used.

    `format` is the archive format: one of "zip", "tar", "gztar", "bztar",
    or "xztar".  Or any other registered format.  If not provided,
    unpack_archive will use the filename extension and see if an unpacker
    was registered for that extension.

    In case none is found, a ValueError is raised.

    If `filter` is given, it is passed to the underlying
    extraction function.
    zshutil.unpack_archiveNr�zUnknown unpack format '{0}'r&
r�zUnknown archive format '{0}')r?rir<r'
r�r/
r�r�rj�dictr>
r()r/r9
rjr�Z
filter_kwargsr*
r+
r�r$r$r%r�s*










 



r�statvfs�
disk_usageZusageztotal used freezTotal space in byteszUsed space in byteszFree space in bytesc
Cs@t�
|�
}
|
j|
j}|
j|
j}|
j|
j|
j}t|||�S)
z�Return disk usage statistics about the given path.

        Returned value is a named tuple with attributes 'total', 'used' and
        'free', which are the amount of total, used and free space, in bytes.
        )r<r@
�f_bavail�f_frsize�f_blocks�f_bfree�_ntuple_diskusage)rVrx�free�total�usedr$r$r%rA
	s





c
Cs"t�
|�
\}
}|
|}t|
||�S)
z�Return disk usage statistics about the given path.

        Returned values is a named tuple with attributes 'total', 'used' and
        'free', which are the amount of total, used and free space, in bytes.
        )rZ
_getdiskusagerF
)rVrH
rG
rI
r$r$r%rA
s

cCs�t�
d
||
|�
|
dur(|dur(td�
�
|
}|}|
dur>d}n(t|
t�rft|
�
}|durftd�|
�
�
�
|durtd}n(t|t�s�t	|�
}|dur�td�|�
�
�
t
�|||�
dS)z�Change owner user and group of the given path.

    user and group can be the uid/gid or the user/group names, and in that case,
    they are converted to their respective uid/gid.
    zshutil.chownNzuser and/or group must be set���zno such user: {!r}zno such group: {!r})r?rir�rSr�r��LookupErrorrj�intr�r<r)rV�userr�Z_userZ_groupr$r$r%r%s$












r��P�c

Cs�ztt
jd
�
}
Wnttfy,


d}
Yn0ztt
jd�
}WnttfyZ


d}Yn0|
dk
sl|dk
r�zt
�tj���
}Wn"t	tt
fy�


t
�|�
}Yn0|
dk
r�|j}
|dk
r�|j
}t
�|
|f�
S)aGet the size of the terminal window.

    For each of the two dimensions, the environment variable, COLUMNS
    and LINES respectively, is checked. If the variable is defined and
    the value is a positive integer, it is used.

    When COLUMNS or LINES is not defined, which is the common case,
    the terminal connected to sys.__stdout__ is queried
    by invoking os.get_terminal_size.

    If the terminal size cannot be successfully queried, either because
    the system doesn't support querying, or because we are not
    connected to a terminal, the value given in fallback parameter
    is used. Fallback defaults to (80, 24) which is the default
    size used by many terminal emulators.

    The value returned is a named tuple of type os.terminal_size.
    ZCOLUMNSr
ZLINES)rL
r<�environr�r�rr?�
__stdout__r+�AttributeErrorr-�
terminal_size�columns�lines)ZfallbackrU
rV
�sizer$r$r%rEs$














rcCs&tj
�|�
o$t�||
�o$tj
�|�
Sr^)r<rVrtr�r�)r`r�r$r$r%�
_access_checkvs

�rX
c
	s�
tj
���
rt�|
�r�Sd
St�t�}|d
urrtj�dd
�}|d
urrzt�d�
}Wnt	t
fyp


tj}Yn0|szd
S|r�t�|�
}|�
t�tj�
�
}nt�|�
}|�
tj�
}tjdk�
rRtj}|r�t�|�
}||v
r�|�d|�
t�d�
p�t}dd�|�
tj�
D�
}|�
rd	d�|D�
}t�f
d
d�|D�
�
�
r>�g
}n�f
dd�|D�
}n�g
}t�}|D]X}	tj
�|	�
}
|
|v
�
rb|�|
�

|D],}tj
�|	|�}t||
��
r�|

S�
q��
qbd
S)
a3
Given a command, mode, and a PATH string, return the path which
    conforms to the given mode on the PATH, or None if there is no such
    file.

    `mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result
    of os.environ.get("PATH"), or can be overridden with a custom search
    path.

    N�PATH�CS_PATHZwin32r
ZPATHEXTc
Ssg|]}
|
r|
�qSr$r$�r�r1
r$r$r%r��r�zwhich.<locals>.<listcomp>c
Ssg|]}
t�
|
�
�qSr$)r<�fsencoder[
r$r$r%r��r�c
3s |]}
����
|
���
V
qdSr^)�lowerr�r[
�
�cmdr$r%�	<genexpr>�r�zwhich.<locals>.<genexpr>c
sg|]}
�|
�qSr$r$r[
r^
r$r%r��r�)r<rVr

rX
rSr�rQ
�get�confstrrS
r��defpathr\
r8
�pathsepr�r?r�r
�insert�getenv�_WIN_DEFAULT_PATHEXT�anyr�rXr
r�)
r_
r�rVZ	use_bytesr
Zpathext_sourceZpathext�files�seen�dirZnormdirZthefiler.r$r^
r%r{sV



































r)
r
)
F)FN)r�r
r
NNN)r
r
N)Nr�)NNr
r
NNN)Nr�)NN)NN)
rN
)jr'r<r?rWr��collectionsr1�zlibr��ImportErrorr�r�Zlzmar��pwdrZgrprr.rnrrrOrUr�r�rBrrrg
�__all__r-rr rrr(r,r)r*r:rFrNrr]rardr	r
r�rrr
rr�r�stat_resultr�r�r�r�rqr�r��supports_dir_fdr��supports_fdr�r�rZavoids_symlink_attacksr�rr�r�r�r�r
r
r
rrrrrr4
rrr5
r<
r=
r/
r>
rr��
namedtuplerF
rH
rI
rG
rA
rrrX
�F_OK�X_OKrr$r$r$r%�<module>
s>









































@

@
B
�
A
�
0	
	8
�
�
�
BB	
�
A
-�

�

�

�


�
8
�

�


�


�


�1








 
1