+
    i.  c                   s   R t ^ RIt^ RIt^ RIt^ RIt^ RIt^ RIt^ RIt^ RIt^ RI	t	^RI
Ht R.tR tR t]P                   t R t ! R R4      t ! R	 R
]]	P(                  4      t ! R R]4      tRR lt ! R R4      tR# )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)
TranslatorPathc                sD    \         P                  ! \        V 4      ^R4      # )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(''))
[]
N)	itertoolsZislice	_ancestry)path   &//usr/lib64/python3.14/zipfile/_path/__init__.py_parentsr      s      IdOQ55    c              #  s   "   V P                  \        P                  4      p V P                  \        P                  4      '       d   V x  \        P                  ! V 4      w  rKC  R# 5i)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sepZsplit)r   Ztail   & r   r   r   ,   sH     * ;;y}}%D
++imm
$
$
__T*
d %s   AA' A'c                sV    \         P                  ! \        V4      P                  V 4      # )zN
Return items in minuend not in subtrahend, retaining order
with O(1) lookup.
)r   ZfilterfalsesetZ__contains__)ZminuendZ
subtrahend   &&r   _differencer   K   s!    
   Z!=!=wGGr   c                   sH   a a ] tR t^St oRtV 3R ltR tV 3R ltRtVt	V ;t
# )InitializedStatez7
Mix-in to save the initialization state for pickling.
c                s@   < Wn         W n        \        SV `  ! V/ VB  R # N)_InitializedState__args_InitializedState__kwargssuper__init__)selfargskwargs	__class__s   &*,r   r   ZInitializedState.__init__X   s    $)&)r   c                s2    V P                   V P                  3# r   )r   r   r   r   r   __getstate__ZInitializedState.__getstate__]   s    {{DMM))r   c                s0   < Vw  r#\         SV `  ! V/ VB  R # r   )r   r   )r   Zstater   r   r   s   &&  r   __setstate__ZInitializedState.__setstate__`   s    $)&)r   )Z__argsZ__kwargs)__name__
__module____qualname____firstlineno____doc__r   r   r   __static_attributes____classdictcell____classcell__r   __classdict__   @@r   r   r   S   s     *
** *r   r   c                   s   a a ] tR t^et oRt]R 4       tV 3R ltR tR t	V 3R lt
]R 4       t]V3R lR	 l4       tR
tVtV ;t# )CompleteDirsa  
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                s    \         P                  P                  \        \        V 4      4      pR  V 4       p\        \        W 4      4      # )c              3   sN   "   T F  q\         P                  ,           x  K  	  R # 5ir   )r
   r   )Z.0Zpr   r   Z	<genexpr>Z-CompleteDirs._implied_dirs.<locals>.<genexpr>s   s     6gy}}$$gs   #%)r   ZchainZfrom_iterablemapr   _deduper   )namesZparentsZas_dirs   &  r   _implied_dirsZCompleteDirs._implied_dirsp   s7    ////He0DE6g6{7233r   c                sb   < \         SV `  4       pV\        V P                  V4      4      ,           # r   )r   namelistZlistr-   )r   r+   r   s   & r   r.   ZCompleteDirs.namelistv   s+     "tD..u5666r   c                s4    \        V P                  4       4      # r   )r   r.   r   r   r   	_name_setZCompleteDirs._name_setz   s    4==?##r   c                sl    V P                  4       pVR,           pW9  ;'       d    W29   pV'       d   V# T# )z`
If the name represents a directory, return that name
as a directory (with the trailing slash).
/)r/   )r   namer+   dirnameZ	dir_match   &&   r   resolve_dirZCompleteDirs.resolve_dir}   s9    
  *%::'*:	#w--r   c                s   <  \         SV `  V4      #   \         dG    TP                  R4      '       d   YP	                  4       9  d   h \
        P                  ! TR7      u # i ; i)z&
