�`^c@s�dZd
dl
Z
d
dlZd
dlZd
dlmZ
d
dlZd
dlZd
dlZyd
dl	m
Z

Wnek
r�


dZ
n
Xyd
dl
mZ
Wnek
r�


dZn
Xdddd	d
ddd
dddddddddgZdef
d��YZdef
d��YZdef
d��YZye
Wnek
rV



dZn
Xd?d�Zd�Zd�Zd�Zd �Zd!�Zd"�Zd#�Zedd$�Zedd%�Z d&�Z!d'�Z"d(�Z#d)�Z$d*�Z%d+d,d,dddd-�Z&eed.�Z'd,d,dd/�Z(ie&d@g
d1fd26e&dAg
d4fd56e&dBg
d6fd76e(gd8fd96Z)d:�Z*dd;d<�Z+d=�Z,ddd,d,dddd>�Z-dS(Cs�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.

i�N(
tabspath(
tgetpwnam(
tgetgrnamtcopyfileobjtcopyfiletcopymodetcopystattcopytcopy2tcopytreetmovetrmtreetErrortSpecialFileErrort	ExecErrortmake_archivetget_archive_formatstregister_archive_formattunregister_archive_formattignore_patternsc
BseZ
RS((t__name__t
__module__(((s/sys/lib/python2.7/shutil.pyRs
c
BseZ
dZRS(
s|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)(RRt__doc__(((s/sys/lib/python2.7/shutil.pyR
"sc
BseZ
dZRS(
s+Raised when a command could not be executed(RRR(((s/sys/lib/python2.7/shutil.pyR&s
iicCs0x)|j|�}|sPn|
j
|�
qd
S(s=copy data from file-like object fsrc to file-like object fdstN(treadtwrite(tfsrctfdsttlengthtbuf((s/sys/lib/python2.7/shutil.pyR.s




cCs{tt
jd
�rAyt
jj||
�SWqAtk
r=


tSXnt
jjt
jj|��t
jjt
jj|
��kS(Ntsamefile(thasattrtostpathRtOSErrortFalsetnormcaseR(tsrctdst((s/sys/lib/python2.7/shutil.pyt	_samefile6s





cCs�t||
�r(t
d
||
f��nx`||
gD]R}ytj|�}Wntk
ra


