*j. S r SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK
J r S/r S r
S r\R r S r " S S
5 r " S S \\ R( 5 r " S
S\5 rSS jr " S S5 rg)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 )
TranslatorPathc D [ R " [ U 5 SS5 $ )z
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 =/opt/alt/python313/lib64/python3.13/zipfile/_path/__init__.py_parentsr s IdOQ 55 c # # U R [ R 5 n U R [ R 5 ( aC U v [ R " U 5 u pU R [ R 5 ( a MB gg7f)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 , sV * ;;y}} %D
++imm
$
$
__T*
++imm
$
$s BB
B
c V [ R " [ U5 R U 5 $ )zN
Return items in minuend not in subtrahend, retaining order
with O(1) lookup.
)r filterfalseset __contains__)minuend
subtrahends r _differencer K s!
Z !=!=w GGr
c > ^ \ rS rSrSrU 4S jrS rU 4S jrSrU =r $ )InitializedStateS z7
Mix-in to save the initialization state for pickling.
c > > Xl X l [ TU ] " U0 UD6 g N)_InitializedState__args_InitializedState__kwargssuper__init__)selfargskwargs __class__s r r# InitializedState.__init__X s
$)&)r
c 2 U R U R 4$ r )r r! r$ s r __getstate__ InitializedState.__getstate__] s {{DMM))r
c . > Uu p#[ TU ] " U0 UD6 g r )r" r# )r$ stater% r& r' s r __setstate__ InitializedState.__setstate__` s
$)&)r
)__args__kwargs)
__name__
__module__ __qualname____firstlineno____doc__r# r+ r/ __static_attributes__
__classcell__r' s @r r r S s *
** *r
r c ^ \ rS rSrSr\S 5 rU 4S jrS rS r U 4S jr
\ S 5 r \ S \
R S
\
R 4S j5 rS rU =r$ )
CompleteDirse a
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 [ R R [ [ U 5 5 nS U 5 n[ [
X 5 5 $ )Nc 3 F # U H o[ R - v M g 7fr )r r ).0ps r -CompleteDirs._implied_dirs..s s 6gy}}$gs !)r chain
from_iterablemapr _deduper )namesparentsas_dirss r
_implied_dirsCompleteDirs._implied_dirsp s7 ////He0DE6g6{7233r
c Z > [ TU ] 5 nU[ U R U5 5 - $ r )r" namelistlistrK )r$ rH r' s r rN CompleteDirs.namelistv s+ "tD . .u 5666r
c 4 [ U R 5 5 $ r )r rN r* s r _name_setCompleteDirs._name_setz s 4==?##r
c ` U R 5 nUS- nX; =( a X2; nU( a U$ U$ )z`
If the name represents a directory, return that name
as a directory (with the trailing slash).
/)rR )r$ namerH dirname dir_matchs r resolve_dirCompleteDirs.resolve_dir} s6
*%:'*: #w--r
c > [ TU ] U5 $ ! [ aA UR S5 ( a XR 5 ; a e [
R " US9s $ f = f)z&
Supplement getinfo for implied dirs.
rU )filename)r" getinfoKeyErrorendswithrR zipfileZipInfo)r$ rV r' s r r] CompleteDirs.getinfo sS 27?4( ( 2==%%^^5E)E??D1 1 2s AA A c [ U[ 5 ( a U$ [ U[ R 5 ( d U " U5 $ SUR ; a [ n Xl U$ )zT
Given a source (filename or zipfile), return an
appropriate CompleteDirs subclass.
r)
isinstancer< r` ZipFilemoder' )clssources r makeCompleteDirs.make sO fl + +M&'//22v; fkk ! C
r
zfreturnc v U R UR 5 5 H nUR US5 M U$ )zq
Given a writable zip file zf, inject directory entries for
any directories implied by the presence of children.
r
)rK rN writestr)rh rl rV s r injectCompleteDirs.inject s2 %%bkkm4D KKc " 5 r
)r3 r4 r5 r6 r7 staticmethodrK rN rR rY r] classmethodrj r` rf rp r8 r9 r: s @r r< r< e sn 4 4
7$. 2 $ GOO r
r< c 8 ^ \ rS rSrSrU 4S jrU 4S jrSrU =r$ )
FastLookup zJ
ZipFile subclass to ensure implicit
dirs exist and are resolved rapidly.
c > [ R " [ 5 U R sS S S 5 $ ! , ( d f O= f[ TU ] 5 U l U R $ r )
contextlibsuppressAttributeError_FastLookup__namesr" rN r$ r' s r rN FastLookup.namelist s=
0<< 1
0
0 w') || 2
A c > [ R " [ 5 U R sS S S 5 $ ! , ( d f O= f[ TU ] 5 U l U R $ r )ry rz r{ _FastLookup__lookupr" rR r} s r rR FastLookup._name_set s=
0== 1
0
0 )+
}} r )__lookup__names) r3 r4 r5 r6 r7 rN rR r8 r9 r: s @r rv rv s
r
rv c [ R R S:H nU=( a [ R S: nSU- n[ R
" X5 X4$ )Npypy) r )sysimplementationrV pypy_version_infoio
text_encoding)encodingr% r& is_pypy is_old_pypi stack_levels r _extract_text_encodingr sN %%/G @c 3 3j @Kk/K
H 2D @@r
c \ rS rSrSrSrS"S jrS rS rS#SS.S jjr S
r
\ S 5 r \ S 5 r
\ S
5 r\ S 5 r\ S 5 rS rS rS rS rS rS rS rS rS rS rS rS r S r S r S r S r \ r!\ S 5 r"S!r#g)$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(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 D [ R U5 U l X l g)a
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)rv rj rootat)r$ r r s r r#
Path.__init__5 s OOD) r
c U R UR La [ $ U R U R 4UR UR 4:H $ )z=
>>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo'
False
)r' NotImplementedr r )r$ others r __eq__ Path.__eq__B s?
>> 0! ! 477#
EHH'===r
c D [ U R U R 45 $ r )hashr r r* s r __hash__
Path.__hash__K s TYY())r
Npwdc r U R 5 ( a [ U 5 eUS nUS:X a U R 5 ( d [ U 5 eU R R U R XRS9nSU; a U( d U( a [ S5 eU$ [ U0 UD6u psn[ R " Xg/UQ70 UD6$ )z
Open this entry as text or binary following the semantics
of ``pathlib.Path.open()`` by passing arguments through
to io.TextIOWrapper().
r rd r bz*encoding args invalid for binary operation) is_dirIsADirectoryErrorexistsFileNotFoundErrorr openr
ValueErrorr r
TextIOWrapper)r$ rg r r% r& zip_modestreamr s r r Path.openN s ;;==#D) )7 s?4;;==#D) ) ; $;v !MNNM!7!H!H B4B6BBr
c | U R ( a [ R " U R 5 $ U R $ r )r pathlib
PurePosixPathr\ r* s r _base
Path._baseb s& 15w$$TWW-KdmmKr
c 6 U R 5 R $ r )r rV r* s r rV Path.namee zz| r
c 6 U R 5 R $ r )r suffixr* s r r Path.suffixi s zz|"""r
c 6 U R 5 R $ r )r suffixesr* s r r
Path.suffixesm s zz|$$$r
c 6 U R 5 R $ r )r stemr* s r r Path.stemq r r
c [ R " U R R 5 R U R
5 $ r )r r r r\ joinpathr r* s r r\
Path.filenameu s* ||DII . ./88AAr
c [ U0 UD6u p1nU R " SU/UQ70 UD6 nUR 5 sS S S 5 $ ! , ( d f g = f)Nrd )r r read)r$ r% r& r strms r read_textPath.read_texty sE !7!H!H
YYsH
6t
6v
6$99; 7
6
6s A
Ac z U R S5 nUR 5 sS S S 5 $ ! , ( d f g = f)Nrb)r r )r$ r s r
read_bytesPath.read_bytes~ s"
YYt_99; __s ,
:c [ R " UR R S5 5 U R R S5 :H $ NrU )r rW r r )r$ r
s r _is_childPath._is_child s2 !45 9LLLr
c : U R U R U5 $ r )r' r )r$ r s r _next
Path._next s ~~dii,,r
c h U R ( + =( d U R R S5 $ r )r r_ r* s r r Path.is_dir s" 77{3dgg . .s 33r
c Z U R 5 =( a U R 5 ( + $ r )r r r* s r is_file Path.is_file s {{}2T[[]!22r
c P U R U R R 5 ; $ r )r r rR r* s r r Path.exists s ww$))--///r
c U R 5 ( d [ S5 e[ U R U R R 5 5 n[
U R U5 $ )NzCan't listdir a file)r r rF r r rN filterr )r$ subss r iterdir Path.iterdir sG {{}} 34 44::tyy 1 1 34dnnd++r
c ` [ R " U R 5 R U5 $ r )r r r match)r$ path_patterns r r
Path.match s" $$TWW-33LAAr
c U R R U R 5 nUR S- n[ R
" U5 $ )z(
Return whether this path is a symlink.
)r r] r
external_attrstatS_ISLNK)r$ inforg s r
is_symlinkPath.is_symlink s; yy )!!R'||D!!r
c P U( d [ SU< 35 e[ R " U R 5 n[ SS9n[ R
" X#R
U5 - 5 R n[ U R [ X@R R 5 5 5 $ )NzUnacceptable pattern: rU )seps)
r reescaper r compile translate fullmatchrF r r r rN )r$ patternprefixtrmatchess r glob Path.glob sw 5g[ AB B477#
S
!**Vll7&; ;<FF4::vgyy/A/A/C DEEr
c * U R SU 35 $ )Nz**/)r )r$ r s r rglob
Path.rglob s yy3wi ))r
c n [ R " [ U 5 [ UR " U6 5 5 $ r )r relpathstrr )r$ r extras r relative_toPath.relative_to s' TC0F,GHHr
c l [ R " U R R U R 5 $ r )r joinr r\ r r* s r __str__ Path.__str__ s! ~~dii 0 0$''::r
c 4 U R R U S9$ )Nr* ) _Path__reprformatr* s r __repr__
Path.__repr__ s {{!!t!,,r
c [ R " U R /UQ76 nU R U R R U5 5 $ r )r r r r r rY )r$ r nexts r r
Path.joinpath s7 ~~dgg..zz$))//566r
c U R ( d U R R $ [ R " U R R S5 5 nU( a US-
nU R
U5 $ r )r r\ parentr rW r r )r$ parent_ats r r Path.parent sR ww=='' ' %%dggnnS&9: Izz)$$r
)r r ) )rd )$r3 r4 r5 r6 r7 r r# r r r r propertyrV r r r r\ r r r r r r r r r r r r r r r
r __truediv__r r8 rr r
r r r s dL NF >*C C(L ! ! # # % % ! ! B B
M-430, B"F*I;-7 K
% %r
r )r7 ry r r r r r r r r` r r __all__r r dictfromkeysrG r r rf r< rv r r rr r
r r s
(6&+6 -- /H* *$H#W__ HV $Ax% x%r