Google Git
Sign in
android / platform / external / rust / crates / zip / 4def21d3f396fcad55b86be3fed90b346ddc0d6f
commit4def21d3f396fcad55b86be3fed90b346ddc0d6f[log] [tgz]
authorXin Li <delphij@google.com>Mon Apr 29 22:16:22 2024 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Mon Apr 29 22:16:22 2024 +0000
treef22a08f84fabca451e486e8a3460064a9f75ec8c
parenta6cbbf9b30f813c3aaf4a5447f201329e05addd3 [diff]
parent8b9a7ca51a2779d369cbcdb924e768a309b6801d [diff]
[automerger skipped] Empty merge of Android 24Q2 Release (ab/11526283) to aosp-main-future am: 8b9a7ca51a -s ours

am skip reason: Merged-In I780b82bcff15e6aa22e855404ff4d17f52bd080c with SHA-1 9c83ef0cdf is already in history

Original change: https://googleplex-android-review.googlesource.com/c/platform/external/rust/crates/zip/+/27144526

Change-Id: Icd7287f072c8a521e8cbf0b7b7db1fb798e4b58b
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
tree: f22a08f84fabca451e486e8a3460064a9f75ec8c
  1. .github/
  2. benches/
  3. examples/
  4. patches/
  5. src/
  6. tests/
  7. .cargo_vcs_info.json
  8. .gitignore
  9. Android.bp
  10. Cargo.toml
  11. Cargo.toml.orig
  12. cargo_embargo.json
  13. CHANGELOG.md
  14. CODE_OF_CONDUCT.md
  15. LICENSE
  16. METADATA
  17. MODULE_LICENSE_MIT
  18. OWNERS
  19. README.md
  20. TEST_MAPPING
README.md

zip-rs

Build Status Crates.io version Discord

Documentation

Info

A zip library for rust which supports reading and writing of simple ZIP files.

Supported compression formats:

  • stored (i.e. none)
  • deflate
  • bzip2
  • zstd

Currently unsupported zip extensions:

  • Encryption
  • Multi-disk

Usage

With all default features:

[dependencies]
zip = "0.6"

Without the default features:

[dependencies]
zip = { version = "0.6.6", 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 the deflate compression algorithm, which is the default for zip files.
  • bzip2: Enables the BZip2 compression algorithm.
  • time: Enables features using the time crate.
  • zstd: Enables the Zstandard compression algorithm.

All of these are enabled by default.

MSRV

Our current Minimum Supported Rust Version is 1.59.0. 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