python (3.12.0)
ˑe d Z dZdZdZddlmZ ddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlZddlZddlZ ddlZ ddlZeeefZg dZdZd Zed
z Zd Z d Z d
Z d
Z dZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.d Z/dZ0d Z1d Z2e2Z3e!e"e#e$e'e(e)e%e&e*e+e,f Z4e!e"e)e,fZ5e*e+e,fZ6d Z7h d Z8e9e9e9e:e:e:d!Z;ejx d"k( rd#Z=n ej| Z=d$ Z?d% Z@d& ZAd'e3fd(ZBd) ZCdedfd*ZDd+ ZE G d, d-eF ZG G d. d/eG ZH G d0 d1eG ZI G d2 d3eG ZJ G d4 d5eG ZK G d6 d7eG ZL G d8 d9eL ZM G d: d;eL ZN G d< d=eL ZO G d> d?eL ZP G d@ dAeL ZQ G dB dC ZR G dD dE ZS G dF dGeT ZU G dH dIeT ZV G dJ dKe j ZX G dL dMeG ZY G dN dOeY ZZ G dP dQeY Z[ G dR dSeY Z\ G dT dUeY Z] G dV dWeY Z^dddXZ_dY Z`dZ Zad[ Zbe`eaebd\Zc eT Zd G d] d^eT Ze G d_ d`eT Zfda Zgefj
Zdb Zheidck( r eh yy# e$ r dZY w xY w# e$ r dZY w xY w)ez,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 FilterErrorAbsoluteLinkErrorOutsideDestinationErrorSpecialFileErrorAbsolutePathErrorLinkOutsideDestinationError 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 ;/BuggyBox/python/3.12.0/bootstrap/lib/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 ) s (rF rY c e Zd ZdZy)SubsequentHeaderErrorz3Exception for missing and invalid extended headers.Nr r rF rD r r , 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__9 sa rzz)BJJ6
2z " BKK D''$e,rF c B t j | j y N)r closer r s rD r z_LowLevelFile.closeB s
rF c B t j | j | S r )r rt r r r1 s rD rt z_LowLevelFile.readE s wwtww%%rF c D t j | j | y r )r ru r r r@ s rD ru z_LowLevelFile.writeH s
! rF N)r r r r r r rt ru r rF rD r r 3 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 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 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__V 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 <Ls s .gzNz
iso-8859-1replace)r compressobjDEFLATED MAX_WBITS
DEF_MEM_LEVELr ri packrW time_Stream__writer endswithr r/ basenamer= r? )r r timestamps rD r z_Stream._init_write_gz s 99(( )-););*.))*=*=)=)-)@)@)* ,
KKc$))+&67 (94{BC 99 e $ #2DIGG$$TYY/ TYY%%lI>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 sy >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.__read. 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 K 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__D s <<$$Y/rF c P | j j | _ | j S r )r rt rk r s rD rt z_StreamProxy.readH 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.getcomptypeL sV 88 /
XXa]f
$!B 9)D
XX
!C
DrF c 8 | j j y r )r r r s rD r z_StreamProxy.closeV s rF N)r r r r r rt r r r rF rD r r ? 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__c 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$)) <DM }} r{{
"!| #DMMH$<a @
}} !$DMMH$<dii H
}} r{{
" DII$8$)) Da HDM }} /0 0rF c || j | j z
}n#t || j | j z
}d}|dkD r$ | j | j \ }}}}|| j cxk r|k rn nn?| xj dz
c_ | j t | j k( rd| _ vt ||| j z
}|re| j j || j |z
z | j j | }t | |k7 r t d ||z
}n |t |z z
}||z }| xj |z
c_ |dkD r$|S )z!Read data from the file.
rF r r- rp ) r1 r r+ r r r> 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 ] 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 i }| 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 ||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< |rk| j$ d |d< | j& d |d < | j( d |d
< | j* d |d < | j s| j! rt j j | j, r t/ | | j! rIt j j |t j j1 | | j, }n*t j j || j, }t j j | }t j j ||g |k7 r t3 | | |S ) N/r i @ i r r3 r4 r5 r6 )r r r/ realpathr seplstripisabsr r
commonpathr r isregislnkisdirissymr r3 r4 r5 r6 linknamer dirnamer )member dest_pathfor_data new_attrsr target_pathr s rD _get_filtered_attrsrj s^ I ;;D +I 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__-'//||~ ggll9+-77??4+@+1?? < !ggll9+1?? < ''**;7Kww!!; ":;yH1&+FF rF c | S r r )re rf s rD r r 1 s MrF c P t | |d }|r | j di |ddiS | S )NFdeepr rj r re rf rh s rD r r 4 s1 #FIu=I v~~6 666 MrF c P t | |d }|r | j di |ddiS | S )NTrm Fr rn ro s rD r r : s1 #FIt<I v~~6 666 MrF )
fully_trustedr r1 c B e Zd ZdZ edTi dddddddd d
d d d
ddddddddddddddd d d d d d!d"d#d$d%d&d%d'd%ZdUd(Zed) Zej d* Zed+ Z
e
j d, Z
d- Z e e e e e e e e d.e d/
d0Z
d1 Zeed2fd3Zd4 Zd5 Zd6 Zed7 Zd8 Zed9 Zed: Zed; Zed< Z ed= Z ed> 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.rc 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 rs REGTYPErt rc r5 r6 ru rv r r: r; rw r r s rD r zTarInfo.__init__p 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".rc r s rD r0 zTarInfo.linkpath r' rF c || _ y r r )r rc 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 rc r3 r4 r5 r6 rm _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 rc r3 r4 r5 r6 ) r r r2 r rc r3 r4 r5 r6 rm 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 rs rt rc r5 r6 ru rv rt r rW )r r r3 r4 r1 r2 rs rt rc r5 r6 ru rv 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<Return a tar header as a string of 512 byte blocks.
z%s may not be Nonezinvalid format) r itemsr< r create_ustar_headerr create_gnu_headerr create_pax_header)r rb rB rC r r values rD tobufz
TarInfo.tobuf s }} ::< >KD%} !5!<== > \ !++D(FC C
z
!))$&A A
z
!))$9 9 -. .rF c , t |d< t |d j || t kD r t d t |d j || t
kD r | j
|d || \ |d< |d< | j |t || S )z3Return the object as a ustar header block.
magicrc zlinkname is too longr prefix) POSIX_MAGICr> 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 rc 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/ rc r0 )r5 r5 )r6 r6 r rR rS ))r3 rP )r4 rP )r1 )r2 r Fr rP r- TrF r )r rw r r r r= UnicodeEncodeErrorr>
isinstancefloatroundstr_create_pax_generic_headerXHDTYPEr r )
r r rB rw r hnamerA ra needs_paxval val_is_floatval_intrk s
rD r zTarInfo.create_pax_header s
$W
&&++-
-
J /T&(>$@ 0 D% #
T
!!'84
4:'%)$Z E"! 0( R -LD& It*C%c51L$0eCjcG3!
"33 T
%T
T 4$'H D!% -* 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)clsrw s rD create_pax_global_headerz TarInfo.create_pax_global_header; 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.
rW r- Nzname is too long)splitrV r> r r=
LENGTH_PREFIXr r< )r r rB rC
componentsr[ r s rD r zTarInfo._posix_split_nameA s ZZ_
q#j/* 1AXXj!n-F88JqrN+D6==623}D Hf56+E t| 1 /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.
rt ru r rP rv r Nz TarInfo.type must not be Noner r r r r3 r4 r1 r r2 s rc 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_fieldsru rv filetypepartsrk rs s rD r zTarInfo._create_headerQ 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<<s45zI
rF c n t t | t \ }}|dkD r| t |z
t z z
} | S )zdReturn the string payload filled with zero bytes
up to the next 512 byte border.
r )rs r> 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 rt r1 r )r= r? r> r r r r )r r rt 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 rt r1 r r )
r r= r r> r r^ r r r r ) r rw rt rB binarykeywordr recordslrZ rK r s rD r z"TarInfo._create_pax_generic_header s ) / / 1 NGU
Wh/ 0 0G ) / / 1 VNGU nnW-G X/@A W-G s5z)A-AIACF O6
uSVW-4w>EMPUU UG! V( '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 rW i r r i i i )$r> r r r countr? r r\ rn rY rL r r r3 r4 r1 r2 rs rt rc r5 r6 ru rv AREGTYPEr r GNUTYPE_SPARSErV r< r boolrx ra rstrip GNU_TYPES)r rk rB rC rs 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.
) rt r r
_proc_gnulongr _proc_sparser r SOLARIS_XHDTYPE _proc_pax
_proc_builtin)r r= s rD r zTarInfo._proc_member 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.
rW )r r r: r_ rt SUPPORTED_TYPES_blockr1 r _apply_pax_inforw rB rC ra r r )r r= r s rD r zTarInfo._proc_builtin* 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.
NrW )r rt r r1 r r r r r rt r rL rB rC r r rc ra 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 )rx 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_sparse[ s )-(<(<%X //&&y1CC2Y
Sr!2 3F "3sRxb#9 :H hNNFH#56r
c#h J "??//1 ))DKK ,BB " s %C55 DDc V |j j | j | j }| j t
k( r
|j }n|j j }t j d| }|#|j d j d |d< |j d }|dk( r
|j }nd}t j d }d}|j || x}r|j! \ } }
t# | } | dk( r t% d ||j' d
dz |j) d | z dz
} | j+ |
dd|j, }
|
t. v r)| j+ | ||j |j, } n | j+ | dd|j, } | ||
< || z
}|j || x}r | j1 | } d |v r| j9 | | nSd |v r| j; | || 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 # t2 $ r}
t5 t7 |
dd}
~
ww xY w)zVProcess an extended or global header as described in
POSIX.1-2008.
s \d+ hdrcharset=([^\n]+)\nNr- r:
hdrcharsetBINARYs (\d+) ([^=]+)=r rU r. GNU.sparse.mapGNU.sparse.sizezGNU.sparse.major1zGNU.sparse.minorrT r1 )&r rt r r1 rt r rw r researchgrouprJ r rB compilematchgroupsrW rY r r2 _decode_pax_fieldrC PAX_NAME_FIELDSr r r r _proc_gnusparse_01_proc_gnusparse_00_proc_gnusparse_10r r r r r: r_ r )r r= rk rw r r rB regexr rA r r r r r s rD r zTarInfo._proc_paxw s
oo""4;;tyy#9:
99 !--K!--224K 7= (- A(=(=g(FK %
!__\2
! ''H H
-. {{3,,e, #llnOFG[F{()9:: ! q(Q &)@1)DEE ,,WgwNN$G/) ..uh@P@P ( ..ugw ( $)K 6MC1 {{3,,e,6 :##G,D
{ * # #D+ 6
+
- # #D+s ;
__ /
0C
7KOOL^<_cf<f # #D+w ? 99/2 2 g.>.> O ++DK$ ))::<499O#Cdkk$)) 44F!' = :'A/T 9 :s !L L(L##L(c P g }t j d| D ]+ }|j t |j d - g }t j d| D ]+ }|j t |j d - t t
|| |_ y)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 finditerr rW r listzipr; )r r rw rk offsetsr r s rD r zTarInfo._proc_gnusparse_00 s [[!BCH 0E NN3u{{1~. / 0[[!DcJ 1E OOC A / 0 13w12 rF c |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 rw xr; s rD r zTarInfo._proc_gnusparse_01 sW #..>"?"E"Ec"JKQ#a&KK3vcc{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 rw 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 rW N) r setattrrW
PAX_FIELDSPAX_NUMBER_FIELDSr< r r rw )r rw rB rC r r s rD r zTarInfo._apply_pax_info s * / / 1 .NGU++fe, --fc%j1 11fc%j1J& //" 1' :5 A f$ !LL -Egu- ." '++-
& " !"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_field s< D<<(3 3! D<< 1?C C Ds 22c H t |t \ }}|r|dz
}|t z S )z_Round up a byte count by BLOCKSIZE and return it,
e.g. _block(834) => 1024.
r- )rs r )r r rz r{ s rD r zTarInfo._block s, #5) 4 aKF !!rF c & | j t v S z4Return True if the Tarinfo object is a regular file.)rt
REGULAR_TYPESr s rD r_ z
TarInfo.isreg$ s yyM))rF c " | j S r )r_ r s rD isfilezTarInfo.isfile( s zz|rF c ( | j t k( S )z!Return True if it is a directory.)rt r r s rD ra z
TarInfo.isdir, yyG##rF c ( | j t k( S )z%Return True if it is a symbolic link.)rt SYMTYPEr s rD rb z
TarInfo.issym0 r" rF c ( | j t k( S )z!Return True if it is a hard link.)rt LNKTYPEr s rD r` z
TarInfo.islnk4 r" rF c ( | j t k( S )z(Return True if it is a character device.)rt r r s rD ischrz
TarInfo.ischr8 r" rF c ( | j t k( S )z$Return True if it is a block device.)rt r r s rD isblkz
TarInfo.isblk< r" rF c ( | j t k( S )z Return True if it is a FIFO.)rt FIFOTYPEr s rD isfifozTarInfo.isfifo@ s yyH$$rF c | j d uS r )r; r s rD issparsezTarInfo.issparseD s {{$&&rF c < | j t t t fv S )zCReturn True if it is one of character device, block device or FIFO.)rt r r r, r s rD isdevz
TarInfo.isdevG 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 r_ r ra rb r` r( r* r- r/ r1 r rF rD r r M s
,
!
G
H
-
$
>
F
*
*!
" /#
$ 5%
&9'
* .+
, -
. /
0 1
I6 0
[[ __! !O %eeuE88 *HEV /" I M 8Qt M M
' 'R * * 0- 0-d < <| ) )( /,68bH 3; ; ..D"* $$$$$%'9rF r c e Zd ZdZdZdZdZdZeZ e
Z dZ e
ZeZdZ d8dZedddefd Zed9d Zed:d
Zed:d Zed;d Zd
ddddZd Zd Z d Z d Z d<dZ d=dddZ d>dddZ!d?dZ"d Z#d@ddd d Z$dAddd d Z%d Z&d! Z'd" Z(d# Z)d$ Z* dBd%Z+d& Z,d' Z-d( Z.d) Z/d* Z0d+ Z1d, Z2d- Z3d. Z4d/ Z5dCd0Z6d1 Z7d?d2Z8d3 Z9d4 Z:d5 Z;d6 Z<d7 Z=y)Dr 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'r> r FNr r Tr r> r r )-r< r _moder r/ exists bltn_openr r r r r r^ abspathr rb r> dereference ignore_zerosrB rC r rw 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> rE rF rB rC rw rG rH rI modesr rk s rD r zTarFile.__init__h 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.<locals>.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 Fr@ zundiscernible mode)r< sortedrS r r r r r r r r popr r r rR )r r r r ry kwargsrT
error_msgsr func saved_posr error_msgs_summaryfilemoder streamr s ` rD r z TarFile.open s9 J G ./ / <
<J "3==n E
sCMM($;<& ' I c7=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.
r= r? )r< )r r r r r\ s rD rR zTarFile.taropen7 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< gziprg r r r r rR r r ) r r r r r r\ rg 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.
re rf r )BZ2Filer N)r r znot a bzip2 fileF) r< r rk r r rR r EOFErrorr r r ) r r r r r r\ rk 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.
re rf r )LZMAFiler r N)presetr znot an lzma fileF) r< r ro r r r rR rl r r r )
r r r r rp r\ ro 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#rR ri rm rq )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.
NTr@ 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.
rW 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.
)_checkrK _loadrJ 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.
awxNrW r r- r majorminor):ry r r r/
splitdriver r[ r\ r> r= rE lstatstatfstatfilenost_modeS_ISREGst_inost_devst_nlinkrL r& r{ S_ISDIRr S_ISFIFOr, S_ISLNKr$ readlinkS_ISCHRr S_ISBLKr r st_uidr3 st_gidr4 st_sizer1 st_mtimer2 rt rc pwdgetpwuidr5 rv grpgetgrgidr6 r r st_rdevru r rv ) r r arcnamer drvr> statresrc stmdinodert s rD
gettarinfozTarFile.gettarinfo s
E <<D
?Gww))'2 W//"&&#...% ,,. ?## ((4. ''$-hhw~~ /0G << ^^W^^4E##(8(81(<T[[(W E8J-J ;;u- 8)0DKK&
\\$
D
]]4
D
\\$
D{{4(H
\\$
D
\\$
D nn nn 7?"??GL GL ((
#
# W[[ 9! <
# W[[ 9! <
GW% %r7#G(<#%88GOO#< #%88GOO#<
s$ ,'M9 'N 9 NN NN)rJ c | j || }|D ] }|r&|j t d n(t t j |j t |j
xs |j d|j xs |j |j s|j r(t dd|j |j fz z nt d|j z |j t d n.t dt j |j dd z t |j" |j% rdnd
z |rP|j' rt d |j( z |j+ rt d |j( z t- y)
a 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. `members' is optional and must be a subset of the
list returned by getmembers().
Nz
??????????rW z%10sz%d,%dz%10dz????-??-?? ??:??:??z%d-%02d-%02d %02d:%02d:%02dr r z-> zlink to )ry r r r ra r5 r3 r6 r4 r( r* ru rv r1 r2 r localtimer ra rb rc r` r )r verboserJ r> s rD r
z TarFile.list6 sk
?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 %rr: r )ry r r r/ rD _dbgr r_ rC addfilera rZ listdiraddr )r r r recursiver r> fs rD r z TarFile.add\ s
E ?G 99 RWW__T%:dii%G IIa.5 6 !T //$0 ? IIa7$> ? WoG ! 3d :; ==?4&
)! Wa(
)
) ]]_ LL !
4 01 6AHHRWW\\$ 2BGGLL!4L %f 66
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- )ry r r rb rB rC r ru r r> rI rr r1 rs r r? rJ 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 |K| j }| t j dt t S t |t r t d |S t | r|S t | S # t $ r t d|d d w xY w)NzPython 3.14 will, by default, filter extracted tar archives and reject files or modify their metadata. Use the filter argument to control this behavior.zrString names are not supported for TarFile.extraction_filter. Use a function such as tarfile.data_filter directly.zfilter z
not found) extraction_filterwarningswarnDeprecationWarningr r r TypeErrorcallable_NAMED_FILTERSrv r< )r r s rD _get_filter_functionz TarFile._get_filter_function s >++F~
J ' (
,+&#& 67 7 M F M G!&) ) G wvj
;<$ F Gs A% %A?)
numeric_ownerr c @ g }| j | }|| }|D ]] }| j ||| }||j r|j | | j |||j | _ |j d d |D ]e }t j j ||j } | j || | | j || | j || g y# t $ r}
| j |
Y d}
~
d}
~
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 c | j S r r~ )r> s rD <lambda>z$TarFile.extractall.<locals>.<lambda> s
qvv rF T)rU reverse)r )r _get_extract_tarinfora r _extract_onesortr r/ r r chownutimechmodr _handle_nonfatal_error) r r/ rJ r r directoriesfilter_functionre r> dirpathr s rD
extractallzTarFile.extractall s! 33F; ?G
;F//NG}} ""7+ gt7==?7J,9
;
; -t< # /Gggll4 6G
/
7G=
I
7G,
7G, /
/++A..
/s >8C99 D DD c z | 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 re r/ r r r r r> s rD extractzTarFile.extract sG 33F;++FOTJ gtY
F rF c t |t r| j | }n|}|} ||| }| | j dd|j z y|j rDt j | }t j j ||j |_ |S # t t f$ r}| j | Y d}~d}~wt $ r}| j | Y d}~d}~ww xY w)z@Get filtered TarInfo (or None) from member, which might be a strNr. r )r r rw r r _handle_fatal_errorr r r r r` r r r/ r rc ry )r re r r/ r>
unfilteredr s rD r z TarFile._get_extract_tarinfo s fc "nnV,G G
+%gt4G
? IIa/*//A B ==?ii(G#%77<<g6F6F#GG % ( $ $Q ' ' + ' ' * * +s# B) )C58C C5C00C5c 4 | j d | j |t j j ||j
|| y# t $ r}| j | Y d}~yd}~wt $ r}| j | Y d}~yd}~ww xY w)z%Extract from filtered tarinfo to diskr r N)
ry _extract_memberr r/ r r r r r r )r r> r/ r r r s rD r zTarFile._extract_one s C + "'',,tW\\*J+4/<
!
> ( $ $Q ' ' + ' ' * * +s# =A BA00 B<BBc N | j dkD r | j dd|z y)z=Handle non-fatal error (ExtractError) according to errorlevelr- tarfile: %sN)rH 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 )rH r r filenamer strerrorrt 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)ry r r rw r_ rt r
fileobjectr` rb r r r
extractfile_find_link_target)r re r> s rD r zTarFile.extractfile6 s
C fc "nnV,G G ==?gll/ A??41 1
]]_
$,,0 ""KLL ''(>(>w(GHH rF 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+ || nj|j s|j r| j- || n7|j. t0 vr| j3 || n| j || |rI| j5 ||| |j s%| j7 || | j9 || yyy)z\Extract the TarInfo object tarinfo to a physical
file called targetpath.
rW r- z -> N) r r r r[ r/ rd rB makedirsr` rb r r rc r_ makefilera makedirr- makefifor( r* makedevmakelinkrt r makeunknownr r r )r r>
targetpathr r upperdirss rD r zTarFile._extract_memberV s &&s+
''RVV4
GGOOJ/ RWW^^I 6
KK " ==?gmmo IIaw||W5E5EF G IIa & ==? MM': .
]]_ LL* -
^^
MM': .
]]_
LL* -
]]_
MM': .
\\
0 Wj 1 MM': . JJw
M :==?
7J/
7J/ # rF c |j t j | yt j |d y# t $ r Y yw xY w)z,Make a directory called targetpath.
Ni )r r mkdirFileExistsErrorr r> r s rD r zTarFile.makedir s? ||#$ U+ s !; ; AAc | 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.
r; N)
r r r: rI rC r; rr r r1 truncate)r r> r sourcery targetr r1 s rD r zTarFile.makefile s G''(""
z4
( NF~~)$+NN JLFDKK' iIJ GLL)!FFGLL)WM N N Ns
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 rt r s rD r zTarFile.makeunknown 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<Make a character or block device called targetpath.
mknodr z'special devices not supported by systemNrY ) r r r r r* r S_IFBLKS_IFCHRr r ru rv )r r> r r s rD r zTarFile.makedev s r7#72y+A HI I|| <D ==? DLL D DLL D
TG , ,g.>.>? ArF c : |j rUt j j | rt j | t j
|j | yt j j |j r!t j |j | y| j | j | | y# t $ r> | j | j | | Y y# t $ r
t d dw xY ww xY w)zMake 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.
z%unable to resolve link inside archiveN)rb r r/ lexistsunlinksymlinkrc rB ry linkr r symlink_exceptionrv r r s rD r zTarFile.makelink s
V}}77??:.IIj)
7++Z877>>'"6"67GGG 0 0*=(()?)?)H)35 V
V$$T%;%;G%D%/1
V"#JKQUU
V Vs+ A$C 'A C 1!C D !D DDc 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 getgrnamrv r r5 getpwnamrb 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"#;<!C
DsB 4D 84D 57D% -D% DD D"!D"% D?. D::D?c |j y t j ||j y# t $ r}t d |d}~ww xY w)zASet file permissions of targetpath according to tarinfo.
Nzcould not change mode)r r r r r )r r> 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: )ry rM r r r r rt r r> r r rF r r rY r r r r Exceptionr r r r rJ r rK )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/ normpathreversedr r ) r r r> normalizerJ skippingr re member_names rD ru zTarFile._getmemberZ
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 rK r s rD rz 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 ry zTarFile._check
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.
rW NT)r> r zlinkname %r not found)
rb r r r r/ rd r rc ru rv )r r> rc limitre 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)rK rJ rM r r> )r r r> s rD __iter__zTarFile.__iter__
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.
fileN)rG r r stderr)r levelmsgs rD r z TarFile._dbg
s# DJJ #CJJ ' rF c & | j | S r )ry r s rD __enter__zTarFile.__enter__
s
rF c || j y | j s| j j d| _ y r )r r r r )r rt r tracebacks rD __exit__zTarFile.__exit__
s2 < JJL ## ""$ DKrF )
Nr NNNNNNr NNNN)r N)r NrY )r NN)NNNTr r ).N)r T)TFr" )>r r r r rG rE rF rH r rb r
rB rC r r> r8 r r r r6 rs r rR ri rm rq rS r rw 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 ru rz ry r r r r r r rF rD r r L s
EK L J FH
FG J AEHL>B)-b^ #tZ ]/ ]/~ 2 2 @ 6 : I%* ? aF$D $L1" 1"f%2G.+/% +/ZGG&. +,
C @ >B&+*0b N B?A$V2 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 | r<t& j |d( 5 }|j% |j ) d d d y |j d"d'j# | y |j +t) |j d"k( r |j d }t* j, }nHt) |j d*k( r|j \ }}n |j d"|j/ t r}t& j |d( 5 }|j1 |j + d d d |j rWd,k( rd-j# | } nd.j# || } t | y |j d"d'j# | y y |j2 |j2 j5 d }
t* j6 j9 |
\ } } d/d/d0d0d1d1d1d1d2}
| |
v rd3|
| z nd4}|j2 }t& j |
| 5 }|D ] }|j; | d d d |j rt d5j# |
y y y # 1 sw Y xY w# 1 sw Y y xY w# 1 sw Y VxY w# 1 sw Y XxY w)6Nr z3A simple command-line interface for tarfile module.) descriptionz-vz --verbose
store_trueFzVerbose output)actiondefaulthelpz--filterz <filtername>zFilter for extraction)metavarchoicesr' T)requiredz-lz--list <tarfile>zShow listing of a tarfile)r( r' z-ez --extract+)r+ z <output_dir>z Extract tarfile into target dir)nargsr( r' z-cz--create)z<name>z<file>zCreate tarfile from sourcesz-tz--testzTest if a tarfile is validr- z&--filter is only valid for extraction
r r z{!r} is a tar archive.z{!r} is not a tar archive.
rP )r r. )r/ r r 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 creater[ r/ splitextr )r. r# parserr argsrv r tfr5 r tar_name_ext compressionstar_mode tar_files file_names rD mainrC
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
93 cnn&SZZ8
9 ||.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
9
9
.
.
?
?> " "s0 :P- P: Q"Q-P7:QQQ __main__r )jr version
__author__ __credits__builtinsr rC r r r) rq r r ri r r r r r r AttributeErrorNotImplementedErrorr r __all__r? r rs r r r r r r{ r r& r$ r r r r, 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 rj r r r r r r r r rC r r rF rD <module>rP s{ : 6
H
'
$%8'B *
^
HgGXWg#%5! # (>+
/
.
9
77d?H(s((*H 0&
( N
< * "&$ 2 y 8 x ( ( { ; [ K 0q qh 6 <e& eP"2$$ " ( J J
?k ?@{ @
L L
?+ ?=~ * | 9f | 9~K f K b$$ ||]9~ zF yX
C
Cs" H4 I 4H?>H?I
I
Browse
Usage
Versions