1j. d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
m Z ddl m
Z
ddlmZ dgZd Zd Zej Z d
Z G d d Z G d
dee j Z G d de ZddZ G d d Z dS )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 )save_method_args)
text_encoding)
TranslatorPathc H t j 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) itertoolsislice _ancestry)paths r/builddir/build/BUILD/cloudlinux-venv-1.0.11/venv/lib/python3.11/site-packages/setuptools/_vendor/zipp/__init__.py_parentsr s IdOOQ 5 55 c # K | t j } | t j r<| V t j | \ } }| t j :dS dS )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 posixpathsepsplit)r tails r
r r . sy * ;;y} % %D
++im
$
$ +
_T**
d ++im
$
$ + + + + +r c P t j t | j | S )zZ
Return items in minuend not in subtrahend, retaining order
with O(1) lookup.
)r filterfalseset __contains__)minuend
subtrahends r
_differencer M s
Z !=w G GGr c B e Zd ZdZe fd Zd Z fdZ xZS )InitializedStatez?
Mix-in to save the initialization state for pickling.
c : t j |i | d S Nsuper__init__)selfargskwargs __class__s r
r# zInitializedState.__init__Z s% $)&)))))r c 2 | j j | j j fS r )_saved___init__r% r& r$ s r
__getstate__z InitializedState.__getstate__^ s #($*>*EEEr c D |\ }} t j |i | d S r r! )r$ stater% r& r' s r
__setstate__z InitializedState.__setstate__a s. f$)&)))))r ) __name__
__module__ __qualname____doc__r r# r+ r.
__classcell__r' s @r
r r U sz * * * * *F F F* * * * * * * * *r r c e Zd ZdZed Z fdZd Zd Z fdZ e
d Z e
de j
d e j
fd
Z xZS ) 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 t j t t | }d |D }t t
|| S )Nc 3 4 K | ]}|t j z V d S r )r r ).0ps r
z-CompleteDirs._implied_dirs..t s) 661y}$666666r )r chain
from_iterablemapr _deduper )namesparentsas_dirss r
_implied_dirszCompleteDirs._implied_dirsq sL ///He0D0DEE66g666{7E22333r c t }|t | | z S r )r" namelistlistrC )r$ r@ r' s r
rE zCompleteDirs.namelistw s9 ""tD . .u 5 56666r c D t | S r )r rE r* s r
_name_setzCompleteDirs._name_set{ s 4==??###r c P | }|dz }||vo||v }|r|n|S )zx
If the name represents a directory, return that name
as a directory (with the trailing slash).
/)rH )r$ namer@ dirname dir_matchs r
resolve_dirzCompleteDirs.resolve_dir~ s?
*%:'U*: #-ww-r c t | S # t $ rD | d r|| vr t j | cY S w xY w)z6
Supplement getinfo for implied dirs.
rJ )filename)r" getinfoKeyErrorendswithrH zipfileZipInfo)r$ rK r' s r
rQ zCompleteDirs.getinfo s} 277??4(( ( 2 2 2==%%
T^^5E5E)E)E?D111 1 1 1 2s $ A A21A2c t |t r|S t |t j s | | S d|j vrt } | |_ |S )zl
Given a source (filename or zipfile), return an
appropriate CompleteDirs subclass.
r)
isinstancer6 rT ZipFilemoder' )clssources r
makezCompleteDirs.make s^ fl + + M&'/22 3v;; fk ! ! C
r zfreturnc | | D ]}| |d |S )z
Given a writable zip file zf, inject directory entries for
any directories implied by the presence of children.
r )rC rE writestr)r[ r^ rK s r
injectzCompleteDirs.inject sE %%bkkmm44 # #D KKc " " " " r )r/ r0 r1 r2 staticmethodrC rE rH rN rQ classmethodr] rT rY rb r3 r4 s @r
r6 r6 f s 4 4 \4
7 7 7 7 7$ $ $. . . 2 2 2 2 2 [$ GO [ r r6 c l e Zd ZdZd Zej fd Zd Zej fd Z xZ
S )
FastLookupzV
ZipFile subclass to ensure implicit
dirs exist and are resolved rapidly.
c | j S r ) _namelistr* s r
rE zFastLookup.namelist s
~ r c D t S r )r" rE r$ r' s r
rh zFastLookup._namelist s ww !!!r c | j S r )_name_set_propr* s r
rH zFastLookup._name_set s ""r c D t S r )r" rH rj s r
rl zFastLookup._name_set_prop s ww """r ) r/ r0 r1 r2 rE functoolscached_propertyrh rH rl r3 r4 s @r
rf rf s
" " " " "# # # # # # # # # # # #r rf c t j j dk }|ot j dk }d|z }t | | ||fS )Npypy) rs )sysimplementationrK pypy_version_infor )encodingr% r& is_pypy is_old_pypi stack_levels r
_extract_text_encodingr| sF %/G @c 3j @Kk/K ; / /v ==r c & e Zd ZdZdZd"dZd Zd Zd#dd d
Zd Z e
d Z e
d
Z e
d Z
e
d Ze
d Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Z d Z d Z d Z e Z e
d! Z!dS )$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 R t | | _ || _ dS )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)rf r] rootat)r$ r r s r
r# z
Path.__init__9 s" OOD)) r c h | j |j urt S | j | j f|j |j fk S )zU
>>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo'
False
)r' NotImplementedr r )r$ others r
__eq__z Path.__eq__F s6
> 0 0! ! 47#
EH'===r c 8 t | j | j f S r )hashr r r* s r
__hash__z
Path.__hash__O s TY()))r rW Npwdc l | rt | |d }|dk r#| st | | j | j || }d|v r|s|rt d |S t |i |\ }}}t j
||g|R i |S )z
Open this entry as text or binary following the semantics
of ``pathlib.Path.open()`` by passing arguments through
to io.TextIOWrapper().
r rW r bz*encoding args invalid for binary operation) is_dirIsADirectoryErrorexistsFileNotFoundErrorr openr
ValueErrorr| io
TextIOWrapper)r$ rZ r r% r& zip_modestreamrx s r
r z Path.openR s ;;== *#D)) )7 s??4;;==?#D)) ) s ;; $;;
Ov
O !MNNNM!7!H!H!H $ B4BBB6BBBr c P | j rt j | j n| j S r )r pathlib
PurePosixPathrP r* s r
_basez
Path._basef s# 15Kw$TW---dmKr c 4 | j S r )r rK r* s r
rK z Path.namei zz|| r c 4 | j S r )r suffixr* s r
r z Path.suffixm s zz||""r c 4 | j S r )r suffixesr* s r
r z
Path.suffixesq s zz||$$r c 4 | j S r )r stemr* s r
r z Path.stemu r r c n t j | j j | j S r )r r r rP joinpathr r* s r
rP z
Path.filenamey s' |DI .//88AAAr c t |i |\ }}} | j d|g|R i |5 }| cd d d S # 1 swxY w Y d S )NrW )r| r read)r$ r% r& rx strms r
read_textzPath.read_text} s !7!H!H!H $
TYsH
6t
6
6
6v
6
6 $99;; s AA Ac | d 5 }| cd d d S # 1 swxY w Y d S )Nrb)r r )r$ r s r
read_byteszPath.read_bytes s~
YYt__ 99;; s 7;;c t j |j d | j d k S NrJ )r rL r r )r$ r s r
_is_childzPath._is_child s4 !4!455 9L9LLLr c 8 | | j | S r )r' r )r$ r s r
_nextz
Path._next s ~~di,,,r c F | j p| j d S r )r rS r* s r
r z Path.is_dir s! 7{3dg . .s 3 33r c T | o| S r )r r r* s r
is_filez Path.is_file s {{}}2T[[]]!22r c B | j | j v S r )r r rH r* s r
r z Path.exists s w$)--////r c | st d t | j | j }t
| j | S )NzCan't listdir a file)r r r> r r rE filterr )r$ subss r
iterdirz Path.iterdir sR {{}} 5 344 44:ty 1 1 3 344dnd+++r c Z t j | j | S r )r r r match)r$ path_patterns r
r z
Path.match s# $TW--33LAAAr c | | j | j }|j dz }t j | S )z8
Return whether this path is a symlink.
)r rQ r
external_attrstatS_ISLNK)r$ inforZ s r
is_symlinkzPath.is_symlink s8 y ))!R'|D!!!r c N |st d| t j | j }t d }t j || | z j }t | j t || j S )NzUnacceptable pattern: rJ )seps)
r reescaper r compile translate fullmatchr> r r r rE )r$ patternprefixtrmatchess r
globz Path.glob s C Ag A ABB B47##
S
!
!
!*Vbll7&;&; ;<<F4:vgty/A/A/C/C D DEEEr c 2 | d| S )Nz**/)r )r$ r s r
rglobz
Path.rglob s yy w )))r c p t j t | t |j | S r )r relpathstrr )r$ r extras r
relative_tozPath.relative_to s, TC0F,G,GHHHr c J t j | j j | j S r )r joinr rP r r* s r
__str__z Path.__str__ s ~di 0$':::r c 8 | j | S )Nr* ) _Path__reprformatr* s r
__repr__z
Path.__repr__ s {!!t!,,,r c t j | j g|R }| | j | S r )r r r r r rN )r$ r nexts r
r z
Path.joinpath s= ~dg....zz$)//55666r c | j s | j j S t j | j d }|r|dz
}| | S r )r rP parentr rL r r )r$ parent_ats r
r z Path.parent sY w (=' ' %dgnnS&9&9:: Izz)$$$r )r~ )rW )"r/ r0 r1 r2 r r# r r r r propertyrK r r r rP r r r r r r r r r r r r r r r r __truediv__r r r
r r s9 d dL NF > > >* * *C C C C C C(L L L ! ! X! # # X# % % X% ! ! X! B B XB
M M M- - -4 4 43 3 30 0 0, , , B B B" " "F F F* * *I I I; ; ;- - -7 7 7 K
% % X% % %r r ) r2 rn r r r r r r ru rT
_functoolsr compat.py310r r r __all__r r dictfromkeysr? r r rY r6 rf r| r r r r
r s
( ( ( ( ( ( ' ' ' ' ' ' (6 6 6&+ + +6 - /H H H* * * * * * * *"H H H H H#W_ H H HV# # # # # # # #*> > > >x% x% x% x% x% x% x% x% x% x%r