U
|
H=®dÔi ã @ sN d dl mZ dZdZdZdZdZdZd dlZd dl Z d dl
|
Z
|
d dl Z d dl Z d dl Z d dlZd dlZzd dlZd dlZW n ek
|
r d ZZY nX eefZzeef7 ZW n ek
|
rÀ Y nX d d
|
d d gZejd d k ræd dlZnd dlZej Z dZ dZ e d Z dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-d Z.d Z/d Z0d Z1d Z2d!Z3d"Z4d Z5d#Z6d$Z7e6Z8e&e'e(e)e,e-e.e*e+e/e0e1f Z9e&e'e.e1fZ:e/e0e1fZ;d%Z<e=d&Z>e?e?e?e@e@e@d'ZAd(ZBd)ZCd*ZDd+ZEd,ZFd-ZGd.ZHd/ZIdZJd0ZKd1ZLd2ZMd3ZNd4ZOd5ZPd6ZQd$ZRd#ZSe jTd7krd8ZUne V¡ ZUd9d: ZWd;d< ZXd=d> ZYd5e8fd?d@ZZdAdB Z[dzdCdDZ\eBdEfeCdFfeDdGfeEdHfeFdIfeGdJffeKdKffeLdLffeMeHB dMfeHdNfeMdOffeNdKffeOdLffePeIB dMfeIdNfePdOffeQdKffeRdLffeSeJB dPfeJdQfeSdOfff
|
Z]dRdS Z^G dTd d e_Z`G dUdV dVe`ZaG dWdX dXe`ZbG dYdZ dZe`ZcG d[d\ d\e`ZdG d]d^ d^e`ZeG d_d` d`eeZfG dadb dbeeZgG dcdd ddeeZhG dedf dfeeZiG dgdh dheeZjG didj djekZlG dkdl dlekZmG dmdn dnekZnG dodp dpekZoG dqdr drekZpG dsdt dtekZqG dud
|
d
|
ekZrG dvd d ekZsG dwdx dxekZtdyd Zue Zvesj Z dS ){é )Úprint_functionz
|
$Revision$z0.9.0u" Lars Gustäbel (lars@gustaebel.de)z5$Date: 2011-02-25 17:42:01 +0200 (Fri, 25 Feb 2011) $z?$Id: tarfile.py 88586 2011-02-25 15:42:01Z marc-andre.lemburg $u4 Gustavo Niemeyer, Niels Gustäbel, Richard Townsend.NÚTarFileÚTarInfoÚ
|
is_tarfileÚTarErroré ó é é s ustar s ustar 00éd é ó 0ó 1ó 2ó 3ó 4ó 5ó 6ó 7ó Ló Kó Só xó gó Xé é )ÚpathÚlinkpathÚsizeÚmtimeÚuidÚgidÚunameÚgname)r r r# r$ )ÚatimeÚctimer r! r" r i i i ` é @ i i i é é é é@ é é é é )ÚntZcezutf-8c C s( | ||¡} | d|
|t| t S )z8Convert a string to a null-terminated bytes object.
|
N)ÚencodeÚlenÚNUL)ÚsÚlengthÚencodingÚerrors© r8 ú\D:\z\workplace\VsCode\pyvenv\venv\Lib\site-packages\pip/_vendor/distlib/_backport/tarfile.pyÚstn¹ s r: c C s* | d¡}|dkr | d|
} | ||¡S )z8Convert a null-terminated bytes object to a string.
|
r éÿÿÿÿN)ÚfindÚdecode)r4 r6 r7 Úpr8 r8 r9 Únts¿ s
|
r? c C s | d t dkrJztt| ddp"dd}W q tk
|
rF tdY qX n6d}tt| d D ] }|dK }|t| |d 7 }q^|S ) z/Convert a number field to a python number.
|
r r* ÚasciiÚstrictÚ0r. zinvalid headerr )ÚchrÚintr? Ú
|
ValueErrorÚInvalidHeaderErrorÚranger2 Úord)r4 ÚnÚir8 r8 r9 ÚntiÇ s rK c C s¼ d| kr d|d k r<n n d|d | f d¡t }n||tksT| d|d kr\td| dk r|t dt d | ¡¡d } t }t|d D ] }| d| d
|
@ ¡ | dL } q| dd ¡ |S ) z/Convert a python number to a number field.
|
r r. r z%0*or@ r) zoverflow in number fieldÚLÚléÿ r* )
|
r1 r3 Ú
|
GNU_FORMATrE ÚstructÚunpackÚpackÚ bytearrayrG Úinsert)rI ÚdigitsÚformatr4 rJ r8 r8 r9 ÚitnØ s
|
rW c C sh dt t d| dd
¡t d| dd
¡ }dt t d| dd
¡t d | dd
¡ }||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.
|
r) Z148BNé Z356Bé r Z148bZ356b)ÚsumrP rQ )ÚbufÚunsigned_chksumÚ signed_chksumr8 r8 r9 Ú calc_chksumsó s 00r^ c C s° |dkr dS |dkr4| d¡}|s$q0| |¡ qdS d}t||\}}t|D ],}| |¡}t||k rptd| |¡ qN|dkr¬| |¡}t||k r¢td| |¡ dS )zjCopy length bytes from fileobj src to fileobj dst.
|
If length is None, copy the entire content.
|
r Nr' zend of file reached)ÚreadÚwriteÚdivmodrG r2 ÚIOError)ÚsrcÚdstr5 r[ ZBUFSIZEÚblocksÚ remainderÚbr8 r8 r9 Ú copyfileobj s*
|
|
|
|
rh rM ú-rg ÚdÚcr> ÚrÚwr4 ÚSÚxÚtÚTc C sJ g }t D ]6}|D ]"\}}| |@ |kr| |¡ qq| d¡ qd |¡S )zcConvert a file's mode to a string of the form
|
-rwxrwxrwx.
|
Used by TarFile.list()
|
ri Ú )Úfilemode_tableÚappendÚjoin)ÚmodeÚpermÚtableÚbitÚcharr8 r8 r9 Úfilemode8 s
|
r{ c @ s e Zd ZdZdS )r zBase exception.N©Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r8 r8 r8 r9 r G s c @ s e Zd ZdZdS )Ú ExtractErrorz%General exception for extract errors.Nr| r8 r8 r8 r9 r J s r c @ s e Zd ZdZdS )Ú ReadErrorz&Exception for unreadable tar archives.Nr| r8 r8 r8 r9 r M s r c @ s e Zd ZdZdS )ÚCompressionErrorz.Exception for unavailable compression methods.Nr| r8 r8 r8 r9 r P s r c @ s e Zd ZdZdS )Ú StreamErrorz=Exception for unsupported operations on stream-like TarFiles.Nr| r8 r8 r8 r9 r S s r c @ s e Zd ZdZdS )Ú HeaderErrorz!Base exception for header errors.Nr| r8 r8 r8 r9 r
V s r
c @ s e Zd ZdZdS )ÚEmptyHeaderErrorz Exception for empty headers.Nr| r8 r8 r8 r9 r Y s r c @ s e Zd ZdZdS )ÚTruncatedHeaderErrorz Exception for truncated headers.Nr| r8 r8 r8 r9 r \ s r c @ s e Zd ZdZdS )ÚEOFHeaderErrorz"Exception for end of file headers.Nr| r8 r8 r8 r9 r _ s r c @ s e Zd ZdZdS )rF z Exception for invalid headers.Nr| r8 r8 r8 r9 rF b s rF c @ s e Zd ZdZdS )ÚSubsequentHeaderErrorz3Exception for missing and invalid extended headers.Nr| r8 r8 r8 r9 r e s r c @ s0 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 dr2|t jO }t ||d¡| _d S )N)rl rm ÚO_BINARYi¶ ) ÚosÚO_RDONLYÚO_WRONLYÚO_CREATÚO_TRUNCÚhasattrr ÚopenÚfd)ÚselfÚnamerv r8 r8 r9 Ú__init__r s þý
|
|
z_LowLevelFile.__init__c C s t | j¡ d S ©N)r Úcloser ©r r8 r8 r9 r { s z_LowLevelFile.closec C s t | j|¡S r )r r_ r ©r r r8 r8 r9 r_ ~ s z_LowLevelFile.readc C s t | j|¡ d S r )r r` r ©r r4 r8 r8 r9 r` s z_LowLevelFile.writeN)r} r~ r r r r r_ r` r8 r8 r8 r9 r l s
|
r c @ st e Zd ZdZdd Zdd Zdd Zdd Zd
|
d Zd d Z dd Z
|
dd Z d ddZ d ddZ 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 sR d| _ |dkr t||}d| _ |dkr6t|}| ¡ }|p<d| _|| _|| _|| _|| _d| _ d| _
|
d| _ z¼|dkrÊz ddl }W n t k
|
r td Y nX || _ | d¡| _|d
|
krÂ| ¡ n| ¡ |d kr$z ddl}W n t k
|
rü td Y nX |d
|
krd| _| ¡ | _n
|
| ¡ | _W n& | j s@| j ¡ d| _ Y nX dS ) z$Construct a _Stream object.
|
TNFÚ*rr ó r Úgzz zlib module is not availablerl Úbz2úbz2 module is not available)Ú _extfileobjr Ú _StreamProxyÚ getcomptyper rv ÚcomptypeÚfileobjÚbufsizer[ ÚposÚclosedÚzlibÚ ImportErrorr Úcrc32ÚcrcÚ _init_read_gzÚ_init_write_gzr ÚdbufÚBZ2DecompressorÚcmpÚ BZ2Compressorr )r r rv r¥ r¦ r§ rª r r8 r8 r9 r sP
|
|
|
|
|
|
z_Stream.__init__c C s t | dr| js| ¡ d S )Nr© )r r© r r r8 r8 r9 Ú__del__Ã s z_Stream.__del__c C s | j d| j j| j j | j jd¡| _t dtt ¡ ¡}|
|
d| d ¡ | j d¡rf| j dd
| _ |
|
| j d d
|
¡t ¡ dS ) z6Initialize for writing with gzip compression.
|
é r ú<Ls s ÿz.gzNéýÿÿÿz
|
iso-8859-1Úreplace)rª Ú compressobjÚDEFLATEDÚ MAX_WBITSÚ DEF_MEM_LEVELr² rP rR rD ÚtimeÚ_Stream__writer Úendswithr1 r3 )r Ú timestampr8 r8 r9 r¯ Ç s ý z_Stream._init_write_gzc C sR | j dkr | j || j¡| _| jt|7 _| j dkrD| j |¡}| |¡ dS )z&Write string s to the stream.
|
r ÚtarN) r¥ rª r¬ r r¨ r2 r² Úcompressr¾ r r8 r8 r9 r` Õ s
|
|
z _Stream.writec C sN | j |7 _ t| j | jkrJ| j | j d| j
¡ | j | jd
| _ qdS )z]Write string s to the stream if a whole new block
|
is ready to be written.
|
N)r[ r2 r§ r¦ r` r r8 r8 r9 Ú__writeß s z_Stream.__writec C s® | j r
|
dS | jdkr2| jdkr2| j| j ¡ 7 _| jdkr| jr| j | j¡ d| _| jdkr| j t d| j
|
d@ ¡¡ | j t d| j d@ ¡¡ | j s¤| j ¡ d| _ dS ) z[Close the _Stream object. No operation should be
|
done on it afterwards.
|
Nrm rÁ r r r¶ l ÿÿ T)r© rv r¥ r[ r² Úflushr¦ r` rP rR r r¨ r¢ r r r8 r8 r9 r è s
|
|
z _Stream.closec C sê | j | j j ¡| _d| _| d¡dkr0td| d¡dkrFtdt| d¡}| d¡ |d @ rt| d¡d
|
t| d¡ }| |¡ |d @ r²| d¡}|r²|t
|
krq²q|d @ rÔ| d¡}|rÔ|t
|
krºqÔqº|d@ ræ| d¡ d S )z:Initialize for reading a gzip compressed fileobj.
|
r r s únot a gzip filer ó z unsupported compression methodé r/ r) r. r- N) rª Ú decompressobjr» r² r° Ú _Stream__readr r rH r_ r3 )r ÚflagÚxlenr4 r8 r8 r9 r® s*
|
|
|
|
z_Stream._init_read_gzc C s | j S )z3Return the stream's file pointer position.
|
©r¨ r r8 r8 r9 Útell# s z _Stream.tellr c C sX || j dkrJt|| j | j\}}t|D ]}| | j¡ q,| |¡ ntd| j S )zXSet the stream's file pointer to pos. Negative seeking
|
is forbidden.
|
r z seeking backwards is not allowed)r¨ ra r§ rG r_ r )r r¨ re rf rJ r8 r8 r9 Úseek( s z _Stream.seekNc C sV |dkr6g }| | j¡}|s q*| |¡ q d |¡}n
|
| |¡}| jt|7 _|S )zReturn the next size number of bytes from the stream.
|
If size is not defined, return all bytes of the stream
|
up to EOF.
|
Nrr )Ú_readr§ rt ru r¨ r2 )r r rp r[ r8 r8 r9 r_ 5 s
|
z _Stream.readc C s¤ | j dkr| |¡S t| j}||k r| | j¡}|s8qz| j |¡}W n tk
|
rd tdY nX | j|7 _|t|7 }q | jd|
}| j|d
| _|S )z+Return size bytes from the stream.
|
rÁ zinvalid compressed dataN) r¥ rÉ r2 r° r§ r² Ú
|
decompressrb r ©r r rk r[ r8 r8 r9 rÏ G s
|
|
|
z _Stream._readc C sd t | j}||k rB| j | j¡}|s&qB| j|7 _|t |7 }q
|
| jd|
}| j|d
| _|S )zsReturn size bytes from stream. If internal buffer is empty,
|
read another block from the stream.
|
N)r2 r[ r¦ r_ r§ rÑ r8 r8 r9 Ú__read\ s
|
z_Stream.__read)r )N)r} r~ r r r r´ r¯ r` r¾ r r® rÍ rÎ r_ rÏ rÉ r8 r8 r8 r9 r s
|
4
|
|
|
r c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
|
S ) r£ zsSmall proxy class that enables transparent compression
|
detection for the Stream interface (mode 'r|*').
|
c C s || _ | j t¡| _d S r )r¦ r_ Ú BLOCKSIZEr[ )r r¦ r8 r8 r9 r q s z_StreamProxy.__init__c C s | j j| _| jS r )r¦ r_ r[ r r8 r8 r9 r_ u s
|
z_StreamProxy.readc C s$ | j d¡rdS | j d¡r dS dS )Ns r s BZh91r rÁ )r[ Ú
|
startswithr r8 r8 r9 r¤ y s
|
z_StreamProxy.getcomptypec C s | j ¡ d S r )r¦ r r r8 r8 r9 r s z_StreamProxy.closeN)r} r~ r r r r_ r¤ r r8 r8 r8 r9 r£ l s
|
r£ c @ sL e Zd ZdZdZdd Zdd Zdd Zd d
|
Zd d Z d d Z
|
dd Z dS )Ú _BZ2Proxya Small proxy class that enables external file object
|
support for "r:bz2" and "w:bz2" modes. This is actually
|
a workaround for a limitation in bz2 module's BZ2File
|
class which (unlike gzip.GzipFile) has no support for
|
a file object argument.
|
r' c C s( || _ || _t| j dd | _| ¡ d S )Nr )r¦ rv Úgetattrr Úinit)r r¦ rv r8 r8 r9 r s z_BZ2Proxy.__init__c C sD dd l }d| _| jdkr6| ¡ | _| j d¡ d| _n
|
| ¡ | _d S )Nr rl r ) r r¨ rv r± Úbz2objr¦ rÎ r[ r³ )r r r8 r8 r9 r× s
|
|
z_BZ2Proxy.initc C s t | j}||k rN| j | j¡}|s&qN| j |¡}| j|7 _|t |7 }q
|
| jd |
}| j|d
| _| jt |7 _|S r )r2 r[ r¦ r_ Ú blocksizerØ rÐ r¨ )r r ro ÚrawÚdatar[ r8 r8 r9 r_ s
|
z_BZ2Proxy.readc C s& || j k r| ¡ | || j ¡ d S r )r¨ r× r_ )r r¨ r8 r8 r9 rÎ s
|
z_BZ2Proxy.seekc C s | j S r rÌ r r8 r8 r9 rÍ ² s z_BZ2Proxy.tellc C s. | j t|7 _ | j |¡}| j |¡ d S r )r¨ r2 rØ r r¦ r` )r rÛ rÚ r8 r8 r9 r` µ s z_BZ2Proxy.writec C s$ | j dkr | j ¡ }| j |¡ d S )Nrm )rv rØ rÄ r¦ r` )r rÚ r8 r8 r9 r º s
|
|
z_BZ2Proxy.closeN) r} r~ r r rÙ r r× r_ rÎ rÍ r` r r8 r8 r8 r9 rÕ s
|
rÕ c @ s< e Zd ZdZd ddZdd Zdd Zd d
|
Zdd d 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| _|d kr*d|fg}d| _g | _d}| j}|D ]L\}}||krh| j d||d f¡ | j d||| |f¡ ||7 }|| }qD|| jk r²| j d|| jd f¡ d S )Nr FT)r¦ Úoffsetr ÚpositionÚ map_indexÚmaprt )r r¦ rÝ r Ú blockinfoÚlastposÚrealposr8 r8 r9 r É s$
|
|
|
z_FileInFile.__init__c C s t | jdsdS | j ¡ S )NÚseekableT)r r¦ rä r r8 r8 r9 rä à s z_FileInFile.seekablec C s | j S )ú*Return the current file position.
|
©rÞ r r8 r8 r9 rÍ æ s z_FileInFile.tellc C s
|
|| _ dS )ú(Seek to a position in the file.
|
Nræ )r rÞ r8 r8 r9 rÎ ë s z_FileInFile.seekc C sð |dkr| j | j }nt|| j | j }d}|dkrì| j| j \}}}}|| j kr^|k rfq nqq4| jd7 _| jt| jkr4d| _q4t||| j }|rÈ| j || j| ¡ || j |¡7 }n |t | 7 }||8 }| j|7 _q,|S )z!Read data from the file.
|
Nr r r )
|
r rÞ Úminrà rß r2 r¦ rÎ r_ r3 )r r r[ rÛ ÚstartÚstoprÝ r5 r8 r8 r9 r_ ð s& z_FileInFile.read)N)N) r} r~ r r r rä rÍ rÎ r_ r8 r8 r8 r9 rÜ Ã s
|
rÜ c @ sz e Zd ZdZdZdd Zdd Zdd Zd d
|
Zdd d Z e Z
|
d ddZ dd Z dd Z ejfddZdd Zdd Zd S ) Ú ExFileObjectzaFile-like object for reading an archive member.
|
Is returned by TarFile.extractfile().
|
r( c C sD t |j|j|j|j| _|j| _d| _d| _|j| _d| _d| _ d S )Nrl Fr r )
|
rÜ r¦ Ú offset_datar Úsparser rv r© rÞ Úbuffer)r ÚtarfileÚtarinfor8 r8 r9 r s ýzExFileObject.__init__c C s dS ©NTr8 r r8 r8 r9 Úreadable! s zExFileObject.readablec C s dS )NFr8 r r8 r8 r9 Úwritable$ s zExFileObject.writablec C s
|
| j ¡ S r )r¦ rä r r8 r8 r9 rä ' s zExFileObject.seekableNc C s | j rtdd}| jrL|dkr.| j}d| _n | jd|
}| j|d
| _|dkrd|| j ¡ 7 }n|| j |t| ¡7 }| jt|7 _|S )z~Read at most size bytes from the file. If size is not
|
present or None, read all data until EOF is reached.
|
ú I/O operation on closed filer N)r© rE rî r¦ r_ r2 rÞ )r r r[ r8 r8 r9 r_ * s zExFileObject.readr; c C sº | j rtd| j d¡d }|dkrt| j | j¡}| j|7 _|rNd|kr&| j d¡d }|dkrtt| j}qtq&|dkrt||}| jd|
}| j|d
| _| j t|7 _ |S )z°Read one entire line from the file. If size is present
|
and non-negative, return a string with at most that
|
size, which may be an incomplete line.
|
rô ó
|
r r r; N)
|
r© rE rî r< r¦ r_ rÙ r2 rè rÞ )r r r¨ r[ r8 r8 r9 ÚreadlineE s"
|
|
zExFileObject.readlinec C s" g }| ¡ }|sq | |¡ q|S )z0Return a list with all remaining lines.
|
)rö rt )r ÚresultÚliner8 r8 r9 Ú readlinesb s zExFileObject.readlinesc C s | j rtd| jS )rå rô )r© rE rÞ r r8 r8 r9 rÍ l s zExFileObject.tellc C s° | j rtd|tjkr.tt|d| j| _nj|tjkrj|dk rTt| j| d| _qt| j| | j| _n.|tj krtt| j| | jd| _ntdd| _
|
| j | j¡ dS )rç rô r zInvalid argumentr N) r© rE r ÚSEEK_SETrè Úmaxr rÞ ÚSEEK_CURÚSEEK_ENDrî r¦ rÎ )r r¨ Úwhencer8 r8 r9 rÎ t s
|
|
|
zExFileObject.seekc C s
|
d| _ dS )z Close the file object.
|
TN)r© r r8 r8 r9 r s zExFileObject.closec c s | ¡ }|sq|V q dS )z/Get an iterator over the file's lines.
|
N)rö )r rø r8 r8 r9 Ú__iter__ s zExFileObject.__iter__)N)r; )r} r~ r r rÙ r rò ró rä r_ Úread1rö rù rÍ r rú rÎ r rÿ r8 r8 r8 r9 rë s
|
|
|
rë c @ s e Zd ZdZdZdVddZdd Zdd ZeeeZ d
|
d Z
|
d d Z ee
|
e Z dd Z dd ZeedfddZdd Zdd Zdd Zedd Zd d Zed d Zed!d" Zed#d$ Zed%d& Z ed'd( Z ed)d* Z d+d, Z d-d. Z d/d0 Z!d1d2 Z"d3d4 Z#d5d6 Z$d7d8 Z%d9d: Z&d;d< Z'd=d> Z(d?d@ Z)dAdB Z*dCdD Z+dEdF Z,dGdH Z-dIdJ Z.dKdL Z/dMdN Z0dOdP Z1dQdR Z2dSdT Z3dUS )Wr a Informational class which holds the details about an
|
archive member given by a tar header block.
|
TarInfo objects are returned by TarFile.getmember(),
|
TarFile.getmembers() and TarFile.gettarinfo() and are
|
usually created internally.
|
)r rv r! r" r r ÚchksumÚtypeÚlinknamer# r$ ÚdevmajorÚdevminorrÝ rì Ú pax_headersrí rï Ú_sparse_structsÚ _link_targetrr 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 rr N)r rv r! r" r r r ÚREGTYPEr r r# r$ r r rÝ rì rí r ©r r r8 r8 r9 r © s" zTarInfo.__init__c C s | j S r ©r r r8 r8 r9 Ú_getpathà s zTarInfo._getpathc C s
|
|| _ d S r r r
|
r8 r8 r9 Ú_setpathÅ s zTarInfo._setpathc C s | j S r ©r r r8 r8 r9 Ú _getlinkpathÉ s zTarInfo._getlinkpathc C s
|
|| _ d S r r )r r r8 r8 r9 Ú _setlinkpathË s zTarInfo._setlinkpathc C s d| j j| jt| f S )Nz<%s %r at %#x>)Ú __class__r} r Úidr r8 r8 r9 Ú__repr__Ï s zTarInfo.__repr__c C sl | j | jd@ | j| j| j| j| j| j| j| j | j
|
| j | j d }|d t krh|d d¡sh|d d7 < |S )z9Return the TarInfo's attributes as a dictionary.
|
éÿ ) r rv r! r" r r r r r r# r$ r r r r ú/)r rv r! r" r r r r r r# r$ r r ÚDIRTYPEr¿ )r Úinfor8 r8 r9 Úget_infoÒ s" ózTarInfo.get_infoÚsurrogateescapec C sT | ¡ }|tkr | |||¡S |tkr4| |||¡S |tkrH| ||¡S tddS )z<Return a tar header as a string of 512 byte blocks.
|
zinvalid formatN)r Ú USTAR_FORMATÚcreate_ustar_headerrO Úcreate_gnu_headerÚ
|
PAX_FORMATÚcreate_pax_headerrE )r rV r6 r7 r r8 r8 r9 Útobufê s z TarInfo.tobufc C sZ t |d< t|d tkr tdt|d tkrJ| |d ¡\|d< |d< | |t||¡S )z3Return the object as a ustar header block.
|
Úmagicr zlinkname is too longr Úprefix)Ú POSIX_MAGICr2 Ú LENGTH_LINKrE Ú LENGTH_NAMEÚ_posix_split_nameÚ_create_headerr )r r r6 r7 r8 r8 r9 r ø s zTarInfo.create_ustar_headerc C sp t |d< d}t|d tkr4|| |d t||¡7 }t|d tkr\|| |d t||¡7 }|| |t||¡ S )z:Return the object as a GNU header block sequence.
|
r r r r ) Ú GNU_MAGICr2 r# Ú_create_gnu_long_headerÚGNUTYPE_LONGLINKr$ ÚGNUTYPE_LONGNAMEr& rO )r r r6 r7 r[ r8 r8 r9 r s zTarInfo.create_gnu_headerc
|
C s* t |d< | j ¡ }ddtfddtfddfD ]j\}}}||kr>q*z|| dd ¡ W n$ tk
|
rv || ||< Y q*Y nX t|| |kr*|| ||< q*d
|
D ]`\}}||kr´d ||< q|| }d | krØd |d k ræn n
|
t|t rt
|
|||< d ||< q|r| |t |¡} nd} | | |tdd¡ S )z³Return the object as a ustar header block. If it cannot be
|
represented this way, prepend a pax extended header sequence
|
with supplement information.
|
r r r r r )r# r# r, )r$ r$ r, r@ rA ))r! r. )r" r. )r é )r r+ r r. r r r¸ )r" r Úcopyr$ r# r1 ÚUnicodeEncodeErrorr2 Ú
|
isinstanceÚfloatÚstrÚ_create_pax_generic_headerÚXHDTYPEr& r )
|
r r r6 r r Úhnamer5 rU Úvalr[ r8 r8 r9 r s8
|
þ
|
*
|
zTarInfo.create_pax_headerc C s | |td¡S )zAReturn the object as a pax global header block sequence.
|
Úutf8)r1 ÚXGLTYPE)Úclsr r8 r8 r9 Úcreate_pax_global_headerD s z TarInfo.create_pax_global_headerc C sj |dt d
}|r.|d dkr.|dd
}q|t|d
}|dd
}|rZt|tkrbtd||fS )zUSplit a name longer than 100 chars into a prefix
|
and a name part.
|
Nr r; r zname is too long)Ú LENGTH_PREFIXr2 r$ rE )r r r! r8 r8 r9 r% J s zTarInfo._posix_split_namec C sV t | dd¡d||t| dd¡d@ d|t| dd¡d|t| d d¡d|t| d
|
d¡d |t| d d¡d |d | dt¡t | dd¡d||| dt¡t | dd¡d||t | dd¡d||t| dd¡d|t| dd¡d|t | dd¡d||g}t dt d |¡¡}t |t d
d }|dd
d |
|
d ¡ |d d
}|S ) zReturn a header block. info is a dictionary with file
|
information, format must be one of the *_FORMAT constants.
|
r rr r rv r r r. r! r" r r+ r s r r r r# r, r$ r r r! r z%dsr Niþÿÿz%06o r@ iþÿÿ) r: ÚgetrW r r" rP rR rÓ ru r^ r1 )r rV r6 r7 Úpartsr[ r r8 r8 r9 r& Y s(
|
|
ñ&zTarInfo._create_headerc C s. t t| t\}}|dkr*| t| t 7 } | S )zdReturn the string payload filled with zero bytes
|
up to the next 512 byte border.
|
r )ra r2 rÓ r3 )Úpayloadre rf r8 r8 r9 Ú_create_payloadu s zTarInfo._create_payloadc C sR | ||¡t }i }d|d< ||d< t||d< t|d< | |t||¡| |¡ S )zTReturn a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence
|
for name.
|
z ././@LongLinkr r r r )r1 r3 r2 r' r& r r= )r7 r r r6 r7 r r8 r8 r9 r( s ÿz TarInfo._create_gnu_long_headerc C s2 d}| ¡ D ]8\}}z| dd¡ W q tk
|
rB d}Y qFY q X q d}|rV|d7 }| ¡ D ]\}}| d¡}|r| |d¡}n
|
| d¡}t|t| d }d } }
|
|tt|
|
} | |
|
krÂqÈ| }
|
q¨|tt|
|
d
|
d | d | d 7 }q^i } d| d< || d< t|| d< t| d< | | td
|
d¡| |¡ S )z¡Return a POSIX.1-2008 extended or global header sequence
|
that contains a list of keyword, value pairs. The values
|
must be strings.
|
Fr5 rA Tr s 21 hdrcharset=BINARY
|
r r r r@ ó ó =rõ z././@PaxHeaderr r r r r¸ )
|
Úitemsr1 r- r2 r0 Úbytesr" r& r r= ) r7 r r r6 ÚbinaryÚkeywordÚvalueÚrecordsrM rI r> r r8 r8 r9 r1 s<
|
|
( ÿz"TarInfo._create_pax_generic_headerc C sv t |dkrtdt |tkr(td| t¡tkr>tdt|dd
}|t|krbt d| }t
|
|dd
|||_ t|dd
|_ t|d d
|
|_ t|d
|
d
|_t|d d
|_t|d d
|_||_|dd
|_t
|
|d d
|||_t
|
|dd
|||_t
|
|dd
|||_t|dd
|_t|dd
|_t
|
|dd
||}|jtkr|j d¡rt|_|jtkr8d}g }t dD ]l} z0t|||d
}
|
t||d |d
} W n t k
|
rô Y qY nX | |
|
| f¡ |d7 }q¢t |d } t|dd
} || | f|_ | !¡ rP|j "d¡|_ |rr|jt#krr|d |j |_ |S ) zAConstruct a TarInfo object from a 512 byte bytes object.
|
r z empty headerztruncated headerzend of file headerrX rY z bad checksumr él ét é| é é i i i) iI iQ iY iô r i r/ r+ é iâ iã iï )$r2 r rÓ r Úcountr3 r rK r^ rF r? r rv r! r" r r r r r r# r$ r r ÚAREGTYPEr¿ r ÚGNUTYPE_SPARSErG rE rt Úboolr ÚisdirÚrstripÚ GNU_TYPES)r7 r[ r6 r7 r Úobjr! r¨ ÚstructsrJ rÝ ÚnumbytesÚ
|
isextendedÚorigsizer8 r8 r9 Úfrombufà sZ
|
zTarInfo.frombufc C s8 |j t¡}| ||j|j¡}|j ¡ t |_| |¡S )zOReturn the next TarInfo object from TarFile object
|
tarfile.
|
) r¦ r_ rÓ rX r6 r7 rÍ rÝ Ú _proc_member)r7 rï r[ rS r8 r8 r9 Ú fromtarfile s zTarInfo.fromtarfilec C sT | j ttfkr| |¡S | j tkr,| |¡S | j tttfkrF| |¡S |
|
|¡S dS )zYChoose the right processing method depending on
|
the type and call it.
|
N) r r* r) Ú _proc_gnulongrN Ú _proc_sparser2 r6 ÚSOLARIS_XHDTYPEÚ _proc_paxÚ _proc_builtin©r rï r8 r8 r9 rY s
|
|
|
|
zTarInfo._proc_memberc C sR |j ¡ | _| j}| ¡ s$| jtkr4|| | j¡7 }||_| |j
|
|j |j ¡ | S )zfProcess a builtin type or an unknown type which
|
will be treated as a regular file.
|
) r¦ rÍ rì Úisregr ÚSUPPORTED_TYPESÚ_blockr rÝ Ú_apply_pax_infor r6 r7 )r rï rÝ r8 r8 r9 r_ $ s zTarInfo._proc_builtinc C s |j | | j¡¡}z| |¡}W n tk
|
r> tdY nX | j|_| jt krft
|
||j |j |_ n | jtkrt
|
||j |j |_|S )zSProcess the blocks that hold a GNU longname
|
or longlink member.
|
ú missing or bad subsequent header)r¦ r_ rc r rZ r
r rÝ r r* r? r6 r7 r r) r )r rï r[ Únextr8 r8 r9 r[ 5 s
|
|
zTarInfo._proc_gnulongc
|
C sÚ | j \}}}| ` |rª|j t¡}d}tdD ]n}z0t|||d
}t||d |d
} W n tk
|
rz Y qY nX |r| r| || f¡ |d7 }q,t|d }q|| _ |j
|
¡ | _ | j | | j ¡ |_|| _ | S )z8Process a GNU sparse header plus extra headers.
|
r é r+ rK iø )r r¦ r_ rÓ rG rK rE rt rO rí rÍ rì rc r rÝ )
|
r rï rT rV rW r[ r¨ rJ rÝ rU r8 r8 r9 r\ K s(
|
zTarInfo._proc_sparsec C s |j | | j¡¡}| jtkr&|j}n
|
|j ¡ }t d|¡}|dk rX|
|
d¡ d¡|d< | d¡}|dkrr|j }nd}t d¡}d}| ||¡}|sq&| ¡ \} }
|
t| } || d ¡d | d¡| d
} | |
|
dd|j¡}
|
|
|
tkr| | ||j |j¡} n| | dd|j¡} | ||
|
< || 7 }qz| |¡} W n tk
|
rR td
|
Y nX d |krl| | |¡ nHd |kr| | ||¡ n.| d ¡dkr´| d¡dkr´| | ||¡ | jt t fkr| ||j |j¡ | j | _ d|kr| j!} | "¡ s| jt#kr| | | j¡7 } | |_ | S )zVProcess an extended or global header as described in
|
POSIX.1-2008.
|
s \d+ hdrcharset=([^\n]+)\nNr r5 Ú
|
hdrcharsetÚBINARYs (\d+) ([^=]+)=r r re úGNU.sparse.mapúGNU.sparse.sizezGNU.sparse.majorÚ1zGNU.sparse.minorrB r )$r¦ r_ rc r r r6 r r, ÚreÚsearchÚgroupr= r: r6 ÚcompileÚmatchÚgroupsrD Úendré Ú_decode_pax_fieldr7 ÚPAX_NAME_FIELDSrZ r
r Ú_proc_gnusparse_01Ú_proc_gnusparse_00Ú_proc_gnusparse_10r2 r] rd rÝ rì ra rb )r rï r[ r rq rh r6 Úregexr¨ r5 rC rD rf rÝ r8 r8 r9 r^ g sd
|
|
|
|
$
|
ÿ
|
ÿ
|
ÿ
|
|
|
|
zTarInfo._proc_paxc C sh g }t d|¡D ]}| t| d¡¡ qg }t d|¡D ]}| t| d¡¡ q:tt|||_dS )z?Process a GNU tar extended sparse header, version 0.0.
|
s \d+ GNU.sparse.offset=(\d+)\nr s \d+ GNU.sparse.numbytes=(\d+)\nN)rm Úfinditerrt rD ro ÚlistÚziprí )r rf r r[ Úoffsetsrq rU r8 r8 r9 rw Í s zTarInfo._proc_gnusparse_00c C s@ dd |d d¡D }tt|ddd
|ddd
|_dS )z?Process a GNU tar extended sparse header, version 0.1.
|
c S s g | ] }t |qS r8 )rD )Ú.0ro r8 r8 r9 Ú
|
<listcomp>Û s z.TarInfo._proc_gnusparse_01.<locals>.<listcomp>rj ú,Nr r )Úsplitr{ r| rí )r rf r rí r8 r8 r9 rv Ø s zTarInfo._proc_gnusparse_01c C s¨ d}g }|j t¡}| dd¡\}}t|}t||d k rtd|krT||j t¡7 }| dd¡\}}| t|¡ q,|j ¡ |_t t
|
|ddd
|ddd
|_ dS )z?Process a GNU tar extended sparse header, version 1.0.
|
Nrõ r r ) r¦ r_ rÓ r rD r2 rt rÍ rì r{ r| rí )r rf r rï Úfieldsrí r[ Únumberr8 r8 r9 rx Þ s zTarInfo._proc_gnusparse_10c C s | ¡ D ]ª\}}|dkr&t| d| q|dkr@t| dt| q|dkrZt| dt| q|tkr|tkrzt| |}W n tk
|
r d}Y nX |dkr¦| d¡}t| || q| ¡ | _dS ) zoReplace fields with supplemental information from a previous
|
pax extended or global header.
|
zGNU.sparse.namer rk r zGNU.sparse.realsizer r N) r@ ÚsetattrrD Ú
|
PAX_FIELDSÚPAX_NUMBER_FIELDSrE rQ r, r )r r r6 r7 rC rD r8 r8 r9 rd î s"
|
|
zTarInfo._apply_pax_infoc C s4 z| |d¡W S tk
|
r. | ||¡ Y S X dS )z1Decode a single field from a pax record.
|
rA N)r= ÚUnicodeDecodeError)r rD r6 Úfallback_encodingÚfallback_errorsr8 r8 r9 rt s zTarInfo._decode_pax_fieldc C s" t |t\}}|r|d7 }|t S )z_Round up a byte count by BLOCKSIZE and return it,
|
e.g. _block(834) => 1024.
|
r )ra rÓ )r rL re rf r8 r8 r9 rc s zTarInfo._blockc C s
|
| j tkS r )r Ú REGULAR_TYPESr r8 r8 r9 ra s z TarInfo.isregc C s | ¡ S r )ra r r8 r8 r9 Úisfile s zTarInfo.isfilec C s
|
| j tkS r )r r r r8 r8 r9 rP s z TarInfo.isdirc C s
|
| j tkS r )r ÚSYMTYPEr r8 r8 r9 Úissym s z TarInfo.issymc C s
|
| j tkS r )r ÚLNKTYPEr r8 r8 r9 Úislnk s z TarInfo.islnkc C s
|
| j tkS r )r ÚCHRTYPEr r8 r8 r9 Úischr s z TarInfo.ischrc C s
|
| j tkS r )r ÚBLKTYPEr r8 r8 r9 Úisblk" s z TarInfo.isblkc C s
|
| j tkS r )r ÚFIFOTYPEr r8 r8 r9 Úisfifo$ s zTarInfo.isfifoc C s
|
| j d k S r )rí r r8 r8 r9 Úissparse& s zTarInfo.issparsec C s | j tttfkS r )r r r r r r8 r8 r9 Úisdev( s z TarInfo.isdevN)rr )4r} r~ r r Ú __slots__r r r Úpropertyr r r r r r ÚDEFAULT_FORMATÚENCODINGr r r r Ú classmethodr8 r% Ú staticmethodr& r= r( r1 rX rZ rY r_ r[ r\ r^ rw rv rx rd rt rc ra r rP r r r r r r r r8 r8 r8 r9 r sf
|
|
|
1
|
|
|
|
|
2
|
>
|
f c @ s e Zd ZdZdZdZdZdZeZ e
|
Z dZ e ZeZdVdd Zedddefd
|
d ZedWd d ZedXddZedYddZddddZdd Zdd Zdd Zd d Z dZd d Z d[d"d#Z d\d$d%Z d]d&d'Z d^d)d*Z!d_d,d-Z"d.d/ Z#d`d0d1Z$d2d3 Z%d4d5 Z&d6d7 Z'd8d9 Z(d:d; Z)d<d= Z*d>d? Z+d@dA Z,dBdC Z-dDdE Z.dadFdGZ/dHdI Z0dbdJdKZ1dLdM Z2dNdO Z3dPdQ Z4dRdS Z5dTdU Z6dS )cr z=The TarFile Class provides an interface to tar archives.
|
r Fr Nrl r c
|
C s t |dks|dkr td|| _dddd| | _|sn| jdkrZtj |¡sZd | _d| _t|| j}d
|
| _n0|d krt |d r|j
|
}t |d r|j| _d| _|r®tj |¡nd | _
|
|| _ |d k rÈ|| _ |d k rÖ|| _|d k rä|| _|d k rò|| _|d k r|| _| | _|
|
d k r&| j tkr&|
|
| _ni | _| d k r<| | _| d k rL| | _d
|
| _g | _d
|
| _| j ¡ | _i | _ zþ| jdkrd | _ | ¡ | _ | jdkr"| j | j¡ z | j | ¡}| j !|¡ W nX t"k
|
rî | j | j¡ Y q"Y n0 t#k
|
r } zt$t%| W 5 d } ~ X Y nX q| jdkrld| _| jrl| j &| j '¡ ¡}| j (|¡ | jt |7 _W n& | js| j )¡ d| _ Y nX d S )aÖ Open an (uncompressed) tar archive `name'. `mode' is either 'r' to
|
read from an existing archive, 'a' to append data to an existing
|
file or 'w' to create a new file overwriting an existing one. `mode'
|
defaults to 'r'.
|
If `fileobj' is given, it is used for reading or writing data. If it
|
can be determined, `mode' is overridden by `fileobj's mode.
|
`fileobj' is not closed, when TarFile is closed.
|
r rÚ ú mode must be 'r', 'a' or 'w'Úrbzr+bÚwb)rl Úarm r¡ rm FNr rv Trl Úaw)*r2 rE rv Ú_moder r ÚexistsÚ bltn_openr¢ r r Úabspathr¦ rV rð Ú dereferenceÚ ignore_zerosr6 r7 r r ÚdebugÚ
|
errorlevelr© ÚmembersÚ_loadedrÍ rÝ ÚinodesÚ firstmemberrf rÎ rZ rt r r
r r0 r8 r, r` r )r r rv r¦ rV rð r§ r¨ r6 r7 r r© rª Úer[ r8 r8 r9 r F s
|
|
|
|
|
|
"
|
zTarFile.__init__c K s¸ |s|st d|dkr¨| jD ]|}t| | j| }|dk rB| ¡ }z||d|f|W S ttfk
|
r } z |dk r| |¡ W Y ¢q W 5 d} ~ X Y q X q tdnd|kr
|
| dd¡\}
|
}|
|
pÈd}
|
|pÐd}|| jkrît| | j| }n td | |||
|
|f|S d
|
|kr| d
|
d¡\}
|
}|
|
p,d}
|
|p6d}|
|
d krJt d t||
|
|||} z| ||
|
| f|} W n | ¡ Y nX d | _
|
| S |dkr¬| j |||f|S t ddS )a| Open a tar archive for reading, writing or appending. Return
|
an appropriate TarFile class.
|
|
mode:
|
'r' or 'r:*' open for reading with transparent compression
|
'r:' open for reading exclusively uncompressed
|
'r:gz' open for reading with gzip compression
|
'r:bz2' open for reading with bzip2 compression
|
'a' or 'a:' open for appending, creating the file if necessary
|
'w' or 'w:' open for writing without compression
|
'w:gz' open for writing with gzip compression
|
'w:bz2' open for writing with bzip2 compression
|
|
'r|*' open a stream of tar blocks with transparent compression
|
'r|' open an uncompressed stream of tar blocks for reading
|
'r|gz' open a gzip compressed stream of tar blocks
|
'r|bz2' open a bzip2 compressed stream of tar blocks
|
'w|' open an uncompressed stream for writing
|
'w|gz' open a gzip compressed stream for writing
|
'w|bz2' open a bzip2 compressed stream for writing
|
znothing to open)rl zr:*Nrl z%file could not be opened successfullyú:r rÁ zunknown compression type %rú|Úrwúmode must be 'r' or 'w'Fr¢ zundiscernible mode) rE Ú OPEN_METHrÖ rÍ r r rÎ r r r r¢ Útaropen) r7 r rv r¦ r§ Úkwargsr¥ ÚfuncÚ saved_posr¯ r{ Ústreamrp r8 r8 r9 r ± sN
|
|
|
|
|
|
|
|
|
z TarFile.openc K s, t |dks|dkr td| |||f|S )zCOpen uncompressed tar archive name for reading or writing.
|
r rÚ r )r2 rE )r7 r rv r¦ r¶ r8 r8 r9 rµ ý s zTarFile.taropenrµ c K sè t |dks|dkr tdzddl}|j W n ttfk
|
rN tdY nX |dk }z*| ||d ||¡}| j|||f|}W nZ tk
|
r¼ |s¦|dk r¦| ¡ |dkr° t
|
dY n" |sÖ|dk rÖ| ¡ Y nX ||_ |S ) zkOpen gzip compressed tar archive name for reading or writing.
|
Appending is not allowed.
|
r r² r³ r Nz gzip module is not availablerg rÅ ) r2 rE ÚgzipÚGzipFiler« ÚAttributeErrorr rµ rb r r r¢ ) r7 r rv r¦ Ú compresslevelr¶ rº Z
|
extfileobjrp r8 r8 r9 Úgzopen s.
|
zTarFile.gzopenc K s´ t |dks|dkr tdz ddl}W n tk
|
rD tdY nX |dk rZt||}n|j|||d}z| j|||f|}W n( tt fk
|
r¨ |
|
¡ t dY nX d |_ |S )
|
zlOpen bzip2 compressed tar archive name for reading or writing.
|
Appending is not allowed.
|
r r² zmode must be 'r' or 'w'.r Nr¡ )r½ znot a bzip2 fileF) r2 rE r r« r rÕ ÚBZ2Filerµ rb ÚEOFErrorr r r¢ )r7 r rv r¦ r½ r¶ r rp r8 r8 r9 Úbz2open$ s zTarFile.bz2openrµ r¾ rÁ )rÁ r r c C s | j r
|
dS | jdkrf| j ttd ¡ | jtd 7 _t| jt\}}|dkrf| j tt| ¡ | j sv| j
|
¡ d| _ dS )zlClose the TarFile. In write-mode, two finishing zero blocks are
|
appended to the archive.
|
Nr¢ r r T) r© rv r¦ r` r3 rÓ rÝ ra Ú
|
RECORDSIZEr¢ r )r re rf r8 r8 r9 r H s
|
|
z TarFile.closec C s" | |¡}|dkr td| |S )a Return a TarInfo object for member `name'. If `name' can not be
|
found in the archive, KeyError is raised. If a member occurs more
|
than once in the archive, its last occurrence is assumed to be the
|
most up-to-date version.
|
Nzfilename %r not found)Ú
|
_getmemberÚKeyError)r r rð r8 r8 r9 Ú 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 r8 r8 r9 Ú
|
getmembersg s zTarFile.getmembersc C s dd | ¡ D S )zReturn the members of the archive as a list of their names. It has
|
the same order as the list returned by getmembers().
|
c S s g | ]
|
}|j qS r8 r )r~ rð r8 r8 r9 r u s z$TarFile.getnames.<locals>.<listcomp>)rÈ r r8 r8 r9 Úgetnamesq s zTarFile.getnamesc C sl | d¡ |dk r|j}|dkr$|}tj |¡\}}| tjd¡}| d¡}| ¡ }| |_ |dkrt
|
tdr~| j s~t |¡}qt |¡}nt | ¡ ¡}d}|j}t |¡r |j|jf} | j sò|jdkrò| | jkrò|| j| kròt}
|
| j| }nt}
|
| d rt|| j| < nht |¡r t}
|
nVt |¡r0t}
|
nDt |¡rLt }
|
t |¡}n(t |¡r^t }
|
nt !|¡rpt"}
|
ndS ||_||_#|j$|_%|j&|_'|
|
tkr¤|j(|_)nd|_)|j*|_+|
|
|_,||_-t.ròzt. /|j%¡d |_0W n t1k
|
rð Y nX t2r&zt2 3|j'¡d |_4W n t1k
|
r$ Y nX |
|
t t"fkrht
|
tdrht
|
td rht 5|j6¡|_7t 8|j6¡|_9|S )
|
aO Create a TarInfo object for either the file `name' or the file
|
object `fileobj' (using os.fstat on its file descriptor). You can
|
modify some of the TarInfo's attributes before you add it using
|
addfile(). If given, `arcname' specifies an alternative name for the
|
file in the archive.
|
r¢ Nr Úlstatrr r r ÚmajorÚminor):rÆ r r r Ú
|
splitdriver¸ ÚsepÚlstriprð rï r r§ rÊ ÚstatÚfstatÚfilenoÚst_modeÚS_ISREGÚst_inoÚst_devÚst_nlinkr r r ÚS_ISDIRr ÚS_ISFIFOr ÚS_ISLNKr ÚreadlinkÚS_ISCHRr ÚS_ISBLKr rv Úst_uidr! Úst_gidr" Úst_sizer Úst_mtimer r r ÚpwdÚgetpwuidr# rÄ ÚgrpÚgetgrgidr$ rË Úst_rdevr rÌ r ) r r Úarcnamer¦ Údrvrð Ústatresr ÚstmdÚinoder r8 r8 r9 Ú
|
gettarinfow s
|
|
ÿ ÿ
|
|
|
zTarFile.gettarinfoTc C s | ¡ | D ]ö}|rªtt|jdd td|jp4|j|jp>|jf dd | ¡ sZ| ¡ rxtdd|j
|
|j f dd ntd|j dd tdt |j¡dd
dd t|j| ¡ r¼d
|
nd dd |rü| ¡ rätd |jdd | ¡ rütd |jdd t q dS )z¼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.
|
ú )rs z%s/%sz%10sz%d,%dz%10dz%d-%02d-%02d %02d:%02d:%02dNrÇ r rr z->zlink to)rÆ Úprintr{ rv r# r! r$ r" r r r r r r½ Ú localtimer r rP r r r )r Úverboserð r8 r8 r9 r{ Ù s8
|
ÿÿ
|
ÿÿÿÿ z TarFile.listc C sn | d¡ |dkr|}|dk rPddl}| dtd¡ ||rP| dd| ¡ dS | jdk rtj |¡| jkr| dd| ¡ dS | d|¡ | ||¡}|dkr´| dd | ¡ dS |dk rà||}|dkrà| dd| ¡ dS |
|
¡ r
|
t |d
|
}| ||¡ | ¡ n`| ¡ r`| |¡ |rjt |¡D ].}| jtj ||¡tj ||¡|||d q.n
|
| |¡ dS ) a~ Add the file `name' to the archive. `name' may be any type of file
|
(directory, fifo, symbolic link, etc.). If given, `arcname'
|
specifies an alternative name for the file in the archive.
|
Directories are added recursively by default. This can be avoided by
|
setting `recursive' to False. `exclude' is a function that should
|
return True for each filename to be excluded. `filter' is a function
|
that expects a TarInfo object argument and returns the changed
|
TarInfo object, if it returns None the TarInfo object will be
|
excluded from the archive.
|
r¢ Nr z use the filter argument insteadr ztarfile: Excluded %rztarfile: Skipped %rr z tarfile: Unsupported type %rr )Úfilter)rÆ ÚwarningsÚwarnÚDeprecationWarningÚ_dbgr r r r¦ rì ra r¥ Úaddfiler rP ÚlistdirÚaddru ) r r rç Ú recursiveÚexcluderñ rò rð Úfr8 r8 r9 rø ö sN
|
ÿ
|
|
|
|
|
ÿ z TarFile.addc C s´ | d¡ t |¡}| | j| j| j¡}| j |¡ | jt |7 _|dk r¤t
|
|| j|j t |j t \}}|dkr| j tt | ¡ |d7 }| j|t 7 _| j |¡ dS )a] Add the TarInfo object `tarinfo' to the archive. If `fileobj' is
|
given, tarinfo.size bytes are read from it and added to the archive.
|
You can create TarInfo objects using gettarinfo().
|
On Windows platforms, `fileobj' should always be opened with mode
|
'rb' to avoid irritation about the file size.
|
r¢ Nr r )rÆ r, r rV r6 r7 r¦ r` rÝ r2 rh r ra rÓ r3 r« rt )r rð r¦ r[ re rf r8 r8 r9 rö 4 s
|
|
zTarFile.addfileÚ.c C sò g }|dkr| }|D ]<}| ¡ r:| |¡ t |¡}d|_| j||| ¡ d q|jdd d | ¡ |D ]~}tj ||j
|
¡}z(| ||¡ | ||¡ | ||¡ W qn tk
|
rê } z"| jdkrÊ n| dd| ¡ W 5 d}~X Y qnX qndS ) aM Extract all members from the archive to the current working
|
directory and set owner, modification time and permissions on
|
directories afterwards. `path' specifies a different directory
|
to extract to. `members' is optional and must be a subset of the
|
list returned by getmembers().
|
NéÀ ©Ú set_attrsc S s | j S r r )r¡ r8 r8 r9 Ú<lambda>d r z$TarFile.extractall.<locals>.<lambda>)Úkeyr ú tarfile: %s)rP rt r, rv ÚextractÚsortÚreverser r ru r ÚchownÚutimeÚchmodr rª rõ )r r r« Ú directoriesrð Údirpathr¯ r8 r8 r9 Ú
|
extractallN s*
|
|
|
zTarFile.extractallrr c
|
C s
|
| d¡ t|tr | |¡}n|}| ¡ r>tj ||j¡|_ z | j
|
|tj ||j ¡|d W n¦ t k
|
rÄ } zH| j dkr~ n6|jdkr| dd|j ¡ n| dd|j|jf ¡ W 5 d}~X Y nB tk
|
r } z"| j dkrä n| dd| ¡ W 5 d}~X Y nX dS )ax Extract a member from the archive to the current working directory,
|
using its full name. Its file information is extracted as accurately
|
as possible. `member' may be a filename or a TarInfo object. You can
|
specify a different directory using `path'. File attributes (owner,
|
mtime, mode) are set unless `set_attrs' is False.
|
rl rþ r Nr r ztarfile: %s %r)rÆ r. r0 rÅ r r r ru r r Ú_extract_memberr ÚEnvironmentErrorrª Úfilenamerõ Ústrerrorr )r Úmemberr rÿ rð r¯ r8 r8 r9 r t s(
|
|
ÿ
|
|
|
(
|
zTarFile.extractc C s | d¡ t|tr | |¡}n|}| ¡ r8| | |¡S |jtkrN| | |¡S | ¡ s^| ¡ rt| j
|
t rtt dq| | |¡¡S ndS dS )aë Extract a member from the archive as a file object. `member' may be
|
a filename or a TarInfo object. If `member' is a regular file, a
|
file-like object is returned. If `member' is a link, a file-like
|
object is constructed from the link's target. If `member' is none of
|
the above, None is returned.
|
The file-like object is read-only and provides the following
|
methods: read(), readline(), readlines(), seek() and tell()
|
rl z'cannot extract (sym)link as file objectN)rÆ r. r0 rÅ ra Ú
|
fileobjectr rb r r r¦ r r Ú extractfileÚ_find_link_target)r r rð r8 r8 r9 r s
|
|
|
|
zTarFile.extractfilec C sR | d¡}| dtj¡}tj |¡}|r>tj |¡s>t |¡ | ¡ sN| ¡ rh|
|
dd|j |j f ¡ n|
|
d|j ¡ | ¡ r| ||¡ n| ¡ r¢| ||¡ nx| ¡ r¸| ||¡ nb| ¡ sÈ| ¡ rÖ| ||¡ nD| ¡ sæ| ¡ rô| ||¡ n&|jtkr| ||¡ n | ||¡ |rN| ||¡ | ¡ sN| ||¡ | ||¡ dS )z\Extract the TarInfo object tarinfo to a physical
|
file called targetpath.
|
r r z%s -> %sN) rQ r¸ r rÎ r Údirnamer¤ Úmakedirsr r rõ r r ra ÚmakefilerP Úmakedirr Úmakefifor r ÚmakedevÚmakelinkr rb Ú makeunknownr r r )r rð Ú
|
targetpathrÿ Ú upperdirsr8 r8 r9 r ½ s4
|
|
|
zTarFile._extract_memberc
|
C sF zt |d¡ W n0 tk
|
r@ } z|jtjkr0 W 5 d}~X Y nX dS )z,Make a directory called targetpath.
|
rý N)r Úmkdirr ÚerrnoÚEEXIST©r rð r r¯ r8 r8 r9 r í s
|
zTarFile.makedirc C s| | j }| |j¡ t|d}|jdk rN|jD ] \}}| |¡ t||| q,nt|||j | |j¡ | ¡ | ¡ dS )z'Make a file called targetpath.
|
r N) r¦ rÎ rì r¥ rí rh r Útruncater )r rð r ÚsourceÚtargetrÝ r r8 r8 r9 r ø s
|
|
|
zTarFile.makefilec C s" | ||¡ | dd|j ¡ dS )zYMake a file from a TarInfo object with an unknown type
|
at targetpath.
|
r z9tarfile: Unknown file type %r, extracted as regular file.N)r rõ r ©r rð r r8 r8 r9 r s ÿzTarFile.makeunknownc C s" t tdrt |¡ ntddS )z'Make a fifo called targetpath.
|
Úmkfifoz fifo not supported by systemN)r r r& r r% r8 r8 r9 r s
|
zTarFile.makefifoc C s^ t tdrt tds td|j}| ¡ r6|tjO }n
|
|tjO }t ||t |j
|
|j ¡¡ dS )z<Make a character or block device called targetpath.
|
Úmknodr z'special devices not supported by systemN) r r r rv r rÐ ÚS_IFBLKÚS_IFCHRr' r r r )r rð r rv r8 r8 r9 r s
|
ÿzTarFile.makedevc C sÄ zL| ¡ rt |j|¡ n0tj |j¡r8t |j|¡ n| | |¡|¡ W n> t
|
k
|
r | ¡ rtj tj |j ¡|j¡}n|j}Y n6X z| | |¡|¡ W n tk
|
r¾ tdY nX dS )zµ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.
|
z%unable to resolve link inside archiveN)r r Úsymlinkr r r¤ r Úlinkr r Úsymlink_exceptionru r r rÄ r )r rð r r r8 r8 r9 r ' s( ÿÿ ÿzTarFile.makelinkc
|
C sè t rättdrät ¡ dkräzt |j¡d }W n tk
|
rH |j}Y nX zt |j
|
¡d }W n tk
|
rx |j }Y nX z>| ¡ rttdrt |||¡ ntjdkr¶t |||¡ W n* tk
|
râ } z tdW 5 d}~X Y nX dS )z6Set owner of targetpath according to tarinfo.
|
Úgeteuidr r ÚlchownZos2emxzcould not change ownerN)râ r r r- rä Úgetgrnamr$ rÄ r" Úgetpwnamr# r! r r. ÚsysÚplatformr r r )r rð r ÚgÚur¯ r8 r8 r9 r D s
|
z TarFile.chownc
|
C sL t tdrHzt ||j¡ W n* tk
|
rF } z tdW 5 d}~X Y nX dS )zASet file permissions of targetpath according to tarinfo.
|
r zcould not change modeN)r r r rv r r r! r8 r8 r9 r Z s
|
|
z TarFile.chmodc
|
C sV t tdsdS zt ||j|jf¡ W n* tk
|
rP } z tdW 5 d}~X Y nX dS )zBSet modification time of targetpath according to tarinfo.
|
r Nz"could not change modification time)r r r r r r r! r8 r8 r9 r c s
|
z TarFile.utimec
|
C s | d¡ | jdk r$| j}d| _|S | j | j¡ d}z| j | ¡}W q tk
|
r } z6| jr| dd| j|f ¡ | jt
|
7 _W Y ¢q6W 5 d}~X Y nþ t k
|
r } zN| jrâ| dd| j|f ¡ | jt
|
7 _W Y ¢ q6n| jdkrøt t |W 5 d}~X Y n tk
|
r0 | jdkr,t dY nj tk
|
rj } z | jdkrZt t |W 5 d}~X Y n0 tk
|
r } zt t |W 5 d}~X Y nX q q6|dk r¸| j |¡ nd| _|S )z¨Return the next member of the archive as a TarInfo object, when
|
TarFile is opened for reading. Return None if there is no more
|
available.
|
ÚraNr z0x%X: %sr z
|
empty fileT)rÆ r® r¦ rÎ rÝ rð rZ r r¨ rõ rÓ rF r r0 r r r r« rt r¬ )r Úmrð r¯ r8 r8 r9 rf n sD
|
|
|
|
|
z TarFile.nextc C sn | ¡ }|dk r"|d| |¡
}|r2tj |¡}t|D ].}|rRtj |j¡}n|j}||kr:| S q:dS )z}Find an archive member by name from bottom to top.
|
If tarinfo is given, it is used as the starting point.
|
N)rÈ Úindexr r ÚnormpathÚreversedr )r r rð Ú normalizer« r Ú member_namer8 r8 r9 rà s zTarFile._getmemberc C s | ¡ }|dkr qq d| _dS )zWRead through the entire archive file and look for readable
|
members.
|
NT)rf r¬ ©r rð r8 r8 r9 rÇ ¶ s z TarFile._loadc C s: | j rtd| jj |dk r6| j|kr6td| j dS )znCheck if TarFile is still open, and if the operation's mode
|
corresponds to TarFile's mode.
|
z %s is closedNzbad operation for mode %r)r© rb r r} rv )r rv r8 r8 r9 rÆ À s zTarFile._checkc C sX | ¡ r&tj |j¡d |j }d}n
|
|j}|}| j||dd}|dkrTtd| |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 r rà rÄ )r rð r Úlimitr r8 r8 r9 r É s zTarFile._find_link_targetc C s | j rt| jS t| S dS )z$Provide an iterator object.
|
N)r¬ Úiterr« ÚTarIterr r8 r8 r9 rÿ Ü s
|
zTarFile.__iter__c C s || j krt|tjd dS )z.Write debugging output to sys.stderr.
|
)ÚfileN)r© rî r1 Ústderr)r ÚlevelÚmsgr8 r8 r9 rõ ä s
|
z TarFile._dbgc C s | ¡ | S r )rÆ r r8 r8 r9 Ú __enter__ê s zTarFile.__enter__c C s, |d kr| ¡ n| js"| j ¡ d| _d S rñ )r r¢ r¦ r© )r r rD Ú tracebackr8 r8 r9 Ú__exit__î s
|
|
|
zTarFile.__exit__) Nrl NNNNNNr NNN)rl N)rl Nrµ )rl Nrµ )NNN)T)NTNN)N)rü N)rr T)T)NF)N)7r} r~ r r r© r§ r¨ rª r rV r r6 r7 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 rf rà rÇ rÆ r rÿ rõ rD rF r8 r8 r8 r9 r , s| þ
|
kK ý
|
|
b
|
|
>
|
|
&
|
#&
|
0 1
|
|
|
c @ s, e Zd ZdZdd Zdd Zdd ZeZdS ) r? zMIterator Class.
|
|
for tarinfo in TarFile(...):
|
suite...
|
c C s || _ d| _dS )z$Construct a TarIter object.
|
r N)rï r7 r` r8 r8 r9 r
|
s zTarIter.__init__c C s | S )z Return iterator object.
|
r8 r r8 r8 r9 rÿ
|
s zTarIter.__iter__c C sb | j js$| j ¡ }|sPd| j _tn,z| j j| j }W n tk
|
rN tY nX | jd7 _|S )zReturn the next item using TarFile's next() method.
|
When all members have been read, set TarFile as _loaded.
|
Tr )rï r¬ rf Ú StopIterationr« r7 Ú
|
IndexErrorr< r8 r8 r9 Ú__next__
|
|
s
|
|
zTarIter.__next__N)r} r~ r r r rÿ rI rf r8 r8 r8 r9 r? ù s
|
r? c C s2 zt | }| ¡ W dS tk
|
r, Y dS X dS )zfReturn True if name points to a tar archive that we
|
are able to handle, else return False.
|
TFN)r r r )r rp r8 r8 r9 r #
|
s )N)wÚ
|
__future__r Ú __version__ÚversionÚ
|
__author__Ú__date__Z __cvsid__Ú __credits__r1 r rÐ r r½ rP r, rm rä râ r« r¼ ÚNotImplementedErrorr, Ú WindowsErrorÚ NameErrorÚ__all__Ú version_infoÚ __builtin__Úbuiltinsr Ú_openr3 rÓ r r' r" r$ r# r9 r rM r r r r r r ÚCONTTYPEr* r) rN r2 r6 r] r rO r r rb r rR r
Úsetru r/ rD r ÚS_IFLNKÚS_IFREGr( ÚS_IFDIRr) ÚS_IFIFOZTSUIDZTSGIDZTSVTXZTUREADZTUWRITEZTUEXECZTGREADZTGWRITEZTGEXECZTOREADZTOWRITEZTOEXECr r Úgetfilesystemencodingr: r? rK rW r^ rh rs r{ Ú Exceptionr r r r r r
r r r rF r Úobjectr r r£ rÕ rÜ rë r r r? r r¥ r8 r8 r8 r9 Ú<module> sZ
|
ü ÿÿú
|
û
|
þ
|
þ
|
þê i?K T*
|