Supplement getinfo for implied dirs.
r0   )filename)r   getinfoZKeyErrorendswithr/   zipfileZZipInfo)r   r1   r   s   &&r   r6   ZCompleteDirs.getinfo   sS    	27?4(( 	2==%%^^5E)E??D11	2s    !A#,A#"A#c                s    \        V\        4      '       d   V# \        V\        P                  4      '       g	   V ! V4      # RVP                  9  d   \        p Wn        V# )zT
Given a source (filename or zipfile), return an
appropriate CompleteDirs subclass.
r)Z
isinstancer(   r8   ZipFilemoder   )clsZsourcer   r   makeZCompleteDirs.make   sO     fl++M&'//22v; fkk!Cr   c                sN   < V ^8  d   QhRS[ P                  RS[ P                  /# )i   zfZreturn)r8   r:   )formatr&   s   "r   Z__annotate__ZCompleteDirs.__annotate__   s#       GOO r   c                sv    V P                  VP                  4       4       F  pVP                  VR4       K  	  V# )zq
Given a writable zip file zf, inject directory entries for
any directories implied by the presence of children.
r   )r-   r.   Zwritestr)r<   r>   r1   s   && r   injectZCompleteDirs.inject   s2     %%bkkm4DKKc" 5	r    )r   r   r   r    r!   Zstaticmethodr-   r.   r/   r4   r6   Zclassmethodr=   r@   r"   r#   r$   r%   r'   r   r(   r(   e   s_      4 4
7$.	2  $   r   r(   c                   sB   a a ] tR t^t oRtV 3R ltV 3R ltRtVtV ;t	# )
FastLookupzJ
ZipFile subclass to ensure implicit
dirs exist and are resolved rapidly.
c                   < \         P                  ! \        4      ;_uu_ 4        V P                  uuR R R 4       #   + '       g   i     M; i\        ST `  4       T n        T P                  # r   )
contextlibsuppressAttributeErrorZ_FastLookup__namesr   r.   r   r      &r   r.   ZFastLookup.namelist   sC      00<< 1000w')||	   ;A	c                rC   r   )rD   rE   rF   Z_FastLookup__lookupr   r/   rG   rH   r   r/   ZFastLookup._name_set   sC      00== 1000)+}}rI   )Z__lookupZ__names)
r   r   r   r    r!   r.   r/   r"   r#   r$   r%   r'   r   rB   rB      s     
 r   rB   c                 s    \         P                  P                  R 8H  pT;'       d    \         P                  R8  p^V,           p\        P
                  ! W4      W3# )Zpypy)i   i   i   )sysZimplementationr1   Zpypy_version_infoioZtext_encoding)encodingr   r   Zis_pypyZis_old_pypiZstack_levels   &*,   r   _extract_text_encodingrM      sQ      %%/G @@c33j@Kk/KH2D@@r   c                   s  a  ] tR t^t o RtRtR!R ltR tR tR"RR/R llt	R	 t
]R
 4       t]R 4       t]R 4       t]R 4       t]R 4       tR tR tR tR tR tR tR tR tR tR tR tR tR tR tR tR t ] t!]R 4       t"R t#V t$R# )#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                sF    \         P                  V4      V n        W n        R# )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)rB   r=   rootat)r   rN   rO   s   &&&r   r   ZPath.__init__5  s     OOD)	r   c                s    V P                   VP                   Jd   \        # V P                  V P                  3VP                  VP                  38H  # )z=
>>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo'
False
)r   ZNotImplementedrN   rO   )r   otherr   r   __eq__ZPath.__eq__B  s?    
 >>0!!		477#

EHH'===r   c                sD    \        V P                  V P                  34      # r   )ZhashrN   rO   r   r   r   __hash__ZPath.__hash__K  s    TYY())r   pwdNc               s   V P                  4       '       d   \        V 4      hV^ ,          pVR8X  d"   V P                  4       '       g   \        V 4      hV P                  P                  V P                  WRR7      pRV9   d   V'       g	   V'       d   \        R4      hV# \        V/ VB w  rsp\        P                  ! Wg.VO5/ VB # )z
Open this entry as text or binary following the semantics
of ``pathlib.Path.open()`` by passing arguments through
to io.TextIOWrapper().
r9   )rS   Zbz*encoding args invalid for binary operation)is_dirZIsADirectoryErrorexistsZFileNotFoundErrorrN   openrO   
ValueErrorrM   rK   ZTextIOWrapper)r   r;   rS   r   r   Zzip_modeZstreamrL   s   &&$*,   r   rV   Z	Path.openN  s     ;;==#D))7s?4;;==#D));$;v !MNNM!7!H!HB4B6BBr   c                s~    V P                   '       d!   \        P                  ! V P                   4      # V P                  # r   )rO   pathlibPurePosixPathr5   r   r   r   _baseZ
Path._baseb  s(    15w$$TWW-KdmmKr   c                6    V P                  4       P                  # r   )rZ   r1   r   r   r   r1   Z	Path.namee      zz|   r   c                r[   r   )rZ   suffixr   r   r   r]   ZPath.suffixi  s    zz|"""r   c                r[   r   )rZ   suffixesr   r   r   r^   ZPath.suffixesm  s    zz|$$$r   c                r[   r   )rZ   stemr   r   r   r_   Z	Path.stemq  r\   r   c                s    \         P                  ! V P                  P                  4      P	                  V P
                  4      # r   )rX   r   rN   r5   joinpathrO   r   r   r   r5   ZPath.filenameu  s*    ||DII../88AAr   c                s    \        V/ VB w  r1pV P                  ! R V.VO5/ VB ;_uu_ 4       pVP                  4       uuRRR4       #   + '       g   i     R# ; i)r9   N)rM   rV   read)r   r   r   rL   strms   &*,  r   	read_textZPath.read_texty  sK    !7!H!HYYsH6t6v66$99; 7666s   A		A	c                s    V P                  R 4      ;_uu_ 4       pVP                  4       uuRRR4       #   + '       g   i     R# ; i)ZrbN)rV   ra   )r   rb   r   r   
read_bytesZPath.read_bytes~  s&    YYt__99; ___s	   5A	c                s    \         P                  ! VP                  P                  R 4      4      V P                  P                  R 4      8H  # r0   )r
   r2   rO   r	   )r   r   r   r   	_is_childZPath._is_child  s2      !459LLLr   c                s:    V P                  V P                  V4      # r   )r   rN   )r   rO   r   r   _nextZ
