pooch.Unzip

class pooch.Unzip(members=None)

Processor that unpacks a zip archive and returns a list of all files.

Use with pooch.Pooch.fetch to unzip a downloaded data file into a folder in the local data store. fetch 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.

Methods

__call__(self, fname, action, pooch)

Extract all files from the given archive.

Unzip.__call__(self, fname, action, pooch)

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 pooch.Pooch.fetch. One of:

• "download": The file didn’t exist locally and was downloaded
• "update": The local file was outdated and was re-download
• "fetch": The file exists and is updated so it wasn’t downloaded

pooch : pooch.Pooch

The instance of pooch.Pooch that is calling this.

Returns:

fnames : list of str

A list of the full path to all files in the extracted archive.