zip-extensions-rs

An extension crate for https://github.com/zip-rs/zip2 that provides high-level functions for common ZIP tasks, such as extracting archives to a directory.

Usage examples

Configure dependencies

Add the following dependencies to the Cargo.toml file.

[dependencies]
zip = "3.0"zip-extensions = "0.8.3"

See https://github.com/zip-rs/zip2 fur further information about zip dependencies.

Extracting an archive to a directory

The ZipArchiveExtensions trait provides the extract method that can be used to unzip an archive to a directory.

use std::fs::File;use zip_extensions::read::ZipArchiveExtensions;
...
let file = File::create(archive_file)?;letmut archive = zip::ZipArchive::new(file)?;
archive.extract(&target_path)?;

Alternatively, the zip_extract helper can be used.

use zip_extensions::*;
...
let archive_file:PathBuf = ...
let target_dir:PathBuf = ...zip_extract(&archive_file,&target_dir)?;

Extracting an archive entry into memory

The zip_extract_file_to_memory method can be used to extract entries ad-hoc into memory.

use zip_extensions::*;let archive_file = PathBuf::from_str(r#"Baloo_Da_2.zip"#)?;let entry_path = PathBuf::from_str("BalooDa2-Medium.ttf")?;letmut buffer :Vec<u8> = vec![];matchzip_extract_file_to_memory(&archive_file,&entry_path,&mut buffer){Ok(()) => {println!("Extracted {} bytes from archive.", buffer.len())},Err(e) => {println!("The entry does not exist.")}};

Creating an archive from a directory

The ZipWriterExtensions trait provides the create_from_directory and create_from_directory_with_options methods that can be used to add an entire directory hierarchy to an archive.

use zip::ZipWriter;use zip_extensions::write::ZipWriterExtensions;
...
let file = File::create(archive_file)?;let zip = ZipWriter::new(file);
zip.create_from_directory(&source_path)?;

Alternatively, the zip_create_from_directory helper can be used.

use zip_extensions::*;
...
let archive_file:PathBuf = ...
let source_dir:PathBuf = ...zip_create_from_directory(&archive_file,&source_dir)?;