a
lji
@ sF d dl mZ dZdZdZdZdZdZd dlZd dl Z d dl
Z
d dl Z d dl Z d dl
Z
d dlZd dlZzd dlZd dlZW n ey d ZZY n0 eefZzeef7 ZW n ey Y n0 g d Zejd d
k rd dlZnd dlZej Z d Z d Z e d
Z dZ!dZ"dZ#dZ$dZ%dZ&d Z'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/dZ0d Z1d Z2d Z3d Z4d Z5d Z6d!Z7e6Z8e&e'e(e)e,e-e.e*e+e/e0e1f Z9e&e'e.e1fZ:e/e0e1fZ;d"Ze?e?e?e@e@e@d$ZAd%ZBd&ZCd'ZDd(ZEd)ZFd*ZGd+ZHd,ZId ZJd-ZKd.ZLd/ZMd0ZNd1ZOd2ZPd3ZQd!ZRd ZSe jTd4v rd5ZUneV ZUd6d7 ZWd8d9 ZXd:d; ZYd2e8fdd? Z[d{d@dAZ\eBdBfeCdCfeDdDfeEdEfeFdFfeGdGffeKdHffeLdIffeMeHB dJfeHdKfeMdLffeNdHffeOdIffePeIB dJfeIdKfePdLffeQdHffeRdIffeSeJB dMfeJdNfeSdLfff
Z]dOdP Z^G dQdR dRe_Z`G dSdT dTe`ZaG dUdV dVe`ZbG dWdX dXe`ZcG dYdZ dZe`ZdG d[d\ d\e`ZeG d]d^ d^eeZfG d_d` d`eeZgG dadb dbeeZhG dcdd ddeeZiG dedf dfeeZjG dgdh dhekZlG didj djekZmG dkdl dlekZnG dmdn dnekZoG dodp dpekZpG dqdr drekZqG dsdt dtekZrG dudv dvekZsG dwdx dxekZtdydz Zue Zvesj Z dS )| )print_functionz
$Revision$z0.9.0u" Lars Gustäbel (lars@gustaebel.de)z5$Date: 2011-02-25 17:42:01 +0200 (Fri, 25 Feb 2011) $z?$Id: tarfile.py 88586 2011-02-25 15:42:01Z marc-andre.lemburg $u4 Gustavo Niemeyer, Niels Gustäbel, Richard Townsend.N)TarFileTarInfo
is_tarfileTarError s ustar s ustar 00d 0 1 2 3 4 5 6 7 L K S x g X )pathlinkpathsizemtimeuidgidunamegname)r r r# r$ )Zatimectimer r! r" r i i i ` @ i i i @ )ntZcezutf-8c C s( | ||} | d| |t| t S )z8Convert a string to a null-terminated bytes object.
N)encodelenNUL)slengthencodingerrors r7 I/usr/lib/python3.9/site-packages/pip/_vendor/distlib/_backport/tarfile.pystn s r9 c C s* | d}|dkr | d| } | ||S )z8Convert a null-terminated bytes object to a string.
r N)finddecode)r3 r5 r6 pr7 r7 r8 nts s
r> c C s | d t dkrHztt| ddp"dd}W q~ tyD tdY q~0 n6d}tt| d D ] }|dK }|t| |d 7 }q\|S ) z/Convert a number field to a python number.
r r) asciistrict0r- zinvalid headerr )chrintr>
ValueErrorInvalidHeaderErrorranger1 ord)r3 nir7 r7 r8 nti s rJ c C s d| kr d|d k r Z(d?d@ Z)dAdB Z*dCdD Z+dEdF Z,dGdH Z-dIdJ Z.dKdL Z/dMdN Z0dOdP Z1dQdR Z2dSdT Z3dUS )Wr a Informational class which holds the details about an
archive member given by a tar header block.
TarInfo objects are returned by TarFile.getmember(),
TarFile.getmembers() and TarFile.gettarinfo() and are
usually created internally.
)r rt r! r" r r chksumtypelinknamer# r$ devmajordevminorr r pax_headersr r _sparse_structs _link_targetrp c C sj || _ d| _d| _d| _d| _d| _d| _t| _d| _ d| _
d| _ d| _ d| _
d| _d| _d| _i | _dS )zXConstruct a TarInfo object. name is the optional name
of the member.
i r rp N)r rt r! r" r r r REGTYPEr r r# r$ r r r r r r r r r7 r7 r8 r s" zTarInfo.__init__c C s | j S r r r r7 r7 r8 _getpath s zTarInfo._getpathc C s
|| _ d S r r r r7 r7 r8 _setpath s zTarInfo._setpathc C s | j S r r r r7 r7 r8 _getlinkpath s zTarInfo._getlinkpathc C s
|| _ d S r r )r r r7 r7 r8 _setlinkpath s zTarInfo._setlinkpathc C s d| j j| jt| f S )Nz<%s %r at %#x>) __class__rz r idr r7 r7 r8 __repr__ s zTarInfo.__repr__c C sl | j | jd@ | j| j| j| j| j| j| j| j | j
| j | j d
}|d t
krh|d dsh|d d7 < |S )z9Return the TarInfo's attributes as a dictionary.
)
r rt r! r" r r r r r r# r$ r r r r /)r rt r! r" r r r r r r# r$ r r DIRTYPEr )r infor7 r7 r8 get_info s" zTarInfo.get_infosurrogateescapec C sT | }|tkr | |||S |tkr4| |||S |tkrH| ||S tddS )zq*z|| dd W n" tyt || ||< Y q*Y n0 t|| |kr*|| ||< q*d
D ]`\}}||v rd ||< q|| }d | krd |d
k rn n
t|t rt
|||< d ||< q|r| |t |} nd} | |
|tdd S )zReturn the object as a ustar header block. If it cannot be
represented this way, prepend a pax extended header sequence
with supplement information.
r r r r r )r# r# r+ )r$ r$ r+ r? r@ ))r! r- )r" r- )r )r r! r r- r r r )r r copyr r r0 UnicodeEncodeErrorr1
isinstancefloatstr_create_pax_generic_headerXHDTYPEr r )
r r
r5 r r Zhnamer4 rT valrZ r7 r7 r8 r s4
*
zTarInfo.create_pax_headerc C s | |tdS )zAReturn the object as a pax global header block sequence.
utf8)r' XGLTYPE)clsr r7 r7 r8 create_pax_global_headerD s z TarInfo.create_pax_global_headerc C sj |dt d }|r.|d dkr.|dd }q|t|d }|dd }|rZt|tkrbtd||fS )zUSplit a name longer than 100 chars into a prefix
and a name part.
Nr r: r zname is too long)
LENGTH_PREFIXr1 r rD )r r r r7 r7 r8 r J s zTarInfo._posix_split_namec C sV t | ddd||t| ddd@ d|t| ddd|t| d dd|t| d
dd |t| d dd |d
| dtt | ddd||| dtt | ddd||t | ddd||t| ddd|t| ddd|t | ddd||g}tdt d|}t |t d d }|dd d |
d |d d }|S ) zReturn a header block. info is a dictionary with file
information, format must be one of the *_FORMAT constants.
r rp r rt r r
r- r! r" r r! r s r r r r# r+ r$ r r r r z%dsr Niz%06o r? i) r9 getrV r r rO rQ r rs r[ r0 )r
rU r5 r6 partsrZ r r7 r7 r8 r Y s(
&zTarInfo._create_headerc C s. t t| t\}}|dkr*| t| t 7 } | S )zdReturn the string payload filled with zero bytes
up to the next 512 byte border.
r )r^ r1 r r2 )Zpayloadrc rd r7 r7 r8 _create_payloadu s zTarInfo._create_payloadc C sR | ||t }i }d|d< ||d< t||d< t|d< | |t||| | S )zTReturn a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence
for name.
z
././@LongLinkr r r r )r0 r2 r1 r r r r1 )r, r r r5 r6 r
r7 r7 r8 r s z TarInfo._create_gnu_long_headerc C s0 d}| D ]6\}}z|dd W q ty@ d}Y qDY q 0 q d}|rT|d7 }| D ]\}}|d}|r||d}n
|d}t|t| d }d } }
|tt|
} | |
krq| }
q|tt|
d
d | d | d
7 }q\i } d| d< || d< t|| d< t| d< | | td
d| | S )zReturn a POSIX.1-2008 extended or global header sequence
that contains a list of keyword, value pairs. The values
must be strings.
Fr* r@ Tr s 21 hdrcharset=BINARY
r r r r? =r z././@PaxHeaderr r r r r )
itemsr0 r# r1 r& bytesr r r r1 ) r, r r r5 ZbinarykeywordvalueZrecordsrL rH r= r
r7 r7 r8 r' s<
( z"TarInfo._create_pax_generic_headerc C st t |dkrtdt |tkr(td|ttkr>tdt|dd }|t|vrbt d| }t
|dd |||_ t|dd |_ t|d d
|_
t|d
d |_t|d d |_t|d d |_||_|dd
|_t
|d
d |||_t
|dd |||_t
|dd |||_t|dd |_t|dd |_t
|dd ||}|jtkr|j drt|_|jtkr6d}g }t dD ]j} z0t|||d }
t||d |d } W n t y Y qY n0 | |
| f |d7 }qt |d } t|dd }
|| |
f|_ |! rN|j "d|_ |rp|jt#vrp|d |j |_ |S ) zAConstruct a TarInfo object from a 512 byte bytes object.
r z empty headerztruncated headerzend of file headerrW rX z bad checksumr l t | i i i) iI iQ iY i r i r. r! i i i )$r1 r r r countr2 r rJ r[ rE r> r rt r! r" r r r r r r# r$ r r AREGTYPEr r GNUTYPE_SPARSErF rD rr boolr isdirrstrip GNU_TYPES)r, rZ r5 r6 r objr r structsrI r numbytes
isextendedorigsizer7 r7 r8 frombuf sZ
zTarInfo.frombufc C s8 |j t}| ||j|j}|j t |_||S )zOReturn the next TarInfo object from TarFile object
tarfile.
) r r\ r rJ r5 r6 r r _proc_member)r, r rZ rE r7 r7 r8 fromtarfile s zTarInfo.fromtarfilec C sT | j ttfv r| |S | j tkr,| |S | j tttfv rF| |S |
|S dS )zYChoose the right processing method depending on
the type and call it.
N) r r r
_proc_gnulongr@ _proc_sparser( r+ SOLARIS_XHDTYPE _proc_pax
_proc_builtinr r r7 r7 r8 rK s
zTarInfo._proc_memberc C sR |j | _| j}| s$| jtvr4|| | j7 }||_| |j
|j |j | S )zfProcess a builtin type or an unknown type which
will be treated as a regular file.
)
r r r isregr SUPPORTED_TYPES_blockr r _apply_pax_infor r5 r6 )r r r r7 r7 r8 rQ $ s zTarInfo._proc_builtinc C s |j | | j}z| |}W n ty< tdY n0 | j|_| jt krdt
||j |j |_
n | jtkrt
||j |j |_|S )zSProcess the blocks that hold a GNU longname
or longlink member.
missing or bad subsequent header)r r\ rU r rL r r r r r r> r5 r6 r r r )r r rZ nextr7 r7 r8 rM 5 s
zTarInfo._proc_gnulongc
C s | j \}}}| ` |r|jt}d}tdD ]l}z0t|||d }t||d |d } W n tyx Y qY n0 |r| r||| f |d7 }q,t|d }q|| _ |j
| _ | j | | j
|_|| _
| S )z8Process a GNU sparse header plus extra headers.
r r! r= i )r r r\ r rF rJ rD rr rA r r r rU r r )
r r rF rH rI rZ r rI r rG r7 r7 r8 rN K s(
zTarInfo._proc_sparsec C s |j | | j}| jtkr&|j}n
|j }t d|}|durX|
d d|d< | d}|dkrr|j
}nd}td}d}|||}|sq&| \} }
t| } ||d d |d| d } | |
dd|j}
|
tv r| | ||j
|j} n| | dd|j} | ||
< || 7 }qz| |} W n tyP td
Y n0 d |v rj| | | nHd |v r| | || n.| d
dkr| ddkr| | || | jt t fv r| ||j
|j | j | _ d|v r| j!}
| " s| jt#vr|
| | j7 }
|
|_ | S )zVProcess an extended or global header as described in
POSIX.1-2008.
s \d+ hdrcharset=([^\n]+)\nNr r*
hdrcharsetZBINARYs (\d+) ([^=]+)=r r rW GNU.sparse.mapGNU.sparse.sizezGNU.sparse.major1zGNU.sparse.minorrA r )$r r\ rU r r r+ r r" researchgroupr< r/ r5 compilematchgroupsrC endr _decode_pax_fieldr6 PAX_NAME_FIELDSrL r r _proc_gnusparse_01_proc_gnusparse_00_proc_gnusparse_10r( rO rV r r rS rT )r r rZ r rb rZ r5 Zregexr r4 r6 r7 rX r r7 r7 r8 rP g sd
$
zTarInfo._proc_paxc C sh g }t d|D ]}|t|d qg }t d|D ]}|t|d q:tt|||_dS )z?Process a GNU tar extended sparse header, version 0.0.
s \d+ GNU.sparse.offset=(\d+)\nr s \d+ GNU.sparse.numbytes=(\d+)\nN)r^ finditerrr rC r` listzipr )r rX r rZ Zoffsetsrb rG r7 r7 r8 rh s zTarInfo._proc_gnusparse_00c C s@ dd |d dD }tt|ddd |ddd |_dS )z?Process a GNU tar extended sparse header, version 0.1.
c S s g | ] }t |qS r7 )rC ).0rm r7 r7 r8
r z.TarInfo._proc_gnusparse_01..r[ ,Nr r )splitrk rl r )r rX r r r7 r7 r8 rg s zTarInfo._proc_gnusparse_01c C s d}g }|j t}|dd\}}t|}t||d k rtd|vrT||j t7 }|dd\}}|t| q,|j |_t t
|ddd |ddd |_ dS )z?Process a GNU tar extended sparse header, version 1.0.
Nr r r ) r r\ r rp rC r1 rr r r rk rl r )r rX r r fieldsr rZ numberr7 r7 r8 ri s zTarInfo._proc_gnusparse_10c C s | D ]\}}|dkr&t| d| q|dkr@t| dt| q|dkrZt| dt| q|tv r|tv rzt| |}W n ty d}Y n0 |dkr|d}t| || q| | _dS ) zoReplace fields with supplemental information from a previous
pax extended or global header.
zGNU.sparse.namer r\ r zGNU.sparse.realsizer r N) r4 setattrrC
PAX_FIELDSPAX_NUMBER_FIELDSrD rC r" r )r r r5 r6 r6 r7 r7 r7 r8 rV s"
zTarInfo._apply_pax_infoc C s2 z| |dW S ty, | || Y S 0 dS )z1Decode a single field from a pax record.
r@ N)r< UnicodeDecodeError)r r7 r5 Zfallback_encodingZfallback_errorsr7 r7 r8 re s zTarInfo._decode_pax_fieldc C s" t |t\}}|r|d7 }|t S )z_Round up a byte count by BLOCKSIZE and return it,
e.g. _block(834) => 1024.
r )r^ r )r r> rc rd r7 r7 r8 rU
s zTarInfo._blockc C s
| j tv S r )r
REGULAR_TYPESr r7 r7 r8 rS s z
TarInfo.isregc C s | S r )rS r r7 r7 r8 isfile s zTarInfo.isfilec C s
| j tkS r )r r r r7 r7 r8 rB s z
TarInfo.isdirc C s
| j tkS r )r SYMTYPEr r7 r7 r8 issym s z
TarInfo.issymc C s
| j tkS r )r LNKTYPEr r7 r7 r8 islnk s z
TarInfo.islnkc C s
| j tkS r )r CHRTYPEr r7 r7 r8 ischr s z
TarInfo.ischrc C s
| j tkS r )r BLKTYPEr r7 r7 r8 isblk" s z
TarInfo.isblkc C s
| j tkS r )r FIFOTYPEr r7 r7 r8 isfifo$ s zTarInfo.isfifoc C s
| j d uS r )r r r7 r7 r8 issparse& s zTarInfo.issparsec C s | j tttfv S r )r r} r r r r7 r7 r8 isdev( s z
TarInfo.isdevN)rp )4rz r{ r| r} __slots__r r r propertyr r r r r r DEFAULT_FORMATENCODINGr r r r classmethodr- r staticmethodr r1 r r' rJ rL rK rQ rM rN rP rh rg ri rV re rU rS rx rB rz r| r~ r r r r r7 r7 r7 r8 r sf
1
2
>
f r c @ s e Zd ZdZdZdZdZdZeZ e
Z dZ e
ZeZdVdd Zedddefd
d ZedWd d
ZedXddZedYddZddddZdd Zdd Zdd Zd d Z dZd d Z d[d"d#Z d\d$d%Z d]d&d'Z d^d)d*Z!d_d,d-Z"d.d/ Z#d`d0d1Z$d2d3 Z%d4d5 Z&d6d7 Z'd8d9 Z(d:d; Z)dd? Z+d@dA Z,dBdC Z-dDdE Z.dadFdGZ/dHdI Z0dbdJdKZ1dLdM Z2dNdO Z3dPdQ Z4dRdS Z5dTdU Z6dS )cr z=The TarFile Class provides an interface to tar archives.
r Fr Nrj r c
C s t |dks|dvr td|| _dddd| | _|sn| jdkrZtj|sZd | _d| _t|| j}d
| _n0|d u rt |d r|j
}t |d
r|j| _d| _|rtj |nd | _
|| _ |d ur|| _
|d ur|| _|d ur|| _|d ur|| _|d ur|| _| | _|
d ur&| j
tkr&|
| _ni | _| d ur<| | _| d urL| | _d
| _g | _d
| _| j | _i | _ z| jdkrd | _ | | _ | jdkr"| j | j z | j | }| j!| W nX t"y | j | j Y q"Y n2 t#y }
zt$t%|
W Y d }
~
n
d }
~
0 0 q| jdv rld| _| jrl| j&| j' }| j (| | jt |7 _W n& | js| j ) d| _ Y n0 d S )a Open an (uncompressed) tar archive `name'. `mode' is either 'r' to
read from an existing archive, 'a' to append data to an existing
file or 'w' to create a new file overwriting an existing one. `mode'
defaults to 'r'.
If `fileobj' is given, it is used for reading or writing data. If it
can be determined, `mode' is overridden by `fileobj's mode.
`fileobj' is not closed, when TarFile is closed.
r r mode must be 'r', 'a' or 'w'rbzr+bwb)rj ark r rk FNr rt Trj aw)*r1 rD rt _moder r exists bltn_openr r r abspathr rU r dereference ignore_zerosr5 r6 r r debug
errorlevelr members_loadedr r inodes firstmemberrX r rL rr r r r r& r- r" r] r )r r rt r rU r r r r5 r6 r r r erZ r7 r7 r8 r F s
&
zTarFile.__init__c
K s |s|st d|dv r| jD ]}t| | j| }|durB| }z||d|fi |W S ttfy } z*|dur|| W Y d} ~ q W Y d} ~ q d} ~ 0 0 q tdnd|v r|dd\}
}|
pd}
|pd}|| jv rt| | j| }n td | |||
|fi |S d
|v r|d
d\}
}|
p:d}
|pDd}|
d vrXt d t||
|||} z| ||
| fi |} W n | Y n0 d
| _
| S |dv r| j |||fi |S t ddS )a| Open a tar archive for reading, writing or appending. Return
an appropriate TarFile class.
mode:
'r' or 'r:*' open for reading with transparent compression
'r:' open for reading exclusively uncompressed
'r:gz' open for reading with gzip compression
'r:bz2' open for reading with bzip2 compression
'a' or 'a:' open for appending, creating the file if necessary
'w' or 'w:' open for writing without compression
'w:gz' open for writing with gzip compression
'w:bz2' open for writing with bzip2 compression
'r|*' open a stream of tar blocks with transparent compression
'r|' open an uncompressed stream of tar blocks for reading
'r|gz' open a gzip compressed stream of tar blocks
'r|bz2' open a bzip2 compressed stream of tar blocks
'w|' open an uncompressed stream for writing
'w|gz' open a gzip compressed stream for writing
'w|bz2' open a bzip2 compressed stream for writing
znothing to open)rj zr:*Nrj z%file could not be opened successfully:r r zunknown compression type %r|rwmode must be 'r' or 'w'Fr zundiscernible mode) rD OPEN_METHr r r r r rp r r r taropen)
r, r rt r r kwargsr funcZ saved_posr rx streamrn r7 r7 r8 r sN
$
z TarFile.openc K s0 t |dks|dvr td| |||fi |S )zCOpen uncompressed tar archive name for reading or writing.
r r r )r1 rD )r, r rt r r r7 r7 r8 r s zTarFile.taropenr c K s t |dks|dvr tdzddl}|j W n ttfyL tdY n0 |du}z.|||d ||}| j|||fi |}W nX ty |s|dur| |du r t
dY n" |s|dur| Y n0 ||_ |S ) zkOpen gzip compressed tar archive name for reading or writing.
Appending is not allowed.
r r r r Nz gzip module is not availablere r ) r1 rD gzipZGzipFiler AttributeErrorr r r_ r r r ) r, r rt r
compresslevelr r Z
extfileobjrn r7 r7 r8 gzopen s.
zTarFile.gzopenc K s t |dks|dvr tdz ddl}W n tyB tdY n0 |durXt||}n|j|||d}z| j|||fi |}W n& tt fy |
t dY n0 d |_ |S )
zlOpen bzip2 compressed tar archive name for reading or writing.
Appending is not allowed.
r r zmode must be 'r' or 'w'.r Nr )r znot a bzip2 fileF)
r1 rD r r r r BZ2Filer r_ EOFErrorr r r )r, r rt r r r r rn r7 r7 r8 bz2open$ s zTarFile.bz2openr r r )r r r c C s | j r
dS | jdv rf| jttd | jtd 7 _t| jt\}}|dkrf| jtt| | j sv| j
d| _ dS )zlClose the TarFile. In write-mode, two finishing zero blocks are
appended to the archive.
Nr r r T) r rt r r] r2 r r r^
RECORDSIZEr r )r rc rd r7 r7 r8 r H s
z
TarFile.closec C s" | |}|du r td| |S )a Return a TarInfo object for member `name'. If `name' can not be
found in the archive, KeyError is raised. If a member occurs more
than once in the archive, its last occurrence is assumed to be the
most up-to-date version.
Nzfilename %r not found)
_getmemberKeyError)r r r r7 r7 r8 getmember\ s
zTarFile.getmemberc C s | | js| | jS )zReturn the members of the archive as a list of TarInfo objects. The
list has the same order as the members in the archive.
)_checkr _loadr r r7 r7 r8
getmembersg s zTarFile.getmembersc C s dd | D S )zReturn the members of the archive as a list of their names. It has
the same order as the list returned by getmembers().
c S s g | ]
}|j qS r7 r )rm r r7 r7 r8 rn u r z$TarFile.getnames..)r r r7 r7 r8 getnamesq s zTarFile.getnamesc C sh | d |dur|j}|du r$|}tj|\}}|tjd}|d}| }| |_ |du rt
tdr~| j s~t |}qt
|}nt| }d}|j}t
|r |j|jf} | j s|jdkr| | jv r|| j| krt}
| j| }nt}
| d rt|| j| < nht
|r t}
nVt
|r0t}
nDt
|rLt }
t |}n(t
|r^t }
nt
!|rpt"}
ndS ||_||_#|j$|_%|j&|_'|
tkr|j(|_)nd|_)|j*|_+|
|_,||_-t.rzt./|j%d |_0W n t1y Y n0 t2r"zt23|j'd |_4W n t1y Y n0 |
t t"fv rdt
tdrdt
td rdt5|j6|_7t8|j6|_9|S )
aO Create a TarInfo object for either the file `name' or the file
object `fileobj' (using os.fstat on its file descriptor). You can
modify some of the TarInfo's attributes before you add it using
addfile(). If given, `arcname' specifies an alternative name for the
file in the archive.
r Nr lstatrp r r majorminor):r r r r
splitdriver seplstripr r r r r statfstatfilenost_modeS_ISREGst_inost_devst_nlinkr r{ r S_ISDIRr S_ISFIFOr S_ISLNKry readlinkS_ISCHRr} S_ISBLKr rt st_uidr! st_gidr" st_sizer st_mtimer r r pwdgetpwuidr# r grpgetgrgidr$ r st_rdevr r r ) r r arcnamer drvr Zstatresr Zstmdinoder r7 r7 r8
gettarinfow s
zTarFile.gettarinfoTc C s | | D ]}|rtt|jdd td|jp4|j|jp>|jf dd | sZ| rxtdd|j
|j f dd ntd|j dd tdt
|jdd dd t|j| rd
nd dd |r| rtd |jdd | rtd
|jdd t q dS )zPrint a table of contents to sys.stdout. If `verbose' is False, only
the names of the members are printed. If it is True, an `ls -l'-like
output is produced.
)rd z%s/%sz%10sz%d,%dz%10dz%d-%02d-%02d %02d:%02d:%02dNr r rp z->zlink to)r printrx rt r# r! r$ r" r~ r r r r r localtimer r rB rz r r| )r verboser r7 r7 r8 rk s8
z TarFile.listc C sn | d |du r|}|durPddl}|dtd ||rP| dd| dS | jdurtj|| jkr| dd| dS | d| | ||}|du r| dd | dS |dur||}|du r| dd| dS |
r
t |d
}| || |
n`| r`| | |rjt|D ].}| jtj||tj|||||d q.n
| | dS ) a~ Add the file `name' to the archive. `name' may be any type of file
(directory, fifo, symbolic link, etc.). If given, `arcname'
specifies an alternative name for the file in the archive.
Directories are added recursively by default. This can be avoided by
setting `recursive' to False. `exclude' is a function that should
return True for each filename to be excluded. `filter' is a function
that expects a TarInfo object argument and returns the changed
TarInfo object, if it returns None the TarInfo object will be
excluded from the archive.
r Nr z use the filter argument insteadr ztarfile: Excluded %rztarfile: Skipped %rr z tarfile: Unsupported type %rr )filter)r warningswarnDeprecationWarning_dbgr r r r r rS r addfiler rB listdiraddrs ) r r r recursiveZexcluder r r fr7 r7 r8 r sH
z TarFile.addc C s | d t|}|| j| j| j}| j| | jt |7 _|durt
|| j|j t |j t
\}}|dkr| jtt
| |d7 }| j|t
7 _| j| dS )a] Add the TarInfo object `tarinfo' to the archive. If `fileobj' is
given, tarinfo.size bytes are read from it and added to the archive.
You can create TarInfo objects using gettarinfo().
On Windows platforms, `fileobj' should always be opened with mode
'rb' to avoid irritation about the file size.
r Nr r )r r" r rU r5 r6 r r] r r1 rf r r^ r r2 r rr )r r r rZ rc rd r7 r7 r8 r 4 s
zTarFile.addfile.c C s g }|du r| }|D ]<}| r:|| t|}d|_| j||| d q|jdd d | |D ]}tj ||j
}z(| || | || |
|| W qn ty } z*| jdkrȂ n| dd| W Y d}~qnd}~0 0 qndS ) aM Extract all members from the archive to the current working
directory and set owner, modification time and permissions on
directories afterwards. `path' specifies a different directory
to extract to. `members' is optional and must be a subset of the
list returned by getmembers().
N set_attrsc S s | j S r r )r r7 r7 r8 d r z$TarFile.extractall..)keyr tarfile: %s)rB rr r" rt extractsortreverser r rs r chownutimechmodr~ r r )r r r Z directoriesr dirpathr r7 r7 r8
extractallN s*
zTarFile.extractallrp c
C s | d t|tr | |}n|}| r>tj||j|_ z | j
|tj||j |d W n t y } zP| j
dkr| n6|jdu r| dd|j n| dd|j|jf W Y d}~nLd}~0 ty } z*| j
dkr n| dd| W Y d}~n
d}~0 0 dS )ax Extract a member from the archive to the current working directory,
using its full name. Its file information is extracted as accurately
as possible. `member' may be a filename or a TarInfo object. You can
specify a different directory using `path'. File attributes (owner,
mtime, mode) are set unless `set_attrs' is False.
rj r r Nr r ztarfile: %s %r)r r$ r& r r| r r rs r r _extract_memberr EnvironmentErrorr filenamer strerrorr~ )r memberr r r r r7 r7 r8 r t s(
,
zTarFile.extractc C s | d t|tr | |}n|}| r8| | |S |jtvrN| | |S | s^| rt| j
t rtt dq|
| |S ndS dS )a Extract a member from the archive as a file object. `member' may be
a filename or a TarInfo object. If `member' is a regular file, a
file-like object is returned. If `member' is a link, a file-like
object is constructed from the link's target. If `member' is none of
the above, None is returned.
The file-like object is read-only and provides the following
methods: read(), readline(), readlines(), seek() and tell()
rj z'cannot extract (sym)link as file objectN)r r$ r& r rS
fileobjectr rT r| rz r r r extractfile_find_link_target)r r r r7 r7 r8 r s
zTarFile.extractfilec C sR | d}|dtj}tj|}|r>tj|s>t| | sN| rh|
dd|j |j f n|
d|j |
r| || n| r| || nx| r| || nb| s| r| || nD| s| r| || n&|jtvr| || n | || |rN| || | sN| || | || dS )z\Extract the TarInfo object tarinfo to a physical
file called targetpath.
r r z%s -> %sN) rC r r r r dirnamer makedirsr| rz r r r rS makefilerB makedirr makefifor~ r makedevmakelinkr rT makeunknownr r r )r r
targetpathr Z upperdirsr7 r7 r8 r s4
zTarFile._extract_memberc
C sH zt |d W n2 tyB } z|jtjkr. W Y d}~n
d}~0 0 dS )z,Make a directory called targetpath.
r N)r mkdirr errnoZEEXISTr r r r r7 r7 r8 r s
zTarFile.makedirc C s| | j }||j t|d}|jdurN|jD ] \}}|| t||| q,nt|||j ||j | | dS )z'Make a file called targetpath.
r N) r r r r r rf r truncater )r r r sourcetargetr r r7 r7 r8 r s
zTarFile.makefilec C s" | || | dd|j dS )zYMake a file from a TarInfo object with an unknown type
at targetpath.
r z9tarfile: Unknown file type %r, extracted as regular file.N)r r r r r r r7 r7 r8 r s zTarFile.makeunknownc C s" t tdrt| ntddS )z'Make a fifo called targetpath.
mkfifoz fifo not supported by systemN)r r r r~ r
r7 r7 r8 r s
zTarFile.makefifoc C s^ t tdrt tds td|j}| r6|tjO }n
|tjO }t||t |j
|j dS )z| rttdrt
||| ntjdkrt||| W n, ty } ztdW Y d}~n
d}~0 0 dS )z6Set owner of targetpath according to tarinfo.
geteuidr r lchownZos2emxzcould not change ownerN)r r r r r getgrnamr$ r r" getpwnamr# r! rz r sysplatformr r r~ )r r r gur r7 r7 r8 r D s
z
TarFile.chownc
C sN t tdrJzt||j W n, tyH } ztdW Y d}~n
d}~0 0 dS )zASet file permissions of targetpath according to tarinfo.
r zcould not change modeN)r r r rt r r~ r r7 r7 r8 r Z s
z
TarFile.chmodc
C sX t tdsdS zt||j|jf W n, tyR } ztdW Y d}~n
d}~0 0 dS )zBSet modification time of targetpath according to tarinfo.
r Nz"could not change modification time)r r r r r r~ r r7 r7 r8 r c s
z
TarFile.utimec
C s | d | jdur$| j}d| _|S | j| j d}z| j| }W q ty } zD| jr| dd| j|f | jt
7 _W Y d}~q6W Y d}~qd}~0 t y } z\| jr| dd| j|f | jt
7 _W Y d}~q6n| jdkrt t
|W Y d}~nd}~0 ty> | jdkr:t dY nn tyz } z$| jdkrft t
|W Y d}~n:d}~0 ty } zt t
|W Y d}~n
d}~0 0 qq6|dur| j| nd| _|S )zReturn the next member of the archive as a TarInfo object, when
TarFile is opened for reading. Return None if there is no more
available.
ZraNr z0x%X: %sr z
empty fileT)r r r r r r rL r r r r rE r r& r r r r rr r )r mr r r7 r7 r8 rX n sD
" "
z TarFile.nextc C sn | }|dur"|d|| }|r2tj|}t|D ].}|rRtj|j}n|j}||kr:| S q:dS )z}Find an archive member by name from bottom to top.
If tarinfo is given, it is used as the starting point.
N)r indexr r normpathreversedr )r r r normalizer r member_namer7 r7 r8 r s zTarFile._getmemberc C s | }|du r qq d| _dS )zWRead through the entire archive file and look for readable
members.
NT)rX r r r r7 r7 r8 r s z
TarFile._loadc C s: | j rtd| jj |dur6| j|vr6td| j dS )znCheck if TarFile is still open, and if the operation's mode
corresponds to TarFile's mode.
z %s is closedNzbad operation for mode %r)r r_ r rz rt )r rt r7 r7 r8 r s zTarFile._checkc C sX | r&tj|jd |j }d}n
|j}|}| j||dd}|du rTtd| |S )zZFind the target member of a symlink or hardlink member in the
archive.
r NT)r r zlinkname %r not found)rz r r r r r r r )r r r limitr r7 r7 r8 r s zTarFile._find_link_targetc C s | j rt| jS t| S dS )z$Provide an iterator object.
N)r iterr TarIterr r7 r7 r8 r s
zTarFile.__iter__c C s || j krt|tjd dS )z.Write debugging output to sys.stderr.
)fileN)r r r stderr)r levelmsgr7 r7 r8 r s
z TarFile._dbgc C s | | S r )r r r7 r7 r8 __enter__ s zTarFile.__enter__c C s, |d u r| n| js"| j d| _d S r )r r r r )r r r7 tracebackr7 r7 r8 __exit__ s
zTarFile.__exit__) Nrj NNNNNNr NNN)rj N)rj Nr )rj Nr )NNN)T)NTNN)N)r N)rp T)T)NF)N)7rz r{ r| r} r r r r r rU r r5 r6 r r r r r r r r r r r r r r r r r rk r r r r r r r r r r r r r r r rX r r r r r r r( r* r7 r7 r7 r8 r , sp
kK
b
>
&
#&
0 1
r c @ s, e Zd ZdZdd Zdd Zdd ZeZdS ) r# zMIterator Class.
for tarinfo in TarFile(...):
suite...
c C s || _ d| _dS )z$Construct a TarIter object.
r N)r r rR r7 r7 r8 r
s zTarIter.__init__c C s | S )z Return iterator object.
r7 r r7 r7 r8 r
s zTarIter.__iter__c C s` | j js$| j }|sNd| j _tn*z| j j| j }W n tyL tY n0 | jd7 _|S )zReturn the next item using TarFile's next() method.
When all members have been read, set TarFile as _loaded.
Tr )r r rX
StopIterationr r
IndexErrorr r7 r7 r8 __next__
s
zTarIter.__next__N)rz r{ r| r} r r r- rX r7 r7 r7 r8 r# s
r# c C s0 zt | }| W dS ty* Y dS 0 dS )zfReturn True if name points to a tar archive that we
are able to handle, else return False.
TFN)r r r )r rn r7 r7 r8 r #
s r )N)wZ
__future__r __version__version
__author__Z__date__Z __cvsid__ __credits__r r r r r rO r" r^ r r r r NotImplementedErrorr Z WindowsError NameError__all__ version_infoZ __builtin__builtinsr Z_openr2 r r r r r r r. r r? r{ ry r} r r r ZCONTTYPEr r r@ r( r+ rO r rN r r rT rw rD rt setrf r% rC ru S_IFLNKS_IFREGr
S_IFDIRr S_IFIFOZTSUIDZTSGIDZTSVTXZTUREADZTUWRITEZTUEXECZTGREADZTGWRITEZTGEXECZTOREADZTOWRITEZTOEXECr r getfilesystemencodingr9 r> rJ rV r[ rf rq rx Exceptionr r~ r r r r r r r rE r objectr r r r r r r r r# r r r7 r7 r7 r8 sN
i?K T*