mirror of https://github.com/rustfs/rustfs.git synced 2026-08-18 18:46:17 +00:00

Files

T

Zhengchao An a38743caf5 chore(zip): trim the unused extract and create surface (#6210 )

rustfs-zip has one workspace consumer, and it uses only
CompressionFormat::{from_extension, extension, get_decoder} and
ArchiveLimits. Remove the tar/zip extract, zip create, and in-memory
compress helpers together with the types and dependencies that only
served them. Trimming public API is semver-major once the stable tag is
cut, so it costs least now.

2026-08-18 18:27:01 +08:00

2.2 KiB

Raw Blame History

RustFS Zip - Archive Format Detection And Stream Decoding

Archive format detection and async stream decoders for RustFS object storage

📖 Documentation · 🐛 Bug Reports · 💬 Discussions

📖 Overview

RustFS Zip provides the archive primitives used by the RustFS archive extract flow:

identify a compression format from an archive extension
wrap an async reader in the matching stream decoder
carry the shared default archive guardrails

Current Features

CompressionFormat::from_extension() for extension-based format detection, including tar-family suffixes such as tgz, tbz2, txz, and tzst
CompressionFormat::get_decoder() for async stream decoding of gzip, bzip2, zlib, xz, and zstd, plus a pass-through reader for plain tar
ArchiveLimits with the default entry count, entry size, total unpacked size, and path length guardrails

Current Boundaries

ZIP has no stream decoder: get_decoder() rejects CompressionFormat::Zip, because ZIP needs central-directory semantics that a forward-only stream cannot provide
This crate detects formats and hands back decoders; archive iteration, entry writing, and extraction to disk belong to the caller
ArchiveLimits carries the values only; enforcement and the resulting protocol error belong to the caller
Archive extraction safety policy remains the responsibility of the RustFS caller for object-store flows

📚 Documentation

For comprehensive documentation, examples, and usage guides, please visit the main RustFS repository.

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

2.2 KiB Raw Blame History