File: //usr/local/ssl/local/ssl/lib/python2.4/tarfile.pyo
m
=5Dc
@ s d Z d Z d Z d Z d Z d Z d Z d k Z d k Z d k Z d k
Z
d k Z d k Z d k
Z
d k Z e i d j o
e d n y d k Z d k Z Wn e j
o e Z Z n Xd
d d d
g Z d Z d Z e d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z! d Z" d Z# d Z$ d Z% d Z& d Z' d Z( d Z) e e e e! e$ e% e& e" e# e' e( e) f Z* e e e& e) f Z+ d! Z, d" Z- d# Z. d$ Z/ d% Z0 d& Z1 d' Z2 d( Z3 d Z4 d) Z5 d* Z6 d+ Z7 d, Z8 d- Z9 d. Z: d/ Z; d0 Z< d1 Z= d2 Z> d3 Z? d4 Z@ d. eA d5 ZB d6 ZC d7 ZD e d8 ZE e, d9 f e- d: f e. d; f e/ d< f e0 d= f e1 d> f f e5 d? f f e6 d@ f f e7 e2 BdA f e2 d f e7 dB f f e8 d? f f e9 d@ f f e: e3 BdA f e3 d f e: dB f f e; d? f f e< d@ f f e= e4 BdC f e4 dD f e= dB f f f
ZF dE ZG e iH dF j o
dG ZI n
e iJ iI ZI d
eK f dH YZL dI eL f dJ YZM dK eL f dL YZN dM eL f dN YZO dO eL f dP YZP dQ f dR YZQ dS f dT YZR dU eS f dV YZT dW eS f dX YZU dY eS f dZ YZV d[ eS f d\ YZW d eS f d] YZX d
eS f d^ YZY d_ f d` YZZ da f db YZ[ dc e[ f dd YZ\ de e[ f df YZ] dg e^ f dh YZ_ di Z` d. Za dj f dk YZb dl Zc eY id Zd d S(m s, Read from and write to tar format archives.
s $Revision: 70530 $s 0.8.0s! Lars Gustbel (lars@gustaebel.de)s5 $Date: 2009-03-22 17:34:05 -0400 (Sun, 22 Mar 2009) $s; $Id: tarfile.py 70530 2009-03-22 21:34:05Z lars.gustaebel $s3 Gustavo Niemeyer, Niels Gustbel, Richard Townsend.Nt macs' tarfile does not work for platform==mact TarFilet TarInfot
is_tarfilet TarErrort i i t ustart 00id i l t 0t 1t 2t 3t 4t 5t 6t 7t Lt Kt Si i i ` i @ i i i i i i i@ i i i i i i c C s | | | t | t S( s@ Convert a python string to a null-terminated string buffer.
N( t st lengtht lent NUL( R R ( ( t /usr/lib/python2.4/tarfile.pyt stn s c C s, | i d } | d j o | Sn | | S( s? Convert a null-terminated string field to a python string.
R iN( R t findt p( R R ( ( R t nts s
c C s | d t d j o t t | p d d } nJ d } x@ t t | d D]( } | d K} | t | | d 7} qT W| S( s/ Convert a number field to a python number.
i i R i l i N( R t chrt intR t nt xrangeR t it ord( R R R ( ( R t nti s
c C s d | j o d | d j n o d | d | f t } n | o t d n | d j o& t i d t i d | d } n d } x6 t | d D]$ } t | d @ | } | d L} q Wt d
| } | S( s/ Convert a python number to a number field.
i i i s %0*os overflow in number fieldR t lt i i N( R t digitsR R t posixt
ValueErrort structt unpackt packR R R ( R R% R& R R ( ( R t itn s &
& c C sT d } x" | d D] } | t | 7} q Wx" | d D] } | t | 7} q6 W| S( s Calculate the checksum for a member's header. It's a simple addition
of all bytes, treating the chksum field as if filled with spaces.
buf is a 512 byte long string buffer which holds the header.
i i i N( t chkt buft cR! ( R- R. R, ( ( R t calc_chksum s c C sx d t t i d | d t i d | d d ! } d t t i d | d t i d | d d ! } | | f S(
s Calculate the checksum for a member's header by summing up all
characters except for the chksum field which is treated as if
it was filled with spaces. According to the GNU tar sources,
some tars (Sun and NeXT) calculate chksum with signed char,
which will be different if there are chars in the buffer with
the high bit set. So we calculate two checksums, unsigned and
signed.
i t 148Bi t 356Bi i t 148bt 356bN( t sumR( R) R- t unsigned_chksumt
signed_chksum( R- R6 R5 ( ( R t calc_chksums s 77c C s | d j o d Sn | d j o t i | | d Sn d d } t | | \ } } xS t
| D]E } | i | } t | | j o t d n | i | qf W| d j oC | i | } t | | j o t d n | i | n d S( sj Copy length bytes from fileobj src to fileobj dst.
If length is None, copy the entire content.
i Ni i s end of file reached( R t Nonet shutilt copyfileobjt srct dstt BUFSIZEt divmodt blockst remainderR t bt readR- R t IOErrort write( R; R< R R= R? R- RA R@ ( ( R R: s(
R# t -RA t dR. R t rt wR t xt tt Tc C sk g } xU t D]M } xD | D]/ \ } } | | @| j o | i | Pq q W| i d q
Wd i | S( sc Convert a file's mode to a string of the form
-rwxrwxrwx.
Used by TarFile.list()
RE R$ N( t permt filemode_tablet tablet bitt chart modet appendt join( RQ RL RP RN RO ( ( R t filemode s
t /c C s t i i | i t i d S( NRU ( t ost patht normpatht replacet sep( RW ( ( R t <lambda> s c B s t Z d Z RS( s Base exception.( t __name__t
__module__t __doc__( ( ( R R s t ExtractErrorc B s t Z d Z RS( s% General exception for extract errors.( R\ R] R^ ( ( ( R R_ # s t ReadErrorc B s t Z d Z RS( s% Exception for unreadble tar archives.( R\ R] R^ ( ( ( R R` & s t CompressionErrorc B s t Z d Z RS( s. Exception for unavailable compression methods.( R\ R] R^ ( ( ( R Ra ) s t StreamErrorc B s t Z d Z RS( s= Exception for unsupported operations on stream-like TarFiles.( R\ R] R^ ( ( ( R Rb , s t
_LowLevelFilec B s2 t Z d Z d Z d Z d Z d Z RS( s Low-level file object. Supports reading and writing.
It is used instead of a regular file object for streaming
access.
c C sj h d t i <d t i t i Bt i B<| } t t d o | t i O} n t i | | | _ d S( NRG RH t O_BINARY( RV t O_RDONLYt O_WRONLYt O_CREATt O_TRUNCRQ t hasattrRd t opent namet selft fd( Rl Rk RQ ( ( R t __init__9 s 0c C s t i | i d S( N( RV t closeRl Rm ( Rl ( ( R Ro B s c C s t i | i | S( N( RV RB Rl Rm t size( Rl Rp ( ( R RB E s c C s t i | i | d S( N( RV RD Rl Rm R ( Rl R ( ( R RD H s ( R\ R] R^ Rn Ro RB RD ( ( ( R Rc 3 s
t _Streamc B s t Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d d
Z e d Z
d Z d
Z RS( s Class that serves as an adapter between TarFile and
a stream-like object. The stream-like object only
needs to have a read() or write() method and is accessed
blockwise. Use of gzip or bzip2 compression is possible.
A stream-like object could be for example: sys.stdin,
sys.stdout, a socket, a tape device etc.
_Stream is intended to be used only internally.
c C s t | _ | d j o t | | } t | _ n | d j o t
| } | i } n | p d | _ | | _ | | _ | | _ | | _ d | _
d | _ t | _ | d j os y
d k } Wn t j
o t d n X| | _ | i d | _ | d j o | i q*| i n | d j ok y
d k } Wn t j
o t d n X| d j o d | _ | i | _ q| i | _ n d S(
s$ Construct a _Stream object.
t *R$ l t gzNs zlib module is not availableRG t bz2s bz2 module is not available( t TrueRl t _extfileobjt fileobjR8 Rc Rk RQ t Falset comptypet _StreamProxyt getcomptypet bufsizeR- t post closedt zlibt ImportErrorRa t crc32t crct
_init_read_gzt _init_write_gzRt t dbuft BZ2Decompressort cmpt
BZ2Compressor( Rl Rk RQ Ry Rw R| R Rt ( ( R Rn V sF
c C s- t | d o | i o | i n d S( NR~ ( Ri Rl R~ Ro ( Rl ( ( R t __del__ s c C s | i i d | i i | i i | i i d | _ t i d t t
i
} | i d | | i
i d o | i
d | _
n | i | i
t d S( s6 Initialize for writing with gzip compression.
i i s <Ls %ss .gziN( Rl R t compressobjt DEFLATEDt MAX_WBITSt
DEF_MEM_LEVELR R( R* t longt timet timestampt _Stream__writeRk t endswithR ( Rl R ( ( R R s
c C s{ | i d j o | i i | | i | _ n | i t | 7_ | i d j o | i i | } n | i
| d S( s& Write string s to the stream.
Rs t tarN( Rl Ry R R R R R} R R t compressR ( Rl R ( ( R RD s c C sa | i | 7_ xK t | i | i j o1 | i i | i | i | i | i | _ q Wd S( s] Write string s to the stream if a whole new block
is ready to be written.
N( Rl R- R R R| Rw RD ( Rl R ( ( R t __write s c C s
| i o d Sn | i d j o, | i d j o | i | i i 7_ n | i d j o | i oz | i i | i d | _ | i d j oJ | i i t i
d | i d @ | i i t i
d | i d @ q n | i
p | i i n t | _ d S( s[ Close the _Stream object. No operation should be
done on it afterwards.
NRH R R$ Rs s <Ll ( Rl R~ RQ Ry R- R t flushRw RD R( R* R R} Rv Ro Ru ( Rl ( ( R Ro s
#+
c C s | i i | i i | _ d | _ | i d d j o t d n | i d d j o t d n t | i d } | i d | d @o= t | i d d
t | i d } | i | n | d @o< x9 t
o- | i d } | p
| t j o Pq q Wn | d @o< x9 t
o- | i d } | p
| t j o Pq0q0Wn | d @o | i d n d
S( s: Initialize for reading a gzip compressed fileobj.
R$ i s s not a gzip filei s s unsupported compression methodi i i i i N( Rl R t
decompressobjR R R t
_Stream__readR` Ra R! t flagt xlenRB Ru R R ( Rl R R R ( ( R R s4
, c C s | i S( s3 Return the stream's file pointer position.
N( Rl R} ( Rl ( ( R t tell s i c C s~ | | i d j oW t | | i | i \ } } x$ t | D] } | i | i q@ W| i | n
t d | i S( sX Set the stream's file pointer to pos. Negative seeking
is forbidden.
i s seeking backwards is not allowedN(
R} Rl R> R| R? R@ R R RB Rb ( Rl R} R? R R@ ( ( R t seek s
c C s | d j oS g } x7 t o/ | i | i } | p Pn | i | q Wd i | } n | i | } | i
t | 7_
| S( s Return the next size number of bytes from the stream.
If size is not defined, return all bytes of the stream
up to EOF.
R$ N( Rp R8 RJ Ru Rl t _readR| R- RR RS R} R ( Rl Rp RJ R- ( ( R RB s
c C s | i d j o | i | Sn t | i } | i g } x_ | | j oQ | i | i } | p Pn | i
i | } | i | | t | 7} q? Wd i
| } | | | _ | | S( s+ Return size bytes from the stream.
R R$ N( Rl Ry R Rp R R R. RJ R| R- R t
decompressRR RS ( Rl Rp R. RJ R- ( ( R R s
c C s t | i } | i g } xP | | j oB | i i | i } | p Pn | i | | t | 7} q Wd i
| } | | | _ | | S( ss Return size bytes from stream. If internal buffer is empty,
read another block from the stream.
R$ N( R Rl R- R. RJ Rp Rw RB R| RR RS ( Rl Rp R. RJ R- ( ( R t __read s
( R\ R] R^ Rn R R RD R Ro R R R R8 RB R R ( ( ( R Rq K s .
Rz c B s2 t Z d Z d Z d Z d Z d Z RS( ss Small proxy class that enables transparent compression
detection for the Stream interface (mode 'r|*').
c C s" | | _ | i i t | _ d S( N( Rw Rl RB t BLOCKSIZER- ( Rl Rw ( ( R Rn 0 s c C s | i i | _ | i S( N( Rl Rw RB R- ( Rl Rp ( ( R RB 4 s c C s: | i i d o d Sn | i i d o d Sn d S( Ns Rs t BZh91Rt R ( Rl R- t
startswith( Rl ( ( R R{ 8 s
c C s | i i d S( N( Rl Rw Ro ( Rl ( ( R Ro ? s ( R\ R] R^ Rn RB R{ Ro ( ( ( R Rz + s
t _BZ2Proxyc B sW t Z d Z d d Z d Z d Z d Z d Z d Z d Z d Z
RS(
s Small proxy class that enables external file object
support for "r:bz2" and "w:bz2" modes. This is actually
a workaround for a limitation in bz2 module's BZ2File
class which (unlike gzip.GzipFile) has no support for
a file object argument.
i i c C s | | _ | | _ | i d S( N( Rw Rl RQ t init( Rl Rw RQ ( ( R Rn M s c C sa d k } d | _ | i d j o, | i | _ | i i d d | _ n | i | _ d S( Ni RG R$ (
Rt Rl R} RQ R t bz2objRw R R- R ( Rl Rt ( ( R R R s
c C s | i g } t | i } x} | | j oo | i i | i } | p Pn y | i
i | } Wn t
j
o Pn X| i | | t | 7} q Wd i | | _ | i | } | i | | _ | i t | 7_ | S( NR$ ( Rl R- RA R RI Rp Rw RB t blocksizet rawR R t datat EOFErrorRR RS R} ( Rl Rp RA R- R RI R ( ( R RB \ s$
c C s6 | | i j o | i n | i | | i d S( N( R} Rl R RB ( Rl R} ( ( R R p s c C s | i S( N( Rl R} ( Rl ( ( R R u s c C s; | i t | 7_ | i i | } | i i | d S( N( Rl R} R R R R R Rw RD ( Rl R R ( ( R RD x s c C sD | i d j o# | i i } | i i | n | i i d S( NRH ( Rl RQ R R R Rw RD Ro ( Rl R ( ( R Ro } s ( R\ R] R^ R Rn R RB R R RD Ro ( ( ( R R C s
t _FileInFilec B sS t Z d Z e d Z d Z d Z e d Z d Z d Z d Z
RS( s A thin wrapper around an existing file object that
provides a part of its data as an individual file
object.
c C s1 | | _ | | _ | | _ | | _ d | _ d S( Ni ( Rw Rl t offsetRp t sparset position( Rl Rw R Rp R ( ( R Rn s
c C s | i S( s* Return the current file position.
N( Rl R ( Rl ( ( R R s c C s
| | _ d S( s( Seek to a position in the file.
N( R Rl ( Rl R ( ( R R s c C sl | d j o | i | i } n t | | i | i } | i d j o | i | Sn | i | Sd S( s! Read data from the file.
N( Rp R8 Rl R t minR t
readnormalt
readsparse( Rl Rp ( ( R RB s
c C s9 | i i | i | i | i | 7_ | i i | S( s* Read operation for regular files.
N( Rl Rw R R R Rp RB ( Rl Rp ( ( R R s c C s` g } xJ | d j o< | i | } | p Pn | t | 8} | i | q Wd i | S( s) Read operation for sparse files.
i R$ N( R Rp Rl t readsparsesectionR- R RR RS ( Rl Rp R- R ( ( R R s
c C s | i i | i } | d j o d Sn t | | i | i | i } t | t
oQ | i | i | i } | i i
| i | | i | 7_ | i i | Sn | i | 7_ t | Sd S( s0 Read a single section of a sparse file.
R$ N( Rl R R R t sectionR8 R Rp R t
isinstancet _datat realposRw R RB R ( Rl Rp R R ( ( R R s
( R\ R] R^ R8 Rn R R RB R R R ( ( ( R R s
t ExFileObjectc B se t Z d Z d Z d Z e d Z d d Z d Z d Z d d Z
d
Z d Z RS( sa File-like object for reading an archive member.
Is returned by TarFile.extractfile().
i c C sm t | i | i | i t | d d | _ | i | _ d | _
t | _ | i | _ d | _
d | _ d S( NR RG i R$ ( R t tarfileRw t tarinfot offset_dataRp t getattrR8 Rl Rk RQ Rx R~ R t buffer( Rl R R ( ( R Rn s c C s | i o t d n d } | i oD | d j o | i } d | _ qn | i | } | i | | _ n | d j o | | i i 7} n! | | i i | t | 7} | i
t | 7_
| S( s~ Read at most size bytes from the file. If size is not
present or None, read all data until EOF is reached.
s I/O operation on closed fileR$ N( Rl R~ R' R- R Rp R8 Rw RB R R ( Rl Rp R- ( ( R RB s
ic C s9 | i o t d n d | i j o | i i d d } n | i g } x t o | i i | i
} | i | | p
d | j oM d i
| | _ | i i d d } | d j o t | i } n PqS qS W| d j o t | | } n | i | } | i | | _ | i t | 7_ | S( s Read one entire line from the file. If size is present
and non-negative, return a string with at most that
size, which may be an incomplete line.
s I/O operation on closed files
i R$ i iN( Rl R~ R' R R R} t buffersRu Rw RB R R- RR RS R Rp R R ( Rl Rp R- R} R ( ( R t readline s,
c C s> g } x1 t o) | i } | p Pn | i | q W| S( s0 Return a list with all remaining lines.
N( t resultRu Rl R t lineRR ( Rl R R ( ( R t readlines s c C s! | i o t d n | i S( s* Return the current file position.
s I/O operation on closed fileN( Rl R~ R' R ( Rl ( ( R R ' s
i c C s | i o t d n | d j o" t t | d | i | _ n | d j oJ | d j o t | i | d | _ q t | i | | i | _ nC | d j o) t t | i | | i d | _ n
t d d | _ | i
i | i d S( s( Seek to a position in the file.
s I/O operation on closed filei i i s Invalid argumentR$ N( Rl R~ R' t whenceR t maxR} Rp R R Rw R ( Rl R} R ( ( R R / s
"
) c C s
t | _ d S( s Close the file object.
N( Ru Rl R~ ( Rl ( ( R Ro D s c c s/ x( t o | i } | p Pn | Vq Wd S( s/ Get an iterator over the file's lines.
N( Ru Rl R R ( Rl R ( ( R t __iter__I s (
R\ R] R^ R Rn R8 RB R R R R Ro R ( ( ( R R s
c B s t Z d Z d d Z d Z e d Z e d Z d Z d Z
d Z d Z d
Z
d Z d Z d
Z d Z d Z d Z RS( s 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$ c C s | | _ d | _ d | _ d | _ d | _ d | _ d | _ t | _ d | _
d | _ d | _ d | _
d | _ d | _ d | _ d S( sX Construct a TarInfo object. name is the optional name
of the member.
i i R$ t usert groupN( Rk Rl RQ t uidt gidRp t mtimet chksumt REGTYPEt typet linknamet unamet gnamet devmajort devminorR R ( Rl Rk ( ( R Rn ^ s c C s d | i i | i t | f S( Ns <%s %r at %#x>( Rl t __class__R\ Rk t id( Rl ( ( R t __repr__s s c C s t | t j o t d n | i t t j o t d n | } | | _ t | d d ! | _ t
| d d ! | _ t
| d d ! | _ t
| d d ! | _
t
| d d ! | _ t
| d d ! | _ t
| d d
! | _ | d
d !| _ t | d d ! | _ t | d
d ! | _ t | d d ! | _ t
| d d ! | _ t
| d d ! | _ t | d d ! } | o& | i o | d | i | _ n | i t | j o t d n | S( sB Construct a TarInfo object from a 512 byte string buffer.
s truncated headers empty headeri id il it i| i i i i i i i) iI iQ iY i RU s invalid headerN( R R- R R' t countR t clsR R Rk R" RQ R R Rp R R R R R R R R t prefixt issparseR7 ( R R- R R ( ( R t frombufv s4 c C s+ d } | i } d } | i i d o
t } n | t t f j o
| i } n t | i } | t j o | d 7} n | i
} | o t | } n | o | i t
j o t d n t | i
t j o t d t n t | t j o | t d } x' | o | d d j o | d } qW| t | } | d } | p t | t j o t d qqna t | i
t j o | | i | i
t 7} n t | t j o | | i | t 7} n t | d t | i d @d
| t | i d
| t | i d
| t | i d | t | i d | d | t | i
d t t d
t t d t | i d t | i d t | i d
| t | i d
| t | d g } | d i! | i" t# t$ 7} t% | t# d } | d d | | d } | | _ | S( s< Return a tar header as a string of 512 byte blocks.
R$ RU s file is too large (>= 8 GB)s linkname is too long (>%d)i is name is too longid i i i s i i i i i is %06o iN(' R- Rl R R Rk R t DIRTYPEt GNUTYPE_LONGNAMEt GNUTYPE_LONGLINKRX R R& Rp t MAXSIZE_MEMBERR' R t LENGTH_LINKt LENGTH_NAMEt
LENGTH_PREFIXt _create_gnulongR R+ RQ R R R t MAGICt VERSIONR R R R t partsRS t ljustR R R7 R ( Rl R& R R R R R R- Rk ( ( R t tobuf sL
c C s | t 7} | i } d | _ | | _ d | _ t | | _ | i } | | 7} t t | t \ } } | d j o | t | t 7} n | S( s Create a GNU longname/longlink header from name.
It consists of an extended tar header, with the length
of the longname as size, followed by data blocks,
which contain the longname as a null terminated string.
s
././@LongLinki N( Rk R Rl R R R RQ R Rp R R- R> R R? R@ ( Rl Rk R R? R- R@ R ( ( R R s
c C s
| i t j S( N( Rl R t
REGULAR_TYPES( Rl ( ( R t isreg s c C s
| i S( N( Rl R ( Rl ( ( R t isfile s c C s
| i t j S( N( Rl R R ( Rl ( ( R t isdir s c C s
| i t j S( N( Rl R t SYMTYPE( Rl ( ( R t issym s c C s
| i t j S( N( Rl R t LNKTYPE( Rl ( ( R t islnk s c C s
| i t j S( N( Rl R t CHRTYPE( Rl ( ( R t ischr s c C s
| i t j S( N( Rl R t BLKTYPE( Rl ( ( R t isblk s c C s
| i t j S( N( Rl R t FIFOTYPE( Rl ( ( R t isfifo s c C s
| i t j S( N( Rl R t GNUTYPE_SPARSE( Rl ( ( R R s c C s | i t t t f j S( N( Rl R R R R ( Rl ( ( R t isdev s ( R\ R] R^ Rn R t classmethodR Rx R R R R R R R R R R R R ( ( ( R R V s ! K c B s
t Z d Z d Z e Z e Z d Z e Z e Z
e d e d Z e
e d e d d d Z e
d e d Z e
d e d d Z e
d e d d
Z h d d <d
d <d d <Z d Z d Z d Z d Z e e e d Z e d Z e e d Z e d Z d e d Z d d Z d Z d Z d Z d Z! d! Z" d" Z# d# Z$ d$ Z% d% Z& d& Z' d' Z( d( Z) d) Z* d* Z+ d+ Z, d, Z- d- Z. e d. Z/ d/ Z0 e d0 Z1 d1 Z2 d2 Z3 RS(3 s= The TarFile Class provides an interface to tar archives.
i RG c C s t | d j p
| d j o t d n | | _ h d d <d d <d d <| | _ | p t | | i } t | _ nT | d j o t | d
o
| i } n t | d o | i | _ n t | _ | o t
i i | | _ n
d | _ | | _ t | _ g | _ t | _ | i i | _ h | _ | i d j o d | _ | i | _ n | i d j oy d | _ xm t oa y | i } Wn$ t j
o | i i d Pn X| d j o | i i t d PqqWn | i d
j o
t | _ n d S( s 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.
i R s mode must be 'r', 'a' or 'w'RG t rbt as r+bRH t wbRk RQ i t awN( R RQ R' Rl t _modeRw t fileRk Rx Rv R8 Ri Ru RV RW t abspathR~ t memberst _loadedR R t inodest firstmembert nextR R` R R ( Rl Rk RQ Rw R ( ( R Rn $ sN (
i i c
C s' | o | o t d n | d j o x | i D] } t | | i | } | d j o | i
} n y | | d | SWq7 t t
f j
o( | d j o | i | q7 q7 q7 Xq7 Wt d nCd | j o | i d d \ } } | p d } | p d } | | i j o t | | i | } n t
d | | | | | Sn d | j o | i d d \ } } | p d } | p d } | d
j o t d n | | | t | | | | | } t | _ | Sn% | d j o | i | | | Sn t d
d S( s\ 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
'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
s nothing to openRG s r:*s% file could not be opened successfullyt :i R s unknown compression type %rt |t rws mode must be 'r' or 'w'R s undiscernible modeN( RG s r:*( Rk Rw R' RQ R t OPEN_METHRy R t funcR8 R t saved_posR` Ra R t splitRT Rq R| RJ Rx Rv t taropen(
R Rk RQ Rw R| R R Ry RT RJ ( ( R Rj j sJ
c C s@ t | d j p
| d j o t d n | | | | S( sC Open uncompressed tar archive name for reading or writing.
i R s mode must be 'r', 'a' or 'w'N( R RQ R' R Rk Rw ( R Rk RQ Rw ( ( R R
s i c C s t | d j p
| d j o t d n y d k } | i Wn% t t f j
o t d n X| d j o t
| | d } n y+ | i
| | | i | | | | } Wn t j
o t d n Xt | _ | S( sk Open gzip compressed tar archive name for reading or writing.
Appending is not allowed.
i R s mode must be 'r' or 'w'Ns gzip module is not availableRA s not a gzip file( R RQ R' t gzipt GzipFileR t AttributeErrorRa Rw R8 R Rk R R
t
compresslevelRJ RC R` Rx Rv ( R Rk RQ Rw R RJ R ( ( R t gzopen s"
c C s t | d j p
| d j o t d n y
d k } Wn t j
o t d n X| d j o t | | } n | i | | d | } y | i
| | | } Wn t j
o t d n Xt | _ | S( sl Open bzip2 compressed tar archive name for reading or writing.
Appending is not allowed.
i R s mode must be 'r' or 'w'.Ns bz2 module is not availableR s not a bzip2 file( R RQ R' Rt R Ra Rw R8 R t BZ2FileRk R R R
RJ RC R` Rx Rv ( R Rk RQ Rw R RJ Rt ( ( R t bz2open s
R R
Rs R Rt R c C s | i o d Sn | i d j op | i i t t d | i t d 7_ t | i t \ } } | d j o | i i t t | q n | i p | i i
n t | _ d S( sl Close the TarFile. In write-mode, two finishing zero blocks are
appended to the archive.
NR i i ( Rl R~ R Rw RD R R R R> t
RECORDSIZER? R@ Rv Ro Ru ( Rl R? R@ ( ( R Ro s
c C s4 | i | } | d j o t d | n | S( s 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 occurence is assumed to be the
most up-to-date version.
s filename %r not foundN( Rl t
_getmemberRk R R8 t KeyError( Rl Rk R ( ( R t getmember
s
c C s) | i | i p | i n | i S( s Return the members of the archive as a list of TarInfo objects. The
list has the same order as the members in the archive.
N( Rl t _checkR t _loadR ( Rl ( ( R t
getmembers s
c C s( g } | i D] } | | i q ~ S( s Return the members of the archive as a list of their names. It has
the same order as the list returned by getmembers().
N( t _[1]Rl R R Rk ( Rl R R ( ( R t getnames s c C s | i d | d j o
| i } n | d j o
| } n t | } t i i | \ } } x# | d d !d j o | d } qe Wt }
| d j oA t
t d o | i o t i | } q t i | } n t i | i } d } | i } t i | oz | i | i f } | i o7 | i d j o' | | i j o t } | i | } qAt } | d o | | i | <qAn t i | o) t! } | d d j o | d 7} qAn| t i" | o
t# } nb t i$ | o t% } t i& | } n9 t i' | o
t( } n t i) | o
t* } n d S| |
_ | |
_+ | i, |
_- | i. |
_/ t i | o | i0 |
_1 n
d |
_1 | i2 |
_3 | |
_ | |
_ t4 o7 y t4 i5 |
i- d |
_6 Wqt7 j
o qXn t8 o7 y t8 i9 |
i/ d |
_: Wq.t7 j
o q.Xn | t( t* f j oR t
t d o> t
t d
o. t i; | i< |
_= t i> | i< |
_? qn |
S( sO 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 i i RU t lstatR$ il t majort minorN(@ Rl R Rw R8 Rk t arcnameRX RV RW t
splitdrivet drvR R Ri t dereferenceR t statrest statt fstatt filenoR t st_modet stmdt S_ISREGt st_inot st_devt inodet st_nlinkR R R R t S_ISDIRR t S_ISFIFOR t S_ISLNKR t readlinkt S_ISCHRR t S_ISBLKR RQ t st_uidR t st_gidR t st_sizeRp t st_mtimeR t pwdt getpwuidR R t grpt getgrgidR R t st_rdevR R R ( Rl Rk R Rw R R+ R R" R R' R ( ( R t
gettarinfo% s
+
c C s | i x | D] } | o t | i Gd | i p | i | i p | i f G| i
p
| i o d d | i | i
f Gn d | i Gd t i | i d Gn | i G| o< | i o d G| i Gn | i o d G| i Gq n Hq Wd S(
s Print 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.
s %s/%ss %10ss %d,%ds %10ds %d-%02d-%02d %02d:%02d:%02di s ->s link toN( Rl R R t verboseRT RQ R R R R R R R R Rp R t localtimeR Rk R R R ( Rl R= R ( ( R t list s$
(
c C s | i d | d j o
| } n | i d j o8 t i i | | i j o | i d d | d Sn | d j oc | oT | d j o
d } n x: t i
d D]% } | i | t i i
| | q Wn d Sn | i d | | i | | } | d j o | i d d | d Sn | i o- t | d } | i | | | i n | i od | i | | oL xI t i
| D]4 } | i t i i
| | t i i
| | qWqn | i | d S(
sQ 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.
R i s tarfile: Skipped %rNt .R$ i s tarfile: Unsupported type %rR ( Rl R R R8 Rk RV RW R t _dbgt recursivet listdirt ft addRS R< R R R t addfileRo R ( Rl Rk R RB RD R ( ( R RE s>
,
'
:c C s | i d t i | } | i | i } | i i | | i t
| 7_ | d j ox t | | i | i
t | i
t \ } } | d j o& | i i t t | | d 7} n | i | t 7_ n | i i | d S( s] 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 i i N( Rl R t copyR R R& R- Rw RD R R R8 R: Rp R> R R? R@ R R RR ( Rl R Rw R? R@ R- ( ( R RF s
R@ c C s2 g } | d j o
| } n xT | D]L } | i o) | i | t i | } d | _ n | i | | q$ W| i d | i x | D] } t
i
i | | i } y4 | i | | | i | | | i | | Wq t j
o4 } | i d j o q*| i d d | q Xq Wd S( sM 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().
i c C s t | i | i S( N( R R Rk RA ( R RA ( ( R R[ s i s tarfile: %sN( t directoriesR R8 Rl R R RR RG RQ t extractRW t sortt reverseRV RS Rk t dirpatht chownt utimet chmodR_ t et
errorlevelRA ( Rl RW R RP RL RH R ( ( R t
extractall s0
R$ c C sE | i d t | t o
| } n | i | } | i o t i i
| | i | _ n y& | i
| t i i
| | i Wn t j
ok } | i d j o qA| i d j o | i d d | i qA| i d d | i | i f nA t j
o4 } | i d j o qA| i d d | n Xd S( s# 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'.
RG i i s tarfile: %ss tarfile: %s %rN( Rl R R t memberR R R R RV RW RS R t _link_targett _extract_memberRk t EnvironmentErrorRP RQ t filenameR8 RA t strerrorR_ ( Rl RS RW RP R ( ( R RI s&
&$c C s | i d t | t o
| } n | i | } | i o | i | | Sn | i t
j o | i | | Snb | i p
| i oC t | i
t o t d q | i | i | i | Sn d Sd S( s 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()
RG s' cannot extract (sym)link as file objectN( Rl R R RS R R R R t
fileobjectR t SUPPORTED_TYPESR R Rw Rq Rb t extractfileR R R8 ( Rl RS R ( ( R R[ 9 s
c C s | d d j o | d } n t i i | } t i i | } | o% t i i | o t i | n | i p
| i
o$ | i d d | i
| i f n | i d | i
| i o | i | | n | i o | i | | n | i o | i | | n | i p
| i o | i | | nc | i p
| i
o | i | | n5 | i t j o | i | | n | i | | | i | | | i
p$ | i | | | i | | n d S( s\ Extract the TarInfo object tarinfo to a physical
file called targetpath.
iRU i s %s -> %sN( t
targetpathRV RW RX t dirnamet upperdirst existst makedirsR R R Rl RA Rk R R t makefileR t makedirR t makefifoR R t makedevt makelinkR RZ t makeunknownRM RO RN ( Rl R R\ R^ ( ( R RU ` s6 $
c C sJ y t i | d Wn/ t j
o# } | i t i j o qF n Xd S( s, Make a directory called targetpath.
i N( RV t mkdirR\ RV RP t errnot EEXIST( Rl R R\ RP ( ( R Rb s c C sC | i | } t | d } t | | | i | i d S( s' Make a file called targetpath.
R N( Rl R[ R t sourceR R\ t targetR: Ro ( Rl R R\ Rk Rj ( ( R Ra s
c C s+ | i | | | i d d | i d S( sY Make a file from a TarInfo object with an unknown type
at targetpath.
i s9 tarfile: Unknown file type %r, extracted as regular file.N( Rl Ra R R\ RA R ( Rl R R\ ( ( R Rf s c C s1 t t d o t i | n
t d d S( s' Make a fifo called targetpath.
t mkfifos fifo not supported by systemN( Ri RV Rl R\ R_ ( Rl R R\ ( ( R Rc s c C s t t d p t t d o t d n | i } | i o | t i O} n | t i O} t i | | t i | i | i
d S( s< Make a character or block device called targetpath.
t mknodRd s' special devices not supported by systemN( Ri RV R_ R RQ R R# t S_IFBLKt S_IFCHRRm R\ Rd R R ( Rl R R\ RQ ( ( R Rd s "
c C s! | i } y8 | i o t i | | n t i | i | Wn t j
o | i o4 t i
i t i
i | i
| } t | } n y | i | i | | Wq t t f j
oS } t i
i | } y t i | | Wqt j
o } t d qXq Xn Xd S( s Make a (symbolic) link called targetpath. If it cannot be created
(platform limitation), we try to make a copy of the referenced file
instead of a link.
s link could not be createdN( R R t linkpathR RV t symlinkR\ t linkRT R
RW RS R] Rk RX Rl RU R RV R RP R9 t copy2RC ( Rl R R\ RP Rp ( ( R Re s&
c C s t ot t d ort i d j o_y t i | i d } WnO t j
oC y t i
| i d } Wq t j
o t i } q Xn Xy t i
| i d } WnO t j
oC y t i | i d } Wqt j
o t i } qXn Xy_ | i o' t t d o t i | | | n( t i d j o t i | | | n Wqt j
o } t d qXn d S( s6 Set owner of targetpath according to tarinfo.
t geteuidi i t lchownt os2emxs could not change ownerN( R7 Ri RV Rt R9 t getgrnamR R t gR R: R t getgidt getpwnamR t uR8 R t getuidR Ru R\ t syst platformRM RV RP R_ ( Rl R R\ RP Rx R{ ( ( R RM s. * c C sS t t d o? y t i | | i WqO t j
o } t d qO Xn d S( sA Set file permissions of targetpath according to tarinfo.
RO s could not change modeN( Ri RV RO R\ R RQ RV RP R_ ( Rl R R\ RP ( ( R RO s c C s t t d p d Sn t i d j o | i o d Sn y t i | | i | i f Wn! t j
o } t d n Xd S( sB Set modification time of targetpath according to tarinfo.
RN Nt win32s" could not change modification time( Ri RV R} R~ R R RN R\ R RV RP R_ ( Rl R R\ RP ( ( R RN s c C s | i d | i d j o | i } d | _ | Sn | i i | i x t o | i i t
} | p d Sn y= t i
| } | i | _ | i t
7_ | i | } Wnz t j
on } | i o3 | i d d | i | f | i t
7_ qM q/| i d j o t d | n d Sn XPqM W| i o | i i d o
t | _ n | i o' | i i d o | i d 7_ n | i i | | S( s Return the next member of the archive as a TarInfo object, when
TarFile is opened for reading. Return None if there is no more
available.
t rai s 0x%X: empty or invalid block: %si s( empty, unreadable or compressed file: %sRU N( Rl R R R8 t mRw R R Ru RB R R- R R R t proc_memberR' RP t ignore_zerosRA R` R Rk R R R R R RR ( Rl RP R R- R ( ( R R s@
!c C sY | i t t f j o | i | Sn/ | i t j o | i | Sn | i | Sd S( se Choose the right processing method for tarinfo depending
on its type and call it.
N( R R R R Rl t proc_gnulongR t proc_sparset proc_builtin( Rl R ( ( R R T s c C sL | i | _ | i p | i t j o | i | i | i 7_ n | S( so Process a builtin type member or an unknown member
which will be treated as a regular file.
N( Rl R R R R R RZ t _blockRp ( Rl R ( ( R R _ s
c C s d } | i } xG | d j o9 | i i t } | | 7} | i t 7_ | t 8} q W| i i t } t i | } | i | _ | i t 7_ | i | } | i | _ | i t j o t | | _ n$ | i t j o t | | _ n | S( sS Process the blocks that hold a GNU longname
or longlink member.
R$ i N( R- R Rp R Rl Rw RB R t blockR RA R R RJ R R R R R Rk R R ( Rl R R RA R R- R RJ ( ( R R i s(
c C s | i } t } d } d } d } x t d D] } y6 t | | | d ! } t | | d | d ! } Wn t j
o Pn X| | j o | i
t | | | n | i
t | | | | | 7} | | } | d 7} q1 Wt | d }
t | d d ! } x|
d j o| i i t } | i
t 7_
d
} x t d D] } y6 t | | | d ! } t | | d | d ! } Wn t j
o Pn X| | j o | i
t | | | n | i
t | | | | | 7} | | } | d 7} qQWt | d }
qW| | j o | i
t | | | n | | _ | i
| _ | i
| i | i 7_
| | _ | S( s8 Process a GNU sparse header plus extra headers.
i l i i i i i i i i i i N( R R- t _ringbuffert spR} t lastposR R R R" R t numbytesR' RR t _holeR R! t
isextendedt origsizeRl Rw RB R R R R Rp ( Rl R R R R R R R} R R R R- ( ( R R s^
c C s2 t | t \ } } | o | d 7} n | t S( s_ Round up a byte count by BLOCKSIZE and return it,
e.g. _block(834) => 1024.
i N( R> R R R? R@ ( Rl R R? R@ ( ( R R s
c C s} | i } | d j o t | } n | i | } x> t | d d d D]& } | | | i
j o | | SqO qO Wd S( s} Find an archive member by name from bottom to top.
If tarinfo is given, it is used as the starting point.
i iN( Rl R R R R8 R t endt indexR R Rk ( Rl Rk R R R R ( ( R R s
c C s: x* t o" | i } | d j o Pq q Wt | _ d S( sW Read through the entire archive file and look for readable
members.
N( Ru Rl R R R8 R ( Rl R ( ( R R s
c C s\ | i o t d | i i n | d j o' | i | j o t d | i n d S( sn Check if TarFile is still open, and if the operation's mode
corresponds to TarFile's mode.
s %s is closeds bad operation for mode %rN( Rl R~ RC R R\ RQ R8 R ( Rl RQ ( ( R R s
c C s) | i o t | i Sn t | Sd S( s$ Provide an iterator object.
N( Rl R t iterR t TarIter( Rl ( ( R R s
c C s% | | i j o t i | IJn d S( s. Write debugging output to sys.stderr.
N( t levelRl t debugR} t stderrt msg( Rl R R ( ( R RA s (4 R\ R] R^ R Rx R! R RQ R& R RY R8 Rn R Rj R
R R R Ro R R R R< Ru R? RE RF RR RI R[ RU Rb Ra Rf Rc Rd Re RM RO RN R R R R R R R R R R RA ( ( ( R R sZ F H!
d 3 % ! ' 0 B
<
R c B s) t Z d Z d Z d Z d Z RS( sM Iterator Class.
for tarinfo in TarFile(...):
suite...
c C s | | _ d | _ d S( s$ Construct a TarIter object.
i N( R Rl R ( Rl R ( ( R Rn s c C s | S( s Return iterator object.
N( Rl ( Rl ( ( R R s c C s | i i p0 | i i } | p t | i _ t qp n4 y | i i | i } Wn t j
o
t n X| i d 7_ | S( s Return the next item using TarFile's next() method.
When all members have been read, set TarFile as _loaded.
i N(
Rl R R R R Ru t
StopIterationR R t
IndexError( Rl R ( ( R R
s
( R\ R] R^ Rn R R ( ( ( R R s t _sectionc B s t Z d Z d Z d Z RS( s$ Base class for _data and _hole.
c C s | | _ | | _ d S( N( R Rl Rp ( Rl R Rp ( ( R Rn % s c C s( | i | j o | i | i j n S( N( Rl R Rp ( Rl R ( ( R t __contains__( s ( R\ R] R^ Rn R ( ( ( R R " s R c B s t Z d Z d Z RS( s/ Represent a data section in a sparse file.
c C s t i | | | | | _ d S( N( R Rn Rl R Rp R ( Rl R Rp R ( ( R Rn . s ( R\ R] R^ Rn ( ( ( R R + s R c B s t Z d Z RS( s/ Represent a hole section in a sparse file.
( R\ R] R^ ( ( ( R R 2 s R c B s t Z d Z d Z d Z RS( sM Ringbuffer class which increases performance
over a regular list.
c C s
d | _ d S( Ni ( Rl t idx( Rl ( ( R Rn ; s c C s | i } xg t o_ | | } | | j o Pn | d 7} | t | j o
d } n | | i j o d Sq q W| | _ | S( Ni i ( Rl R Ru t itemR R R8 ( Rl R R R ( ( R R = s
( R\ R] R^ Rn R ( ( ( R R 7 s i t
TarFileCompatc B st t Z d Z d e d Z d Z d Z d Z d Z d Z d Z
e e d Z d
Z
d Z RS( sR TarFile class compatible with standard module zipfile's
ZipFile class.
RG c C s | t j o t i | | | _ n3 | t j o t i | | | _ n
t
d | d d !d j oU | i i } xC | D]7 } | i | _ | i | _ t i | i d | _ q Wn d S( Ns unknown compression constanti i RG i ( t compressiont TAR_PLAINR R
R RQ Rl R t TAR_GZIPPEDR R' R R R Rk RW Rp t file_sizeR t gmtimeR t date_time( Rl R RQ R R R ( ( R Rn U s
c C s t d | i S( Nc C s | i S( N( R Rk ( R ( ( R R[ c s ( t mapRl t infolist( Rl ( ( R t namelistb s c C s t d | i i S( Nc C s
| i t j S( N( R R R ( R ( ( R R[ e s ( t filterRl R R ( Rl ( ( R R d s c C s | i i d S( N( Rl R R? ( Rl ( ( R t printdirg s c C s d S( N( ( Rl ( ( R t testzipi s c C s | i i | S( N( Rl R R Rk ( Rl Rk ( ( R t getinfok s c C s" | i i | i i | i S( N( Rl R R[ R Rk RB ( Rl Rk ( ( R RB m s c C s | i i | | d S( N( Rl R RE RW R ( Rl RW R t
compress_type( ( R RD o s c C s y d k l } Wn t j
o d k l } n Xd k } | i | _ | i | _ | i | i
| _ | i
i | | | d S( N( s StringIO( t cStringIOt StringIOR t calendart zinfoRW Rk R Rp t timegmR R Rl R RF t bytes( Rl R R R R ( ( R t writestrq s c C s | i i d S( N( Rl R Ro ( Rl ( ( R Ro { s ( R\ R] R^ R Rn R R R R R RB R8 RD R Ro ( ( ( R R Q s
c C s< y t | } | i t SWn t j
o t Sn Xd S( sf Return True if name points to a tar archive that we
are able to handle, else return False.
N( Rj Rk RJ Ro Ru R Rx ( Rk RJ ( ( R R s
(e R^ t __version__t versiont
__author__t __date__t __cvsid__t __credits__R} RV R9 R# Rh R R( RG R~ R R9 R7 R8 t __all__R R R R R R R R R R t AREGTYPER R R R R R t CONTTYPER R R RZ R t S_IFLNKt S_IFREGRn t S_IFDIRRo t S_IFIFOt TSUIDt TSGIDt TSVTXt TUREADt TUWRITEt TUEXECt TGREADt TGWRITEt TGEXECt TOREADt TOWRITEt TOEXECR R R" Rx R+ R/ R7 R: RM RT RZ RX RW t ExceptionR R_ R` Ra Rb Rc Rq t objectRz R R R R R R R R R R? R R R R R Rj ([ R+ Ra R( R R Rc R R Rq R R R R Ro R7 R R R R Rb Rz R R R R R R: R R Rn R R R R R R/ R R R" R` RM R R RV R R R R R Rj R R R Rh R R R RZ R R7 R R RG R R RT R R9 R R R R_ R R R R# R R R} R R R R R R9 R R RX R R R ( ( R t ? s
*
DL % 1