+ Bi>Rt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RIH t ^RI H t ^RI H t !RR]P4t!RR]4t!R R ]4t!R R 4tR#) z Post-processing hooks N)ZipFile)TarFile) get_loggerca]tRt^toRtR Rlt]]PR44t ]PR4t ]PR4t Rt Rt VtR#) ExtractorProcessora Abstract base class for extractions from compressed archives. Subclasses can be used with :meth:`pooch.Pooch.fetch` and :func:`pooch.retrieve` to unzip a downloaded data file into a folder in the local data store. :meth:`~pooch.Pooch.fetch` will return a list with the names of the extracted files instead of the archive. Parameters ---------- members : list or None If None, will unpack all files in the archive. Otherwise, *members* must be a list of file names to unpack from the archive. Only these files will be unpacked. extract_dir : str or None If None, files will be unpacked to the default location (a folder in the same location as the downloaded zip file, with a suffix added). Otherwise, files will be unpacked to ``extract_dir``, which is interpreted as a *relative path* (relative to the cache location provided by :func:`pooch.retrieve` or :meth:`pooch.Pooch.fetch`). NcWnW nR#N)members extract_dir)selfr r s&&&N/var/www/html/photoedit/myenv/lib/python3.14/site-packages/pooch/processors.py__init__ExtractorProcessor.__init__1s  &c R#)zz String appended to unpacked archive folder name. Only used if extract_dir is None. MUST BE IMPLEMENTED BY CHILD CLASSES. Nr s&r suffixExtractorProcessor.suffix5rc R#)zN Return all the members in the archive. MUST BE IMPLEMENTED BY CHILD CLASSES. Nr)r fnames&&r _all_membersExtractorProcessor._all_members>rrc R#)z} This method receives an argument for the archive to extract and the destination path. MUST BE IMPLEMENTED BY CHILD CLASSES. Nr)r rr s&&&r _extract_file ExtractorProcessor._extract_fileErrc  Zaa SPfVSP,SnMaVP\PP ^R7^,p\PP VSP4SnSPeSP'gSPV4pM SPpVR9gp\PPSP4'dA\;QJdV3RlV4F 'dK RM RM!V3RlV44'g?\P!SPRR7SPVSP4.p\P!SP4EFwrxp V Fp \PP\PP \PPVSP4V 44o SPeW\ ;QJd)V 3RlSP4F 'gK RM RM!V 3RlSP44'gKVP#\PP Wz44K EK V#)a Extract all files from the given archive. Parameters ---------- fname : str Full path of the zipped file in local storage. action : str Indicates what action was taken by :meth:`pooch.Pooch.fetch` or :func:`pooch.retrieve`: * ``"download"``: File didn't exist locally and was downloaded * ``"update"``: Local file was outdated and was re-download * ``"fetch"``: File exists and is updated so it wasn't downloaded pooch : :class:`pooch.Pooch` The instance of :class:`pooch.Pooch` that is calling this. Returns ------- fnames : list of str A list of the full path to all files in the extracted archive. )maxsplitc3<"TFLp\PP\PPSPV44xKN R#5ir)ospathexistsjoinr ).0mr s& r .ExtractorProcessor.__call__..us9KRarww||D,<,updatedownload)r rrsplitr r!sepr#r rr"allmakedirsrwalkr+r,anyappend) r ractionpooch archive_dirr fnamesr!_filesfilenamer,s f&&& @r __call__ExtractorProcessor.__call__Ms2    #$t{{2D ,,rww{{Q,?BK!ww||K9I9IJD  << t|||''.GllG - -GGNN4#3#3443KR333KR KK((4 8   ud&6&6 7 ggd&6&67NDU!''**GGLLt7G7G!H(S<<'33/EI\\/333/EI\\/,,MM"'',,t">?"8 r)r r )NN)__name__ __module__ __qualname____firstlineno____doc__r propertyabcabstractmethodrrrr>__static_attributes____classdictcell__ __classdict__s@r rrso.'        ==rrc@a]tRt^toRt]R4tRtRtRt Vt R#)Unzipa Processor that unpacks a zip archive and returns a list of all files. Use with :meth:`pooch.Pooch.fetch` or :func:`pooch.retrieve` to unzip a downloaded data file into a folder in the local data store. The method/function will return a list with the names of the unzipped files instead of the zip archive. The output folder is ``{fname}.unzip``. Parameters ---------- members : list or None If None, will unpack all files in the zip archive. Otherwise, *members* must be a list of file names to unpack from the archive. Only these files will be unpacked. extract_dir : str or None If None, files will be unpacked to the default location (a folder in the same location as the downloaded zip file, with the suffix ``.unzip`` added). Otherwise, files will be unpacked to ``extract_dir``, which is interpreted as a *relative path* (relative to the cache location provided by :func:`pooch.retrieve` or :meth:`pooch.Pooch.fetch`). c R#)T String appended to unpacked archive folder name. Only used if extract_dir is None. z.unziprrs&r r Unzip.suffix rc \VR4;_uu_4pVP4uuRRR4# +'giR#;iz(Return all members from a given archive.rN)rnamelist)r rzip_files&& r rUnzip._all_memberss, UC H$$&! s 0 A c  L\VR4;_uu_4pVPf.\4PRW4VP VR7MVPFp\4PRWAV4VP 4Uu.uFXp\ PPV4P\ PPV44'gKVVNKZ ppVP WbR7K RRR4R#uupi +'giR#;i)W This method receives an argument for the archive to extract and the destination path. rTNz"Unzipping contents of '%s' to '%s')r!!Extracting '%s' from '%s' to '%s')r r!) rr rinfo extractallrUr r!r+r*)r rr rVmembernamesubdir_memberss&&& r rUnzip._extract_files UC H||# !!8%###5"llFL%%;VK%-$5$5$7&$7D77++D1<Decompress.__call__Ws6 99  9,L77<<(> JL + +277>>,3O3O L  ?   --e4FlE**f[['':&&z:(+|('+*s$D/1D D/ D, 'D// E c RpVPVP9dcRVP R\VPP44 R2pVPR9dRP W2.4p\ V4hVPR8Xd\ PPV4R ,pW@P9dORV R\VPP44 R2pVR 9dRP W2.4p\ V4hVPVPV,,#VPVP,#) z Get the Python module compatible with fname and the chosen method. If the *method* attribute is "auto", will select a method based on the extension. If no recognized extension is in the file name, will raise a ValueError. z:To unpack zip/tar archives, use pooch.Unzip/Untar instead.zInvalid compression method 'z'. Must be one of 'z'. rvzUnrecognized file extension '>tarzip>.tar.zip) r}moduleslistkeysr# ValueErrorr r!splitext extensions)r rerror_archivesmessageexts&& r rDecompress._compression_modules+V ;;dll *.t{{m<##' (9(9(;#<"=RA {{n,((G#<=W% % ;;& ''""5)"-C//)3C59''+DOO,@,@,B'C&DBH**!hh'@AG ))<< 45 5||DKK((rr|)rvN)r@rArBrCrDrwrybz2rrr r>rrHrIrJs@r ruru$sN)VtVT4vtWcRG@J*X))rru)rDrFr rryrwrrpzipfilertarfilerutilsrABCrrMrcrurrr rsk qqhER ERPL L^{){)r