zip_next

Documentation

Info

A zip library for rust which supports reading and writing of simple ZIP files. Forked from https://crates.io/crates/zip to add more features and improve test coverage.

Supported compression formats:

• stored (i.e. none)
• deflate
• deflate64 (decompression only)
• bzip2
• zstd

Currently unsupported zip extensions:

• Encryption
• Multi-disk

Usage

With all default features:

[dependencies]
zip_next = "1.1.0"

Without the default features:

[dependencies]
zip_next = { version = "1.1.0", default-features = false }

The features available are:

• aes-crypto: Enables decryption of files which were encrypted with AES. Supports AE-1 and AE-2 methods.
• deflate: Enables decompressing the deflate compression algorithm, which is the default for zip files.
• deflate-miniz: Enables deflating files with the miniz_oxide library (used when compression quality is 0..=9).
• deflate-zlib: Enables deflating files with the zlib library (used when compression quality is 0..=9).
• deflate-zlib-ng: Enables deflating files with the zlib-ng library (used when compression quality is 0..=9). This is the fastest deflate implementation available.
• deflate-zopfli: Enables deflating files with the zopfli library (used when compression quality is 10..=264). This is the most effective deflate implementation available.
• deflate64: Enables the deflate64 compression algorithm. Decompression is only supported.
• bzip2: Enables the BZip2 compression algorithm.
• time: Enables features using the time crate.
• chrono: Enables converting last-modified zip_next::DateTime to and from chrono::NaiveDateTime.
• zstd: Enables the Zstandard compression algorithm.

By default aes-crypto, deflate, deflate-zlib-ng, deflate-zopfli, bzip2, time and zstd are enabled.

MSRV

Our current Minimum Supported Rust Version is 1.70. When adding features, we will follow these guidelines:

• We will always support the latest four minor Rust versions. This gives you a 6 month window to upgrade your compiler.
• Any change to the MSRV will be accompanied with a minor version bump
  • While the crate is pre-1.0, this will be a change to the PATCH version.

Examples

See the examples directory for:

• How to write a file to a zip.
• How to write a directory of files to a zip (using walkdir).
• How to extract a zip file.
• How to extract a single file from a zip.
• How to read a zip from the standard input.

Fuzzing

Fuzzing support is through cargo fuzz. To install cargo fuzz:

cargo install cargo-fuzz

To list fuzz targets:

cargo +nightly fuzz list

To start fuzzing zip extraction:

cargo +nightly fuzz run fuzz_read

To start fuzzing zip creation:

cargo +nightly fuzz run fuzz_write