U
    M»{j7.  ã                   @   sÖ   d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
mZ ddlmZ dgZdd„ Zd	d
„ ZejZdd„ ZG dd„ dƒZG dd„ deejƒZG dd„ deƒZddd„ZG dd„ dƒZdS )zÒ
A Path-like interface for zipfiles.

This codebase is shared between zipfile.Path in the stdlib
and zipp in PyPI. See
https://github.com/python/importlib_metadata/wiki/Development-Methodology
for more detail.
é    Né   )Útext_encoding)Ú
TranslatorÚPathc                 C   s   t  t| ƒdd¡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)Úpath© r
   úL/var/www/html/bwave/python/venv/lib/python3.8/site-packages/zipp/__init__.pyÚ_parents   s    r   c                 c   s2   |   tj¡} |   tj¡r.| V  t | ¡\} }qdS )aÔ  
    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(''))
    []

    Multiple separators are treated like a single.

    >>> list(_ancestry('//b//d///f//'))
    ['//b//d///f', '//b//d', '//b']
    N)ÚrstripÚ	posixpathÚsepÚsplit)r	   Útailr
   r
   r   r   .   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__)ZminuendZ
subtrahendr
   r
   r   Ú_differenceM   s    r   c                       s4   e Zd ZdZ‡ fdd„Zdd„ Z‡ fdd„Z‡  ZS )ÚInitializedStatez?
    Mix-in to save the initialization state for pickling.
    c                    s   || _ || _tƒ j||Ž d S ©N)Ú_InitializedState__argsÚ_InitializedState__kwargsÚsuperÚ__init__)ÚselfÚargsÚkwargs©Ú	__class__r
   r   r   Z   s    zInitializedState.__init__c                 C   s   | j | jfS r   )r   r   ©r   r
   r
   r   Ú__getstate___   s    zInitializedState.__getstate__c                    s   |\}}t ƒ j||Ž d S r   )r   r   )r   Ústater   r   r   r
   r   Ú__setstate__b   s    zInitializedState.__setstate__)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r"   r$   Ú__classcell__r
   r
   r   r   r   U   s   r   c                       sl   e Zd ZdZedd„ ƒZ‡ fdd„Zdd„ Zdd	„ Z‡ fd
d„Z	e
dd„ ƒZe
ejejdœdd„ƒZ‡  ZS )ÚCompleteDirsa8  
    A ZipFile subclass that ensures that implied directories
    are always included in the namelist.

    >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt']))
    ['foo/', 'foo/bar/']
    >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt', 'foo/bar/']))
    ['foo/']
    c                 C   s.   t j tt| ƒ¡}dd„ |D ƒ}tt|| ƒƒS )Nc                 s   s   | ]}|t j V  qd S r   )r   r   )Ú.0Úpr
   r
   r   Ú	<genexpr>u   s     z-CompleteDirs._implied_dirs.<locals>.<genexpr>)r   ÚchainÚfrom_iterableÚmapr   Ú_deduper   )ÚnamesÚparentsZas_dirsr
   r
   r   Ú_implied_dirsr   s    zCompleteDirs._implied_dirsc                    s   t ƒ  ¡ }|t|  |¡ƒ S r   )r   ÚnamelistÚlistr4   )r   r2   r   r
   r   r5   x   s    
zCompleteDirs.namelistc                 C   s   t |  ¡ ƒS r   )r   r5   r!   r
   r
   r   Ú	_name_set|   s    zCompleteDirs._name_setc                 C   s,   |   ¡ }|d }||ko||k}|r(|S |S )zx
        If the name represents a directory, return that name
        as a directory (with the trailing slash).
        ú/)r7   )r   Únamer2   ÚdirnameZ	dir_matchr
   r
   r   Úresolve_dir   s    zCompleteDirs.resolve_dirc                    sL   zt ƒ  |¡W S  tk
