WjJ d Z dZdZdZddlmZ ddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlZddlZddlZ ddlZ ddlZeeefZg dZdZd Zd
Zd Z e d z Z d
Z dZ dZ dZ!dZ"dZ#d
Z$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.d Z/d Z0d Z1dZ2d Z3d Z4e4Z5e#e$e%e&e)e*e+e'e(e,e-e.f Z6e#e$e+e.fZ7e,e-e.fZ8d!Z9h d"Z:e;e;e;e d?eN ZQ G d@ dAeN ZR G dB dCeN ZS G dD dE ZT G dF dG ZU G dH dIeV ZW G dJ dKeV ZX G dL dMe j ZZ G dN dOeI Z[ G dP dQe[ Z\ G dR dSe[ Z] G dT dUe[ Z^ G dV dWe[ Z_ G dX dYe[ Z` G dZ d[e[ Zae[eeJfZbdid\Zcd] Zdd^ Zed_ Zfedeeefd`Zg eV Zh ej da Zj G db dceV Zk G dd deeV Zldf Zmelj
Zdg Zneodhk( r en yy# e$ r dZY (w xY w# e$ r dZY 1w xY w)jz,Read from and write to tar format archives.
z0.9.0u" Lars Gustäbel (lars@gustaebel.de)u4 Gustavo Niemeyer, Niels Gustäbel, Richard Townsend. )openN)TarFileTarInfo
is_tarfileTarError ReadErrorCompressionError StreamError ExtractError HeaderErrorENCODING USTAR_FORMAT
GNU_FORMAT
PAX_FORMATDEFAULT_FORMATr fully_trusted_filter data_filter
tar_filter FilterErrorAbsoluteLinkErrorOutsideDestinationErrorSpecialFileErrorAbsolutePathErrorLinkOutsideDestinationErrorTz/etc/python/tarfile.cfg i s ustar s ustar 00d 0 1 2 3 4 5 6 7 L K S x g X )pathlinkpathsizemtimeuidgidunamegname> r/ r6 r5 r0 )atimectimer2 r3 r4 r1 ntutf-8c v | t d | j || } | d| |t | z
t z z S )z8Convert a string to a null-terminated bytes object.
Nz metadata cannot contain None)
ValueErrorencodelenNUL)slengthencodingerrorss /usr/lib64/python3.12/tarfile.pystnrE sC y788 6"A Wf:#a& C/ // c \ | j d }|dk7 r| d| } | j || S )z8Convert a null-terminated bytes object to a string.
r N)finddecode)r@ rB rC ps rD ntsrL s4
u
ABw
bqE 88Hf %%rF c 6 | d dv rMd}t t | dz
D ] }|dz }|| |dz z
} | d dk( rdt | dz
z |z
}|S t | dd } t | j xs d d }|S # t
$ r t
d
w xY w) z/Convert a number field to a python number.
r ) r- rO asciistrict0invalid header)ranger> rL intstripr< InvalidHeaderError)r@ nis rD ntir\ s
t~
s1vz"A
!GA
1q5MA #
Q45=#a&1*%)*A
H 7Aw)AAGGI$a(A
H 7$%56 6 7s +B BrP c | }t | } d| cxk r d|dz
z k r n n t d|dz
| fz d t z }|S |t k( rzd|dz
z | cxk r d|dz
z k rbn t d | dk\ r
t dg }nt dg }d|z | z } t |dz
D ] }|j
d| dz | dz } |S t d )
z/Convert a python number to a number field.
r rP r- z%0*orR rQ rN rO zoverflow in number field)rW bytesr? r bytearrayrV insertr< )rZ digitsformat
original_nr@ r[ s rD itnrd s J AAA!fqj!! &FQJ?*G 4s :
H
: 36A:#6"6!"Qcfqj>Q"Q 344
65'"A5'"Av
!Avz"A
HHQE "
!GA #
H 344rF c dt t j d| z }dt t j d| z }||fS )a 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.
rQ
148B8x356B
148b8x356b)sumstruct unpack_from)bufunsigned_chksum
signed_chksums rD calc_chksumsrn sG C 2 2< E FFO#f 0 0 s CDDM M ))rF c x |xs d}|dk( ry|t j | || yt || \ }}t | D ]: }| j | }t | |k r |d |j
| < |dk7 r8| j | }t | |k r |d |j
| y)zjCopy length bytes from fileobj src to fileobj dst.
If length is None, copy the entire content.
i @ r Nunexpected end of data)shutil copyfileobjdivmodrV readr> write) srcdstrA exceptionbufsizeblocks remainderbrk s rD rr rr s "G
{
~3W- vw/FI
6]hhw s8g 45 5 # A~hhy! s8i 45 5 #
rF c t t j dd }|!| j |d j | } t | d y )NrB backslashreplace )end)getattrsysstdoutr= rJ print)r@ rB s rD _safe_printr s@ szz:t4H
HHX 1 2 9 9( C !rF c e Zd ZdZy)r zBase exception.N__name__
__module__ __qualname____doc__ rF rD r r s rF r c e Zd ZdZy)r z%General exception for extract errors.Nr r rF rD r r s /rF r c e Zd ZdZy)r z&Exception for unreadable tar archives.Nr r rF rD r r s 0rF r c e Zd ZdZy)r z.Exception for unavailable compression methods.Nr r rF rD r r s 8rF r c e Zd ZdZy)r
z=Exception for unsupported operations on stream-like TarFiles.Nr r rF rD r
r
! s GrF r
c e Zd ZdZy)r z!Base exception for header errors.Nr r rF rD r r $ s +rF r c e Zd ZdZy)EmptyHeaderErrorz Exception for empty headers.Nr r rF rD r r ' s &rF r c e Zd ZdZy)TruncatedHeaderErrorz Exception for truncated headers.Nr r rF rD r r * s *rF r c e Zd ZdZy)EOFHeaderErrorz"Exception for end of file headers.Nr r rF rD r r - s ,rF r c e Zd ZdZy)rY z Exception for invalid headers.Nr r rF rD rY rY 0 s (rF rY c e Zd ZdZy)SubsequentHeaderErrorz3Exception for missing and invalid extended headers.Nr r rF rD r r 3 s =rF r c ( e Zd ZdZd Zd Zd Zd Zy)
_LowLevelFilezLow-level file object. Supports reading and writing.
It is used instead of a regular file object for streaming
access.
c t j t j t j z t j z d| }t t d r|t j z }t j ||d | _ y )NrwO_BINARYi ) osO_RDONLYO_WRONLYO_CREATO_TRUNChasattrr r fd)selfnamemodes rD __init__z_LowLevelFile.__init__@ sa rzz)BJJ6
2z " BKK D''$e,rF c B t j | j y N)r closer r s rD r z_LowLevelFile.closeI s
rF c B t j | j | S r )r rt r r r1 s rD rt z_LowLevelFile.readL s wwtww%%rF c D t j | j | y r )r ru r r r@ s rD ru z_LowLevelFile.writeO s
! rF N)r r r r r r rt ru r rF rD r r : s
-& rF r c Z e Zd ZdZd Zd Zd Zd Zd Zd Z d Z
d Z dd
Z d Z
d Zd
Zy)_Streama 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 that works with bytes,
and the method is accessed blockwise.
Use of gzip or bzip2 compression is possible.
A stream-like object could be for example: sys.stdin.buffer,
sys.stdout.buffer, a socket, a tape device etc.
_Stream is intended to be used only internally.
c d| _ |t || }d| _ |dk( rt | }|j }|xs d| _ || _ || _ || _ || _ d| _ d| _
d| _ |dk( r[ ddl }|| _ |j d | _ |d
k( r"|j" | _ | j' y| j) | y|d k( rI ddl}|d
k( r(d| _ |j/ | _ t2 | _ y|j5 | | _ y|d
k( rN ddl} |d
k( r.d| _ | j9 | _ | j: | _ y| j= | _ y|dk7 rt d|z y# t $ r
t d dw xY w# t $ r
t d dw xY w# t $ r
t d dw xY w# | j s| j j? d| _ xY w)z$Construct a _Stream object.
TNF* rF r gzz zlib module is not availabler bz2bz2 module is not availablexz lzma module is not availabletarunknown compression type %r) _extfileobjr _StreamProxy getcomptyper r comptypefileobjry rk posclosedzlib ImportErrorr crc32crcerrorrx
_init_read_gz_init_write_gzr dbufBZ2DecompressorcmpOSError
BZ2CompressorlzmaLZMADecompressor LZMAErrorLZMACompressorr )
r r r r r ry
compresslevelr r r s
rD r z_Stream.__init__^ s ?#D$/G $D s? #7+G **,H
- 4 U ! ::c?3;%)ZZDN&&(''
6U"T 3; #DI " 2 2 4DH%,DN " 0 0 ?DHT!U 3; #DI # 4 4 6DH%)^^DN # 2 2 4DHU"&'Dx'OPP #E # U*+IJPTTU # T*+HItST # U*+IJPTTU ## ""$ DK sy :G F AG G G F( $,G G (G .G 22G %G ;G F%%G (F>>G GG 0H
c X t | d r | j s| j y y y )Nr )r r r r s rD __del__z_Stream.__del__ s# 4 "4;; JJL ,7 "rF c t | j j || j j | j j | j j d | _ t
j dt t j }| j d|z dz | j j d r| j dd | _ t j j | j | _ | j | j j! dd t" z y)
z6Initialize for writing with gzip compression.
r DErF c * | j dk( r+| j j || j | _ | xj t | z
c_ | j dk7 r| j j | }| j | y)z&Write string s to the stream.
r r N) r r r r r r> r compressr r s rD ru z
_Stream.write sg ==D yyq$((3DH CF ==E !!!!$A QrF c Z | xj |z
c_ t | j | j kD rt| j j | j d| j | j | j d | _ t | j | j kD rsyy)z]Write string s to the stream if a whole new block
is ready to be written.
N)rk r> ry r ru r s rD __writez_Stream.__write sr
A
$((mdll* LL txx
6 7xx
.DH $((mdll*rF c | j ryd| _ | j dk( r<| j dk7 r-| xj | j j z
c_ | j dk( r| j r| j j | j d| _ | j dk( ru| j j t j d| j | j j t j d| j dz | j s| j j yy# | j s| j j w w xY w) z[Close the _Stream object. No operation should be
done on it afterwards.
NTr r rF r r l )r r r rk r flushr ru ri r r r r r r s rD r z
_Stream.close s ;; %yyC DMMU$:DHHNN ,,yyC DHH ""488, ==D(LL&&v{{4'BCLL&&v{{4J9N'OP## ""$ $4## ""$ $s DE )E=c | j j | j j | _ d| _ | j d dk7 r t
d | j d dk7 r t d t | j d }| j d |d z rIt | j d d
t | j d z z }| j | |d z r | j d }|r |t k( rn |d z r | j d }|r |t k( rn |dz r| j d y
y
)z:Initialize for reading a gzip compressed fileobj.
rF r. s not a gzip filer- z unsupported compression method rQ rP N) r
decompressobjr r r
_Stream__readr r ordrt r? )r flagxlenr@ s rD r z_Stream._init_read_gz s+ 99**DII,?,?+?@ ;;q>[ ( -. . ;;q>W $"#CD D4;;q>" A !8t{{1~&s4;;q>/B)BBD IIdO !8KKNAH "9KKNAH !8 KKN rF c | j S )z3Return the stream's file pointer position.
)r r s rD tellz _Stream.tell s
xxrF c || j z
dk\ rnt || j z
| j \ }}t | D ] }| j | j | j | | j S t d )zXSet the stream's file pointer to pos. Negative seeking
is forbidden.
r z seeking backwards is not allowed)r rs ry rV rt r
)r r rz r{ r[ s rD seekz _Stream.seek st >Q &sTXX~t|| D FI6] $,,' # IIi xx @A ArF c d | j | }| xj t | z
c_ |S )z5Return the next size number of bytes from the stream.)_readr r> )r r1 rk s rD rt z _Stream.read s) jj CH
rF c ( | j dk( r| j | S t | j }| j g}||k r| j r| j }d| _ n(| j
j
| j }|snA | j j | }|j | |t | z
}||k rdj | }||d | _ |d| S # | j $ r}t d |d}~ww xY w)z+Return size bytes from the stream.
r rF zinvalid compressed dataN)r r r> r rk r rt ry r
decompressrx r appendjoin)r r1 ctrk es rD r z
_Stream._read s ==E !;;t$ $ N
YYK$hxxhh ll'' 5
Bhh))#.
HHSM
SMA $h
HHQKdeH $x
>>
B 9:A
Bs C1 1D D Dc * t | j }| j g}||k rM| j j | j }|sn%|j | |t | z
}||k rMdj
| }||d | _ |d| S )zsReturn size bytes from stream. If internal buffer is empty,
read another block from the stream.
rF N)r> rk r rt ry r r )r r1 r r rk s rD __readz_Stream.__read6 s
M
XXJ$h,,##DLL1C
HHSM
SMA $h
HHQKTU8$xrF N)r )r r r r r r r ru r r r r r rt r r r rF rD r r R sF ENF"/%, >
6rF r c ( e Zd ZdZd Zd Zd Zd Zy)r zsSmall proxy class that enables transparent compression
detection for the Stream interface (mode 'r|*').
c Z || _ | j j t | _ y r )r rt BLOCKSIZErk )r r s rD r z_StreamProxy.__init__L s <<$$Y/rF c P | j j | _ | j S r )r rt rk r s rD rt z_StreamProxy.readP s LL%% xxrF c | j j d ry| j dd dk( r| j dd dk( ry | j j d
ry y )
Ns r r s BZhr
s 1AY&SYr )s ] s 7zXZr r )rk
startswithr s rD r z_StreamProxy.getcomptypeT sV 88 /
XXa]f
$!B 9)D
XX
!C
DrF c 8 | j j y r )r r r s rD r z_StreamProxy.close^ s rF N)r r r r r rt r r r rF rD r r G s 0 rF r c h e Zd ZdZd
dZd Zd Zd Zd Zd Z e
j fd Z d
d
Z
d Zd Zy) _FileInFilezA thin wrapper around an existing file object that
provides a part of its data as an individual file
object.
Nc || _ || _ || _ d| _ || _ d| _ |d|fg}d| _ g | _ d}| j }|D ]U \ }}||kD r | j j d||d f | j j d|||z |f ||z
}||z }W || j k r*| j j d|| j d f y y )Nr FT) r offsetr1 positionr r map_indexmapr )r r r r1 r blockinfolastposrealposs rD r z_FileInFile.__init__k s
T I ++ %LFD >? HHOOT66D=' B C tOG tmG & TYY HHOOUGTYY = > rF c y r r r s rD r z_FileInFile.flush s rF c yNTr r s rD readablez_FileInFile.readable s rF c yNFr r s rD writablez_FileInFile.writable s rF c 6 | j j S r )r seekabler s rD r% z_FileInFile.seekable s ||$$&&rF c | j S )z*Return the current file position.
)r r s rD r z_FileInFile.tell }} rF c . |t j k( r1t t |d | j | _ | j
S |t j k( rc|dk r*t | j
|z d | _ | j
S t | j
|z | j | _ | j
S |t j k( r>t t | j |z | j d | _ | j
S t d )z(Seek to a position in the file.
r zInvalid argument) ioSEEK_SETminmaxr1 r SEEK_CURSEEK_ENDr< )r r whences rD r z_FileInFile.seek s R[[ Ha 0$)) r r rt r r? ) r r1 rk datastartstopr rA r| s rD rt z_FileInFile.read sD <99t}},DtTYY 67DQh,0HHT^^,D)eT6DMM0D0NNa'N~~TXX 6)* tdmm 34F !!&DMME,A"BCLL%%f-q6V##$<==qsV|# FND MMV #M' Qh(
rF c h | j t | }||d t | t | S r )rt r> )r r| rk s rD readintoz_FileInFile.readinto s, iiA )3s8 3xrF c d| _ y r )r r s rD r z_FileInFile.close s rF r )r r r r r r r r# r% r r) r* r rt r5 r r rF rD r r e sB
?2
'
%'KK >
rF r c e Zd Z fdZ xZS ) ExFileObjectc t |j |j |j |j |j
}t | | y r )r r offset_datar1 r sparsesuperr )r tarfiletarinfor __class__s rD r zExFileObject.__init__ s; goow/B/B gllGNN<
!rF r r r r
__classcell__r? s @rD r8 r8 s
" "rF r8 c e Zd Zy)r N)r r r r rF rD r r s rF r c e Zd Z fdZ xZS )r c N || _ t | d|j d y )Nzmember z has an absolute pathr> r< r r r r> r? s rD r zAbsolutePathError.__init__ s&
77<<"22GHIrF r@ rB s @rD r r s J JrF r c e Zd Z fdZ xZS )r c f || _ || _ t |
|j d|ddz y )Nz would be extracted to , which is outside the destinationr> _pathr< r r r r> r/ r? s rD r z OutsideDestinationError.__init__ s;
GLL++B4("M=> ?rF r@ rB s @rD r r
? ?rF r c e Zd Z fdZ xZS )r c L || _ t | |j d y )Nz is a special filerF rG s rD r zSpecialFileError.__init__ s$
GLL++=>?rF r@ rB s @rD r r s @ @rF r c e Zd Z fdZ xZS )r c L || _ t | |j d y )Nz is a link to an absolute pathrF rG s rD r zAbsoluteLinkError.__init__ s$
GLL++IJKrF r@ rB s @rD r r s L LrF r c e Zd Z fdZ xZS )r c f || _ || _ t |
|j d|ddz y )Nz would link to rJ rK rL rN s rD r z$LinkOutsideDestinationError.__init__ s:
GLL+?4("E=> ?rF r@ rB s @rD r r rO rF r c e Zd Z fdZ xZS )LinkFallbackErrorc j || _ || _ t |
d|j dd|dz y )Nzlink z would be extracted as a zcopy of z, which was rejectedrL rN s rD r zLinkFallbackError.__init__ sC
5 00IJ %dX-ABC DrF r@ rB s @rD rW rW s D DrF rW c 2 i }| j }t j j |t j j }|j dt j f r1| j j dt j z x}|d< t j j | r t | t j j t j j || t j j }t j j ||g |k7 r t | | | j }|y|dz }|r^| j s| j r|dz s|dz }|dz }n.| j! s| j# rd }n t% | || j k7 r||d< |r| j& d |d < | j( d |d
< | j* d |d < | j, d |d < | j s| j# r]t j j | j. r t1 | t j j3 | j. }|| j. k7 r||d
< | j# rIt j j |t j j5 | | j. }n*t j j || j. }t j j |t j j }t j j ||g |k7 r t7 | | |S )N)rS /r i @ i r r3 r4 r5 r6 linkname) r r r/ realpath
ALLOW_MISSINGr seplstripisabsr r
commonpathr r isregislnkisdirissymr r3 r4 r5 r6 r] r normpathdirnamer )member dest_pathfor_data new_attrsr target_pathr
normalizeds rD _get_filtered_attrsrp s I ;;D 2773H3H II RVV}%#);;#5#5cBFFl#CCy ww}}T ''''""277<< 4#@*,''*?*? # AK ww; 23y@%fk:: ;;D e| ||~ e|FND
6<<> 'v.. 6;; $If :: ! #Ie :: ! #Ie << #!%Ig << #!%Ig <<>V\\^ww}}V__-'//))&//:JV__,(2 *%||~ ggll9+-77??4+@+1?? < !ggll9+1?? < ''**;24''2G2G + IKww!!; ":;yH1&+FF rF c | S r r )rj rk s rD r r J s MrF c P t | |d }|r | j di |ddiS | S )NFdeepr rp r rj rk rm s rD r r M s1 #FIu=I v~~6 666 MrF c P t | |d }|r | j di |ddiS | S )NTrs Fr rt ru s rD r r S s1 #FIt Z d? Z d@ Z dA Z!dB Z"dC Z#dD Z$dE Z%dF Z&dG Z'dH Z(dI Z)dJ Z*dK Z+dL Z,dM Z-dN Z.dO Z/dP Z0dQ Z1dR Z2dS Z3y%)Vr 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 zName of the archive member.r zPermission bits.r3 z6User ID of the user who originally stored this member.r4 z7Group ID of the user who originally stored this member.r1 zSize in bytes.r2 zTime of last modification.chksumzHeader checksum.typezFile type. type is usually one of these constants: REGTYPE, AREGTYPE, LNKTYPE, SYMTYPE, DIRTYPE, FIFOTYPE, CONTTYPE, CHRTYPE, BLKTYPE, GNUTYPE_SPARSE.r] zcName of the target file name, which is only present in TarInfo objects of type LNKTYPE and SYMTYPE.r5 z
User name.r6 z Group name.devmajorzDevice major number.devminorzDevice minor number.r zThe tar header starts here.r: z The file's data starts here. pax_headerszMA dictionary containing key-value pairs of an associated pax extended header.r; zSparse member information.r= N_sparse_structs _link_targetc || _ d| _ d| _ d| _ d| _ d| _ d| _ t | _ d| _ d| _
d| _ d| _ d| _
d| _ d| _ d| _ i | _ y)zXConstruct a TarInfo object. name is the optional name
of the member.
i r r N)r r r3 r4 r1 r2 ry REGTYPErz r] r5 r6 r{ r| r r: r; r} r r s rD r zTarInfo.__init__ s}
rF c | j S )z(In pax headers, "name" is called "path".r r s rD r/ z TarInfo.path s yyrF c || _ y r r r s rD r/ z TarInfo.path s rF c | j S )z0In pax headers, "linkname" is called "linkpath".r] r s rD r0 zTarInfo.linkpath r' rF c || _ y r r )r r] s rD r0 zTarInfo.linkpath s
rF c ` d| j j | j t | fz S )Nz<%s %r at %#x>)r? r r idr s rD __repr__zTarInfo.__repr__ s& 4>>#:#:499RX"NNNrF T)
r r2 r r] r3 r4 r5 r6 rs _KEEPc
| rt j | } nt j | } ||
ur|| _ ||
ur|| _ ||
ur|| _ ||
ur|| _ ||
ur|| _ ||
ur|| _ ||
ur|| _ ||
ur|| _ | S )zGReturn a deep copy of self with the given attributes replaced.
)
copydeepcopyr r2 r r] r3 r4 r5 r6 ) r r r2 r r] r3 r4 r5 r6 rs r results rD r zTarInfo.replace s ]]4(FYYt_F u FK FL u FK 5 &FO e FJ e FJ FL FL
rF c | j d}n| j dz }| j || j | j | j | j
| j | j | j | j | j | j | j d
}|d t k( r!|d j d s
|dxx dz
cc< |S )z9Return the TarInfo's attributes as a dictionary.
N )
r r r3 r4 r1 r2 ry rz r] r5 r6 r{ r| rz r rZ )r r r3 r4 r1 r2 ry rz r] r5 r6 r{ r| DIRTYPEr )r r infos rD get_infozTarInfo.get_info s 99 D99v%D
<7 "4<+@+@+E LC L rF surrogateescapec . | j }|j D ] \ }}| t d|z |t k( r| j ||| S |t
k( r| j
||| S |t k( r| j || S t d )z r= LENGTH_LINKr< LENGTH_NAME_posix_split_name_create_headerr )r r rB rC s rD r zTarInfo.create_ustar_header s $W
tJ &&x8 9K G 34 4 tF|""8V4 5 C+/+A+A$v,PXZ`+a (DNDL""4 xHHrF c Z t |d< d}t |d j || t kD r || j |d t
|| z
}t |d j || t kD r || j |d t || z
}|| j |t || z S )z:Return the object as a GNU header block sequence.
r rF r] r )
GNU_MAGICr> r= r _create_gnu_long_headerGNUTYPE_LONGLINKr GNUTYPE_LONGNAMEr r )r r rB rC rk s rD r zTarInfo.create_gnu_header s "W
tJ &&x8 9K G 4//Z0@BRT\^de eC tF|""8V4 5 C 4//V >NPXZ`a aCT((z8VLLLrF c \ t |d< | j j }ddt fddt fddfD ]; \ }}}||v r || j dd t || |kD s4|| ||< = d
D ]e \ }}d }|| } t | t }
|
r t | n| } d | cxk r d
|dz
z k s
n d ||< d}n |
r| ||< d}|sS||vsXt | ||< g |r| j |t | } nd} | | j |t dd z S # t $ r || ||< Y w xY w)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] r0 )r5 r5 )r6 r6 r rR rS ))r3 rP )r4 rP )r1 )r2 r Fr rP r- TrF r )r r} r r r r= UnicodeEncodeErrorr>
isinstancefloatroundstr_create_pax_generic_headerXHDTYPEr r )
r r rB r} r hnamerA ra needs_paxval val_is_floatval_intrk s
rD r zTarInfo.create_pax_header s~
$W
&&++-
-
J /T&(>$@ D% #
T
!!'84
4:'%)$Z E"!$@( RLD& It*C%c51L$0eCjcG3!
"33 T
%T
T 4$'H D!% R* 11+wQCCT((|WiPPPG &
%)$Z E"
s DD+*D+c 0 | j |t d S )zAReturn the object as a pax global header block sequence.
r: )r XGLTYPE)clsr} s rD create_pax_global_headerz TarInfo.create_pax_global_headerW s --k7GLLrF c R |j d }t dt | D ]t }dj |d| }dj ||d }t |j || t
k sNt |j || t k sq ||fS t d )zUSplit a name longer than 100 chars into a prefix
and a name part.
rZ r- Nzname is too long)splitrV r> r r=
LENGTH_PREFIXr r< )r r rB rC
componentsr[ r s rD r zTarInfo._posix_split_name] s ZZ_
q#j/*AXXj!n-F88JqrN+D6==623}D Hf56+E t| + /0 0rF c h | j d t t fv }|r;t | j dd d| }t | j dd d| }n t dd|| }t dd|| }| j dt
}| t
d t | j d d d
|| t | j d d d z d| t | j d
d d| t | j dd d| t | j dd d| t | j dd d| d|t | j dd d
|| | j dt t | j dd d|| t | j dd d|| ||t | j dd d|| g}t j dt z dj | } t | t d d }
| dd t d |
z d z | d d z } | S ) zReturn a header block. info is a dictionary with file
information, format must be one of the *_FORMAT constants.
rz r{ r rP r| r Nz TarInfo.type must not be Noner r r r r3 r4 r1 r r2 s r] r r5 r r6 r r z%dsrF iz%06o rR i)getCHRTYPEBLKTYPErd rE r r< r ri r r r rn r^ ) r rb rB rC has_device_fieldsr{ r| filetypepartsrk ry s rD r zTarInfo._create_headerm s
!HHV ,'0B B 488J2Av>H488J2Av>H2q(F3H2q(F3H 88FG, <= =
$c8V < #f,a 8 "Av . "Av . #R 0 !$b& 1 R(#x @ HHWk * "%r8V < "%r8V < 2&Xv >
$ kk%)+SXXe_= c9*+ ./2%4j5F!2G< r r? )payloadrz r{ s rD _create_payloadzTarInfo._create_payload s9
#3w< ; q= I-4 4GrF c |j || t z }i }d|d< ||d< t | |d< t |d< | j |t
|| | j
| z S )zTReturn a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence
for name.
z
././@LongLinkr rz r1 r )r= r? r> r r r r )r r rz rB rC r s rD r z TarInfo._create_gnu_long_header st
{{8V,s2&V V 4yV !W
!!$ hG##D)* *rF c d}|j D ] \ }} |j dd d}|r|dz
}|j D ] \ }}|j d }|r|j |d }n|j d }t | t | z dz }d x} }
|t t |
z } | |
k( rn| }
|t t |
d
d z |z d z |z d
z z
} i } d| d< || d< t | | d< t | d< | j | t d
d | j | z S # t $ r d}Y w xY w)zReturn a POSIX.1-2008 extended or global header sequence
that contains a list of keyword, value pairs. The values
must be strings.
Fr: rS TrF s 21 hdrcharset=BINARY
r r r rR =
z././@PaxHeaderr rz r1 r r )
r r= r r> r r^ r r r r ) r r} rz rB binarykeywordr recordslrZ rK r s rD r z"TarInfo._create_pax_generic_header s ) / / 1NGU
Wh/ 2 0 0G ) / / 1NGU nnW-G X/@A W-G s5z)A-AIACF O6
uSVW-4w>EMPUU UG! 2( 'V V 7|V #W
!!$ gyI##G,- -I &
s D99 E E c l t | dk( r t d t | t k7 r t d |j t
t k( r t
d t |dd }|t | vr t 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 || }|j$ t0 k( r&|j j3 d r t4 |_ |j$ t6 k( rxd}g }t9 d D ]@ } t |||dz }
t ||dz |dz } |j= |
| f |dz
}B t? |d } t |dd }
|| |
f|_ |jC r |j jE d |_ |r)|j$ tF vr|dz |j z |_ |S # t: $ r Y w xY w) zAConstruct a TarInfo object from a 512 byte bytes object.
r z empty headerztruncated headerzend of file header z bad checksumr l t | i i i) iI iQ iY i rZ i r r i i i )$r> r r r countr? r r\ rn rY rL r r r3 r4 r1 r2 ry rz r] r5 r6 r{ r| AREGTYPEr r GNUTYPE_SPARSErV r< r boolr~ rf rstrip GNU_TYPES)r rk rB rC ry objr r structsr[ r numbytes
isextendedorigsizes rD frombufzTarInfo.frombuf s s8q=">2 2 s8y &'9: : 99S>Y & !56 6SS\" c* *$^4 4es1Sz8V4s3s|$c#cl#c#cl#s3s|$C %
s3<3s3<6: C h7 C h7 3s3<( 3s3<( SS\8V4 88x CHH$5$5c$: CH
88~ %CG1X Sr!2 3F "3sRxb#9 :H 12r c#h J3s3<(H#*J"AC 99;xxs+CH chhi/ |chh.CH
" s $%J&& J32J3c |j j t }| j ||j |j
}|j j
t z
|_ |j | S )zOReturn the next TarInfo object from TarFile object
tarfile.
) r rt r r rB rC r r _proc_member)r r= rk r s rD fromtarfilezTarInfo.fromtarfile$ s^
oo""9-kk#w / / @ __))+i7
((rF c | j t t fv r| j | S | j t k( r| j | S | j t t t fv r| j | S | j | S )zYChoose the right processing method depending on
the type and call it.
) rz r r
_proc_gnulongr _proc_sparser r SOLARIS_XHDTYPE _proc_pax
_proc_builtin)r r= s rD r zTarInfo._proc_member9 sx 99)+;< <%%g. .
YY.
($$W- -
YY7G_=
=>>'* *%%g. .rF c |j j | _ | j }| j s| j t
vr || j
| j z
}||_ | j |j |j |j | j r | j j d | _ | S )zfProcess a builtin type or an unknown type which
will be treated as a regular file.
rZ )r r r: rd rz SUPPORTED_TYPES_blockr1 r _apply_pax_infor} rB rC rf r r )r r= r s rD r zTarInfo._proc_builtinF s #??//1!! ::<499O; dkk$)), ,F
W 0 0'2B2BGNNS ::< ((-DI rF c F |j j | j | j } | j | }| j |_ | j t k( r't ||j |j |_ n9| j t k( r&t ||j |j |_ |j# r |j j% d |_ |S # t
$ r}t
t | dd}~ww xY w)zSProcess the blocks that hold a GNU longname
or longlink member.
NrZ )r rt r r1 r r r r r rz r rL rB rC r r r] rf removesuffix)r r= rk nextr s rD r zTarInfo._proc_gnulong\ s oo""4;;tyy#9: :##G,D kk 99( (C!1!17>>BDI
YY*
* W%5%5w~~ FDM ::< ..s3DI ! :'A/T 9 :s C= = D DD c
| j \ }}}| ` |r|j j t }d}t d D ]D } t |||dz }t ||dz |dz } |r| r|j || f |dz
}F t |d }|r|| _ |j j | _ | j | j | j z |_ || _
| S # t $ r Y yw xY w)z8Process a GNU sparse header plus extra headers.
r r r i )r~ r rt r rV r\ r< r r r; r r: r r1 r )
r r= r r r rk r r[ r r s
rD r zTarInfo._proc_sparsew s
)-(<(<%X //&&y1CC2Y Sr!2 3F "3sRxb#9 :H hNNFH#56r c#h J "??//1 ))DKK ,BB " s %C55 DDc |j j | j | j }| j t
k( r
|j }n|j j }d}d}g }t | |kD r || dk7 rt j || x}s t d t |j d }|dk r t d ||z t | kD r t d |j d |z dz
} ||j! d dz | }
|
j# d \ } } }
| r
| dk7 s|| dk7 r t d |j% || |
f | dk( r||
d k( r
|j& }nd
}||z
}t | |kD r
|| dk7 r|d
}|D ]x \ }} }
| j) | d
d
|j* }|t, v r)| j) |
||j& |j* }n | j) |
d
d
|j* }|||< z | j/ | }d |v r| j7 || nRd |v r| j9 || n;|j; d
dk( r'|j; d dk( r| j= ||| | j t> t@ fv r|jC ||j& |j* | jD |_" d|v rS|jF }|jI s|j tJ vr ||j |j z
}||_" |S # t $ r t d w xY w# t0 $ r}t3 t5 | dd}~ww xY w)zVProcess an extended or global header as described in
POSIX.1-2008.
r NrU r- r r s
hdrcharsets BINARYr: GNU.sparse.mapGNU.sparse.sizezGNU.sparse.major1zGNU.sparse.minorrT r1 )&r rt r r1 rz r r} r r> _header_length_prefix_rematchrY rW groupr< r2 r partitionr rB _decode_pax_fieldrC PAX_NAME_FIELDSr r r r _proc_gnusparse_01_proc_gnusparse_00r _proc_gnusparse_10r r r r r: rd r )r r= rk r} r rB raw_headersr rA header_value_end_offsetkeyword_and_value raw_keywordequals raw_valuer r r r r s rD r zTarInfo._proc_pax s
oo""4;;tyy#9:
99 !--K!--224K #hnST!1 5 ; ;C EEEE()9::
; U[[^,
z()9::V|c#h&()9::&+kk!nv&=&A # #EIIaL1$45L M ->-H-H-N *K &D.C8O4PTX4X()9:: Y ? @ m+0@ ) & / /H &H 6MCM #hnST!1R H /: *FK ,,['7NN$G/) ..y(GDTDT ( ..y'7 ( $)K # /:( :##G,D
{ * # #D+ 6
+
- # #D+ 6
__ /
0C
7KOOL^<_cf.> O ++DK$ ))::<499O#Cdkk$)) 44F!' y
;()9::
;| :'A/T 9 :s$ 1M "M M N &M;;N c r g }g }|D ]d \ }}}|dk( r* |j t |j 6|dk( s< |j t |j f t t
|| |_ y# t $ r t d w xY w# t $ r t d w xY w)z?Process a GNU tar extended sparse header, version 0.0.
s GNU.sparse.offsetrU s GNU.sparse.numbytesN)r rW rJ r< rY listzipr; )r r r
offsetsr _r r s rD r zTarInfo._proc_gnusparse_00 s !, Aw..?NN3u||~#67 22? OOC $78 "- 3w12 " ?,-=>>? " ?,-=>>?s (B (B! B !B6c |d j d D cg c]
}t | }}t t |ddd |ddd |_ yc c}w )z?Process a GNU tar extended sparse header, version 0.1.
r ,Nr. r- )r rW r r r; )r r r} xr; s rD r zTarInfo._proc_gnusparse_01 sZ #..>"?"E"Ec"JK"JQ#a&"JK3vcc{F14a4L9: Ls Ac d}g }|j j t }|j dd \ }}t | }t | |dz k rgd|vr"||j j t z
}|j dd \ }}|j
t | t | |dz k rg|j j |_ t t |ddd |ddd |_ y)z?Process a GNU tar extended sparse header, version 1.0.
Nr r- r. ) r rt r r rW r> r r r: r r r; )r r r} r= fieldsr; rk numbers rD r zTarInfo._proc_gnusparse_10& s oo""9-iiq) V&kFQJ&C w++I66 ))E1-KFC MM#f+ & &kFQJ&
#??//13vcc{F14a4L9: rF c |j D ] \ }}|dk( rt | d| |dk( rt | dt | 5|dk( rt | dt | Q|t v sZ|t v r t | | }|dk( r|j
d }t | || |j | _ y# t
$ r d}Y Hw xY w) zoReplace fields with supplemental information from a previous
pax extended or global header.
zGNU.sparse.namer/ r r1 zGNU.sparse.realsizer rZ N) r setattrrW
PAX_FIELDSPAX_NUMBER_FIELDSr< r r r} )r r} rB rC r r s rD r zTarInfo._apply_pax_info6 s * / / 1NGU++fe, --fc%j1 11fc%j1J& //" 1' :5 A f$ !LL -Egu- 2" '++-
& " !"s 4B== C
C c j |j |d S # t $ r |j || cY S w xY w)z1Decode a single field from a pax record.
rS )rJ UnicodeDecodeError)r r rB fallback_encodingfallback_errorss rD r zTarInfo._decode_pax_fieldM s< D<<(3 3! D<< 1?C C Ds 22c h |dk r t d t |t \ }}|r|dz
}|t z S )z_Round up a byte count by BLOCKSIZE and return it,
e.g. _block(834) => 1024.
r zinvalid offsetr- )rY rs r )r r rz r{ s rD r zTarInfo._blockU s?
19$%56 6 "5) 4 aKF !!rF c & | j t v S z4Return True if the Tarinfo object is a regular file.)rz
REGULAR_TYPESr s rD rd z
TarInfo.isrega s yyM))rF c " | j S r% )rd r s rD isfilezTarInfo.isfilee s zz|rF c ( | j t k( S )z!Return True if it is a directory.)rz r r s rD rf z
TarInfo.isdiri yyG##rF c ( | j t k( S )z%Return True if it is a symbolic link.)rz SYMTYPEr s rD rg z
TarInfo.issymm r* rF c ( | j t k( S )z!Return True if it is a hard link.)rz LNKTYPEr s rD re z
TarInfo.islnkq r* rF c ( | j t k( S )z(Return True if it is a character device.)rz r r s rD ischrz
TarInfo.ischru r* rF c ( | j t k( S )z$Return True if it is a block device.)rz r r s rD isblkz
TarInfo.isblky r* rF c ( | j t k( S )z Return True if it is a FIFO.)rz FIFOTYPEr s rD isfifozTarInfo.isfifo} s yyH$$rF c | j d uS r )r; r s rD issparsezTarInfo.issparse s {{$&&rF c < | j t t t fv S )zCReturn True if it is one of character device, block device or FIFO.)rz r r r4 r s rD isdevz
TarInfo.isdev s yyWgx 888rF r )r )4r r r r dict __slots__r propertyr/ setterr0 r r r r r r
r r r r classmethodr r staticmethodr r r r r r r r r r r r r r r r r rd r( rf rg re r0 r2 r5 r7 r9 r rF rD r r i s
,
!
G
H
-
$
>
F
*
*!
" /#
$ 5%
&9'
* .+
, -
. /
0 1
I6 0
[[ __! !O %eeuE88 *HEV /" I M 8Qt M M
' 'R * * 0- 0-d < <| ) )( /,68wr3(; ; ..D
"* $$$$$%'9rF r c e Zd ZdZdZdZdZdZeZ e
Z dZ e
ZeZdZ d;dZedddefd Zedd Zd
ddddZd Zd Z d Z d Z d?dZ d@dddZ dAdddZ!dBdZ"d Z#dCddd d Z$d Z%dDddd d Z&d! Z' dBd"Z(d# Z)d$ Z*d% Z+ dEddd&d'Z,d( Z-d) Z.d* Z/d+ Z0d, Z1d- Z2d. Z3d/ Z4d0 Z5d1 Z6d2 Z7dFd3Z8d4 Z9dBd5Z:d6 Z;d7 Zd: Z?y)Gr z=The TarFile Class provides an interface to tar archives.
r Fr- Nr c ddddd}||vr t d || _ || | _ |sZ| j dk( r-t j j | sd| _ d| _ t
|| j }d | _ n^|8t |d r,t |j t t f r |j }t |d r|j | _ d
| _ |r t j j | nd
| _
|| _ ||| _ ||| _ ||| _ ||| _ ||| _ | | _ |
| j t* k( r|
| _ ni | _ | | | _ | | | _ |
| _ d | _ g | _ d | _ | j j; | _ i | _ | j dk( r d
| _ | jC | _ | j dk( r^ | j jE | j< | j jG | }| j6 jI | ]| j dv rd
| _ | j, rm| j jQ | j, jS }| j jU | | xj< tW | z
c_ y
y
y
# tJ $ r( | j jE | j< Y tL $ r}tO t | d
d
}~ww xY w# | j s| j jY d
| _ xY w)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.
rbzr+bwbxbr ar r !mode must be 'r', 'a', 'w' or 'x'rF r FNr r Tr rF r r )-r< r _moder r/ exists bltn_openr r r r r r^ abspathr rb r> dereference ignore_zerosrB rC r r} debug
errorlevel copybufsizer members_loadedr r inodes firstmemberr r r r r r r r r ru r> r )r r r r rb r> rM rN rB rC r} rO rP rQ modesr rk s rD r zTarFile.__init__ s T= u @A A 4[
yyC t(< !
djj1G $D &!97<<#u 6 ||w' $\\
#D -1BGGOOD)t DK "DL " *D # ,D $DM "t{{j'@ *D !D DJ ! (DO ' ll'') yyC #' #'99; yyC LL%%dkk2:"&,,":":4"@ ++G4 yyO+ # ## ,,??@P@P@U@U@WXCLL&&s+KK3s8+K $ ,
* ))$++6 & : 'A /T9: ## ""$ DK s> >A L; 6K& BL; &.L8L; L8 L33L88L; ;0M+c |s
|s t d |dv rz fd}g }t j | D ]: }t j | } ||j }
| |d|fi |c S d j | } t d
| d |v rb|j d d \ }
}|
xs d}
|xs d
}| j v rt j | } nt
d|z | ||
|fi |S d|v rg|j dd \ }
}|
xs d}
|xs d
}|
dvr t d |j dd }t ||
|||| } ||
|fi |}d|_ |S |dv r j |||fi |S t d # t
t f$ r5} |j d| d| ||j
Y d} ~ d} ~ ww xY w# |j xY w)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
'r:xz' open for reading with lzma 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
'w:xz' open for writing with lzma compression
'x' or 'x:' create a tarfile exclusively without compression, raise
an exception if the file is already created
'x:gz' create a gzip compressed tarfile, raise an exception
if the file is already created
'x:bz2' create a bzip2 compressed tarfile, raise an exception
if the file is already created
'x:xz' create an lzma compressed tarfile, raise an exception
if the file is already created
'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
'r|xz' open an lzma 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
'w|xz' open an lzma compressed stream for writing
znothing to open)r r:*c ( j | dk( S )Ntaropen) OPEN_METH)r r s rD not_compressedz$TarFile.open..not_compressed> s }}X.);;rF )keyNr z - method z:
z'file could not be opened successfully:
:r- r r |r zmode must be 'r' or 'w'r FrH zundiscernible mode)r< sortedr[ r r r r r r r r popr r r rZ )r r r r ry kwargsr\
error_msgsr func saved_posr error_msgs_summaryfilemoder streamr s ` rD r z TarFile.open s5 J G ./ / <
<J "3==n E sCMM($;<& ' I c7=f== F "&:!6 FGYFZ [\ \
D[!%C!3 Hh 3H (5H 3==( sCMM($;<&'Dx'OPPh:6: :
D[!%C!3 Hh 3H (5Hz) !:;; "JJ :M T8Xw *,F
h9&9 "AMH
_
$ 3;;tT7=f= =-..W "#34 %% (2aU&CD * Y/ D
s$ "
F G G*GG G c 6 |dvr t d | |||fi |S )zCOpen uncompressed tar archive name for reading or writing.
rE rG )r< )r r r r rd s rD rZ zTarFile.taropent s- + + @A A4w1&11rF c |dvr t d ddlm} |||dz || } | j |||fi |}d
|_ |S # t $ r
t d dw xY w# t
$ r}||dk( r t
d | d}~ww xY w# t
$ r'}|j |dk( r t
d | d}~w |j xY w) zkOpen gzip compressed tar archive name for reading or writing.
Appending is not allowed.
r r r mode must be 'r', 'w' or 'x'r )GzipFilez gzip module is not availableNr| r r F)
r< gzipro r r r r rZ r r ) r r r r r rd ro r r s rD gzopenzTarFile.gzopen| s
& ;< < M % tTCZ HG D$:6:A
+ M"#AB L M
"ts{ 129 MMOs{ 129 MMO s9 A A B A B 'A;;B C "B..Cc P |dvr t d ddlm} ||xs ||| } | j
|||fi |}d
|_
|S # t $ r
t d dw xY w# t t f$ r'}|j |dk( r t d | d}~w |j xY w) zlOpen bzip2 compressed tar archive name for reading or writing.
Appending is not allowed.
rm rn r )BZ2Filer N)r r znot a bzip2 fileF) r< r rs r r rZ r EOFErrorr r r ) r r r r r rd rs r r s rD bz2openzTarFile.bz2open s
& ;< < L # '/T4}M D$:6:A
! L"#@At K L " MMOs{ 23: MMO s" A A A B%-"BB%c L |dvr t d ddlm}m} ||xs ||| } | j |||fi |}d
|_
|S # t $ r
t d dw xY w# |t f$ r'} |j |dk( r t d | d} ~ w |j xY w) zkOpen lzma compressed tar archive name for reading or writing.
Appending is not allowed.
rm rn r )LZMAFiler r N)presetr znot an lzma fileF) r< r rw r r r rZ rt r r r )
r r r r rx rd rw r r r s
rD xzopenzTarFile.xzopen s
& ;< < M 0 7?dD@ D$:6:A
! M"#AB L M 8$ MMOs{ 23: MMO s" A A A B#+"B
B#rZ rq ru ry )r r r r c | j ryd| _ | j dv r| j j t t
dz z | xj t
dz z
c_ t | j t \ }}|dkD r)| j j t t |z
z | j s| j j yy# | j s| j j w w xY w)zlClose the TarFile. In write-mode, two finishing zero blocks are
appended to the archive.
NTrH r. r ) r r r ru r? r r rs
RECORDSIZEr r )r rz r{ s rD r z
TarFile.close s ;; %yyO+ ""3)a-#89 A
. %+4;;
$C! q=LL&&sj9.D'EF## ""$ $4## ""$ $s B C )Dc f | j |j d }|t d|z |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.
rZ zfilename %r not found)
_getmemberr KeyError)r r r> s rD getmemberzTarFile.getmember s6 //$++c"23 ?2T9: :rF c r | j | j s| j | j S )zReturn the members of the archive as a list of TarInfo objects. The
list has the same order as the members in the archive.
)_checkrS _loadrR r s rD
getmemberszTarFile.getmembers s'
|| JJL||rF c \ | j D cg c] }|j c}S c c}w )zReturn the members of the archive as a list of their names. It has
the same order as the list returned by getmembers().
)r r )r r> s rD getnameszTarFile.getnames
s) -1OO,=>,= ,=>>>s )c . | j d | |j }||}t j j | \ }}|j t j d }|j d }| j }| |_ |8| j st j | }n9t j | }n#t j |j }d}|j }t j | r|j" |j$ f} | j sE|j& dkD r6| | j( v r(|| j( | k7 rt* }
| j( | }nt, }
| d r|| j( | < nt j. | rt0 }
nt j2 | rt4 }
njt j6 | r t8 }
t j: | }n9t j< | rt> }
n t j@ | rtB }
ny||_ ||_" |jF |_$ |jJ |_& |
t, k( r|jN |_( nd|_( |jR |_* |
|_+ ||_, tZ r( t[ j\ |jH d |_/ tb r( tc jd |jL d |_3 |
t> tB fv rhti t d rXti t d rHt jj |jl |_7 t jp |jl |_9 |S # t` $ r Y w xY w# t` $ r Y w xY w) a Create a TarInfo object from the result of os.stat or equivalent
on an existing file. The file is either named by `name', or
specified as a file object `fileobj' with a file descriptor. If
given, `arcname' specifies an alternative name for the file in the
archive, otherwise, the name is taken from the 'name' attribute of
'fileobj', or the 'name' argument. The name should be a text
string.
awxNrZ r r- r majorminor):r r r r/
splitdriver r` ra r> r= rM lstatstatfstatfilenost_modeS_ISREGst_inost_devst_nlinkrT r. r S_ISDIRr S_ISFIFOr4 S_ISLNKr, readlinkS_ISCHRr S_ISBLKr r st_uidr3 st_gidr4 st_sizer1 st_mtimer2 rz r] pwdgetpwuidr5 r~ grpgetgrgidr6 r r st_rdevr{ r r| ) r r arcnamer drvr> statresr] stmdinoderz s rD
gettarinfozTarFile.gettarinfo s
E < zlink to )r r r r ri r5 r3 r6 r4 r0 r2 r{ r| r1 r2 r localtimer rf rg r] re r )r verboserR r> s rD r z TarFile.lists sf
?G G<<' -
gll ;<w}}'C 'C'.}}'C 'C E F==?gmmo $(8(8':J:J'K K!M N 56==( 56 ="&.. "?"C!D E
w}}BG H==? (8(8 89==?
W-=-= => G5 rF filterc b | j d ||}| j Bt j j | | j k( r| j dd|z y| j d| | j
|| }|| j dd|z y| || }|| j dd|z y|j r(t |d 5 }| j || ddd y|j r| j | |rut t j | D ]S }| j t j j || t j j || || U yy| j | y# 1 sw Y yxY w)
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. `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. ztarfile: Skipped %rr- z tarfile: Unsupported type %rtarfile: Excluded %rrB r )r r r r/ rL _dbgr rd rK addfilerf rb listdiraddr )r r r recursiver r> fs rD r z TarFile.add sq
E ?G 99 RWW__T%:dii%G IIa.5 6 !T //$0 ? IIa7$> ? WoG ! 3d :; ==?4&! Wa( '& ]]_ LL !
4 01AHHRWW\\$ 2BGGLL!4L %f 6 2
LL ! '&s F%%F.c | j d t j | }|j | j | j | j
}| j j | | xj t | z
c_ | j }|t || j |j | t |j t \ }}|dkD r.| j j t t |z
z |dz
}| xj |t z z
c_ | j j# | y)a Add the TarInfo object `tarinfo' to the archive. If `fileobj' is
given, it should be a binary file, and tarinfo.size bytes are read
from it and added to the archive. You can create TarInfo objects
directly, or by using gettarinfo().
r N)ry r r- )r r r rb rB rC r ru r r> rQ rr r1 rs r r? rR r )r r> r rk ry rz r{ s rD r zTarFile.addfile s
E))G$mmDKK D 3 s3x w||W M &w||Y ? FI1} ""3)i*?#@A! KK6I- -K G$rF c || j }|t j j d }|W t t
}dd l}|j d d }|5 |j | d d d |j ddd }|r t | }|| _ |S t r"t j d
t d t" S t$ S t' |t( r t+ d
|S t- | r|S t | S # 1 sw Y xY w# t $ r Y w xY w# t $ r t d|d d w xY w# t $ r t d|d d w xY w)N PYTHON_TARFILE_EXTRACTION_FILTERr )#)
interpolationcomment_prefixesr= r )fallbackzfilter z
not founda The default behavior of tarfile extraction has been changed to disallow common exploits (including CVE-2007-4559). By default, absolute/parent paths are disallowed and some mode bits are cleared. See https://access.redhat.com/articles/7004769 for more details.r )
stacklevelzrString names are not supported for TarFile.extraction_filter. Use a function such as tarfile.data_filter directly.)extraction_filterr environr rK _CONFIG_FILENAME configparser ConfigParser read_fileFileNotFoundError_NAMED_FILTERSr~ r< _RH_SAFER_DEFAULTwarningswarnRuntimeWarningr r r r TypeErrorcallable)r r r filer confs rD _get_filter_functionz TarFile._get_filter_function s >++F~zz~~&HI<5 ()9 : , + 8 8*.-4 9 " NN4 0 " #xx (J13 ( 5 S!/!5 .4D*!M$ MM. '16 &%++&#& 67 7 M F M G!&) )C "T - $ S (76*J)G HdRS4 G wvj
;<$ F Gs5 D D D 7D8 D DDD58E)
numeric_ownerr c g }| j | }|| }|D ]a }| j ||| \ }} | |j r|j | | j |||j || c |j d d |D ] } || | }|| j | d #t j j ||j } t j | } t j | j" s| j |d | j% || | | j' || | j) || y# t $ r%}
| j | t |
Y d}
~
d}
~
ww xY w# t $ r | j |d Y w xY w# t* $ r }
| j- |
Y d}
~
Cd}
~
ww xY w)
a 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(). If `numeric_owner` is True, only
the numbers for user/group names are used and not the names.
The `filter` function will be called on each member just
before extraction.
It can return a changed TarInfo or None to skip the member.
String names of common filters are accepted.
N) set_attrsr filter_functionc | j S r r )rF s rD z$TarFile.extractall..= s qvvrF T)r] reversezexcluded by filtermissingznot a directory)r )r _get_extract_tarinforf r _extract_onesort_FILTER_ERRORS_log_no_directory_fixupreprr r/ r r r r r r r chownutimechmodr _handle_nonfatal_error)r r/ rR r r directoriesr rj r>
unfilteredexcdirpathr r s rD
extractallzTarFile.extractall s 33F; ?G F"&";";#/ GZ}} "":. gt7==?7J,9.=
? -t< &J
/ -j$ ?G ?001EG '',,tW\\: HHW -E ||EMM2 00:KL
7G=
I
7G,
7G,5 & & 00T#YG ) 00)D
/++A..
/sl E$"F77*F7"F71F7)8F7$ F-F
F7
FF7F40F73F44F77 G GG c J | j dd|j d|d y )Nr. z!tarfile: Not fixing up directory z ())r r )r rj reasons rD r z TarFile._log_no_directory_fixup_ s !;;( )rF c | j | }| j ||| \ }}|| j |||| yy)a 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. If `numeric_owner`
is True, only the numbers for user/group names are used and not
the names.
The `filter` function will be called before extraction.
It can return a changed TarInfo or None to skip the member.
String names of common filters are accepted.
N)r r r ) r rj r/ r r r r r> r s rD extractzTarFile.extractc sO 33F; " 7 7 OT + gtY
F rF c t |t r| j | }n|}d} ||| }| | j dd|j z y|j rDt j | }t j j ||j |_ ||fS # t t f$ r}| j | Y d}~d}~wt $ r}| j | Y d}~d}~ww xY w)zGet (filtered, unfiltered) TarInfos from *member*
*member* might be a string.
Return (None, None) if not found.
Nr. r )NN)r r r r r _handle_fatal_errorr r r r re r r r/ r r] r )r rj r r/ r filteredr s rD r z TarFile._get_extract_tarinfow s fc " /J J +&z48H
IIa/*//A B >> yy*H$&GGLLx7H7H$IH !## % ( $ $Q ' ' + ' ' * * +s# B+ +C7:C C7 C22C7c 8 | j d | j |t j j ||j
|||| y# t $ r}| j | Y d}~yd}~wt $ r}| j | Y d}~yd}~ww xY w)zExtract from filtered tarinfo to disk.
filter_function is only used when extracting a *different*
member (e.g. as fallback to creating a symlink)
r )r r r extraction_rootN)
r _extract_memberr r/ r r r r r r )r r> r/ r r r r s rD r zTarFile._extract_one s
C + "'',,tW\\*J+4/<1@15
!
7
( $ $Q ' ' + ' ' * * +s# ?A B A22 B>BBc N | j dkD r | j dd|z y)z=Handle non-fatal error (ExtractError) according to errorlevelr- tarfile: %sN)rP r r r s rD r z TarFile._handle_nonfatal_error s$ ??Q IIa * +rF c L | j dkD r t |t rY|j | j dd|j
z y| j dd|j
d|j y| j ddt
| j d| y)z1Handle "fatal" error according to self.errorlevelr Nr- r z tarfile: r )rP r r filenamer strerrorrz r r s rD r zTarFile._handle_fatal_error st ??Q
7
#zz! !]QZZ 78 !QZZ HI IIaT!W-=-=qA BrF c | j d t |t r| j | }n|}|j s|j
t vr| j | | S |j s|j rEt | j t r t d | j | j | S y)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 or
a link, an io.BufferedReader object is returned. For all other
existing members, None is returned. If `member' does not appear
in the archive, KeyError is raised.
r z'cannot extract (sym)link as file objectN)r r r r rd rz r
fileobjectre rg r r r
extractfile_find_link_target)r rj r> s rD r zTarFile.extractfile s
C fc "nnV,G G ==?gll/ A??41 1
]]_
$,,0 ""KLL ''(>(>w(GHH rF r r c |j d }|j dt j }t j j | }|r4t j j
| st j | |j s|j r,| j d|j d|j n | j d|j |j r| j || n|j r| j! || n|j# r| j% || n|j' s|j) r| j+ || nm|j s|j r| j- |||| n7|j. t0 vr| j3 || n| j || |rI| j5 ||| |j s%| j7 || | j9 || yyy)zExtract the filtered TarInfo object tarinfo to a physical
file called targetpath.
filter_function is only used when extracting a *different*
member (e.g. as fallback to creating a symlink)
rZ r- z -> r N) r r r r` r/ ri rJ makedirsre rg r r r] rd makefilerf makedirr5 makefifor0 r2 makedevmakelink_with_filterrz r makeunknownr r r )r r>
targetpathr r r r upperdirss rD r zTarFile._extract_member s &&s+
''RVV4
GGOOJ/ RWW^^I 6
KK " ==?gmmo IIaw||W5E5EF G IIa & ==? MM': .
]]_ LL* -
^^
MM': .
]]_
LL* -
]]_
% % / /
&
1 \\
0 Wj 1 MM': . JJw
M :==?
7J/
7J/ # rF c |j t j | yt j |d y# t $ r# t j j | s Y yw xY w)z,Make a directory called targetpath.
Ni )r r mkdirFileExistsErrorr/ rf r r> r s rD r zTarFile.makedir
sT
||#$ U+ 77==, - s !; ; )A'&A'c | j }|j |j | j }t |d 5 }|j
d|j
D ]) \ }}|j | t
|||t | + |j |j |j n t
|||j t | ddd y# 1 sw Y yxY w)z'Make a file called targetpath.
rC N)
r r r: rQ rK r; rr r r1 truncate)r r> r sourcery targetr r1 s rD r zTarFile.makefile#
s G''(""
z4
(F~~)$+NNLFDKK' iI %3 GLL)!FFGLL)WM )
(
(s
BCC c f | j || | j dd|j z y)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 rz r s rD r zTarFile.makeunknown3
s3
gz* ! 24;LLA BrF c d t t d rt j | yt d )z'Make a fifo called targetpath.
mkfifoz fifo not supported by systemN)r r r r r s rD r zTarFile.makefifo;
s& 2x IIj ! => >rF c f t t d rt t d s t d |j }|d}|j r|t
j z }n|t
j z }t j ||t j |j |j y)z r r s rD r zTarFile.makedevC
s r7#72y+A HI I|| <D ==? DLL D DLL D
TG , ,g.>.>? ArF c * | j ||d d S r )r r s rD makelinkzTarFile.makelinkU
s ((*dDIIrF c d} |j rUt j j | rt j | t j
|j | yt j j |j r!t j |j | y | j | }||}n| t d ||| }|| j# |||| yy# t $ r d}Y Tw xY w# t $ r |r t d d w xY w# t $ r }t ||j |d}~ww xY w)a3 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.
filter_function is only used when extracting a *different*
member (e.g. as fallback to creating a link).
FNTz%unable to resolve link inside archivez[makelink_with_filter: if filter_function is not None, extraction_root must also not be Noner )rg r r/ lexistsunlinksymlinkr] rJ r linksymlink_exceptionr r~ r r rW r r ) r r> r r r keyerror_to_extracterrorr r causes rD r z TarFile.makelink_with_filterX
s] $)
,}}77??:.IIj)
7++Z877>>'"6"67GGG 0 0*= 8 //8J "!H &">? ?
M*:G :1@1@
!
B / ! ,'+ $ ,
'";=BFG "
M' AuL
Ms= A$C; )A C; 5D D( ; D D D%( E
1EE
c t t d rt j dk( r|j }|j }|sj t
r.|j r"t j |j d } t r.|j r"t j |j d }|d}|d} |j r(t t d rt j ||| yt j ||| yyy# t $ r Y w xY w# t $ r Y uw xY w# t $ r}t! d |d}~ww xY w)zSet owner of targetpath according to tarinfo. If numeric_owner
is True, use .gid/.uid instead of .gname/.uname. If numeric_owner
is False, fall back to .gid/.uid when the search based on name
fails.
geteuidr r. NrH lchownzcould not change owner)r r r r4 r3 r r6 getgrnamr~ r r5 getpwnamrg r! r r r )r r> r r gur s rD r z
TarFile.chown
s 2y !bjjla&7 A A w}} LL 7 :w}} LL 7 : yy
D==?wr8'<IIj!Q/HHZA./ '8 !
D"#; r r s rD r z
TarFile.chmod
sF << ? HHZ . ? 67Q > ?s 0 A
AA
c |j }|yt t d sy t j |||f y# t $ r}t d |d}~ww xY w)zBSet modification time of targetpath according to tarinfo.
Nr z"could not change modification time)r2 r r r r r )r r> r r2 r s rD r z
TarFile.utime
sZ
= r7# L HHZ% 0 L CD! K Ls ; A AAc L | j d | j | j }d| _ |S | j | j j k7 r^| j dk( ry| j j | j dz
| j j
d s t d d} | j j | } | | j0 j3 | |S d| _ |S # t $ rU}| j r?| j dd| j |fz | xj t z
c_ Y d}~Y d}~d}~wt $ rz}| j r?| j dd| j |fz | xj t z
c_ Y d}~| j dk( rt t | dY d}~d}~wt $ r | j dk( r t d dY -t" $ r/}| j dk( rt t | dY d}~_d}~wt$ $ r}t t | dd}~wt& $ r@} ddl}t+ ||j, rt d
| d|# t. $ r |w xY wd}~ww xY w) 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.
raNr r- rp Tr. z0x%X: %sz
empty filez zlib error: )r rU r r r r rt r r> r r rN r r rY r r r r Exceptionr r r r rR r rS )r mr> r r s rD r z TarFile.next
sR
D ' A #D H ;;$,,++- -{{a LL dkkAo .<<$$Q' 899
,,2248<
LL ( DLI "
$$IIat{{A.>!>?KK9,K % &
6$$IIat{{A.>!>?KK9,K [[A%#CF+5 &#
<;;!##L1t; $'
6;;!##CF+5 $(
2 A'T1
!!TZZ0 ',qc(: ;E " G
sb <D J# AE J#%AG0$G'J#J# $H66 J#I J#$+J JJ J#c | j }d}| |j | }|d| }|r t j j | }t
| D ]a }|r |j |j k( rd}!|r*t j j |j }n |j }||k( s_|c S |r t | y# t $ r d}Y w xY w)z}Find an archive member by name from bottom to top.
If tarinfo is given, it is used as the starting point.
FNT) r indexr< r r/ rh reversedr r ) r r r> normalizerR skippingr- rj member_names rD r} zTarFile._getmember s
//#
*
g. "&5/ 77##D)D w'F>>V]]2 $H gg . .v{{ ; $kk {"
( W% % 1
s C
CCc V | j | j d| _ y)zWRead through the entire archive file and look for readable
members.
NT)r rS r s rD r z
TarFile._load, s( iik% iik% rF c | j r"t d| j j z |'| j |vrt d| j z yy)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? r r )r r s rD r zTarFile._check4 sS ;;.4>>+B+BBC C 55 AB B !6 rF c , |j rQdj t dt j j |j |j f }d}n|j }|}| j ||d }|t d|z |S )zZFind the target member of a symlink or hardlink member in the
archive.
rZ NT)r> r/ zlinkname %r not found)
rg r r r r/ ri r r] r} r~ )r r> r] limitrj s rD r zTarFile._find_link_target= s ==?xxtbggoogll.KWM]M]-^ _`HE ''HE 5D I >2X=> >
rF c # R K | j r| j E d{ yd}| j | j }|dz
}| |t | j k r| j | }n'| j s| j }|s d| _ yy|dz
}| Y7 w)z$Provide an iterator object.
Nr r- T)rS rR rU r r> )r r- r> s rD __iter__zTarFile.__iter__P s <<|| # # 'iikG QJEMs4<<(( ,,u-\\ ))+ #'DL QJEM
$s B'B%BB'c Z || j k r t |t j yy)z.Write debugging output to sys.stderr.
r N)rO r r stderr)r levelmsgs rD r z TarFile._dbgo s# DJJ #CJJ ' rF c & | j | S r )r r s rD __enter__zTarFile.__enter__u s
rF c || j y | j s| j j d| _ y r )r r r r )r rz r tracebacks rD __exit__zTarFile.__exit__y s2 < JJL ## ""$ DKrF )
Nr NNNNNNr NNNN)r N)r Nra )r NN)NNNTr r ).N)r T)TFr" )@r r r r rO rM rN rP r rb r
rB rC r r> r8 r r r r> r{ r rZ rq ru ry 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 r r r r} r r r r7 r r> rA r rF rD r r s
EK L J FH
FG J AEHL>B)-b^ #tZ ]/ ]/~ 2 2 @ 6 : I%* ? aF$D $L1" 1"f%23GjC/% C/J)GG( $> &*+(,
C @ >B&+10@D(,10p
N B?A$J0Bd DB? L <B&&P C& >( rF r c t | d r.| j }t | }| j | n t | }|j y# t
$ r Y yw xY w)zReturn True if name points to a tar archive that we
are able to handle, else return False.
'name' should be a string, file, or file-like object.
rt )r TF)r r r r r r )r r r s rD r r sX
4 ))+CT"A IIcNT
A s AA A$#A$c dd l } d}| j | }|j ddddd |j d
d t d
|j d }|j dddd |j ddddd |j dd dd d |j d d dd! |j }|j r |j |j d"d# |j |j }t | rut |d$ 5 }|j t |j t j % d d d |j r=t d&j# | y |j d"d'j# | y y |j$ u|j$ }t | rzFilter for extraction)metavarchoicesrJ T)requiredz-lz--list zShow listing of a tarfile)rK rJ z-ez --extract+)rN z z Extract tarfile into target dir)nargsrK rJ z-cz--create)zzzCreate tarfile from sourcesz-tz--testzTest if a tarfile is validr- z&--filter is only valid for extraction
r r9 z{!r} is a tar archive.z{!r} is not a tar archive.
rX )r r. )r/ r rC z{!r} file is extracted.z+{!r} file is extracted into {!r} directory.r r r )r z.tgzz.xzz.txzz.bz2z.tbzz.tbz2z.tb2zw:r z{!r} file created.) argparseArgumentParser add_argumentr add_mutually_exclusive_group
parse_argsr r exittestr r r r r r: r rb r r r> r curdir format_helpr createrc r/ splitextr )rQ rF parserr argsrv r tfrX r< tar_namer ext compressionstar_mode tar_files file_names rD mainre s GK
$
$
$
=F
k, - /
N . 4 6
/ / / >E tX{ 7 9 t[ < = ?
tZs 3 9 ;
tX{ 8 : D {{t||+ A@A yy ii c?c3 3 cnn&SZZ8 ||.55c:; KK9@@E F
ii c? c5)R - *)
KK9@@E F
! t|| !,,q/CYYF
!
# ,,KC KK6--/ 0 c? c5)R
6$++
> *||S=3::3?C 2396#v3F c
KK9@@E F
;;??1%!!(+3
03l/B4,s++KK
\\(H
- & y! ' . << &--h7 8 /
!M *) *)> .
-s0 :P- P: Q"Q-P7:QQQ __main__rB )pr version
__author__ __credits__builtinsr rK r r r) rq r r ri r rer r r r AttributeErrorNotImplementedErrorr r __all__r r r? r r{ r r r r r r r r. r, r r r r4 CONTTYPEr r r r r r r r r r r r& r r r r rW r r r
getfilesystemencodingrE rL r\ rd rn rr r r* r r r r r
r r r r rY r r r objectr r BufferedReaderr8 r r r r r r rW r rp r r r r r compiler r r r re r r rF rD rt s : 6
H
'
$%8'B * -
^
HgGXWg#%5! # (>+
/
.
9
77d?H(s((*H 0&
( N
< * "&$ 2 y 8 x ( ( { ; [ K 0r rj 6