tf/ 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 dZ(eeeGdde e'e&fee'Z)Gdde)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])boundceZdZUdZded<d2d Zd3d Zd4dZed5dZ d6dZ d7dZ e rd8dZ d9dZd9dZd:dZd:dZd:dZd:dZd;d!Zdd*Zd?d+Zd@d,ZdAd.ZdAd/ZdAd0Zd1S)BZipPathzF I represent a file or directory contained within a zip file. rpatharchiveZipArchive[_ArchiveStr] pathInArchivereturnNonec||_||_t|j||_t|t }t||j}|j|}tjj |g|R}||_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_zipfileFilename_nativePathInArchive ZIP_PATH_SEPsplitosr"join)selfr#r%separchiveFilenamesegmentsfakePaths U/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/python/zippath.py__init__zZipPath.__init__=s18 &31L  $m2 2 ! *-FF#> 73$ $ #'"4":":3"?"?GLD8DDD% otherobjectintct|tstSt|j|jf|j|jfSN) isinstancer!NotImplementedrr#r%r/r7s r4__cmp__zZipPath.__cmp__WsE%)) "! ! \4- .@S0T   r6strcPt|jtj|jjg}||j|jt|jtj}d| |dS)NzZipPath()) rr0r-r"abspathr#extendr%r,r.)r/partsosseps r4__repr__zZipPath.__repr__^s ("'//$,BS2T2T U U   T'--dh77888+DHbf==0%**U++0000r6c6t|jtS)z Return a zip directory separator. @return: The zip directory separator. @returntype: The same type as C{self.path}. )rr"r+r/s r4r0z ZipPath.sepgs+49lCCCr6=Union[ZipPath[_ZipStr, _ArchiveStr], ZipArchive[_ArchiveStr]]c|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,r0lenr#r!r.)r/splitups r4 _nativeParentzZipPath._nativeParentqs]$**4844 w<<1  < t|TX]]73B3<%@%@AAAr69Union[ZipPath[_ZipStr, _ArchiveStr], ZipArchive[_ZipStr]]c|}t|tr,tt|j|jjS|Sr;)rPr< ZipArchiverr"r#r))r/parents r4rTzZipPath.parent}sR##%% fj ) ) +DIt|7TUU  r6CIterable[Union[ZipPath[_ZipStr, _ArchiveStr], ZipArchive[_ZipStr]]]cdSr;rIs r4parentszZipPath.parentss  Cr6r!ZipPath[OtherAnyStr, _ArchiveStr]ct|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%r!r#r.)r/r"joinerr%s r4childz ZipPath.childsH-T<@@3D$:LMM t|V[[-1F%G%GHHHr6c|}t|tr|jn|}||}|Sr;)rTr<rSr#r\)r/r"rTrightTypedParentr\s r4siblingzZipPath.siblingsD+5fj+I+IU4<z#ZipPath.listdir..s50 4@@r6zLeaf zip entry listedzNon-existent zip entry listed) rdrbrr#r)r%rfkeysrOSErrorerrnoENOTDIRENOENT)r/parentArchivePaths` r4listdirzZipPath.listdirs ;;== zz|| W1LL143E22! $ 56G H M M O O &gem=T&U&UVVV! &EFF r6Tuple[_ZipStr, _ZipStr]cJtj|jS)zQ Return a value similar to that returned by C{os.path.splitext}. )r-r"splitextrIs r4r{zZipPath.splitextsw ***r6cL|j|jdS)NrM)r%r,r0rIs r4basenamezZipPath.basenames !''11"55r6c4|jSr;)rTr"rIs r4dirnamezZipPath.dirnames{{}}!!r6rmodeLiteral['r', 'w'] IO[bytes]cntd|j}|jj||S)N)r)rr%r#rhopen)r/rr%s r4rz ZipPath.opens44B8JKK |#((T(BBBr6cdSr;rWrIs r4changedzZipPath.changeds r6cdtd|j}|jjj|jS)zR Retrieve this file's size. @return: file size, in bytes r)rr%r#rhri file_sizer/r%s r4getsizezZipPath.getsizes, 4B8JKK |#.}=GGr6floatc4|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# getAccessTimerIs r4rzZipPath.getAccessTimes|))+++r6ctd|j}tj|jjj|jdzS)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. r)rrr)rr%timemktimer#rhri date_timers r4getModificationTimezZipPath.getModificationTimesB4B8JKK { L +M : Dy P   r6c*|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. )rrIs r4getStatusChangeTimezZipPath.getStatusChangeTimes'')))r6N)r#r$r%rr&r'r7r8r&r9r&r@)r&r)r&rJ)r&rQ)r&rU)r"rr&rYr&r`)r&rl)r&ry)r)rrr&r)r&r')r&r9r&r)__name__ __module__ __qualname____doc____annotations__r5r?rGpropertyr0rPrTrrXr\r_rdrbrcrkrxr{r}rrrrrrrrWr6r4r!r!4s+MMM&&&&4    1111DDDXD B B B B     IIII ----;;;;EEEE"++++6666"""" CCCCC    HHHH,,,,     ******r6r!cveZdZUdZded<eddZdd Zdd ZddZ ddZ d dZ d dZ d dZ d!dZdS)"rSa 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)r&rc|Sr;rWrIs r4r#zZipArchive.archives r6archivePathnamer'cx||_ttd||_|jj}| Jdt|||_t|d|_i|_|jD]}t|j| |j }tt|D]Q}|| }|j |d| }||jvr i|j|<d|j||<Rt|d}dS)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. rNz7zipfile must have filename when initialized with a pathrL)r"rrrhfilenamer)r%rfnamelistr,r0rangerNr.)r/rzfnamename splitNamexr\rTs r4r5zZipArchive.__init__sB$ :2OOPP &    D    ;OV T T8"MM:< L))++ F FD3DItDDJJ48TTI3y>>** 1 1!1" y1"~66..,.DM&)/0 f%e,,0"EEFF F Fr6r7r8r9cnt|tstSt|j|jSr;)r<rSr=rr"r>s r4r?zZipArchive.__cmp__6s.%,, "! !49ej)))r6r"rZipPath[OtherAnyStr, AnyStr]c"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"s r4r\zZipArchive.child;stT"""r6r`cNt|jS)zC Returns C{True} if the underlying archive exists. )rr)rdrIs r4rdzZipArchive.existsDs!-..55777r6rcNt|jS)z= Return the archive file's last access time. )rr)rrIs r4rzZipArchive.getAccessTimeJs!-..<<>>>r6cNt|jS)z> Return the archive file's modification time. )rr)rrIs r4rzZipArchive.getModificationTimeP!-..BBDDDr6cNt|jS)z? Return the archive file's status change time. )rr)rrIs r4rzZipArchive.getStatusChangeTimeVrr6r@cRdtj|jdS)Nz ZipArchive(rB)r-r"rCrIs r4rGzZipArchive.__repr__\s#rs\  #"""""                           &&&&&&++++++++11111111 gmUC00 ')UC ( ( 7:%8 9 9 9  YL*L*L*L*L*gg{*+-=g-FL*L* L*^X=X=X=X=X=(X=X=X=v  #r6