Ɠ,j>SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJ r SSK J r SSK J r "SS\R5r"S S \5r"S S \5r"S S5rg)z Post-processing hooks N)ZipFile)TarFile) get_loggerc\rSrSrSrS Sjr\\RS55r \RS5r \RS5r Sr S r g) 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`). NcXlX lgN)members extract_dir)selfr r s ڞC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pooch/processors.py__init__ExtractorProcessor.__init__1s  &cg)zz String appended to unpacked archive folder name. Only used if extract_dir is None. MUST BE IMPLEMENTED BY CHILD CLASSES. Nrs rsuffixExtractorProcessor.suffix5rcg)zN Return all the members in the archive. MUST BE IMPLEMENTED BY CHILD CLASSES. Nr)rfnames r _all_membersExtractorProcessor._all_members>rrcg)z} This method receives an argument for the archive to extract and the destination path. MUST BE IMPLEMENTED BY CHILD CLASSES. Nr)rrr s r _extract_file ExtractorProcessor._extract_fileErrc ^^ TRcUTR-TlOZUR[RR SS9Sn[RR UTR5TlTRbTR(dTRU5nO TRnUS;dH[RRTR5(a[U4SjU55(d;[R"TRSS9 TRUTR5 /n[R"TR5Hupxn U Hn [RR[RR [RRUTR5U 55m TRb&[!U 4SjTR55(dMUR#[RR Xz55 M M U$) 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. r)maxsplitrupdatedownloadc3># UHLn[RR[RRTRU55v MN g7fr )ospathexistsjoinr ).0mrs r .ExtractorProcessor.__call__..us9KRarww||D,<,# UH3nTR[RRU55v M5 g7fr ) startswithr&r'normpath)r*r+relpaths rr,r-s1/EQG&&rww'7'7':;;\s;>)r rrsplitr&r'sepr)r rr(allmakedirsrwalkr1r2anyappend) rractionpooch archive_dirr fnamesr'_filesfilenamer2s ` @r__call__ExtractorProcessor.__call__Ms2    #$t{{2D ,,rww{{Q,?BK!ww||K9I9IJD  << t||''.GllG - -GGNN4#3#344KR KK((4 8   ud&6&6 7 ggd&6&67NDU!''**GGLLt7G7G!H(S<<'3/EI\\/,,MM"'',,t">?"8 r)r r )NN)__name__ __module__ __qualname____firstlineno____doc__rpropertyabcabstractmethodrrrrA__static_attributes__rrrrrsg.'        =rrc4\rSrSrSr\S5rSrSrSr g)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`). cg)T String appended to unpacked archive folder name. Only used if extract_dir is None. z.unziprrs rr Unzip.suffix rcp[US5nUR5sSSS5 $!,(df  g=fz(Return all members from a given archive.rN)rnamelist)rrzip_files rrUnzip._all_memberss& UC H$$&! s' 5c &[US5nURc*[5RSX5 UR US9 OURHn[5RSXAU5 UR 5Vs/sHWn[ RRU5R[ RRU55(dMUUPMY nnUR XbS9 M SSS5 gs snf!,(df  g=f)W This method receives an argument for the archive to extract and the destination path. rUNz"Unzipping contents of '%s' to '%s')r'!Extracting '%s' from '%s' to '%s'r r') rr rinfo extractallrVr&r'r1r0)rrr rWmembernamesubdir_memberss rrUnzip._extract_files UC H||# !!8%###5"llFL%%;VK%-$5$5$7&$7D77++D1< JL + +277>>,3O3O L  ?   --e4FlE*f[[':&&z:(+|('+*s$DD1D D D D%cSnURUR;aaSURS[URR55S3nURS;aSR X2/5n[ U5eURS:Xa[ RRU5SnX@R;aMS US[URR55S3nUS ;aSR X2/5n[ U5eURURU$URUR$) 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'.>tarzip ryzUnrecognized file extension '>.tar.zip) rmoduleslistkeysr) ValueErrorr&r'splitext extensions)rrerror_archivesmessageexts rrDecompress._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)ryN)rCrDrErFrGrzr|bz2rrrrArrKrrrrxrx$s6)VTtcRG@J*X)rrx)rGrIr&rr|rzrrszipfilertarfilerutilsrABCrrMrerxrrrrsk qqhER ERPL L^{){)r