q5Xtj|j�r5td|��q5q5Wt|d��}t|
d��}t	||�
WdQXWdQXdS(sCopy data from src to dsts`%s` and `%s` are the same files`%s` is a named pipetrbtwbN(
R&RRtstatR!tS_ISFIFOtst_modeR
topenR(R$R%tfntstRR((s/sys/lib/python2.7/shutil.pyRBs







cCsGtt
d
�rCt
j|�}tj|j�}t
j|
|�
ndS(sCopy mode bits from src to dsttchmodN(RRR)tS_IMODER+R/(R$R%R.tmode((s/sys/lib/python2.7/shutil.pyRVs


cCs
tj
|�}t
j|j�}ttd
�rOtj|
|j|jf�
nttd�rqtj|
|�
nttd�r�|d�r�tj	|
|j
�
Wq�k
r�
x@dD]1}tt|�r�|jt
t|�kr�Pq�q�W�q�dS(	sCCopy all stat info (mode bits, atime, mtime, flags) from src to dsttutimeR/tchflagstst_flagst
EOPNOTSUPPtENOTSUPN(R5R6(RR)R0R+RR2tst_atimetst_mtimeR/R3R4R!terrnotgetattr(R$R%R.R1twhyterr((s/sys/lib/python2.7/shutil.pyR]s











'
cCsTtj
j|
�r6tj
j|
tj
j|��}
nt||
�
t||
�
d
S(sVCopy data and mode bits ("cp src dst").

    The destination may be a directory.

    N(RR tisdirtjointbasenameRR(R$R%((s/sys/lib/python2.7/shutil.pyRos
$


cCsTtj
j|
�r6tj
j|
tj
j|��}
nt||
�
t||
�
d
S(s]Copy data and all stat info ("cp -p src dst").

    The destination may be a directory.

    N(RR R=R>R?RR(R$R%((s/sys/lib/python2.7/shutil.pyRzs
$


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

    Patterns is a sequence of glob-style patterns
    that are used to exclude filescs:g}x'�D]}|jt
j|
|��
q
Wt|�S(
N(textendtfnmatchtfiltertset(R tnamest
ignored_namestpattern(
tpatterns(s/sys/lib/python2.7/shutil.pyt_ignore_patterns�s




((RGRH((
RGs/sys/lib/python2.7/shutil.pyR�sc
Cs�tj
|�}|dk	r-|||�}n	t�}tj|
�
g}x
|D]

}||krhqPntjj||�}tjj|
|�}	ys|r�tjj|�r�tj|�}
tj	|
|	�
n5tjj
|�r�||	||�
n
t||	�
WqPt
k
r.

}
|j|jd
�
qPtk
r\

}
|j||	t|�f�
qPXqPWyt||
�
WnMtk
r�
}
tdk	r�t|t�r�q�|j||
t|�f�
n
X|r�t
|�ndS(s�Recursively copy a directory tree using copy2().

    The destination directory must not already exist.
    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.

    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.

    XXX Consider this example code rather than the ultimate tool.

    iN(RtlistdirtNoneRCtmakedirsR R>tislinktreadlinktsymlinkR=R	RRR@targstEnvironmentErrortappendtstrRR!tWindowsErrort
isinstance(
R$R%tsymlinkstignoreRDREterrorstnametsrcnametdstnametlinktoR<R;((s/sys/lib/python2.7/shutil.pyR	�s<

	
















$



 

cCs�|
rd
�}n|dkr*d�}ny%t
jj|�rNtd��nWn.tk
r


|t
jj|tj��
dSXg}yt
j|�}Wn/t
jk
r�
}
|t
j|tj��
n
Xx�|D]�}t
jj	||�}yt
j
|�j}Wnt
jk
r



d}n
Xtj
|�rB
t||
|�
q�yt
j|�
Wq�t
jk
r�
}
|t
j|tj��
q�Xq�Wyt
j|�
Wn-t
jk
r�


|t
j|tj��
n
XdS(s�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 os.listdir, os.remove, or os.rmdir;
    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.

    c

WsdS(
N((
RO((s/sys/lib/python2.7/shutil.pytonerror�s
c

Ws�dS(
N((
RO((s/sys/lib/python2.7/shutil.pyR\�s
s%Cannot call rmtree on a symbolic linkNi(RJRR RLR!tsystexc_infoRIterrorR>tlstatR+R)tS_ISDIRRtremovetrmdir(R t
ignore_errorsR\RDR<RXtfullnameR1((s/sys/lib/python2.7/shutil.pyR�s>























!



c
Cs5tj
jtj
jpd
}
tj
j|j|
��S(Nt(RR tseptaltsepR?trstrip(R Rg((s/sys/lib/python2.7/shutil.pyt	_basename
s
cCs
|
}tj
j|
�r{t||
�r;tj||
�
d
Stj
j|
t|��}tj
j|�r{td|�q{nytj||�
Wn�t	k
r



tj
j|�r�||
�r�td||
f�nt||dt�

t
|�
q
t||�
tj|�
n
Xd
S(s�Recursively move a file or directory to another location. This is
    similar to the Unix "mv" command.

    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.
    A lot more could be done here...  A look at a mv.c shows a lot of
    the issues this implementation glosses over.

    Ns$Destination path '%s' already existss.Cannot move a directory '%s' into itself '%s'.RU(RR R=R&trenameR>RjtexistsRR!t
_destinsrcR	tTrueRRtunlink(R$R%treal_dst((s/sys/lib/python2.7/shutil.pyR
	
s$
















cCsut|�}t|
�}
|j
tjj�s@|tjj7}n|
j
tjj�sh|
tjj7}
n|
j|�S(
N(RtendswithRR Rgt
startswith(R$R%((s/sys/lib/python2.7/shutil.pyRm1
s






c
Cs^tdks|dkrdSyt|�}
Wntk
rE


d}
n
X|
dk	rZ|
d
SdS(s"Returns a gid, given a group name.iN(RRJtKeyError(RXtresult((s/sys/lib/python2.7/shutil.pyt_get_gid:
s









c
Cs^tdks|dkrdSyt|�}
Wntk
rE


d}
n
X|
dk	rZ|
d
SdS(s"Returns an uid, given a user name.iN(R
RJRs(RXRt((s/sys/lib/python2.7/shutil.pyt_get_uidF
s









tgzipicss
id
d6dd6dd6}idd6dd6}	|dk	rY||	j
�krYtd�n|d	|	j|d�}
tjj|
�}tjj|�s�|dk	r�|jd
|�
n|s�tj	|�
q�nddl
}|dk	r�jd
�
nt���t�������fd�}
|so
|j
|
d||�}z|j|
d|
�

Wd|j�
Xn|
S(s�Create a (possibly compressed) tar file from all the files under
    'base_dir'.

    'compress' must be "gzip" (the default), "bzip2", 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", or ".bz2").

    Returns the output filename.
    tgzRwtbz2tbzip2Rfs.gzs.bz2s9bad value for 'compress': must be None, 'gzip' or 'bzip2's.tarscreating %si�NsCreating tar archivec

sF�dk	r!�|_
�|_n�dk	rB�|_�|_n|S(
N(RJtgidtgnametuidtuname(
ttarinfo(R{tgrouptownerR}(s/sys/lib/python2.7/shutil.pyt_set_uid_gid}
s

	


	

sw|%sRB(RJtkeyst
ValueErrortgetRR tdirnameRltinfoRKttarfileRvRuR,taddtclose(t	base_nametbase_dirtcompresstverbosetdry_runR�R�tloggerttar_compressiontcompress_exttarchive_nametarchive_dirR�R�ttar((R{R�R�R}s/sys/lib/python2.7/shutil.pyt
_make_tarballR
s0


	






	


cCsz|rd
}nd}ddlm
}
ddlm}
y |d||
|gd|�

Wn|k
ru


td|
�n
XdS(	Ns-rs-rqi�(
tDistutilsExecError(
tspawntzipR�skunable to create zip file '%s': could neither import the 'zipfile' module nor find a standalone zip utility(tdistutils.errorsR�tdistutils.spawnR�R(R�tzip_filenameR�R�t
zipoptionsR�R�((s/sys/lib/python2.7/shutil.pyt_call_external_zip�s
	



 


c
Cs�|d
}tj
j|�}tj
j|�sf|dk	rM|jd|�
n|sftj|�
qfnyddl}Wntk
r�


d}n
X|dkr�t	|
|||�
n�dk	r�|jd||
�
n|s�|j
|dd|j�
�}x�tj|
�D]�\}	}
}xs|D]k}tj
j
tj
j|	|��}
tj
j|
�r
|j|
|
�
|dk	r�|jd|
�
q�q
q
Wq
WWdQXn|S(	sm
Create a zip file from all the files under 'base_dir'.

    The output zip file will be named 'base_name' + ".zip".  Uses either the
    "zipfile" Python module (if available) or the InfoZIP "zip" utility
    (if installed and found on the default search path).  If neither tool is
    available, raises ExecError.  Returns the name of the output zip
    file.
    s.zipscreating %si�Ns#creating '%s' and adding '%s' to itt
wtcompressionsadding '%s'(RR R�RlRJR�RKtzipfiletImportErrorR�tZipFiletZIP_DEFLATEDtwalktnormpathR>tisfileR(R�R�R�R�R�R�R�R�tzftdirpathtdirnamest	filenamesRXR ((s/sys/lib/python2.7/shutil.pyt
_make_zipfile�s6	












	







!



'R�sgzip'ed tar-filetgztarRzsbzip2'ed tar-filetbztarsuncompressed tar fileR�sZIP fileR�cCs=gtj
�D]\}}
||
d
f^q
}|j�
|S(s�Returns a list of supported formats for archiving and unarchiving.

    Each element of the returned sequence is a tuple (name, description)
    i(t_ARCHIVE_FORMATStitemstsort(RXtregistrytformats((s/sys/lib/python2.7/shutil.pyR�s
,


RfcCs�|dkrg}nt
|
tj�s:td
|
��nt
|ttf�s^td��nxE|D]=}t
|ttf�s�t|�dkretd��qeqeW|
||ft|<dS(su
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.
    sThe %s object is not callables!extra_args needs to be a sequenceis+extra_args elements are : (arg_name, value)N(	RJRTtcollectionstCallablet	TypeErrorttupletlisttlenR�(RXtfunctiont
extra_argstdescriptiontelement((s/sys/lib/python2.7/shutil.pyR�s	
	






(
c

Cst|=dS(
N(
R�(
RX((s/sys/lib/python2.7/shutil.pyR�s
c	Csh
tj
�}	|d
k	rb|d
k	r7|jd
|�
ntjj|�}|sbtj|�
qbn|d
krztj}ni|d6|d6}
yt|
}Wnt	k
r�


t
d|
�n
X|d}x"|dD]\}
}||
|
<q�W|
dkr
||
d<||
d	<nz||||
�}Wd
|d
k	rc
|d
k	rS
|jd|	�
ntj|	�
nX|S(s�Create 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", "bztar"
    or "gztar".

    '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.
    schanging into '%s'R�R�sunknown archive format '%s'ii
R�R�R�Nschanging back to '%s'(RtgetcwdRJtdebugR RtchdirtcurdirR�RsR�(R�tformattroot_dirR�R�R�R�R�R�tsave_cwdtkwargstformat_infotfunctargtvaltfilename((s/sys/lib/python2.7/shutil.pyR�s6





















i@(scompresssgzip(scompresssbzip2(scompressN(.RRR]R)tos.pathRRAR�R9tpwdR
R�RJtgrpRt__all__RPRR
RRSt	NameErrorRR&RRRRRRR"R	RRjR
RmRuRvR�R�R�R�RRRR(((s/sys/lib/python2.7/shutil.pyt<module>sp

















	

	




							A1		(					
<-