Edit File: zipfile.cpython-38.pyc
U @��d�V � @ s d Z ddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZzddlZejZW n ek r� dZejZY nX z ddlZW n ek r� dZY nX z ddlZW n ek r� dZY nX ddddddd d d d d ddg ZG dd� de�ZG dd� de�Ze ZZdZdZ dZ dZ dZ dZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'd Z(e �)e'�Z*dZ+d Z,d Z-d Z.d Z/d!Z0d"Z1d#Z2dZ3d$Z4d%Z5d&Z6e �)e5�Z7dZ8d Z9d Z:d Z;d Z<d!Z=d"Z>d#Z?dZ@d$ZAd'ZBd(ZCdZDd)ZEdZFd*ZGd+ZHd,ZId-ZJd.ZKd/ZLe �)eK�ZMdZNd ZOd ZPd ZQd ZRd!ZSd"ZTd#ZUdZVd$ZWd'ZXd(ZYd0ZZd1Z[e �)eZ�Z\d2Z]d3Z^e �)e]�Z_dZ`d Zad Zbd Zcd Zdd!Zed"Zfd#ZgdZhd$Zid4Zje �kd5�Zld6d7� Zmd8d9� Znd:d � Zod;d<� Zpd=d>� ZqG d?d � d er�Zsdatd@dA� ZudBdC� ZvG dDdE� dE�ZwG dFdG� dG�ZxdHdIdJdJdJdJdKdLdMdNdKdOdPdQdRdSdTdU�ZydVdW� ZzdtdXdY�Z{dZd[� Z|G d\d]� d]�Z}G d^d_� d_�Z~G d`da� daej�Z�G dbdc� dcej�Z�G ddd � d �Z�G ded � d e��Z�dfdg� Z�dhdi� Z�e�j�Z�djdk� Z�G dldm� dme��Z�G dndo� doe��Z�G dpd� d�Z�dudqdr�Z�e�dsk�r e�� dS )vzP Read and write ZIP files. XXX references to utf-8 need further investigation. � N� BadZipFile� BadZipfile�error� ZIP_STORED� ZIP_DEFLATED� ZIP_BZIP2�ZIP_LZMA� is_zipfile�ZipInfo�ZipFile� PyZipFile� LargeZipFile�Pathc @ s e Zd ZdS )r N)�__name__� __module__� __qualname__� r r �,/opt/alt/python38/lib64/python3.8/zipfile.pyr + s c @ s e Zd ZdZdS )r zu Raised when writing a zipfile, the zipfile requires ZIP64 extensions and those extensions are disabled. N)r r r �__doc__r r r r r / s i���� � � � � �- �. �? s <4s4H2LHs PK� � � � � � � � z<4s4B4HL2L5H2Ls PK� � � � � � � z <4s2B4HL2L2Hs PKz<4sLQLs PKz <4sQ2H2L4Qs PKiPK�<HHc C s� t j}d}g }d }}|d t| �krz|| ||d � �\}}|d | } ||krt||krl|�| ||� � | }d}| }q|s�| S d�|�S )NFr r T� )�_EXTRA_FIELD_STRUCT�unpack�len�append�join) �extraZxidsr/ Zmodified�buffer�start�iZxidZxlen�jr r r � _strip_extra� s r8 c C s, zt | �rW dS W n tk r& Y nX dS )NTF)� _EndRecData�OSError��fpr r r �_check_zipfile� s r= c C sV d}z8t | d�r t| d�}n t| d��}t|�}W 5 Q R X W n tk rP Y nX |S )z�Quickly see if a file is a ZIP file by checking the magic number. The filename argument may be a file or file-like object too. F�readr; �rb)�hasattrr= �openr: )�filename�resultr< r r r r � s c C s z| � |t d� W n tk r, | Y S X | �t�}t|�tkrH|S t�t|�\}}}}|tkrh|S |dksx|dkr�t d��| � |t t d� | �t �}t|�t kr�|S t�t |�\ }}} } } } } }}}|t kr�|S ||t < | |t< | |t< | |t< ||t< ||t< ||t< |S )zM Read the ZIP64 end-of-archive records and use that to update endrec r r r z3zipfiles that span multiple disks are not supported)�seek�sizeEndCentDir64Locatorr: r> r0 �structr/ �structEndArchive64Locator�stringEndArchive64Locatorr �sizeEndCentDir64�structEndArchive64�stringEndArchive64�_ECD_SIGNATURE�_ECD_DISK_NUMBER�_ECD_DISK_START�_ECD_ENTRIES_THIS_DISK�_ECD_ENTRIES_TOTAL� _ECD_SIZE� _ECD_OFFSET)�fpin�offset�endrec�dataZsigZdisknoZreloffZdisksZsz�create_versionZ read_versionZdisk_numZdisk_dirZdircountZ dircount2ZdirsizeZ diroffsetr r r � _EndRecData64� s@ � rX c C sh | � dd� | �� }z| � t d� W n tk r< Y dS X | �� }t|�tkr�|dd� tkr�|dd� dkr�t�t |�}t |�}|� d� |� |t � t | t |�S t |d t d�}| � |d� | �� }|�t�}|dk�rd|||t � }t|�tk�rdS t t�t |��}|t }||t |t | � }|� |� |� || � t | || | |�S dS ) z�Return data from the "End of Central Directory" record, or None. The data is a list of the nine items in the ZIP "End of central dir" record followed by a tenth item, the file seek offset of this record.r r Nr ���s r- i )rD �tell�sizeEndCentDirr: r> r0 �stringEndArchiverF r/ �structEndArchive�listr1 rX �max�rfind�_ECD_COMMENT_SIZE) rS ZfilesizerV rU ZmaxCommentStartr5 ZrecDataZ commentSize�commentr r r r9 sD �� �r9 c @ s\ e Zd ZdZdZddd�Zdd� Zdd d �Zd d � Zdd� Z e ddd�dd��Z dd� Z d S )r z>Class with attributes describing each file in the ZIP archive.)� orig_filenamerB � date_time� compress_type�_compresslevelrb r3 � create_systemrW �extract_version�reserved� flag_bits�volume� internal_attr� external_attr� header_offset�CRC� compress_size� file_size� _raw_time�NoName�� r r r r r c C s� || _ |�td��}|dkr(|d|� }tjdkrJtj|krJ|�tjd�}|| _|| _|d dk rjtd��t | _ d | _ d| _ d| _ tjdkr�d| _nd| _t| _t| _d| _d| _d| _d| _d| _d S )Nr �/ru z+ZIP does not support timestamps before 1980r- Zwin32r )rc �find�chr�os�sep�replacerB rd � ValueErrorr re rf rb r3 �sys�platformrg �DEFAULT_VERSIONrW rh ri rj rk rl rm )�selfrB rd Z null_byter r r �__init__X s0 zZipInfo.__init__c C s� d| j j| jf g}| jtkr8|�dt�| j| j� � | jd? }| jd@ }|rd|�dt � |� � |rv|�d| � | � � }|r�| j r�|�d| j � |r�| j r�| jtks�| j | j kr�|�d| j � |�d � d �|�S ) Nz<%s filename=%r� compress_type=%sr) r z filemode=%rz external_attr=%#xz file_size=%rz compress_size=%r�>� )� __class__r rB re r r1 �compressor_names�getrm �stat�filemode�is_dirrq rp r2 )r� rC �hi�lo�isdirr r r �__repr__� s0 �� � � zZipInfo.__repr__Nc C s| | j }|d d d> |d d> B |d B }|d d> |d d> B |d d B }| jd @ rfd } }}n| j}| j}| j}| j}d} |d kr�|tkp�|tk}|r�d } |t�| dt� | �d ||� }|tks�|tkr�|s�t d ��d}d}t } | j t k�rtt| �} n| j tk�rtt| �} t| | j�| _t| | j�| _| �� \} } t�tt| j| j| | j |||||t| �t|�� } | | | S )z-Return the per-file header as a bytes object.r ru r$ r r! r r r& r r Nz<HHQQz'Filesize would require ZIP64 extensions� �� )rd rj ro rp rq r3 � ZIP64_LIMITrF �pack�calcsizer � ZIP64_VERSIONre r r_ � BZIP2_VERSIONr � LZMA_VERSIONrh rW �_encodeFilenameFlags�structFileHeader�stringFileHeaderri r0 )r� �zip64�dt�dosdate�dostimero rp rq r3 � min_version�fmtrB rj �headerr r r � FileHeader� s^ $$ � �zZipInfo.FileHeaderc C sD z| j �d�| jfW S tk r> | j �d�| jdB f Y S X d S )N�ascii�utf-8� )rB �encoderj �UnicodeEncodeError�r� r r r r� � s z ZipInfo._encodeFilenameFlagsc C s� | j }tj}t|�dk�r�|d|d d� �\}}|d t|�krPtd||f ��|dk�rp|dkrv|d|dd� �}nV|dkr�|d |dd � �}n:|d kr�|d |dd � �}n |dkr�d}ntd||f ��d}| jdk�rt|�|kr�td��|| | _|d7 }| jdk�r6t|�|k�r$td��|| | _|d7 }| jdk�rpt|�|k�rXtd��| j}|| | _|d7 }||d d � }q d S )Nr r, z"Corrupt extra field %04x (size=%d)r � z<QQQ� r) z<QQr r z<Qr r r )l ���� r� z/Corrupt zip64 extra field. File size not found.r� z3Corrupt zip64 extra field. Compress size not found.z3Corrupt zip64 extra field. Header offset not found.)r3 rF r/ r0 r rq rp rn )r� r3 r/ �tpZlnZcounts�idx�oldr r r � _decodeExtra� sP � � � zZipInfo._decodeExtraT��strict_timestampsc C s t |tj�rt�|�}t�|�}t�|j�}t�|j �}|dd� }|sZ|d dk rZd}n|sn|d dkrnd}|dkrz|}tj � tj � |�d �}|d tj tjfkr�|dd� }q�|r�|d 7 }| ||�}|jd @ d > |_|r�d|_| jd O _n|j|_|S ) a_ Construct an appropriate ZipInfo for a file on the filesystem. filename should be the path to a file or directory on the filesystem. arcname is the name which it will have within the archive (by default, this will be the same as filename, but without a drive letter and with leading path separators removed). r r" ru rt �; )r� r � � �; r� Nr rv r r) )� isinstancery �PathLike�fspathr� �S_ISDIR�st_mode�time� localtime�st_mtime�path�normpath� splitdriverz �altseprm rq �st_size) �clsrB �arcnamer� �str� �mtimerd �zinfor r r � from_file� s0 zZipInfo.from_filec C s | j d dkS )z2Return True if this archive member is a directory.���rv �rB r� r r r r� % s zZipInfo.is_dir)rs rt )N)N) r r r r � __slots__r� r� r� r� r� � classmethodr� r� r r r r r > s + .2%c C s0 t d�D ]"}| d@ r"| d? dA } q| dL } q| S )Nr r l q[ )�range)�crcr7 r r r �_gen_crc/ s r� c sl d�d�d�t d kr&ttttd���a t ��fdd�� � ���fdd��| D ] }�|� qL��fd d �}|S ) NixV4i�gE#i�xV4� c s |d? � || A d@ A S )z(Compute the CRC32 primitive on one byte.r � r )Zchr� )�crctabler r �crc32I s z _ZipDecrypter.<locals>.crc32c s< � | �����d@ d@ ��d d d@ �� �d? ���d S )Nr� r� i�r r� r )�c)r� �key0�key1�key2r r � update_keysM s z"_ZipDecrypter.<locals>.update_keysc sN t � }|j}| D ]4}� dB }|||dA d? d@ N }�|� ||� qt|�S )zDecrypt a bytes object.r r r r� )� bytearrayr1 �bytes)rV rC r1 r� �k)r� r� r r � decrypterW s z _ZipDecrypter.<locals>.decrypter)� _crctabler^ �mapr� r� )�pwd�pr� r )r� r� r� r� r� r� r � _ZipDecrypter? s r� c @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S ) �LZMACompressorc C s d | _ d S �N)�_compr� r r r r� g s zLZMACompressor.__init__c C sF t �dt ji�}t jt jt �t j|�gd�| _t�dddt |��| S )N�id��filtersz<BBHr$ r ) �lzmaZ_encode_filter_properties� FILTER_LZMA1r� � FORMAT_RAW�_decode_filter_propertiesr� rF r� r0 )r� Zpropsr r r �_initj s � zLZMACompressor._initc C s* | j d kr | �� | j �|� S | j �|�S r� )r� r� �compress)r� rV r r r r� q s zLZMACompressor.compressc C s& | j d kr | �� | j �� S | j �� S r� )r� r� �flushr� r r r r� v s zLZMACompressor.flushN)r r r r� r� r� r� r r r r r� e s r� c @ s e Zd Zdd� Zdd� ZdS )�LZMADecompressorc C s d | _ d| _d| _d S )Nr- F)�_decomp� _unconsumed�eofr� r r r r� ~ s zLZMADecompressor.__init__c C s� | j d kr�| j|7 _t| j�dkr*dS t�d| jdd� �\}t| j�d| krXdS tjtjt�tj | jdd| � �gd�| _ | jd| d � }| `| j � |�}| j j | _ |S )Nr r- z<Hr r� ) r� r� r0 rF r/ r� r� r� r� r� � decompressr� )r� rV ZpsizerC r r r r� � s" �� zLZMADecompressor.decompressN)r r r r� r� r r r r r� | s r� ZstoreZshrink�reduceZimplode�tokenizeZdeflateZ deflate64Zbzip2r� ZterseZlz77ZwavpackZppmd)r r r r r r! r" r# r r$ r% r r r+ � �a �b c C sX | t kr nJ| tkr tsTtd��n4| tkr6tsTtd��n | tkrLtsTtd��ntd��d S )Nz.Compression requires the (missing) zlib modulez-Compression requires the (missing) bz2 modulez.Compression requires the (missing) lzma modulez(That compression method is not supported) r r �zlib� RuntimeErrorr �bz2r r� �NotImplementedError)� compressionr r r �_check_compression� s$ ���r� c C sj | t kr2|d k r t�|tjd�S t�tjtjd�S | tkrT|d k rLt�|�S t�� S | tkrbt � S d S d S )N��) r r� Z compressobjZDEFLATEDZZ_DEFAULT_COMPRESSIONr r� Z BZ2Compressorr r� )re � compresslevelr r r �_get_compressor� s r� c C sv t | � | tkrd S | tkr&t�d�S | tkr6t�� S | tkrDt � S t � | �}|rdt d| |f ��nt d| f ��d S )Nr� zcompression type %d (%s)zcompression type %d) r� r r r� Z decompressobjr r� ZBZ2Decompressorr r� r� r� r� )re Zdescrr r r �_get_decompressor� s r� c @ s0 e Zd Zdd� Zd dd�Zd dd�Zd d � Zd S )� _SharedFilec C s2 || _ || _|| _|| _|| _|j| _|j| _d S r� )�_file�_pos�_close�_lock�_writing�seekablerZ )r� �file�pos�close�lockZwritingr r r r� � s z_SharedFile.__init__r c C sN | j �> | �� rtd��| j�||� | j�� | _| jW 5 Q R � S Q R X d S )Nz}Can't reposition in the ZIP file while there is an open writing handle on it. Close the writing handle before trying to read.)r r r| r rD rZ r )r� rT �whencer r r rD � s z_SharedFile.seekr� c C sX | j �H | �� rtd��| j�| j� | j�|�}| j�� | _|W 5 Q R � S Q R X d S )N�yCan't read from the ZIP file while there is an open writing handle on it. Close the writing handle before trying to read.)r r r| r rD r r> rZ �r� �nrV r r r r> � s z_SharedFile.readc C s$ | j d k r | j }d | _ | �|� d S r� )r r )r� �fileobjr r r r s z_SharedFile.closeN)r )r� )r r r r� rD r> r r r r r r � s r c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd S ) � _Tellablec C s || _ d| _d S �Nr )r< rT �r� r< r r r r� s z_Tellable.__init__c C s | j �|�}| j|7 _|S r� )r< �writerT )r� rV r r r r r s z_Tellable.writec C s | j S r� )rT r� r r r rZ s z_Tellable.tellc C s | j �� d S r� )r< r� r� r r r r� s z_Tellable.flushc C s | j �� d S r� )r< r r� r r r r s z_Tellable.closeN)r r r r� r rZ r� r r r r r r s r c s� e Zd ZdZdZdZdZd(dd�Zd d � Zd d � Z d)dd�Z d*dd�Z dd� Z d+dd�Z dd� Zdd� Zdd � Zd d � Z� fd d �Zd!d"� Zd,d$d%�Zd&d'� Z� ZS )-� ZipExtFilezZFile-like object for reading an archive member. Is returned by ZipFile.open(). i @i i NFc C s( || _ || _|| _|j| _|j| _|j| _t | j�| _ d| _ d| _ d| _ d | _|| _|j| _t|d�rz|j| _td�| _nd | _d| _z4|�� r�|�� | _|j| _|j| _ | j| _ d| _W n t k r� Y nX d | _ |�r$|j d@ r�|j!d? d@ }n|jd? d@ }| �"� }||k�r$t#d |j$ ��d S ) NFr- r ro Tr r� r� zBad password for file %r)%�_fileobj�_pwd�_close_fileobjre �_compress_typerp �_compress_leftrq �_leftr� � _decompressor�_eof� _readbuffer�_offset�newlines�moderB �namer@ ro � _expected_crcr� � _running_crc� _seekabler rZ �_orig_compress_start�_orig_compress_size�_orig_file_size�_orig_start_crc�AttributeError� _decrypterrj rr �_init_decrypterr� rc )r� r r �zipinfor� Z close_fileobjZ check_byte�hr r r r� ) sF zZipExtFile.__init__c C s4 t | j�| _| j�d�}| jd8 _| �|�d S )Nr r& )r� r r* r r> r )r� r� r r r r+ \ s zZipExtFile._init_decrypterc C sv d| j j| j jf g}| jsX|�d| j| jf � | jtkrb|�dt � | j| j� � n |�d� |�d� d� |�S )N�<%s.%sz name=%r mode=%rr� � [closed]r� r� ) r� r r �closedr1 r! r r r r� r� r2 �r� rC r r r r� g s � �� zZipExtFile.__repr__r� c C sL |dk r>| j �d| j�d }|dkr>| j | j|� }|| _|S tj�| |�S )zrRead and return a line from the stream. If limit is specified, at most limit bytes will be read. r � r )r rw r �io�BufferedIOBase�readline)r� �limitr6 �liner r r r5 u s zZipExtFile.readliner c C sr |t | j�| j kr\| �|�}t |�| jkrJ|| j| jd� | _d| _n| jt |�8 _| j| j| jd � S )z6Returns buffered bytes without advancing the position.Nr i )r0 r r r> )r� r �chunkr r r �peek� s zZipExtFile.peekc C s dS �NTr r� r r r �readable� s zZipExtFile.readablec C s |dks|dk rH| j | jd� }d| _ d| _| jsD|| �| j�7 }q,|S || j }|t| j �k rz| j | j|� }|| _|S |t| j � }| j | jd� }d| _ d| _|dkr�| js�| �|�}|t|�k r�|| _ || _||d|� 7 }q�||7 }|t|�8 }q�|S )z�Read and return up to n bytes. If the argument is omitted, None, or negative, data is read and returned until EOF is reached. Nr r- �r r r �_read1�MAX_Nr0 )r� r �buf�endrV r r r r> � s4 zZipExtFile.readc C s@ | j d krd S t|| j�| _| jr<| j| j kr<td| j ��d S )NzBad CRC-32 for file %r)r" r� r# r r r! )r� �newdatar r r � _update_crc� s zZipExtFile._update_crcc C s |dks|dk rR| j | jd� }d| _ d| _| jsN| �| j�}|r,||7 }qNq,|S || j }|t| j �k r�| j | j|� }|| _|S |t| j � }| j | jd� }d| _ d| _|dk�r| j�s| �|�}|t|�k r�|| _ || _||d|� 7 }�q|r�||7 }�qq�|S )z7Read up to n bytes with at most one read() system call.Nr r- r< )r� r r? rV r@ r r r �read1� s> zZipExtFile.read1c C s" | j s|dkrdS | jtkrH| jj}|t|�krR|| �|t|� �7 }n | �|�}| jtkrj| jdk| _ nx| jtkr�t || j �}| j� ||�}| jj p�| jdko�| jj | _ | j r�|| j� � 7 }n | j� |�}| jj p�| jdk| _ |d | j� }| jt|�8 _| jdk�rd| _ | �|� |S )Nr r- T)r r r r Zunconsumed_tailr0 �_read2r r r_ � MIN_READ_SIZEr� r� r� r rB r r r r r= � s4 � zZipExtFile._read1c C sd | j dkrdS t|| j�}t|| j �}| j�|�}| j t|�8 _ |sLt�| jd k r`| �|�}|S )Nr r- ) r r_ rE �minr r> r0 �EOFErrorr* r r r r rD s zZipExtFile._read2c s& z| jr| j�� W 5 t � �� X d S r� )�superr r r r� �r� r r r s zZipExtFile.closec C s | j S r� )r$ r� r r r r s zZipExtFile.seekabler c C s> | j st�d��| �� }|dkr&|}n.|dkr8|| }n |dkrL| j| }ntd��|| jkrd| j}|dk rpd}|| }|| j }|dkr�|t| j�k r�|| _d}nf|dk �r | j � | j � | j | _ | j| _| j| _d| _d| _t| j�| _d| _|}| jd k �r | �� |dk�r6t| j|�}| �|� ||8 }�q | �� S )N�!underlying stream is not seekabler r r zCwhence must be os.SEEK_SET (0), os.SEEK_CUR (1), or os.SEEK_END (2)r- F)r$ r3 �UnsupportedOperationrZ r' r| r r0 r r rD r% r( r# r& r r r� r r r r* r+ rF � MAX_SEEK_READr> )r� rT r Zcurr_posZnew_posZ read_offsetZ buff_offsetZread_lenr r r rD # sH zZipExtFile.seekc C s0 | j st�d��| j| j t| j� | j }|S )NrJ )r$ r3 rK r' r r0 r r )r� Zfileposr r r rZ S s zZipExtFile.tell)NF)r� )r )r� )r )r r r r r> rE rL r� r+ r� r5 r9 r; r> rB rC r= rD r r rD rZ � __classcell__r r rI r r s* � 3 ! %$ 0r c s@ e Zd Zdd� Zedd� �Zdd� Zdd� Z� fd d �Z� Z S ) � _ZipWriteFilec C s8 || _ || _|| _t|j|j�| _d| _d| _d| _ d S r ) �_zinfo�_zip64�_zipfiler� re rf � _compressor� _file_size�_compress_size�_crc)r� �zfr� r� r r r r� [ s �z_ZipWriteFile.__init__c C s | j jS r� )rQ r< r� r r r r e s z_ZipWriteFile._fileobjc C s dS r: r r� r r r �writablei s z_ZipWriteFile.writablec C sf | j rtd��t|�}| j|7 _t|| j�| _| jrV| j�|�}| jt|�7 _| j � |� |S )Nz I/O operation on closed file.) r0 r| r0 rS r� rU rR r� rT r r )r� rV �nbytesr r r r l s z_ZipWriteFile.writec sb | j r d S �zFt� �� | jrR| j�� }| jt|�7 _| j � |� | j| j _ n | j | j _ | j| j _| j | j _| j jd@ r�| jr�dnd}| j � t�|t| j j| j j | j j�� | j �� | j_nn| js�| j tkr�td��| jtkr�td��| j �� | j_| j �| j j� | j � | j � | j�� | j �| jj� | jj � | j � | j | jj | j j < W 5 d| j_X d S )NFr z<LLQQz<LLLLz+File size unexpectedly exceeded ZIP64 limitz1Compressed size unexpectedly exceeded ZIP64 limit)!r0 rQ r rH r rR r� rT r0 r r rO rp rS rU ro rq rj rP rF r� � _DD_SIGNATURErZ � start_dirr� r� rD rn r� �filelistr1 � NameToInforB )r� r? r� rI r r r x sF � � �z_ZipWriteFile.close) r r r r� �propertyr rW r r rM r r rI r rN Z s rN c @ s$ e Zd ZdZdZdZdeddfdd�dd�Zdd � Zd d � Z d d � Z dd� Z dd� Z dd� Z d=dd�Zdd� Zdd� Zdd� Zed d � �Zejd d � �Zd>d d �Zd?d!d"�d#d$�Zd@d%d&�ZdAd'd(�ZdBd)d*�Zed+d,� �Zd-d.� Z d/d0� Z dCd1d2�Z dDd3d4�Z d5d6� Z d7d8� Z!d9d:� Z"d;d<� Z#dS )Er ai Class with methods to open, read, write, close, list zip files. z = ZipFile(file, mode="r", compression=ZIP_STORED, allowZip64=True, compresslevel=None) file: Either the path to the file, or a file-like object. If it is a path, the file will be opened and closed by ZipFile. mode: The mode can be either read 'r', write 'w', exclusive create 'x', or append 'a'. compression: ZIP_STORED (no compression), ZIP_DEFLATED (requires zlib), ZIP_BZIP2 (requires bz2) or ZIP_LZMA (requires lzma). allowZip64: if True ZipFile will create files with ZIP64 extensions when needed, otherwise it will raise an exception when this would be necessary. compresslevel: None (default for the given compression type) or an integer specifying the level to pass to the compressor. When using ZIP_STORED or ZIP_LZMA this keyword has no effect. When using ZIP_DEFLATED integers 0 through 9 are accepted. When using ZIP_BZIP2 integers 1 through 9 are accepted. N�rTr� c C sP |dkrt d��t|� || _d| _d| _i | _g | _|| _|| _|| _ d| _ d| _ || _ t |tj�rpt�|�}t |t�r�d| _|| _ddd d dd d d �}|| }zt�||�| _W q� tk r� ||kr�|| }Y q�� Y q�X q�q�nd| _|| _t|dd�| _d| _t�� | _ d| _ d| _ �z|dk�r4| � � n�|dk�r�d| _z| j� � | _!W n2 t"tfk �r� t#| j�| _d| _!d| _ Y n6X z| j�$| j!� W n t"tfk �r� d| _ Y nX nf|dk�r z| � � | j�$| j!� W n6 t%k �r | j�$dd� d| _| j� � | _!Y nX nt d��W n$ | j} d| _| �&| � � Y nX dS )z]Open the ZIP file with mode read 'r', write 'w', exclusive create 'x', or append 'a'.)r^ �w�x�az+ZipFile requires mode 'r', 'w', 'x', or 'a'Fr Nr- r? �w+b�x+b�r+b�wbZxb)r^ r_ r` ra rd rb rc r r! Tr^ )r_ r` ra r z"Mode must be 'r', 'w', 'x', or 'a')'r| r� � _allowZip64� _didModify�debugr\ r[ r� r� r r� �_comment�_strict_timestampsr� ry r� r� �str� _filePassedrB r3 rA r< r: �getattr� _fileRefCnt� threading�RLockr r$ r �_RealGetContentsrZ rZ r) r rD r �_fpclose) r� r r r� � allowZip64r� r� ZmodeDictr� r< r r r r� � s� � zZipFile.__init__c C s | S r� r r� r r r � __enter__ s zZipFile.__enter__c C s | � � d S r� �r )r� �type�value� tracebackr r r �__exit__ s zZipFile.__exit__c C s� d| j j| j jf g}| jd k rd| jr8|�d| j � n| jd k rR|�d| j � |�d| j � n |�d� |�d� d�|�S )Nr. z file=%rz filename=%rz mode=%rr/ r� r� ) r� r r r< rl r1 rB r r2 r1 r r r r� " s � zZipFile.__repr__c C s� | j }z t|�}W n tk r. td��Y nX |s<td��| jdkrNt|� |t }|t }|t | _ |t | | }|t t kr�|t t 8 }| jdkr�|| }td|||� || | _|�| jd� |�|�}t�|�}d}||k �r�|�t�} t| �tk�r td��t�t| �} | t tk�r,td��| jdk�r@t| � |�| t �} | d } | d @ �rl| � d �} n | � d �} t | �} |�| t �| _ |�| t �| _!| t" | _#| dd � \ | _$| _%| _&| _'| _(| _)} }| _*| _+| _,| j&t-k�r�t.d | j&d ��| dd� \| _/| _0| _1| | _2|d? d |d? d@ |d@ | d? | d? d@ | d@ d f| _3| �4� | j#| | _#| j5�6| � | | j7| j8< |t | t | t | t }| jdkr�td|� q�dS )z/Read in the table of contents for the ZIP file.zFile is not a zip filer r zgiven, inferred, offsetr zTruncated central directoryz&Bad magic number for central directoryr! r� r� �cp437r zzip file version %.1fr% r( r+ r$ ru r� r& r �totalN)9r< r9 r: r rh �printrQ rR � _ECD_COMMENTri � _ECD_LOCATIONrL rK rI rE rZ rD r> r3 �BytesIO�sizeCentralDirr0 rF r/ �structCentralDir� _CD_SIGNATURE�stringCentralDir�_CD_FILENAME_LENGTH�decoder �_CD_EXTRA_FIELD_LENGTHr3 �_CD_COMMENT_LENGTHrb �_CD_LOCAL_HEADER_OFFSETrn rW rg rh ri rj re ro rp rq �MAX_EXTRACT_VERSIONr� rk rl rm rr rd r� r[ r1 r\ rB )r� r< rU Zsize_cdZ offset_cd�concatZinferredrV r{ �centdirrB �flagsr` �t�dr r r rq 0 s� � � � �� zZipFile._RealGetContentsc C s dd� | j D �S )z+Return a list of file names in the archive.c S s g | ] }|j �qS r r� )�.0rV r r r � <listcomp>� s z$ZipFile.namelist.<locals>.<listcomp>�r[ r� r r r �namelist~ s zZipFile.namelistc C s | j S )zJReturn a list of class ZipInfo instances for files in the archive.r� r� r r r �infolist� s zZipFile.infolistc C sL t dd |d� | jD ]0}d|jdd� }t d|j||jf |d� qdS )z+Print a table of contents for the zip file.z%-46s %19s %12s)z File Namez Modified ZSize�r z%d-%02d-%02d %02d:%02d:%02dNr" z %-46s %s %12d)r| r[ rd rB rq )r� r r� �dater r r �printdir� s � �zZipFile.printdirc C s^ d}| j D ]N}z*| �|jd��}|�|�r,q W 5 Q R X W q tk rV |j Y S X q dS )z%Read all the files and check the CRC.i r^ N)r[ rA rB r> r )r� Z chunk_sizer� �fr r r �testzip� s zZipFile.testzipc C s$ | j �|�}|dkr td| ��|S )z,Return the instance of ZipInfo given 'name'.Nz(There is no item named %r in the archive)r\ r� �KeyError)r� r! �infor r r �getinfo� s �zZipFile.getinfoc C s6 |r t |t�s tdt|�j ��|r,|| _nd| _dS )z)Set default password for encrypted files.�pwd: expected bytes, got %sN)r� r� � TypeErrorrv r r� )r� r� r r r � setpassword� s zZipFile.setpasswordc C s | j S )z.The comment text associated with the ZIP file.)ri r� r r r rb � s zZipFile.commentc C s^ t |t�s tdt|�j ��t|�tkrNdd l}|jdt dd� |d t� }|| _ d| _ d S )Nz comment: expected bytes, got %sr z3Archive comment is too long; truncating to %d bytesr �� stacklevelT) r� r� r� rv r r0 �ZIP_MAX_COMMENT�warnings�warnri rg )r� rb r� r r r rb � s �� c C s. | � |d|��}|�� W 5 Q R � S Q R X dS )zReturn file bytes for name.r^ N�rA r> )r� r! r� r< r r r r> � s z ZipFile.readF�� force_zip64c s |dkrt d��|r0t|t�s0tdt|�j ��|rD|dkrDt d��� jsRt d��t|t�rb|}n,|dkr�t|�}� j|_ � j |_ n � � |�}|dkr�� j ||d�S � jr�t d��� jd 7 _t� j|j� j� j� fd d ��}�z|�t�}t|�tk�rtd ��t�t|�}|t t k�r&td ��|�|t �}|t �rL|�|t � |j d@ �r`t d��|j d@ �rtt d��|t! d@ �r�|�"d�} n |�"d�} | |j#k�r�td|j#|f ��|j d @ } | �r�|�s҈ j$}|�s�t%d| ��nd}t&||||d�W S |�'� � Y nX dS )au Return file-like object for 'name'. name is a string for the file name within the ZIP file, or a ZipInfo object. mode should be 'r' to read a file already in the ZIP file, or 'w' to write to a file newly added to the archive. pwd is the password to decrypt files (only used for reading). When writing, if the file size is not known in advance but may exceed 2 GiB, pass force_zip64 to use the ZIP64 format, which can handle large files. If the size is known in advance, it is best to pass a ZipInfo instance for name, with zinfo.file_size set. > r^ r_ z open() requires mode "r" or "w"r� r_ z'pwd is only supported for reading filesz2Attempt to use ZIP archive that was already closedr� r r c s � j S r� )r r r� r r �<lambda>� r- z ZipFile.open.<locals>.<lambda>zTruncated file headerz Bad magic number for file header� z$compressed patched data (flag bit 5)�@ z strong encryption (flag bit 6)r� r� rz z/File name in directory %r and header %r differ.z6File %r is encrypted, password required for extractionNT)(r| r� r� r� rv r r< r r� re r� rf r� �_open_to_writer rn r rn rr r r> �sizeFileHeaderr0 r rF r/ r� � _FH_SIGNATUREr� �_FH_FILENAME_LENGTH�_FH_EXTRA_FIELD_LENGTHrj r� � _FH_GENERAL_PURPOSE_FLAG_BITSr� rc r� r� r r ) r� r! r r� r� r� Zzef_fileZfheader�fnameZ fname_strZ is_encryptedr r� r rA � s~ � � �� �z ZipFile.openc C s� |r| j std��| jr td��t|d�s0d|_d|_d|_d|_|jt krZ| jdO _| j sn| jdO _|j szd|_ | j o�|p�|jd t k}| j r�| j �| j� | j �� |_| �|� d | _| j �|�|�� d | _t| ||�S ) NzHforce_zip64 is True, but allowZip64 was False when opening the ZIP file.zzCan't write to the ZIP file while there is another write handle open on it. Close the first handle before opening another.rq r r r � �g�������?T)rf r| r r@ rq rp ro rj re r r$ rm r� r< rD rZ rZ rn � _writecheckrg r r� rN )r� r� r� r� r r r r� ( s8 � � zZipFile._open_to_writec C s* |dkrt �� }n t �|�}| �|||�S )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 ZipInfo object. You can specify a different directory using `path'. N)ry �getcwdr� �_extract_member)r� �memberr� r� r r r �extractS s zZipFile.extractc C sH |dkr| � � }|dkr"t�� }n t�|�}|D ]}| �|||� q0dS )z�Extract all members from the archive to the current working directory. `path' specifies a different directory to extract to. `members' is optional and must be a subset of the list returned by namelist(). N)r� ry r� r� r� )r� r� �membersr� r, r r r � extractall` s zZipFile.extractallc C s^ | j }|s(d}t�|dt|� �}|| _ |�|�}dd� |�|�D �}|�dd� |D ��}|S )z;Replace bad characters and remove trailing dots from parts.z:<>|"?*�_c s s | ]}|� d �V qdS )�.N)�rstrip�r� r` r r r � <genexpr>{ s z1ZipFile._sanitize_windows_name.<locals>.<genexpr>c s s | ]}|r|V qd S r� r r� r r r r� } s )�!_windows_illegal_name_trans_tablerk � maketransr0 � translate�splitr2 )r� r� �pathsep�tableZillegalr r r �_sanitize_windows_nameq s z ZipFile._sanitize_windows_namec sL t |t�s| �|�}|j�dtjj�}tjjrB|�tjjtjj�}tj� |�d }dtjj tjj f� tjj� � fdd�|� tjj�D ��}tjjdkr�| �|tjj�}tj� ||�}tj�|�}tj�|�}|r�tj�|�s�t�|� |�� �r tj�|��st�|� |S | j||d��(}t|d��}t�||� W 5 Q R X W 5 Q R X |S ) zbExtract the ZipInfo object 'member' to a physical file on the path targetpath. rv r r� c 3 s | ]}|� kr|V qd S r� r r� �Zinvalid_path_partsr r r� � s �z*ZipFile._extract_member.<locals>.<genexpr>�\)r� re )r� r r� rB r{ ry r� rz r� r� �curdir�pardirr2 r� r� r� �dirname�exists�makedirsr� r� �mkdirrA �shutil� copyfileobj)r� r� Z targetpathr� r� Z upperdirs�source�targetr r� r r� � s2 & � zZipFile._extract_memberc C s� |j | jkr(ddl}|jd|j dd� | jdkr:td��| jsHtd��t|j� | j s�d}t | j �t krpd }n |j tkr�d }n|jtkr�d }|r�t|d ��dS ) z6Check for errors before writing a file to the archive.r NzDuplicate name: %rr r� �r_ r` ra z&write() requires mode 'w', 'x', or 'a'z4Attempt to write ZIP archive that was already closed� Files countZFilesizez Zipfile size� would require ZIP64 extensions)rB r\ r� r� r r| r< r� re rf r0 r[ �ZIP_FILECOUNT_LIMITrq r� rn r )r� r� r� �requires_zip64r r r r� � s, � �zZipFile._writecheckc C sP | j std��| jr td��tj||| jd�}|�� rDd|_d|_n0|dk rT||_ n| j |_ |dk rl||_ n| j |_ |�� �r| j �� | jr�| j �| j� | j �� |_|j tkr�| jdO _| �|� d| _| j�|� || j|j< | j �|� d�� | j �� | _W 5 Q R X n<t |d ��,}| � |d ��}t � ||d � W 5 Q R X W 5 Q R X dS ) zLPut the bytes from filename into the archive under the name arcname.�7Attempt to write to ZIP archive that was already closedz>Can't write to ZIP archive while an open writing handle existsr� r Nr TFr? r_ i ) r< r| r r r� rj r� rp ro re r� rf r� r r$ rD rZ rZ rn r rj r� rg r[ r1 r\ rB r r� rA r� r� )r� rB r� re r� r� �src�destr r r r � sF ��� z ZipFile.writec C s� t |t�r|�d�}t |t�sxt|t�t�� �dd� d�}| j|_| j|_ |j d dkrpd|_ | j dO _ q|d |_ n|}| j s�t d ��| jr�t d ��|dk r�||_|dk r�||_ t|�|_| j�* | j|d d ��}|�|� W 5 Q R X W 5 Q R X dS )a Write a file into the archive. The contents is 'data', which may be either a 'str' or a 'bytes' instance; if it is a 'str', it is encoded as UTF-8 first. 'zinfo_or_arcname' is either a ZipInfo instance or the name of the file in the archive.r� Nr" )rB rd r� rv i �Ar) r� r� z?Can't write to ZIP archive while an open writing handle exists.r_ )r )r� rk r� r r� r� r� re r� rf rB rm r< r| r r0 rq r rA r )r� Zzinfo_or_arcnamerV re r� r� r� r r r �writestr� s: ��� zZipFile.writestrc C s | � � dS )z2Call the "close()" method in case the user forgot.Nru r� r r r �__del__ s zZipFile.__del__c C s| | j dkrdS | jr td��zB| jdkr\| jr\| j�" | jrJ| j �| j � | � � W 5 Q R X W 5 | j }d| _ | �|� X dS )zOClose the file, and for mode 'w', 'x' and 'a' write the ending records.NzvCan't close the ZIP file while there is an open writing handle on it. Close the writing handle before closing the zip.r� ) r< r r| rr r rg r r$ rD rZ �_write_end_recordr r r r r s z ZipFile.closec C s� | j D �]D}|j}|d d d> |d d> B |d B }|d d> |d d> B |d d B }g }|jtksr|jtkr�|�|j� |�|j� d }d }n |j}|j}|jtkr�|�|j� d }n|j}|j} d} |�r t| d �} t j d d t |� ddt |� f|�� | } t } |j tk�r$tt| �} n|j tk�r:tt| �} t| |j�} t| |j�} zZ|�� \} }t � tt| |j| |j||j |||j||t | �t | �t |j�d|j |j |�}W nl t k �r t tt| |j| |j|j |j |||j||t |j!�t | �t |j�d|j |j |ft"j#d� � Y nX | j$�%|� | j$�%| � | j$�%| � | j$�%|j� q| j$�&� }t | j �}|| j' }| j'}d }|t(k�r�d}n |tk�r�d}n|tk�r�d}|�r$| j)�s�t*|d ��t � t+t,ddddd||||� }| j$�%|� t � t-t.d|d�}| j$�%|� t/|d�}t/|d �}t/|d �}t � t0t1dd||||t | j2�� }| j$�%|� | j$�%| j2� | j3dk�rt| j$�4� | j$�5� d S )Nr ru r$ r r! r r r& r r� )r r, �Qr r� r� zCentral directory offsetzCentral directory sizer� �, r r ra )6r[ rd rq r� rp r1 rn r3 r8 rF r� r0 r� re r r_ r� r r� rh rW r� r� r� rg ri ro rb rl rm �DeprecationWarningr| rj rB r} �stderrr< r rZ rZ r� rf r rJ rK rG rH rF r] r\ ri r �truncater� )r� r� r� r� r� r3 rq rp rn Z extra_datar� rh rW rB rj r� Zpos2Z centDirCountZ centDirSizeZ centDirOffsetr� Z zip64endrecZ zip64locrecrU r r r r� 5 s $$ � ��� � �� � � � � zZipFile._write_end_recordc C s4 | j dkst�| j d8 _ | j s0| js0|�� d S )Nr r )rn �AssertionErrorrl r r r r r rr � s zZipFile._fpclose)N)N)r^ N)F)NN)NNN)NNN)NN)$r r r r r< r� r r� rt ry r� rq r� r� r� r� r� r� r] rb �setterr> rA r� r� r� r� r� r� r� r r� r� r r� rr r r r r r � sT �� ZN b + * � 2 � )hc @ s4 e Zd ZdZdeddfdd�Zd d d �Zd d � ZdS )r zDClass to create ZIP archives with Python library files and packages.r^ Tr� c C s t j| ||||d� || _d S )N)r r� rs )r r� � _optimize)r� r r r� rs �optimizer r r r� � s �zPyZipFile.__init__r� Nc C s� t �|�}|rD||�sD| jr@t j�|�r,dnd}td||f � dS t j�|�\}}t j�|��rht j�|d�}t j�|��r�|r�d||f }n|}| jr�td|d|� | � |d d � |�\}} | jr�td | � | � || � t t � |��} | � d� | D ]�} t j�|| �} t j�| �\} }t j�| ��rRt j�t j�| d���r�| j| ||d � q�|d kr�|�r~|| ��s~| jr�td| � q�| � | d d � |�\}} | j�r�td | � | � || � q�n�| j�r�td|� t t � |��D ]�} t j�|| �} t j�| �\} }|d k�r�|�r,|| ��s,| j�r�td| � �q�| � | d d � |�\}} | j�rVtd | � | � || � �q�nP|d d� d k�r�td��| � |d d � |�\}} | j�r�td| � | � || � dS )a� Add all files from "pathname" to the ZIP archive. If pathname is a package directory, search the directory and all package subdirectories recursively for all *.py and enter the modules into the archive. If pathname is a plain directory, listdir *.py and enter all modules. Else, pathname must be a Python *.py file and the module will be put into the archive. Added modules are always module.pyc. This method will compile the module.py into module.pyc if necessary. If filterfunc(pathname) is given, it is called with every argument. When it is False, the file or directory is skipped. r� r z%s %r skipped by filterfuncNz __init__.py�%s/%szAdding package in�asr ���ZAdding)� filterfunc�.pyz file %r skipped by filterfunczAdding files from directoryz.Files added with writepy() must end with ".py"z Adding file)ry r� rh r� r� r| r� r2 �isfile� _get_codenamer �sorted�listdir�remove�splitext�writepyr� )r� �pathname�basenamer� Zlabel�dirr! Zinitnamer� r� ZdirlistrB r� �rootZextr r r r� � s� � � � � zPyZipFile.writepyc s d� fdd� }|d }|d }t jj|dd�}t jj|dd�}t jj|d d�}� jdk�r\tj�|�r�t�|�jt�|�jkr�| } } n�tj�|�r�t�|�jt�|�jkr�|} |} n�tj�|�r�t�|�jt�|�jkr�|} |} nvtj�|��rt�|�jt�|�jk�r|} |} nD||��rRt j j d k�r4|} nt j j dk�rH|} n|} |} n| } } n�� jd k�rr|} |} n<|} � jdk�r�|} n&� jd k�r�|} nd � � j�} t | ��tj�| ��r�t�| �jt�|�jk�s�||� jd ��s�| } } tj�| �d } |�rd || f } | | fS )a Return (filename, archivename) for the path. Given a module name path, return the correct file path and archive name, compiling if necessary. For example, given /python/lib/string, return (/python/lib/string.pyc, string). r� c sf dd l }� jrtd| � z|j| d|d� W n4 |jk r` } zt|j� W Y �dS d }~X Y nX dS )Nr Z CompilingT)�doraiser� F)� py_compilerh r| �compile�PyCompileError�msg)r r� r� �errr� r r �_compile s z)PyZipFile._get_codename.<locals>._compiler� z.pycr� )� optimizationr r r z"invalid value for 'optimize': {!r})r� r� )r� )� importlib�util�cache_from_sourcer� ry r� r� r� r� r} r� r� �formatr| r� ) r� r� r� r� Zfile_pyZfile_pycZ pycache_opt0Z pycache_opt1Z pycache_opt2r� r� r� Z archivenamer r� r r� � sj � � �� � zPyZipFile._get_codename)r� N)r r r r r r� r� r� r r r r r � s � Rc C s t �t| �dd�S )a2 Given a path with elements separated by posixpath.sep, generate all parents of that path. >>> list(_parents('b/d')) ['b'] >>> list(_parents('/b/d/')) ['/b'] >>> list(_parents('b/d/f/')) ['b/d', 'b'] >>> list(_parents('b')) [] >>> list(_parents('')) [] r N)� itertools�islice� _ancestry)r� r r r �_parentsR s r c c s4 | � tj�} | r0| tjkr0| V t�| �\} }q dS )aR Given a path with elements separated by posixpath.sep, generate all elements of that path >>> list(_ancestry('b/d')) ['b/d', 'b'] >>> list(_ancestry('/b/d/')) ['/b/d', '/b'] >>> list(_ancestry('b/d/f/')) ['b/d/f', 'b/d', 'b'] >>> list(_ancestry('b')) ['b'] >>> list(_ancestry('')) [] N)r� � posixpathrz r� )r� �tailr r r r e s r c C s t �t|�j| �S )zZ Return items in minuend not in subtrahend, retaining order with O(1) lookup. )r � filterfalse�set� __contains__)ZminuendZ subtrahendr r r � _difference s r c sH e Zd ZdZedd� �Z� fdd�Zdd� Zdd � Ze d d � �Z � Z S ) � CompleteDirszk A ZipFile subclass that ensures that implied directories are always included in the namelist. c C s. t j�tt| ��}dd� |D �}tt|| ��S )Nc s s | ]}|t j V qd S r� )r rz )r� r� r r r r� � s z-CompleteDirs._implied_dirs.<locals>.<genexpr>)r �chain� from_iterabler� r �_deduper )�names�parentsZas_dirsr r r � _implied_dirs� s zCompleteDirs._implied_dirsc s t t| ��� }|t| �|�� S r� )rH r r� r^ r )r� r rI r r r� � s zCompleteDirs.namelistc C s t | �� �S r� )r r� r� r r r � _name_set� s zCompleteDirs._name_setc C s, | � � }|d }||ko ||k}|r(|S |S )zx If the name represents a directory, return that name as a directory (with the trailing slash). rv )r )r� r! r r� Z dir_matchr r r � resolve_dir� s zCompleteDirs.resolve_dirc C sN t |t�r|S t |t�s | |�S d|jkr.t} | �| �}t|��t|�� |S )zl Given a source (filename or zipfile), return an appropriate CompleteDirs subclass. r^ )r� r r r �__new__�vars�update)r� r� �resr r r �make� s zCompleteDirs.make) r r r r � staticmethodr r� r r r� r rM r r rI r r � s r c s, e Zd ZdZ� fdd�Z� fdd�Z� ZS )� FastLookupzV ZipFile subclass to ensure implicit dirs exist and are resolved rapidly. c s: t �t�� | jW 5 Q R � S Q R X tt| ��� | _| jS r� )� contextlib�suppressr) Z_FastLookup__namesrH r r� r� rI r r r� � s zFastLookup.namelistc s: t �t�� | jW 5 Q R � S Q R X tt| ��� | _| jS r� )r r r) Z_FastLookup__lookuprH r r r� rI r r r � s zFastLookup._name_set)r r r r r� r rM r r rI r r � s r c @ s� e Zd ZdZdZd#dd�Zedd� �Zedd � �Zd d � Z d d � Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zdd� Zd d � Zd d � ZeZed d!� �Zd"S )$r u� A pathlib-compatible interface for zip files. Consider a zip file with this structure:: . ├── a.txt └── b ├── c.txt └── d └── e.txt >>> data = io.BytesIO() >>> zf = ZipFile(data, 'w') >>> zf.writestr('a.txt', 'content of a') >>> zf.writestr('b/c.txt', 'content of c') >>> zf.writestr('b/d/e.txt', 'content of e') >>> zf.filename = 'abcde.zip' Path accepts the zipfile object itself or a filename >>> root = Path(zf) From there, several path operations are available. Directory iteration (including the zip file itself): >>> a, b = root.iterdir() >>> a Path('abcde.zip', 'a.txt') >>> b Path('abcde.zip', 'b/') name property: >>> b.name 'b' join with divide operator: >>> c = b / 'c.txt' >>> c Path('abcde.zip', 'b/c.txt') >>> c.name 'c.txt' Read text: >>> c.read_text() 'content of c' existence: >>> c.exists() True >>> (b / 'missing.txt').exists() False Coercion to string: >>> str(c) 'abcde.zip/b/c.txt' z>{self.__class__.__name__}({self.root.filename!r}, {self.at!r})r� c C s t �|�| _|| _d S r� )r r r� �at)r� r� r r r r r� s z Path.__init__c C s t �| jj| j�S r� )� functools�partialr� rA r r� r r r rA s z Path.openc C s t �| j�d��S �Nrv )r r� r r� r� r r r r! s z Path.namec O s6 | � � �$}tj|f|�|��� W 5 Q R � S Q R X d S r� )rA r3 � TextIOWrapperr> )r� �args�kwargs�strmr r r � read_text s zPath.read_textc C s( | � � �}|�� W 5 Q R � S Q R X d S r� r� )r� r$ r r r � read_bytes s zPath.read_bytesc C s t �|j�d��| j�d�kS r )r r� r r� )r� r� r r r � _is_child" s zPath._is_childc C s t | j|�S r� )r r� )r� r r r r �_next% s z Path._nextc C s | j p| j �d�S r )r �endswithr� r r r r� ( s z Path.is_dirc C s | � � S r� )r� r� r r r �is_file+ s z Path.is_filec C s | j | j�� kS r� )r r� r r� r r r r� . s z Path.existsc C s. | � � std��t| j| j�� �}t| j|�S )NzCan't listdir a file)r� r| r� r( r� r� �filterr' )r� Zsubsr r r �iterdir1 s z Path.iterdirc C s t �| jj| j�S r� )r r2 r� rB r r� r r r �__str__7 s z Path.__str__c C s | j j| d�S )Nr� )� _Path__reprr r� r r r r� : s z Path.__repr__c C s t �| j|�}| �| j�|��S r� )r r2 r r( r� r )r� �add�nextr r r �joinpath= s z Path.joinpathc C s( t �| j�d��}|r |d7 }| �|�S r )r r� r r� r( )r� Z parent_atr r r �parentC s z Path.parentN)r� )r r r r r. r� r] rA r! r% r& r' r( r� r* r� r, r- r� r1 � __truediv__r2 r r r r r � s* @ c s� dd l }d}|j|d�}|jdd�}|jdddd d � |jd d d ddd� |jdddddd� |jddddd � |�| �} | jd k r�| j}t|d��}|�� }W 5 Q R X |r�td� |�� td� n�| j d k r�| j }t|d��}|� � W 5 Q R X n�| j d k �r,| j \}}t|d��}|� |� W 5 Q R X n�| jd k �r�| j�d�} | j} � fd d �� t| d ��\}| D ]P} tj�| �} | �s�tj�tj�| ��} | d tjtjfk�r�d } � || | � �qfW 5 Q R X d S ) Nr z3A simple command-line interface for zipfile module.)� descriptionT)Zrequiredz-lz--list� <zipfile>zShow listing of a zipfile)�metavar�helpz-ez --extractr )r5 z <output_dir>z Extract zipfile into target dir)�nargsr6 r7 z-cz--create�+)z<name>z<file>zCreate zipfile from sourcesz-tz--testzTest if a zipfile is validr^ z.The following enclosed file is corrupted: {!r}z Done testingc sp t j�|�r | �||t� nPt j�|�rl|r8| �||� tt �|��D ]$}� | t j�||�t j�||�� qFd S r� ) ry r� r� r r r� r� r� r2 )rV r� �zippathZnm��addToZipr r r< s s �zmain.<locals>.addToZipr_ r� )�argparse�ArgumentParserZ add_mutually_exclusive_group� add_argument� parse_argsZtestr r� r| r r^ r� r� r� Zcreate�popry r� r� r� r� r� ) r" r= r4 �parser�groupr� rV Zbadfiler� Zzip_name�filesr� r: r r; r �mainK s\ � � � � rE �__main__)N)N)�r Zbinasciir �importlib.utilr� r3 r ry r r� r� rF r} ro r� r r� r� � ImportErrorr� r� �__all__� Exceptionr r r r r� r� r� r r r r r r� r� r� r� r] r\ r� r[ rL rM rN rO rP rQ rR ra r} r~ r� r� r� r� Z_CD_CREATE_VERSIONZ_CD_CREATE_SYSTEMZ_CD_EXTRACT_VERSIONZ_CD_EXTRACT_SYSTEMZ _CD_FLAG_BITSZ_CD_COMPRESS_TYPEZ_CD_TIMEZ_CD_DATEZ_CD_CRCZ_CD_COMPRESSED_SIZEZ_CD_UNCOMPRESSED_SIZEr� r� r� Z_CD_DISK_NUMBER_STARTZ _CD_INTERNAL_FILE_ATTRIBUTESZ _CD_EXTERNAL_FILE_ATTRIBUTESr� r� r� r� r� Z_FH_EXTRACT_VERSIONZ_FH_EXTRACT_SYSTEMr� Z_FH_COMPRESSION_METHODZ_FH_LAST_MOD_TIMEZ_FH_LAST_MOD_DATEZ_FH_CRCZ_FH_COMPRESSED_SIZEZ_FH_UNCOMPRESSED_SIZEr� r� rG rH rE rJ rK rI Z_CD64_SIGNATUREZ_CD64_DIRECTORY_RECSIZEZ_CD64_CREATE_VERSIONZ_CD64_EXTRACT_VERSIONZ_CD64_DISK_NUMBERZ_CD64_DISK_NUMBER_STARTZ _CD64_NUMBER_ENTRIES_THIS_DISKZ_CD64_NUMBER_ENTRIES_TOTALZ_CD64_DIRECTORY_SIZEZ_CD64_OFFSET_START_CENTDIRrY ZStructr. r8 r= r rX r9 �objectr r� r� r� r� r� r� r� r� r� r r r4 r rN r r r r �dict�fromkeysr r r r r rE r r r r r �<module> sl � += q& � & AN /2 =