o Ri.@sdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZdgZdd Zd d ZejZ d d ZGdddZGdddee jZGdddeZdddZGdddZdS)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) TranslatorPathcCstt|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)pathr D/home/app/Keep/.python/lib/python3.10/site-packages/zipp/__init__.py_parentssr ccsB|tj}|tjr|Vt|\}}|tjs dSdS)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 tailr r r r .s   r cCstt|j|S)zZ Return items in minuend not in subtrahend, retaining order with O(1) lookup. )r filterfalseset __contains__)minuend subtrahendr r r _differenceMsrcs8eZdZdZefddZddZfddZZS)InitializedStatez? Mix-in to save the initialization state for pickling. cstj|i|dSNsuper__init__)selfargskwargs __class__r r rZzInitializedState.__init__cCs|jj|jjfSr)Z_saved___init__rr rr r r __getstate__^zInitializedState.__getstate__cs|\}}tj|i|dSrr)rstaterr r!r r __setstate__aszInitializedState.__setstate__) __name__ __module__ __qualname____doc__rrr%r( __classcell__r r r!r rUs rcsneZdZdZeddZfddZddZdd Zfd d Z e d d Z e de j de j fddZZS) 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/'] cCs.tjtt|}dd|D}tt||S)Ncss|]}|tjVqdSr)rr).0pr r r tsz-CompleteDirs._implied_dirs..)rchain from_iterablemapr _deduper)namesparentsas_dirsr r r _implied_dirsqszCompleteDirs._implied_dirscst}|t||Sr)rnamelistlistr9)rr6r!r r r:ws zCompleteDirs.namelistcCs t|Sr)rr:r$r r r _name_set{s zCompleteDirs._name_setcCs,|}|d}||vo||v}|r|S|S)zx If the name represents a directory, return that name as a directory (with the trailing slash). /)r<)rnamer6dirname dir_matchr r r resolve_dir~s zCompleteDirs.resolve_dircsFzt|WSty"|dr||vrtj|dYSw)z6 Supplement getinfo for implied dirs. r=)filename)rgetinfoKeyErrorendswithr<zipfileZipInfo)rr>r!r r rCs zCompleteDirs.getinfocCs:t|tr|St|tjs||Sd|jvrt}||_|S)zl Given a source (filename or zipfile), return an appropriate CompleteDirs subclass. r) isinstancer.rFZipFilemoder")clssourcer r r makes   zCompleteDirs.makezfreturncCs$||D]}||dq|S)z Given a writable zip file zf, inject directory entries for any directories implied by the presence of children. )r9r:writestr)rLrOr>r r r injectszCompleteDirs.inject)r)r*r+r, staticmethodr9r:r<rArC classmethodrNrFrJrSr-r r r!r r.fs     r.csHeZdZdZddZejfddZddZejfdd Z Z S) FastLookupzV ZipFile subclass to ensure implicit dirs exist and are resolved rapidly. cC|jSr) _namelistr$r r r r:zFastLookup.namelistc tSr)rr:r$r!r r rX zFastLookup._namelistcCrWr)_name_set_propr$r r r r<rYzFastLookup._name_setcrZr)rr<r$r!r r r\r[zFastLookup._name_set_prop) r)r*r+r,r: functoolscached_propertyrXr<r\r-r r r!r rVsrVcOs2tjjdk}|o tjdk}d|}t||||fS)Npypy)ra)sysimplementationr>pypy_version_infor)encodingrr is_pypyZ is_old_pypiZ stack_levelr r r _extract_text_encodings rhc@seZdZdZdZd=ddZddZdd Zd>d d d dZddZ e ddZ e ddZ e ddZ e ddZe ddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd3d4Zd5d6Zd7d8Zd9d:ZeZ e d;d<Z!d S)?ru$ 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})cCst||_||_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)rVrNrootat)rrjrkr r r r9s z Path.__init__cCs(|j|jurtS|j|jf|j|jfkS)zU >>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo' False )r"NotImplementedrjrk)rotherr r r __eq__Fs z Path.__eq__cCst|j|jfSr)hashrjrkr$r r r __hash__Or&z Path.__hash__rHNpwdcOs|rt||d}|dkr|st||jj|j||d}d|vr0|s*|r.td|St|i|\}}}t j ||g|Ri|S)z Open this entry as text or binary following the semantics of ``pathlib.Path.open()`` by passing arguments through to io.TextIOWrapper(). rrHrqbz*encoding args invalid for binary operation) is_dirIsADirectoryErrorexistsFileNotFoundErrorrjopenrk ValueErrorrhio TextIOWrapper)rrKrrrr zip_modestreamrfr r r rxRsz Path.opencCs|jr t|jS|jSr)rkpathlib PurePosixPathrBr$r r r _basefsz Path._basecC |jSr)rr>r$r r r r>ir[z Path.namecCrr)rsuffixr$r r r rmr[z Path.suffixcCrr)rsuffixesr$r r r rqr[z Path.suffixescCrr)rstemr$r r r rur[z Path.stemcCst|jj|jSr)r~rrjrBjoinpathrkr$r r r rByr#z Path.filenamecOsZt|i|\}}}|jd|g|Ri| }|WdS1s&wYdS)NrH)rhrxread)rrr rfstrmr r r read_text}s$zPath.read_textcCs6|d }|WdS1swYdS)Nrb)rxr)rrr r r read_bytess $zPath.read_bytescCst|jd|jdkSNr=)rr?rkr)rr r r r _is_childszPath._is_childcCs||j|Sr)r"rj)rrkr r r _nextz Path._nextcCs|j p |jdSr)rkrEr$r r r rtsz Path.is_dircCs|o| Sr)rvrtr$r r r is_filez Path.is_filecCs|j|jvSr)rkrjr<r$r r r rvr&z Path.existscCs.|stdt|j|j}t|j|S)NzCan't listdir a file)rtryr4rrjr:filterr)rsubsr r r iterdirs z Path.iterdircCst|j|Sr)r~rrkmatch)r path_patternr r r rrz Path.matchcCs"|j|j}|jd?}t|S)z8 Return whether this path is a symlink. )rjrCrk external_attrstatS_ISLNK)rinforKr r r is_symlinks  zPath.is_symlinkcCsV|s td|t|j}tdd}t|||j}t|j t ||j S)NzUnacceptable pattern: r=)seps) ryreescaperkrcompile translate fullmatchr4rrrjr:)rpatternprefixtrmatchesr r r globs   z Path.globcCs|d|S)Nz**/)r)rrr r r rglobr&z Path.rglobcGstt|t|j|Sr)rrelpathstrr)rrmextrar r r relative_toszPath.relative_tocCst|jj|jSr)rjoinrjrBrkr$r r r __str__rz Path.__str__cCs|jj|dS)Nr$) _Path__reprformatr$r r r __repr__rz Path.__repr__cGs&tj|jg|R}||j|Sr)rrrkrrjrA)rrmnextr r r rsz Path.joinpathcCs6|js|jjSt|jd}|r|d7}||Sr)rkrBparentrr?rr)r parent_atr r r rs  z Path.parent)ri)rH)"r)r*r+r,rrrnrprxrpropertyr>rrrrBrrrrrtrrvrrrrrrrrr __truediv__rr r r r rsJf         r)r,r]rzrr~rrrrcrF _functoolsrZ compat.py310rrr__all__r r dictfromkeysr5rrrJr.rVrhrr r r r s0    K