U P|j/@s*dZddlmZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z mZmZmZmZddlmZddlmZddlmZmZddlmZmZdd lmZmZmZm Z m!Z!m"Z"d Z#ed e$e%Z&ed e$e%Z'ed ddZ(eeeGddde e'e&fee'Z)Gddde)e e fZ*ddgZ+dS)zt This module contains implementations of L{IFilePath} for zip files. See the constructor of L{ZipArchive} for use. ) annotationsN) IO TYPE_CHECKINGAnyAnyStrDictGenericIterableListTupleTypeVarUnion)ZipFile) implementer)LiteralSelf)cmp comparable)AbstractFilePathFilePath IFilePath OtherAnyStrUnlistableError_coerceToFilesystemEncoding/ _ArchiveStr_ZipStr_ZipSelfzZipPath[Any, Any])boundc@sreZdZUdZded<ddddddZd d d d d ZddddZeddddZ ddddZ ddddZ e rddddZ dddd d!Zdddd"d#Zd$dd%d&Zd$dd'd(Zd$dd)d*Zd$dd+d,Zd-dd.d/Zd0dd1d2Zddd3d4Zddd5d6ZdId8d9d:d;d<Zddd=d>Zd dd?d@ZdAddBdCZdAddDdEZdAddFdGZdHS)JZipPathzF I represent a file or directory contained within a zip file. rpathzZipArchive[_ArchiveStr]None)archive pathInArchivereturncCsX||_||_t|j||_t|t}t||j}|j|}tjj |f|}||_dS)z Don't construct me directly. Use C{ZipArchive.child()}. @param archive: a L{ZipArchive} instance. @param pathInArchive: a ZIP_PATH_SEP-separated string. N) r"r#r_zipfileFilenameZ_nativePathInArchive ZIP_PATH_SEPsplitosr join)selfr"r#sepZarchiveFilenamesegmentsZfakePathr-:/tmp/pip-unpacked-wheel-audpp6lv/twisted/python/zippath.py__init__=s   zZipPath.__init__objectintotherr$cCs(t|tstSt|j|jf|j|jfSN) isinstancerNotImplementedrr"r#r*r3r-r-r.__cmp__Ws   zZipPath.__cmp__strr$cCsNt|jtj|jjg}||j|jt|jtj}d| |dS)NzZipPath()) rr+r(r abspathr"extendr#r'r))r*partsZossepr-r-r.__repr__^s zZipPath.__repr__cCs t|jtS)z Return a zip directory separator. @return: The zip directory separator. @returntype: The same type as C{self.path}. )rr r&r*r-r-r.r+gsz ZipPath.sepz=Union[ZipPath[_ZipStr, _ArchiveStr], ZipArchive[_ArchiveStr]]cCs<|j|j}t|dkr |jSt|j|j|ddS)zk Return parent, discarding our own encoding in favor of whatever the archive's is. N)r#r'r+lenr"rr))r*Zsplitupr-r-r. _nativeParentqs zZipPath._nativeParentz9Union[ZipPath[_ZipStr, _ArchiveStr], ZipArchive[_ZipStr]]cCs*|}t|tr&tt|j|jjS|Sr4)rDr5 ZipArchiverr r"r%)r*parentr-r-r.rF}s  zZipPath.parentzCIterable[Union[ZipPath[_ZipStr, _ArchiveStr], ZipArchive[_ZipStr]]]cCsdSr4r-r@r-r-r.parentsszZipPath.parentsrz!ZipPath[OtherAnyStr, _ArchiveStr]r r$cCs,t|t}t||j}t|j|||gS)a& Return a new ZipPath representing a path in C{self.archive} which is a child of this path. @note: Requesting the C{".."} (or other special name) child will not cause L{InsecurePath} to be raised since these names do not have any special meaning inside a zip archive. Be particularly careful with the C{path} attribute (if you absolutely must use it) as this means it may include special names with special meaning outside of the context of a zip archive. )rr&r#rr"r))r*r joinerr#r-r-r.childs  z ZipPath.childcCs*|}t|tr|jn|}||}|Sr4)rFr5rEr"rJ)r*r rFZrightTypedParentrJr-r-r.siblings zZipPath.siblingboolcCs|p|Sr4)isdirisfiler@r-r-r.existsszZipPath.existscCs|j|jjkSr4)r#r"childmapr@r-r-r.rMsz ZipPath.isdircCs|j|jjjkSr4)r#r"zipfile NameToInfor@r-r-r.rNszZipPath.isfilecCsdS)NFr-r@r-r-r.islinkszZipPath.islinkz List[_ZipStr]csdrPr>tjjj}fddjj|DStt t j dntt t j ddS)Ncsg|]}tj|qSr-)rr ).0Zeachr@r-r. sz#ZipPath.listdir..zLeaf zip entry listedzNon-existent zip entry listed) rOrMrr"r%r#rPkeysrOSErrorerrnoENOTDIRENOENT)r*ZparentArchivePathr-r@r.listdirs  zZipPath.listdirzTuple[_ZipStr, _ZipStr]cCstj|jS)zQ Return a value similar to that returned by C{os.path.splitext}. )r(r splitextr@r-r-r.r\szZipPath.splitextcCs|j|jdS)NrB)r#r'r+r@r-r-r.basenameszZipPath.basenamecCs |jSr4)rFr r@r-r-r.dirnameszZipPath.dirnamerzLiteral[('r', 'w')]z IO[bytes])moder$cCstd|j}|jjj||dS)N)r`)rr#r"rQopen)r*r`r#r-r-r.rbs z ZipPath.opencCsdSr4r-r@r-r-r.changedszZipPath.changedcCstd|j}|jjj|jS)zR Retrieve this file's size. @return: file size, in bytes ra)rr#r"rQrR file_sizer*r#r-r-r.getsizes zZipPath.getsizefloatcCs |jS)z Retrieve this file's last access-time. This is the same as the last access time for the archive. @return: a number of seconds since the epoch )r" getAccessTimer@r-r-r.rhszZipPath.getAccessTimecCs&td|j}t|jjj|jdS)z Retrieve this file's last modification time. This is the time of modification recorded in the zipfile. @return: a number of seconds since the epoch. ra)rrr)rr#timemktimer"rQrR date_timerer-r-r.getModificationTimes zZipPath.getModificationTimecCs|S)z Retrieve this file's last modification time. This name is provided for compatibility, and returns the same value as getmtime. @return: a number of seconds since the epoch. )rlr@r-r-r.getStatusChangeTimeszZipPath.getStatusChangeTimeN)r_)__name__ __module__ __qualname____doc____annotations__r/r8r?propertyr+rDrFrrGrJrKrOrMrNrSr[r\r]r^rbrcrfrhrlrmr-r-r-r.r4s6         rc@seZdZUdZded<eddddZddd d d Zd d dddZdddddZ ddddZ ddddZ ddddZ ddddZ d dd!d"Zd#S)$rEa I am a L{FilePath}-like object which can wrap a zip archive as if it were a directory. It works similarly to L{FilePath} in L{bytes} and L{unicode} handling -- instantiating with a L{bytes} will return a "bytes mode" L{ZipArchive}, and instantiating with a L{unicode} will return a "text mode" L{ZipArchive}. Methods that return new L{ZipArchive} or L{ZipPath} instances will be in the mode of the argument to the creator method, converting if required. rr%rr:cCs|Sr4r-r@r-r-r.r"szZipArchive.archiver!)archivePathnamer$cCs||_ttd||_|jj}|dk s.tdt|||_t|d|_i|_|j D]v}t|j| |j }t t |D]F}|| }|j |d| }||jkri|j|<d|j||<qzt|d}qVdS)z Create a ZipArchive, treating the archive at archivePathname as a zip file. @param archivePathname: a L{bytes} or L{unicode}, naming a path in the filesystem. raNz7zipfile must have filename when initialized with a pathrA)r rrrQfilenameAssertionErrorr%r#rPnamelistr'r+rangerCr))r*rtZzfnamenameZ splitNamexrJrFr-r-r.r/s&     zZipArchive.__init__r0r1r2cCst|tstSt|j|jSr4)r5rEr6rr r7r-r-r.r86s zZipArchive.__cmp__rzZipPath[OtherAnyStr, AnyStr]rHcCs t||S)z Create a ZipPath pointing at a path within the archive. @param path: a L{bytes} or L{unicode} with no path separators in it (either '/' or the system path separator, if it's different). )r)r*r r-r-r.rJ;szZipArchive.childrLcCst|jS)zC Returns C{True} if the underlying archive exists. )rr%rOr@r-r-r.rODszZipArchive.existsrgcCst|jS)z= Return the archive file's last access time. )rr%rhr@r-r-r.rhJszZipArchive.getAccessTimecCst|jS)z> Return the archive file's modification time. )rr%rlr@r-r-r.rlPszZipArchive.getModificationTimecCst|jS)z? Return the archive file's status change time. )rr%rmr@r-r-r.rmVszZipArchive.getStatusChangeTimer9cCsdtj|jdS)Nz ZipArchive(r;)r(r r<r@r-r-r.r?\szZipArchive.__repr__N)rnrorprqrrrsr"r/r8rJrOrhrlrmr?r-r-r-r.rEs   rE),rq __future__rrXr(ritypingrrrrrrr r r r r rQrZzope.interfacerZtyping_extensionsrrZtwisted.python.compatrrZtwisted.python.filepathrrrrrrr&bytesr9rrrrrE__all__r-r-r-r.s( 4      "P[