rF   | d¡r4||  ¡ kr6‚ tj|d� Y S X dS )z6
        Supplement getinfo for implied dirs.
        r8   )ÚfilenameN)r   ÚgetinfoÚKeyErrorÚendswithr7   ÚzipfileÚZipInfo)r   r9   r   r
   r   r=   ‰   s    zCompleteDirs.getinfoc                 C   s:   t |tƒr|S t |tjƒs"| |ƒS d|jkr0t} | |_|S )zl
        Given a source (filename or zipfile), return an
        appropriate CompleteDirs subclass.
        Úr)Ú
isinstancer*   r@   ÚZipFileÚmoder    )ÚclsÚsourcer
   r
   r   Úmake”   s    

zCompleteDirs.make)ÚzfÚreturnc                 C   s$   |   | ¡ ¡D ]}| |d¡ q|S )z‰
        Given a writable zip file zf, inject directory entries for
        any directories implied by the presence of children.
        ó    )r4   r5   Úwritestr)rF   rI   r9   r
   r
   r   Úinject§   s    zCompleteDirs.inject)r%   r&   r'   r(   Ústaticmethodr4   r5   r7   r;   r=   ÚclassmethodrH   r@   rD   rM   r)   r
   r
   r   r   r*   g   s   



r*   c                       s,   e Zd ZdZ‡ fdd„Z‡ fdd„Z‡  ZS )Ú
FastLookupzV
    ZipFile subclass to ensure implicit
    dirs exist and are resolved rapidly.
    c              
      s6   t  t¡� | jW  5 Q R £ S Q R X tƒ  ¡ | _| jS r   )Ú
contextlibÚsuppressÚAttributeErrorZ_FastLookup__namesr   r5   r!   r   r
   r   r5   ¸   s    zFastLookup.namelistc              
      s6   t  t¡� | jW  5 Q R £ S Q R X tƒ  ¡ | _| jS r   )rQ   rR   rS   Z_FastLookup__lookupr   r7   r!   r   r
   r   r7   ¾   s    zFastLookup._name_set)r%   r&   r'   r(   r5   r7   r)   r
   r
   r   r   rP   ²   s   rP   c                 O   s$   t jjdk}d| }t| |ƒ||fS )NÚpypyé   )ÚsysÚimplementationr9   r   )Úencodingr   r   Zis_pypyZstack_levelr
   r
   r   Ú_extract_text_encodingÅ   s    rY   c                   @   s  e Zd ZdZdZd=dd„Zdd„ Zdd	„ Zd>ddœdd„Zdd„ Z	e