Path._next  s    ~~dii,,r   c                sj    V P                   '       * ;'       g    V P                   P                  R 4      # re   )rO   r7   r   r   r   rT   ZPath.is_dir  s%    77{33dgg..s33r   c                s\    V P                  4       ;'       d    V P                  4       '       * # r   )rU   rT   r   r   r   is_fileZPath.is_file  s    {{}22T[[]!22r   c                sP    V P                   V P                  P                  4       9   # r   )rO   rN   r/   r   r   r   rU   ZPath.exists  s    ww$))--///r   c                s    V P                  4       '       g   \        R 4      h\        V P                  V P                  P                  4       4      p\        V P                  V4      # )zCan't listdir a file)rT   rW   r)   rg   rN   r.   filterrf   )r   Zsubsr   r   iterdirZPath.iterdir  sG    {{}}3444::tyy1134dnnd++r   c                s`    \         P                  ! V P                  4      P                  V4      # r   )rX   rY   rO   match)r   Zpath_patternr   r   rk   Z
Path.match  s"    $$TWW-33LAAr   c                s    V P                   P                  V P                  4      pVP                  ^,	          p\        P
                  ! V4      # )z(
Return whether this path is a symlink.
)rN   r6   rO   Zexternal_attrstatZS_ISLNK)r   Zinfor;   r,   r   
is_symlinkZPath.is_symlink  s;     yy  )!!R'||D!!r   c                s`   V'       g   \        R V: 24      h\        P                  ! V P                  4      p\	        RR7      p\        P
                  ! W#P                  V4      ,           4      P                  p\        V P                  \        W@P                  P                  4       4      4      # )zUnacceptable pattern: r0   )Zseps)rW   reZescaperO   r    ZcompileZ	translateZ	fullmatchr)   rg   ri   rN   r.   )r   patternZprefixZtrZmatchesr3   r   globZ	Path.glob  sw    5g[ABB477#S!**Vll7&;;<FF4::vgyy/A/A/CDEEr   c                s*    V P                  R V 24      # )z**/)rp   )r   ro   r   r   rglobZ
Path.rglob  s    yy3wi))r   c           	     sp    \         P                  ! \        V 4      \        VP                  ! V!  4      4      # r   )r
   ZrelpathZstrr`   )r   rP   Zextras   &&*r   relative_toZPath.relative_to  s'      TC0F,GHHr   c                sl    \         P                  ! V P                  P                  V P                  4      # r   )r
   joinrN   r5   rO   r   r   r   __str__ZPath.__str__  s!    ~~dii00$''::r   c                s:    V P                   P                  V R 7      # )r   )_Path__reprr?   r   r   r   __repr__ZPath.__repr__  s    {{!!t!,,r   c                s    \         P                  ! V P                  .VO5!  pV P                  V P                  P                  V4      4      # r   )r
   rs   rO   rg   rN   r4   )r   rP   Znexts   &* r   r`   ZPath.joinpath  s7    ~~dgg..zz$))//566r   c                s    V P                   '       g   V P                  P                  # \        P                  ! V P                   P                  R 4      4      pV'       d
   VR ,          pV P                  V4      # re   )rO   r5   parentr
   r2   r	   rg   )r   Z	parent_atr   r   rw   ZPath.parent  sT    www=='''%%dggnnS&9:	Izz)$$r   )rO   rN   )Z )r9   )%r   r   r   r    r!   ru   r   rQ   rR   rV   rZ   Zpropertyr1   r]   r^   r_   r5   rc   rd   rf   rg   rT   rh   rU   rj   rk   rm   rp   rq   rr   rt   rv   r`   Z__truediv__rw   r"   r#   )r&   s   @r   r   r      s
    dL NF>*C C(L ! ! # # % % ! ! B B
M-430,B"F*I;-7 K% %r   r   )r!   rD   rK   r   rX   r
   rn   rl   rJ   r8   rp   r    Z__all__r   r   ZdictZfromkeysr*   r   r   r:   r(   rB   rM   r   rA   r   r   <module>rx      s     	    	  
  (6&+6 -- /H* *$H#W__ HV $Ax% x%r   