atomate2.common.files.gunzip_files(directory: str | Path | None = None, host: str | None = None, include_files: list[str | Path] | None = None, exclude_files: list[str | Path] | None = None, allow_missing: bool = False, force: bool = False, file_client: FileClient | None = None)[source]#

Gunzip files in a directory.

directorystr or Path or None

Directory in which to gunzip files. If None, the current directory will be used (or home folder if specifying a remote host).

hoststr or None

The hostname used to specify a remote filesystem. Can be given as either “username@host” or just “host” in which case the username will be inferred from the current user. If None, the local filesystem will be used.

include_filesNone or list of (str or Path)

Filenames to include as a list of str or Path objects given relative to directory. Glob file paths are supported, e.g. “*.dat”. If None, all gzipped files in the directory will be gunzipped.

exclude_filesNone or list of (str or Path)

Filenames to exclude. Supports glob file matching, e.g., “*.dat”.


Whether to error if a file in include_files is not present in the directory.


Whether to overwrite files if they exist.


A file client to use for performing file operations.