dd„ ƒZe
dd„ ƒZe
dd„ ƒZe
dd„ ƒZe
dd„ ƒZdd„ Zdd„ Zdd „ Zd!d"„ Zd#d$„ Zd%d&„ Zd'd(„ Zd)d*„ Zd+d,„ Zd-d.„ Zd/d0„ Zd1d2„ Zd3d4„ Zd5d6„ Zd7d8„ Zd9d:„ ZeZ e
d;d<„ ƒZ!dS )?r   u$  
    A :class:`importlib.resources.abc.Traversable` interface for zip files.

    Implements many of the features users enjoy from
    :class:`pathlib.Path`.

    Consider a zip file with this structure::

        .
        â”œâ”€â”€ a.txt
        â””â”€â”€ b
            â”œâ”€â”€ c.txt
            â””â”€â”€ d
                â””â”€â”€ e.txt

    >>> data = io.BytesIO()
    >>> zf = zipfile.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 = 'mem/abcde.zip'

    Path accepts the zipfile object itself or a filename

    >>> path = Path(zf)

    From there, several path operations are available.

    Directory iteration (including the zip file itself):

    >>> a, b = path.iterdir()
    >>> a
    Path('mem/abcde.zip', 'a.txt')
    >>> b
    Path('mem/abcde.zip', 'b/')

    name property:

    >>> b.name
    'b'

    join with divide operator:

    >>> c = b / 'c.txt'
    >>> c
    Path('mem/abcde.zip', 'b/c.txt')
    >>> c.name
    'c.txt'

    Read text:

    >>> c.read_text(encoding='utf-8')
    'content of c'

    existence:

    >>> c.exists()
    True
    >>> (b / 'missing.txt').exists()
    False

    Coercion to string:

    >>> import os
    >>> str(c).replace(os.sep, posixpath.sep)
    'mem/abcde.zip/b/c.txt'

    At the root, ``name``, ``filename``, and ``parent``
    resolve to the zipfile.

    >>> str(path)
    'mem/abcde.zip/'
    >>> path.name
    'abcde.zip'
    >>> path.filename == pathlib.Path('mem/abcde.zip')
    True
    >>> str(path.parent)
    'mem'

    If the zipfile has no filename, such attributes are not
    valid and accessing them will raise an Exception.

    >>> zf.filename = None
    >>> path.name
    Traceback (most recent call last):
    ...
    TypeError: ...

    >>> path.filename
    Traceback (most recent call last):
    ...
    TypeError: ...

    >>> path.parent
    Traceback (most recent call last):
    ...
    TypeError: ...

    # workaround python/cpython#106763
    >>> pass
    z>{self.__class__.__name__}({self.root.filename!r}, {self.at!r})Ú c                 C   s   t  |¡| _|| _dS )aX  
        Construct a Path from a ZipFile or filename.

        Note: When the source is an existing ZipFile object,
        its type (__class__) will be mutated to a
        specialized type. If the caller wishes to retain the
        original type, the caller should either create a
        separate ZipFile object or pass a filename.
        N)rP   rH   ÚrootÚat)r   r[   r\   r
   r
   r   r   5  s    
zPath.__init__c                 C   s(   | j |j k	rtS | j| jf|j|jfkS )zU
        >>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo'
        False
        )r    ÚNotImplementedr[   r\   )r   Úotherr
   r
   r   Ú__eq__B  s    zPath.__eq__c                 C   s   t | j| jfƒS r   )Úhashr[   r\   r!   r
   r
   r   Ú__hash__K  s    zPath.__hash__rB   N©Úpwdc                O   s„   |   ¡ rt| ƒ‚|d }|  ¡ s0|dkr0t| ƒ‚| jj| j||d�}d|kr`|sT|r\tdƒ‚|S t||Ž\}}}t	j
||f|ž|ŽS )zª
        Open this entry as text or binary following the semantics
        of ``pathlib.Path.open()`` by passing arguments through
        to io.TextIOWrapper().
        r   rB   rb   Úbz*encoding args invalid for binary operation)Úis_dirÚIsADirectoryErrorÚexistsÚFileNotFoundErrorr[   Úopenr\   Ú
ValueErrorrY   ÚioÚTextIOWrapper)r   rE   rc   r   r   Zzip_modeÚstreamrX   r
   r
   r   ri   N  s    z	Path.openc                 C   s   t  | jp| jj¡S r   )ÚpathlibÚPurePosixPathr\   r[   r<   r!   r
   r
   r   Ú_baseb  s    z
Path._basec                 C   s
   |   ¡ jS r   )rp   r9   r!   r
   r
   r   r9   e  s    z	Path.namec                 C   s
   |   ¡ jS r   )rp   Úsuffixr!   r
   r
   r   rq   i  s    zPath.suffixc                 C   s
   |   ¡ jS r   )rp   Úsuffixesr!   r
   r
   r   rr   m  s    zPath.suffixesc                 C   s
   |   ¡ jS r   )rp   Ústemr!   r
   r
   r   rs   q  s    z	Path.stemc                 C   s   t  | jj¡ | j¡S r   )rn   r   r[   r<   Újoinpathr\   r!   r
   r
   r   r<   u  s    zPath.filenamec              
   O   sD   t ||Ž\}}}| jd|f|ž|Ž�}| ¡ W  5 Q R £ S Q R X d S )NrB   )rY   ri   Úread)r   r   r   rX   Ústrmr
   r
   r   Ú	read_texty  s    zPath.read_textc              
   C   s*   |   d¡�}| ¡ W  5 Q R £ S Q R X d S )NÚrb)ri   ru   )r   rv   r
   r
   r   Ú
read_bytes~  s    zPath.read_bytesc                 C   s   t  |j d¡¡| j d¡kS ©Nr8   )r   r:   r\   r   )r   r	   r
   r
   r   Ú	_is_child‚  s    zPath._is_childc                 C   s   |   | j|¡S r   )r    r[   )r   r\   r
   r
   r   Ú_next…  s    z
Path._nextc                 C   s   | j  p| j  d¡S rz   )r\   r?   r!   r
   r
   r   re   ˆ  s    zPath.is_dirc                 C   s   |   ¡ o|  ¡  S r   )rg   re   r!   r
   r
   r   Úis_file‹  s    zPath.is_filec                 C   s   | j | j ¡ kS r   )r\   r[   r7   r!   r
   r
   r   rg   Ž  s    zPath.existsc                 C   s.   |   ¡ stdƒ‚t| j| j ¡ ƒ}t| j|ƒS )NzCan't listdir a file)re   rj   r0   r|   r[   r5   Úfilterr{   )r   Úsubsr
   r
   r   Úiterdir‘  s    zPath.iterdirc                 C   s   t  | j¡ |¡S r   )rn   ro   r\   Úmatch)r   Úpath_patternr
   r
   r   r�   —  s    z
Path.matchc                 C   s"   | j  | j¡}|jd? }t |¡S )z8
        Return whether this path is a symlink.
        é   )r[   r=   r\   Úexternal_attrÚstatÚS_ISLNK)r   ÚinforE   r
   r
   r   Ú
is_symlinkš  s    
zPath.is_symlinkc                 C   sV   |st d|›�ƒ‚t | j¡}tdd�}t || |¡ ¡j}t| j	t
|| j ¡ ƒƒS )NzUnacceptable pattern: r8   )Úseps)rj   ÚreÚescaper\   r   ÚcompileÚ	translateÚ	fullmatchr0   r|   r~   r[   r5   )r   ÚpatternÚprefixÚtrÚmatchesr
   r
   r   Úglob¢  s    
z	Path.globc                 C   s   |   d|› �¡S )Nz**/)r“   )r   r�   r
   r
   r   Úrglob«  s    z
Path.rglobc                 G   s   t  t| ƒt|j|Ž ƒ¡S r   )r   ÚrelpathÚstrrt   )r   r^   Úextrar
   r
   r   Úrelative_to®  s    zPath.relative_toc                 C   s   t  | jj| j¡S r   )r   Újoinr[   r<   r\   r!   r
   r
   r   Ú__str__±  s    zPath.__str__c                 C   s   | j j| d�S )Nr!   )Ú_Path__reprÚformatr!   r
   r
   r   Ú__repr__´  s    zPath.__repr__c                 G   s$   t j| jf|žŽ }|  | j |¡¡S r   )r   r™   r\   r|   r[   r;   )r   r^   Únextr
   r
   r   rt   ·  s    zPath.joinpathc                 C   s6   | j s| jjS t | j  d¡¡}|r,|d7 }|  |¡S rz   )r\   r<   Úparentr   r:   r   r|   )r   Ú	parent_atr
   r
   r   rŸ   ½  s    zPath.parent)rZ   )rB   )"r%   r&   r'   r(   r›   r   r_   ra   ri   rp   Úpropertyr9   rq   rr   rs   r<   rw   ry   r{   r|   re   r}   rg   r€   r�   rˆ   r“   r”   r˜   rš   r�   rt   Ú__truediv__rŸ   r
   r
   r
   r   r   Ì   sH   f
	




	)N)r(   rk   r   r@   r   rQ   rn   rŠ   r…   rV   Zcompat.py310r   r“   r   Ú__all__r   r   ÚdictÚfromkeysr1   r   r   rD   r*   rP   rY   r   r
   r
   r
   r   Ú<module>   s*   	K
