AHj-dZddlZddlZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z ddlmZdgZdZd Zej(Z d ZGd d ZGd deej0ZGddeZddZGddZy)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)none_assave_method_args text_encoding) TranslatorPathcBtjt|ddS)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('')) [] rN) itertoolsislice _ancestry)paths E/root/tools/cai/cai_env/lib/python3.12/site-packages/zipp/__init__.py_parentsrs   IdOQ 55c#K|jtj}|jtjr=|tj|\}}|jtjr>> 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)rtails rr r -sS* ;;y}} %D ++imm $ __T* d ++imm $s A:A?=A?cTtjt|j|S)zZ Return items in minuend not in subtrahend, retaining order with O(1) lookup. )r filterfalseset __contains__)minuend subtrahends r _differencerLs!  Z!=!=w GGrc<eZdZdZefdZdZfdZxZS)InitializedStatez? Mix-in to save the initialization state for pickling. c$t||i|yNsuper__init__)selfargskwargs __class__s rr%zInitializedState.__init__Ys $)&)rcZ|jj|jjfSr")_saved___init__r'r(r&s r __getstate__zInitializedState.__getstate__]s%##(($*>*>*E*EEErc.|\}}t||i|yr"r#)r&stater'r(r)s r __setstate__zInitializedState.__setstate__`s f $)&)r) __name__ __module__ __qualname____doc__rr%r-r0 __classcell__r)s@rr r Ts,**F**rr ceZdZdZedZfdZdZdZfdZ e dZ e de jd e jfd ZxZS) 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/'] ctjjtt|}d|D}t t ||S)Nc3BK|]}|tjzywr")rr).0ps r z-CompleteDirs._implied_dirs..ss61y}}$6s)r chain from_iterablemapr_deduper)namesparentsas_dirss r _implied_dirszCompleteDirs._implied_dirsps9////He0DE6g6{7E233rcZt|}|t|j|zSr")r$namelistlistrE)r&rBr)s rrGzCompleteDirs.namelistvs+ "tD..u5666rc4t|jSr")rrGr,s r _name_setzCompleteDirs._name_setzs4==?##rcL|j}|dz}||vxr||v}|r|S|S)zx If the name represents a directory, return that name as a directory (with the trailing slash). /)rJ)r&namerBdirname dir_matchs r resolve_dirzCompleteDirs.resolve_dir}s:  *%:'U*: #w--rc t||S#t$r=|jdr||j vrt j |cYSwxYw)z6 Supplement getinfo for implied dirs. rL)filename)r$getinfoKeyErrorendswithrJzipfileZipInfo)r&rMr)s rrSzCompleteDirs.getinfosR 27?4( ( 2==%T^^5E)E??D1 1 2sAAAct|tr|St|tjs||Sd|jvrt}||_|S)zl Given a source (filename or zipfile), return an appropriate CompleteDirs subclass. r) isinstancer8rVZipFilemoder))clssources rmakezCompleteDirs.makesK fl +M&'//2v;  fkk !C rzfreturncr|j|jD]}|j|d|S)z Given a writable zip file zf, inject directory entries for any directories implied by the presence of children. r)rErGwritestr)r]r`rMs rinjectzCompleteDirs.injects7 %%bkkm4 #D KKc " # r)r1r2r3r4 staticmethodrErGrJrPrS classmethodr_rVr[rdr5r6s@rr8r8esn44 7$. 2$GOOrr8cteZdZdZdZej fdZdZej fdZ xZ S) FastLookupzV ZipFile subclass to ensure implicit dirs exist and are resolved rapidly. c|jSr") _namelistr,s rrGzFastLookup.namelists ~~rc t|Sr")r$rGr&r)s rrjzFastLookup._namelistsw!!rc|jSr")_name_set_propr,s rrJzFastLookup._name_sets"""rc t|Sr")r$rJrls rrnzFastLookup._name_set_propsw ""r) r1r2r3r4rG functoolscached_propertyrjrJrnr5r6s@rrhrhsF ""###rrhc$d}t||||fS)Nr)encodingr'r( stack_levels r_extract_text_encodingrvsK ; /v ==rceZdZdZdZd dZdZdZd!dddZd Z e d Z e d Z e d Z e d Ze dZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZeZ e dZ!y)"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})cFtj||_||_y)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)rhr_rootat)r&ryrzs rr%z Path.__init__3sOOD) rc|j|jurtS|j|jf|j|jfk(S)zU >>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo' False )r)NotImplementedryrz)r&others r__eq__z Path.__eq__@s? >> 0! ! 477# EHH'===rcDt|j|jfSr")hashryrzr,s r__hash__z Path.__hash__IsTYY())rNpwdcN|jr t||d}|dk(r|js t||jj |j ||}d|vr|s|r td|St|i|\}}}tj||g|i|S)z Open this entry as text or binary following the semantics of ``pathlib.Path.open()`` by passing arguments through to io.TextIOWrapper(). rrYrbz*encoding args invalid for binary operation) is_dirIsADirectoryErrorexistsFileNotFoundErrorryopenrz ValueErrorrvio TextIOWrapper)r&r\rr'r(zip_modestreamrts rrz Path.openLs ;;=#D) )7 s?4;;=#D) )s; $;v !MNNM!7!H!H$B4B6BBrcp|jrtj|jS|jSr")rzpathlib PurePosixPathrRr,s r_basez Path._base`s&15w$$TWW-KdmmKrc6|jjSr")rrMr,s rrMz Path.nameczz|   rc6|jjSr")rsuffixr,s rrz Path.suffixgszz|"""rc6|jjSr")rsuffixesr,s rrz Path.suffixeskszz|$$$rc6|jjSr")rstemr,s rrz Path.stemorrctj|jjj |j Sr")rr ryrRjoinpathrzr,s rrRz Path.filenamess*||DII../88AArct|i|\}}}|jd|g|i|5}|jcdddS#1swYyxYw)NrY)rvrread)r&r'r(rtstrms r read_textzPath.read_textwsR!7!H!H$ TYYsH 6t 6v 6 $99;   s AA cp|jd5}|jcdddS#1swYyxYw)Nrb)rr)r&rs r read_byteszPath.read_bytes|s- YYt_ 99;   s,5ctj|jjd|jjdk(SNrL)rrNrzr)r&rs r _is_childzPath._is_childs2  !459LLLrc:|j|j|Sr")r)ry)r&rzs r_nextz Path._nexts~~dii,,rcV|j xs|jjdSr)rzrUr,s rrz Path.is_dirs"77{3dgg..s33rcH|jxr|j Sr")rrr,s ris_filez Path.is_files{{}2T[[]!22rcN|j|jjvSr")rzryrJr,s rrz Path.existssww$))--///rc|js tdt|j|jj }t |j|S)NzCan't listdir a file)rNotADirectoryErrorr@rryrGfilterr)r&subss riterdirz Path.iterdirsE{{}$%;< <4::tyy1134dnnd++rc^tj|jj|Sr")rrrzmatch)r& path_patterns rrz Path.matchs"$$TWW-33LAArc|jj|j}|jdz }t j |S)z8 Return whether this path is a symlink. )ryrSrz external_attrstatS_ISLNK)r&infor\s r is_symlinkzPath.is_symlinks;yy  )!!R'||D!!rcJ|std|tj|j}t d}tj ||j |zj}t|jt||jjS)NzUnacceptable pattern: rL)seps) rreescaperzrcompile translate fullmatchr@rrryrG)r&patternprefixtrmatchess rglobz Path.globs{5g[AB B477# S !**Vbll7&;;<FF4::vgtyy/A/A/CDEErc*|jd|S)Nz**/)r)r&rs rrglobz Path.rglobsyy3wi))rcltjt|t|j|Sr")rrelpathstrr)r&r}extras r relative_tozPath.relative_tos)  TC0F,GHHrct|jjd}|jr t j ||jS|S)Nz :zipfile:)rryrRrzrjoin)r&rys r__str__z Path.__str__s8tyy));704y~~dDGG,ATArc:|jj|S)Nr,) _Path__reprformatr,s r__repr__z Path.__repr__s{{!!t!,,rctj|jg|}|j|jj |Sr")rrrzrryrP)r&r}nexts rrz Path.joinpaths7~~dgg..zz$))//566rc|js|jjStj|jj d}|r|dz }|j |Sr)rzrRparentrrNrr)r& parent_ats rrz Path.parentsRww=='' '%%dggnnS&9:   Izz)$$r))rY)"r1r2r3r4rr%r~rrrpropertyrMrrrrRrrrrrrrrrrrrrrrr __truediv__rrrr r sdLNF >*CC(L!!##%%!!BB M-430, B"F*IB-7K %%rr")r4rprr rrrrrV _functoolsrr compat.py310rrr__all__rr dictfromkeysrArr r[r8rhrvr rrrrs  1' (6&+6 --/H**"H#W__HV##*> y%y%r