/usr/lib/python3.10/__pycache__
Edit: /usr/lib/python3.10/__pycache__/tarfile.cpython-310.pyc (71578B)
o
9j, @ s d Z dZdZdZddlmZ ddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlZddlZddlZzddlZW n eyG dZY nw zddlZW n eyY dZY nw eefZzeef7 ZW n eyn Y nw g dZdZd Zed
Z d Z d Z d
Z d
Z dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/d Z0dZ1d Z2d Z3e3Z4e"e#e$e%e(e)e*e&e'e+e,e-f Z5e"e#e*e-fZ6e+e,e-fZ7d Z8h d Z9e:e:e:e;e;e;d!Z
ne? Z>d$d% Z@d&d' ZAd(d) ZBd*e4fd+d,ZCd-d. ZDdedfd/d0ZEd1d2 ZFG d3d4 d4eGZHG d5d6 d6eHZIG d7d8 d8eHZJG d9d: d:eHZKG d;d< d d>eHZMG d?d@ d@eMZNG dAdB dBeMZOG dCdD dDeMZPG dEdF dFeMZQG dGdH dHeMZRG dIdJ dJZSG dKdL dLZTG dMdN dNeUZVG dOdP dPeUZWG dQdR dRe jXZYG dSdT dTeHZZG dUdV dVeZZ[G dWdX dXeZZ\G dYdZ dZeZZ]G d[d\ d\eZZ^G d]d^ d^eZZ_dsd`daZ`dbdc Zaddde Zbdfdg ZceaebecdhZdeU ZeefdiZgG djdk dkeUZhG dldm dmeUZidndo ZjeijZdpdq Zkeldrkrek dS dS )tz,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 i s ustar s ustar 00d 0 1 2 3 4 5 6 7 L K S x g X )pathlinkpathsizemtimeuidgidunamegname> r% r, r+ r& )atimectimer( r) r* r' ntutf-8c C s8 | du rt d| ||} | d| |t| t S )z8Convert a string to a null-terminated bytes object.
Nz metadata cannot contain None)
ValueErrorencodelenNUL)slengthencodingerrors r9 /usr/lib/python3.10/tarfile.pystn s r; c C s* | d}|dkr| d| } | ||S )z8Convert a null-terminated bytes object to a string.
r N)finddecode)r5 r7 r8 pr9 r9 r: nts s
r@ c C s | d dv r2d}t t| d D ]}|dK }|| |d 7 }q| d dkr0dt| d | }|S zt| dd} t| p?d d}W |S tyO td
w ) z/Convert a number field to a python number.
r ) r# rB asciistrict0invalid header)ranger3 r@ intstripr1 InvalidHeaderError)r5 nir9 r9 r: nti s rO rC c C s | }t | } d| krd|d k r%n ntd|d | f dt }|S |tkrmd|d | kr print)r5 r7 r9 r9 r: _safe_print s rt c @ e Zd ZdZdS )r zBase exception.N__name__
__module__ __qualname____doc__r9 r9 r9 r: r r c @ ru )r
z%General exception for extract errors.Nrv r9 r9 r9 r: r
r{ r
c @ ru )r z&Exception for unreadable tar archives.Nrv r9 r9 r9 r: r r{ r c @ ru )r z.Exception for unavailable compression methods.Nrv r9 r9 r9 r: r r{ r c @ ru )r z=Exception for unsupported operations on stream-like TarFiles.Nrv r9 r9 r9 r: r r{ r c @ ru )r z!Base exception for header errors.Nrv r9 r9 r9 r: r r{ r c @ ru )EmptyHeaderErrorz Exception for empty headers.Nrv r9 r9 r9 r: r| ! r{ r| c @ ru )TruncatedHeaderErrorz Exception for truncated headers.Nrv r9 r9 r9 r: r} $ r{ r} c @ ru )EOFHeaderErrorz"Exception for end of file headers.Nrv r9 r9 r9 r: r~ ' r{ r~ c @ ru )rL z Exception for invalid headers.Nrv r9 r9 r9 r: rL * r{ rL c @ ru )SubsequentHeaderErrorz3Exception for missing and invalid extended headers.Nrv r9 r9 r9 r: r - r{ r c @ 0 e Zd ZdZdd Zdd Zdd Zdd Zd
S )
_LowLevelFilezLow-level file object. Supports reading and writing.
It is used instead of a regular file object for streaming
access.
c C sF t jt jt jB t jB d| }tt dr|t jO }t ||d| _d S )NrwO_BINARYi ) osO_RDONLYO_WRONLYO_CREATO_TRUNChasattrr r fd)selfnamemoder9 r9 r: __init__: s
z_LowLevelFile.__init__c C s t | j d S N)r closer r r9 r9 r: r C s z_LowLevelFile.closec C s t | j|S r )r rd r r r' r9 r9 r: rd F z_LowLevelFile.readc C s t | j| d S r )r re r r r5 r9 r9 r: re I s z_LowLevelFile.writeN)rw rx ry rz r r rd re r9 r9 r9 r: r 4 s r c @ sr e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dd Z
dd Z d ddZ dd Z
dd Zdd ZdS ) _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 C s d| _ |du rt||}d| _ |dkrt|}| }|p d| _|| _|| _|| _|| _d| _ d| _
d| _ z|dkrlzddl }W n t
yL td dw || _ |d| _|d
kre| |j| _W dS | W dS |d krzddl}W n t
y td dw |d
krd| _| | _t| _W dS | | _W dS |d
krzddl}W n t
y tddw |d
krd| _| | _|j | _W dS | | _W dS |dkrtd| W dS | j s| j d| _ )z$Construct a _Stream object.
TNF* r gzz zlib module is not availabler bz2bz2 module is not availablexz lzma module is not availabletarunknown compression type %r) _extfileobjr _StreamProxy getcomptyper r comptypefileobjri r\ posclosedzlib ImportErrorr crc32crc
_init_read_gzerrorrh _init_write_gzr dbufBZ2DecompressorcmpOSError
BZ2CompressorlzmaLZMADecompressor LZMAErrorLZMACompressorr ) r r r r r ri r r r r9 r9 r: r W st
z_Stream.__init__c C s$ t | dr| js| d S d S d S )Nr )r r r r r9 r9 r: __del__ s z_Stream.__del__c C s | j d| j j| j j | j jd| _tdtt }|
d| d | j dr3| j dd | _ t
j| j | _ |
| j d d
t dS ) z6Initialize for writing with gzip compression.
r s
r c @ sj e Zd ZdZdddZdd Zdd Zd d
Zd d Zd
d Z e
j fddZ dddZ
dd Zdd ZdS ) _FileInFilezA thin wrapper around an existing file object that
provides a part of its data as an individual file
object.
Nc C s || _ || _|| _d| _t|dd | _d| _|d u r d|fg}d| _g | _d}| j}|D ]&\}}||kr>| j d||d f | j d||| |f ||7 }|| }q,|| jk re| j d|| jd f d S d S )Nr r FT)
r offsetr' positionrp r r map_indexmapr )r r r r' blockinfolastposrealposr9 r9 r: r b s*
z_FileInFile.__init__c C s d S r r9 r r9 r9 r: r { z_FileInFile.flushc C dS NTr9 r r9 r9 r: readable~ r z_FileInFile.readablec C r NFr9 r r9 r9 r: writable r z_FileInFile.writablec C s
| j S r )r seekabler r9 r9 r: r
z_FileInFile.seekablec C r )z*Return the current file position.
)r r r9 r9 r: r r z_FileInFile.tellc C s |t jkrtt|d| j| _| jS |t jkr4|dk r't| j| d| _| jS t| j| | j| _| jS |t jkrItt| j| | jd| _| jS td)z(Seek to a position in the file.
r zInvalid argument) ioSEEK_SETminmaxr' r SEEK_CURSEEK_ENDr1 )r r whencer9 r9 r: r s
z_FileInFile.seekc C s |du r | j | j }n t|| j | j }d}|dkr | j| j \}}}}|| j kr0|k r3n nn| jd7 _| jt| jkrEd| _qt||| j }|rp| j|| j| | j|}t||krkt d||7 }n|t
| 7 }||8 }| j|7 _|dks|S )z!Read data from the file.
Nr r Tr# r` ) r' r r r r r3 r r rd r r4 ) r r' r\ datastartstopr r6 rl r9 r9 r: rd s2
z_FileInFile.readc C s& | t|}||d t|< t|S r )rd r3 )r rl r\ r9 r9 r: readinto s z_FileInFile.readintoc C s
d| _ d S r )r r r9 r9 r: r r z_FileInFile.closer )rw rx ry rz r r r r r r r r r rd r r r9 r9 r9 r: r \ s
r c e Zd Z fddZ ZS ) ExFileObjectc s& t |j|j|j|j}t | d S r )r r offset_datar' sparsesuperr )r tarfiletarinfor __class__r9 r: r s
zExFileObject.__init__rw rx ry r
__classcell__r9 r9 r r: r s r c @ s e Zd ZdS ) FilterErrorN)rw rx ry r9 r9 r9 r: r s r c r )AbsolutePathErrorc s || _ t d|jd d S )Nzmember z has an absolute pathr r r r r r r r9 r: r s zAbsolutePathError.__init__r
r9 r9 r r: r
r
c r )OutsideDestinationErrorc . || _ || _t |jd|dd d S )Nz would be extracted to , which is outside the destinationr _pathr r r r r r% r r9 r: r
z OutsideDestinationError.__init__r
r9 r9 r r: r r r c r )SpecialFileErrorc || _ t |jd d S )Nz is a special filer r r r9 r: r zSpecialFileError.__init__r
r9 r9 r r: r r r c r )AbsoluteLinkErrorc r )Nz! is a symlink to an absolute pathr r r r9 r: r r zAbsoluteLinkError.__init__r
r9 r9 r r: r r r c r )LinkOutsideDestinationErrorc r )Nz would link to r r r r r r9 r: r r z$LinkOutsideDestinationError.__init__r
r9 r9 r r: r r r Tc C s i }| j }tj|}|dtjfr | jdtj }|d< tj|r*t| tjtj ||}tj
||g|krDt | || j }|d ur~|d@ }|ru|
sY| rf|d@ sa|dM }|dO }n| sn| rqd }nt| || j kr~||d< |r| jd urd |d< | jd urd |d < | jd urd |d
< | jd urd |d < | s| rtj| jrt| tjtj || j}tj
||g|krt| ||S ) N/r i @ i r r) r* r+ r, )r r r% realpathr seplstripisabsr
r
commonpathr r isregislnkisdirissymr r) r* r+ r, linknamer r )member dest_pathfor_data new_attrsr target_pathr r9 r9 r: _get_filtered_attrs sN
r0 c C s | S r r9 )r+ r, r9 r9 r: fully_trusted_filter) r r1 c C s, t | |d}|r| jdi |ddiS | S )NFdeepr9 r0 r r+ r, r. r9 r9 r:
tar_filter, r5 c C s, t | |d}|r| jdi |ddiS | S )NTr2 Fr9 r3 r4 r9 r9 r: data_filter2 r6 r7 )
fully_trustedr r s ([0-9]{1,20}) c @ sP e Zd ZdZedi dddddddd d
d d d
ddddddddddddddd d d d d d!d"d#d$d%d&d%d'd%Zdd)d*Zed+d, Zej d-d, Zed.d/ Z
e
j d0d/ Z
d1d2 Z e e e e e e e e d3e d4
d5d6Z
d7d8 Zeed9fd:d;Zdd? Zd@dA ZedBdC ZdDdE ZedFdG ZedHdI ZedJdK ZedLdM Z edNdO Z ed3dPdQdRZ edSdT Z ed3dPdUdVZ dWdX Z!dYdZ Z"d[d\ Z#d]d^ Z$d_d` Z%dadb Z&dcdd Z'dedf Z(dgdh Z)didj Z*dkdl Z+dmdn Z,dodp Z-dqdr Z.dsdt Z/dudv Z0dwdx Z1dydz Z2d{d| Z3d}d~ Z4dd Z5d%S )r 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.r) z6User ID of the user who originally stored this member.r* z7Group ID of the user who originally stored this member.r' zSize in bytes.r( 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.r+ z
User name.r, 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_targetr c C sj || _ d| _d| _d| _d| _d| _d| _t| _d| _ d| _
d| _ d| _ d| _
d| _d| _d| _i | _dS )zXConstruct a TarInfo object. name is the optional name
of the member.
i r r N)r r r) r* r' r( r9 REGTYPEr: r* r+ r, r; r< r r r r= r r r9 r9 r: r k s"
zTarInfo.__init__c C r )z(In pax headers, "name" is called "path".r r r9 r9 r: r% r z TarInfo.pathc C
|| _ d S r rB rA r9 r9 r: r%
c C r )z0In pax headers, "linkname" is called "linkpath".r* r r9 r9 r: r& r zTarInfo.linkpathc C rC r rE )r r* r9 r9 r: r& rD c C s d| j j| jt| f S )Nz<%s %r at %#x>)r rw r idr r9 r9 r: __repr__ s zTarInfo.__repr__T)
r r( r r* r) r* r+ r, r2 _KEEPc
C s | rt | } nt | } ||
ur|| _||
ur|| _||
ur"|| _||
ur)|| _||
ur0|| _||
ur7|| _||
ur>|| _||
urE|| _ | S )zGReturn a deep copy of self with the given attributes replaced.
)
copydeepcopyr r( r r* r) r* r+ r, ) r r r( r r* r) r* r+ r, r2 rH resultr9 r9 r: r s(
zTarInfo.replacec C s | j du rd}n| j d@ }| j|| j| j| j| j| j| j| j| j | j
| j | j d
}|d t
kr>|d ds>|d d7 < |S )z9Return the TarInfo's attributes as a dictionary.
N )
r r r) r* r' r( r9 r: r* r+ r, r; r< r: r r )r r r) r* r' r( r9 r: r* r+ r, r; r< DIRTYPEr )r r infor9 r9 r: get_info s(
zTarInfo.get_infosurrogateescapec C sv | }| D ]\}}|du rtd| q|tkr"| |||S |tkr-| |||S |tkr7| ||S td)z r( rstrip GNU_TYPES)rq r\ r7 r8 r r9 objrX r structsrN r numbytes
isextendedorigsizer9 r9 r: r s\
zTarInfo._frombufc C s
| |S )zOReturn the next TarInfo object from TarFile object
tarfile.
) _fromtarfile)rq r r9 r9 r: fromtarfile s
zTarInfo.fromtarfilec C s< |j t}| j||j|j|d}|j t |_||S )z;
See dircheck documentation in _frombuf().
r ) r rd r r r7 r8 r r _proc_member)rq r r r\ r r9 r9 r: r s
zTarInfo._fromtarfilec C sP | j ttfv r | |S | j tkr| |S | j tttfv r#| |S |
|S )zYChoose the right processing method depending on
the type and call it.
) r: ra r`
_proc_gnulongr _proc_sparserj rp SOLARIS_XHDTYPE _proc_pax
_proc_builtin)r r r9 r9 r: r - s
zTarInfo._proc_memberc C sh |j | _| j}| s| jtvr|| | j7 }||_| |j
|j |j |
r2| jd| _| S )zfProcess a builtin type or an unknown type which
will be treated as a regular file.
r )r r r r& r: SUPPORTED_TYPES_blockr' r _apply_pax_infor= r7 r8 r( r r )r r r r9 r9 r: r : s zTarInfo._proc_builtinc
C s |j | | j}z | j|dd}W n ty& } ztt|dd}~ww | j|_| j t
kr:t ||j |j
|_n| j tkrHt ||j |j
|_| rS|jd|_|S )zSProcess the blocks that hold a GNU longname
or longlink member.
Fr Nr )r rd r r' r r r rh r r: ra r@ r7 r8 r r` r* r( removesuffix)r r r\ nextr r9 r9 r: r P s
zTarInfo._proc_gnulongc
C s | j \}}}| ` |rS|jt}d}tdD ]4}zt|||d }t||d |d } W n
ty: Y nw |rF| rF||| f |d7 }qt|d }|s
|| _ |j
| _ | j | | j
|_|| _
| S )z8Process a GNU sparse header plus extra headers.
r rc r i )r> r rd r rI rO r1 r r r r r r r' r )
r r r r r r\ r rN r r r9 r9 r: r k s,
zTarInfo._proc_sparsec
C s |j | | j}| jtkr|j}n|j }d}d}g }t||kr|| dkrt
|| }s6t dz t |
d}W n tyJ t dw |dk rSt d|| t|kr_t d|d| d } ||dd | }
|
d\} } }
| r| dks|| dkrt d||| |
f | dkr|du r|
d kr|j}nd
}||7 }t||kr|| dks*|du rd
}|D ]*\}} }
| | d
d
|j}|tv r| |
||j|j}n | |
d
d
|j}|||< qz | j|d d }W n ty } ztt|dd}~ww d
|v r| || n#d|v r | || n| ddkr5| ddkr5| ||| | jt t fv rh|!||j|j | j"|_"d|v rh|j#}|$ s]|jt%vre|||j7 }||_"|S )zVProcess an extended or global header as described in
POSIX.1-2008.
r NrH r# r r s
hdrcharsets BINARYr0 Fr GNU.sparse.mapGNU.sparse.sizezGNU.sparse.major1zGNU.sparse.minorrG r' )&r rd r r' r: rp r= rI r3 _header_length_prefix_rematchrL rJ groupr1 r ro partitionr r7 _decode_pax_fieldr8 PAX_NAME_FIELDSr r r rh _proc_gnusparse_01_proc_gnusparse_00rv _proc_gnusparse_10rj r r r r r& r )r r r\ r= r r7 raw_headersr r6 header_value_end_offsetkeyword_and_value raw_keywordequals raw_valuer rU r r r r9 r9 r: r s
)
zTarInfo._proc_paxc C s g }g }|D ];\}}}|dkr&z | t| W q ty% tdw |dkrAz | t| W q ty@ tdw qtt|||_dS )z?Process a GNU tar extended sparse header, version 0.0.
s GNU.sparse.offsetrH s GNU.sparse.numbytesN)r rJ r> r1 rL listzipr )r r r offsetsr _r rU r9 r9 r: r s" zTarInfo._proc_gnusparse_00c C s@ dd |d dD }tt|ddd |ddd |_dS )z?Process a GNU tar extended sparse header, version 0.1.
c S s g | ]}t |qS r9 )rJ ).0xr9 r9 r:
s z.TarInfo._proc_gnusparse_01..r ,Nr$ r# )rs r r r )r r r= r r9 r9 r: r s (zTarInfo._proc_gnusparse_01c C s d}g }|j t}|dd\}}t|}t||d k rAd|vr*||j t7 }|dd\}}|t| t||d k s |j |_t t
|ddd |ddd |_ dS )z?Process a GNU tar extended sparse header, version 1.0.
Nr r# r$ ) r rd r rs rJ r3 r r r r r r )r r r= r fieldsr r\ numberr9 r9 r: r s (zTarInfo._proc_gnusparse_10c C s | D ]T\}}|dkrt| d| q|dkr t| dt| q|dkr-t| dt| q|tv rX|tv rIzt| |}W n tyH d}Y nw |dkrR|d}t| || q| | _dS ) zoReplace fields with supplemental information from a previous
pax extended or global header.
zGNU.sparse.namer% r r' zGNU.sparse.realsizer r N) rQ setattrrJ
PAX_FIELDSPAX_NUMBER_FIELDSr1 r rI r= )r r= r7 r8 r rU r9 r9 r: r * s&
zTarInfo._apply_pax_infoc C s. z| |dW S ty | || Y S w )z1Decode a single field from a pax record.
rF )r> UnicodeDecodeError)r rU r7 fallback_encodingfallback_errorsr9 r9 r: r A s
zTarInfo._decode_pax_fieldc C s2 |dk rt dt|t\}}|r|d7 }|t S )z_Round up a byte count by BLOCKSIZE and return it,
e.g. _block(834) => 1024.
r zinvalid offsetr# )rL rc r )r r rj rk r9 r9 r: r I s zTarInfo._blockc C s
| j tv S z4Return True if the Tarinfo object is a regular file.)r:
REGULAR_TYPESr r9 r9 r: r& U rD z
TarInfo.isregc C s | S r )r& r r9 r9 r: isfileY s zTarInfo.isfilec C
| j tkS )z!Return True if it is a directory.)r: rM r r9 r9 r: r( ] rD z
TarInfo.isdirc C r )z%Return True if it is a symbolic link.)r: SYMTYPEr r9 r9 r: r) a rD z
TarInfo.issymc C r )z!Return True if it is a hard link.)r: LNKTYPEr r9 r9 r: r' e rD z
TarInfo.islnkc C r )z(Return True if it is a character device.)r: rw r r9 r9 r: ischri rD z
TarInfo.ischrc C r )z$Return True if it is a block device.)r: rx r r9 r9 r: isblkm rD z
TarInfo.isblkc C r )z Return True if it is a FIFO.)r: FIFOTYPEr r9 r9 r: isfifoq rD zTarInfo.isfifoc C s
| j d uS r )r r r9 r9 r: issparseu r zTarInfo.issparsec C s | j tttfv S )zCReturn True if it is one of character device, block device or FIFO.)r: rw rx r r r9 r9 r: isdevx s z
TarInfo.isdevr9 )r )6rw rx ry rz dict __slots__r propertyr% setterr& rG rH r rO r r rV rR rS rT classmethodrr r\ staticmethodr] r} r_ ri 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 r9 r9 r9 r: r H s
:
)
2
C
y r c @ s e Zd ZdZdZdZdZdZeZ e
Z dZ e
ZeZdZ dfdd Zedddefd
d Zedgd d
ZedhddZedhddZediddZdddddZdd Zd d Z d d Z d d! Z djd"d#Z dkdd%d&d'Z dldd(d)d*Z!dmd+d,Z"d-d. Z#dnddd0d1d2Z$doddd0d4d5Z%d6d7 Z&d8d9 Z'd:d; Z(dd? Z* $ dpd@dAZ+dBdC Z,dDdE Z-dFdG Z.dHdI Z/dJdK Z0dLdM Z1dNdO Z2dPdQ Z3dRdS Z4dTdU Z5dqdVdWZ6dXdY Z7dmdZd[Z8d\d] Z9d^d_ Z:d`da Z;dbdc Z.not_compressed)keyNr z - method z:
z'file could not be opened successfully:
:r# r r |r zmode must be 'r' or 'w'Fr zundiscernible mode)r1 sortedr rp r r r r r r rs r r r r )rq r r r ri kwargsr
error_msgsr func saved_posr error_msgs_summaryfilemodestreamr r9 r r: r sZ %
z TarFile.openc K s$ |dvrt d| |||fi |S )zCOpen uncompressed tar archive name for reading or writing.
r r )r1 )rq r r r r r9 r9 r: r f s zTarFile.taropenr c
K s |dvrt dzddlm} W n ty tddw z |||d ||}W n tyB } z|dur=|dkr=td | d}~ww z
| j|||fi |}W n! tyj } z| |dkretd | d}~w | d
|_ |S ) 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 availableNrl r r F)
r1 gzipr r r r r r r r ) rq r r r
compresslevelr r r r r9 r9 r: gzopenn s8
zTarFile.gzopenc
K s |dvrt dzddlm} W n ty tddw ||p!|||d}z
| j|||fi |}W n# ttfyO } z| |dkrJt d | d}~w | d
|_
|S ) zlOpen bzip2 compressed tar archive name for reading or writing.
Appending is not allowed.
r r r )BZ2Filer N)r r znot a bzip2 fileF) r1 r r r r r r EOFErrorr r r ) rq r r r r r r r r r9 r9 r: bz2open s*
zTarFile.bz2openc
K s |dvrt dz
ddlm}m} W n ty tddw ||p#|||d}z
| j|||fi |}W n# |tfyQ } z| |dkrLt d | d} ~ w | d
|_
|S ) zkOpen lzma compressed tar archive name for reading or writing.
Appending is not allowed.
r r r )LZMAFiler r N)presetr znot an lzma fileF) r1 r r r r r r r r r r )
rq r r r r r r r r r r9 r9 r: xzopen s*
zTarFile.xzopenr r
r
r )r r r r c C s | j rdS d| _ z;| jdv r7| jttd | jtd 7 _t| jt\}}|dkr7| jtt| W | j sB| j
dS dS | j sM| j
w w )zlClose the TarFile. In write-mode, two finishing zero blocks are
appended to the archive.
NTr r$ r ) r r r re r4 r r rc
RECORDSIZEr r )r rj rk r9 r9 r: r s
z
TarFile.closec C s( | |d}|du rtd| |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.
r Nzfilename %r not found)
_getmemberr KeyError)r r r r9 r9 r: getmember s zTarFile.getmemberc C s | | js | | jS )zReturn the members of the archive as a list of TarInfo objects. The
list has the same order as the members in the archive.
)_checkr _loadr r r9 r9 r:
getmembers s zTarFile.getmembersc C s dd | D S )zReturn the members of the archive as a list of their names. It has
the same order as the list returned by getmembers().
c S s g | ]}|j qS r9 rB )r r r9 r9 r: r s z$TarFile.getnames..)r r r9 r9 r: getnames s zTarFile.getnamesc C sJ | d |dur |j}|du r|}tj|\}}|tjd}|d}| }| |_ |du r@| j
s:t |}n
t |}nt
| }d}|j}t |r|j|jf} | j
ss|jdkrs| | jv rs|| j| krst}
| j| }n;t}
| d r~|| j| < n/t |rt}
n't |rt}
n t |rt }
t |}nt |rt }
n
t |rt!}
ndS ||_||_"|j#|_$|j%|_&|
tkr|j'|_(nd|_(|j)|_*|
|_+||_,t-rz t-.|j$d |_/W n t0y Y nw t1rz t12|j&d |_3W n
t0y Y nw |
t t!fv r#t4tdr#t4tdr#t5|j6|_7t8|j6|_9|S ) 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.
awxNr r r# r majorminor):r r r r%
splitdriver r" r# r r r lstatstatfstatfilenost_modeS_ISREGst_inost_devst_nlinkr r r@ S_ISDIRrM S_ISFIFOr S_ISLNKr readlinkS_ISCHRrw S_ISBLKrx r st_uidr) st_gidr* st_sizer' st_mtimer( r: r* pwdgetpwuidr+ r grpgetgrgidr, r r st_rdevr; r r< ) r r arcnamer drvr statresr* stmdinoder: r9 r9 r:
gettarinfo s
zTarFile.gettarinfoT)r c C s" | |du r
| }|D ]}|rf|jdu rtd ntt|j td|jp)|j|jp.|jf | s:|
rGtdd|j |j f ntd|j
|jdu rXtd ntdt|jdd t|j| rod
nd |r| rtd |j | rtd
|j t q dS )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
??????????z%s/%sz%10sz%d,%dz%10dz????-??-?? ??:??:??z%d-%02d-%02d %02d:%02d:%02dr r r z-> zlink to )r r rt r r r+ r) r, r* r r r; r< r' r( r localtimer r( r) r* r' rs )r verboser r r9 r9 r: r e s:
z TarFile.listfilterc C sP | d |du r |}| jdur#tj|| jkr#| dd| dS | d| | ||}|du r=| dd| dS |durS||}|du rS| dd| dS | rut|d}| || W d dS 1 snw Y dS |
r| | |rt t |D ]}| j
tj||tj||||d qdS dS | | dS )
a! Add the file `name' to the archive. `name' may be any type of file
(directory, fifo, symbolic link, etc.). If given, `arcname'
specifies an alternative name for the file in the archive.
Directories are added recursively by default. This can be avoided by
setting `recursive' to False. `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= )r r r r% r _dbgr: r& r addfiler( r listdiraddr )r r r5 recursiver> r fr9 r9 r: rC s<
"
z TarFile.addc C s | d t|}|| j| j| j}| j| | jt |7 _| j
}|durWt || j|j |d t
|j t\}}|dkrN| jtt| |d7 }| j|t 7 _| j| dS )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)ri r r# )r rI rV rT r7 r8 r re r r3 r rb r' rc r r4 r r )r r r r\ ri rj rk r9 r9 r: rA s
zTarFile.addfilec C sh |d u r| j }|d u r
tS t|trtd|S t|r |S zt| W S ty3 td|dd w )NzrString names are not supported for TarFile.extraction_filter. Use a function such as tarfile.data_filter directly.zfilter z
not found) extraction_filterr1 re rh TypeErrorcallable_NAMED_FILTERSr r1 )r r> r9 r9 r: _get_filter_function s
z TarFile._get_filter_function.)
numeric_ownerr> c C s g }| |}|du r
| }|D ]#}| |||}|du r q| r&|| | j||| |d q|jdd dd |D ]7}tj||j } z| j
|| |d | || | || W q> t
yu }
z | |
W Y d}
~
q>d}
~
ww dS )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_attrsrL c S r r rB )r r9 r9 r:
s z$TarFile.extractall..T)r reverse)rL )rJ _get_extract_tarinfor( r _extract_onesortr r% r r chownutimechmodr
_handle_nonfatal_error) r r% r rL r> directoriesfilter_functionr+ r dirpathr r9 r9 r:
extractall s2
zTarFile.extractallr c C s8 | |}| |||}|dur| |||| dS dS )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)rJ rQ rR )r r+ r% rN rL r> rY r r9 r9 r: extract s
zTarFile.extractc
C s t |tr | |}n|}|}z|||}W n/ ttfy/ } z | | W Y d}~nd}~w tyE } z | | W Y d}~nd}~ww |du rU| dd|j dS |
rgt |}t j
||j|_|S )z@Get filtered TarInfo (or None) from member, which might be a strNr$ r? )re rh r r r _handle_fatal_errorr
rW r@ r r' rI r r% r r* r? )r r+ rY r% r
unfilteredr r9 r9 r: rQ ) s(
z TarFile._get_extract_tarinfoc
C s | d z| j|tj||j||d W dS ty/ } z | | W Y d}~dS d}~w tyF } z | | W Y d}~dS d}~ww )z%Extract from filtered tarinfo to diskr rM N)
r _extract_memberr r% r r r r] r
rW )r r r% rN rL r r9 r9 r: rR @ s
zTarFile._extract_onec C s | j dkr | dd| dS )z=Handle non-fatal error (ExtractError) according to errorlevelr# tarfile: %sN)r r@ r r r9 r9 r: rW M s
z TarFile._handle_nonfatal_errorc C sp | j dkr t|tr)|jdu r| dd|j dS | dd|j|jf dS | ddt|j|f dS )z1Handle "fatal" error according to self.errorlevelr Nr# r` ztarfile: %s %rztarfile: %s %s)r re r filenamer@ strerrorr: rw ra r9 r9 r: r] T s
zTarFile._handle_fatal_errorc C sz | d t|tr| |}n|}| s|jtvr!| | |S | s)| r;t| j
t r3t d|
| |S dS )a\ Extract a member from the archive as a file object. `member' may be
a filename or a TarInfo object. If `member' is a regular file 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 re rh r r& r: r
fileobjectr' r) r r r extractfile_find_link_target)r r+ r r9 r9 r: re ` s
zTarFile.extractfilec C sV | d}|dtj}tj|}|r tj|s t| | s'| r4|
dd|j |j f n|
d|j |
rF| || nF| rQ| || n;| r\| || n0| sd| rk| || n!| ss| rz| || n|jtvr| || n| || |r| ||| | s| || | || dS dS dS )z\Extract the TarInfo object tarinfo to a physical
file called targetpath.
r r# z%s -> %sN) r r r r" r% dirnamer makedirsr' r) r@ r r* r& makefiler( makedirr makefifor r makedevmakelinkr: r makeunknownrT rV rU )r r
targetpathrN rL upperdirsr9 r9 r: r_ s8
zTarFile._extract_memberc C sB z|j du rt| W dS t|d W dS ty Y dS w )z,Make a directory called targetpath.
Ni )r r mkdirFileExistsErrorr r ro r9 r9 r: rj s
zTarFile.makedirc C s | j }||j | j}t|d?}|jdur7|jD ]\}}|| t|||t| q||j | nt|||jt| W d dS W d dS 1 sSw Y dS )z'Make a file called targetpath.
r N)
r r r r r r rb r r' truncate)r r ro sourceri targetr r' r9 r9 r: ri s
"zTarFile.makefilec C s" | || | dd|j dS )zYMake a file from a TarInfo object with an unknown type
at targetpath.
r# z9tarfile: Unknown file type %r, extracted as regular file.N)ri r@ r: rs r9 r9 r: rn s
zTarFile.makeunknownc C s t tdr t| dS td)z'Make a fifo called targetpath.
mkfifoz fifo not supported by systemN)r r rw r
rs r9 r9 r: rk s
zTarFile.makefifoc C sj t tdr
t tdstd|j}|du rd}| r!|tjO }n|tjO }t||t |j
|j dS )z
z
TarFile.chownc
C sF |j du rdS z
t||j W dS ty" } ztd|d}~ww )zASet file permissions of targetpath according to tarinfo.
Nzcould not change mode)r r rV r r
)r r ro r r9 r9 r: rV +
s
z
TarFile.chmodc
C sZ |j }|du r dS ttdsdS z t|||f W dS ty, } ztd|d}~ww )zBSet modification time of targetpath according to tarinfo.
NrU z"could not change modification time)r( r r rU r r
)r r ro r( r r9 r9 r: rU 5
s
z
TarFile.utimec C s: | d | jdur| j}d| _|S | j| j kr-| j| jd | jds-tdd} z| j | }W n t
ye } z!| j r[| dd| j|f | jt
7 _W Y d}~q/W Y d}~nd}~w ty } z-| j r| dd| j|f | jt
7 _W Y d}~q/| jdkrtt|dW Y d}~nqd}~w ty | jdkrtd dY n[ ty } z| jdkrtt|dW Y d}~nBd}~w ty } ztt|dd}~w ty } z zddl}t||jrtd
| d| ty |w d}~ww |dur| j| |S d| _|S ) zReturn the next member of the archive as a TarInfo object, when
TarFile is opened for reading. Return None if there is no more
available.
raNr# r` Tr$ z0x%X: %sr z
empty filez zlib error: )r r r r r r rd r r r r~ r r@ r rL rh r| r} r Exceptionr re r r r r r )r mr r r r9 r9 r: r C
st
z TarFile.nextc C s | }d}|dur#z||}W n ty d}Y nw |d| }|r+tj|}t|D ]"}|r<|j|jkr;d}q/|rFtj|j}n|j}||krQ| S q/|rXt|dS )z}Find an archive member by name from bottom to top.
If tarinfo is given, it is used as the starting point.
FNT) r indexr1 r r% normpathreversedr r ) r r r normalizer skippingr r+ member_namer9 r9 r: r
s2 zTarFile._getmemberc C s | }|du r
nqd| _dS )zWRead through the entire archive file and look for readable
members.
TN)r r r r9 r9 r: r
s
z
TarFile._loadc C s> | j r td| jj |dur| j|vr td| j dS dS )znCheck if TarFile is still open, and if the operation's mode
corresponds to TarFile's mode.
z %s is closedNzbad operation for mode %r)r r r rw r )r r r9 r9 r: r
s
zTarFile._checkc C s` | rdtdtj|j|jf}d}n|j}|}| j||dd}|du r.t d| |S )zZFind the target member of a symlink or hardlink member in the
archive.
r NT)r r zlinkname %r not found)
r) r r> r r% rg r r* r r )r r r* limitr+ r9 r9 r: rf
s zTarFile._find_link_targetc c s | j r | jE dH dS d}| jdur | }|d7 }|V |t| jk r,| j| }n| j s;| }|s:d| _ dS ndS |d7 }|V q )z$Provide an iterator object.
Nr r# T)r r r r r3 )r r r r9 r9 r: __iter__
s,
zTarFile.__iter__c C s || j krt|tjd dS dS )z.Write debugging output to sys.stderr.
fileN)r rs rq stderr)r levelmsgr9 r9 r: r@
s
z TarFile._dbgc C s | | S r )r r r9 r9 r: __enter__
s zTarFile.__enter__c C s. |d u r
| d S | js| j d| _d S r )r r r r )r r: rU tracebackr9 r9 r: __exit__
s
zTarFile.__exit__)
Nr NNNNNNrP NNNN)r N)r Nr )r NN)NNNTr r )rK N)r T)TFr )>rw rx ry rz r r r r r rT r r7 r8 r r r rd rF r r r r r r
r
r r r r r r r: r rC rA rJ r[ r\ rQ rR rW r] re r_ rj ri rn rk rl rm rT rV rU r r r r rf r r@ r r r9 r9 r9 r: r } s
o]
c&
3 -
1!
?(
r c C sB zt | dr t| d}nt| }| W dS ty Y dS 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.
rd )r TF)r r r r )r r r9 r9 r: r s
r c C sh dd l } d}| j|d}|jdddddd |jd
d td d
|jdd}|jddddd |jdddddd |jdd dd d d |jd d dd!d | }|jr]|jd u r]|d"d# |j d ur|j }t
|rt |d$}| t
| tjd% W d n1 sw Y |jrt
d&| d S d S |d"d'| d S |jd ur|j}t
|rt |d(}|j|jd) W d d S 1 sw Y d S |d"d'| d S |jd urRt|jd"kr|jd }tj}nt|jd*kr|j\}}n|d"| t
|rGt |d(}|j||jd+ W d n 1 s%w Y |jrE|d,kr9d-|} nd.||} t
| d S d S |d"d'| d S |jd ur|jd}
tj |
\} } d/d/d0d0d1d1d1d1d2}
| |
v r|d3|
| nd4}|j}t |
|}|D ]}| | qW d n 1 sw Y |jrt
d5|
d S d S d S )6Nr z3A simple command-line interface for tarfile module.) descriptionz-vz --verbose
store_trueFzVerbose output)actiondefaulthelpz--filterz zFilter for extraction)metavarchoicesr T)requiredz-lz--list zShow listing of a tarfile)r r z-ez --extract+)r z z Extract tarfile into target dir)nargsr r z-cz--create)zzzCreate 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.
r )r< r$ )r% r> rK 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_argumentrI add_mutually_exclusive_group
parse_argsr> r\ exittestr r r rs rq r r< rT r r r3 r curdir format_helpr[ createpopr% splitextrC )r r parserr argsrf r tfr r tar_namer ext compressionstar_mode tar_files file_namer9 r9 r: main s
"
r __main__r )mrz version
__author__ __credits__builtinsr r rq r r ra r r rZ rI rewarningsr0 r r2 AttributeErrorNotImplementedErrorr r NameError__all__r4 r r r^ rY r[ rZ rt r@ r r r rw rx rM r CONTTYPEra r` r rj rp r r
r r r r r r r r rf rJ r r r getfilesystemencodingr; r@ rO rV r_ rb rt r r r
r r r r r| r} r~ rL r r r objectr r BufferedReaderr r r
r r r r r0 r1 r5 r7 rI rH compiler r r r r rw r9 r9 r9 r: s$
s h
8
;
_