GZ File Extractor

Purpose & User Intent: This web-based tool is a gz file extractor that decompresses single-member gzip archives (.gz). It targets developers, data engineers, IT admins, and data scientists who receive compressed files (logs, backups, datasets) and need to inspect or reuse their contents without desktop utilities. When you encounter a .gz attachment or a compressed data feed, you can upload it to obtain the original file contents for analysis or integration into pipelines. Core Logic & Features: The system validates the input as gzip, then applies DEFLATE-based decompression per RFC 1951. It operates in streaming mode to support large files, avoiding full in-memory loading when possible. Required features include: file upload input, gzip header validation, streaming decompression, CRC32 verification, and safe output delivery. Optional/advanced features include: support for single-member gzip with optional filename restoration from the header, an option to preserve the original internal path, and an output option to download the decompressed file directly. Inputs & Outputs: Inputs include gzip_file (type: file, required, units: none, sample: logs.gz, validation: .gz extension or MIME type application/gzip). Optional inputs: preserve_filename (boolean), preserve_path (boolean). Outputs include decompressed_file (type: file, units: bytes), decompressed_size (bytes), content_type (string). Algorithms & Calculations: The tool parses the gzip header (ID1, ID2, CM, FLG), processes optional extra fields, and then decompresses blocks with the DEFLATE algorithm. It computes and verifies CRC32 and ISIZE against the uncompressed data. For performance, decompression is streamed in chunks, with an output size reported to the user. Error & Edge Cases: If input is not a valid gzip, is truncated, or contains multiple members or unsupported extensions, decompression fails with a data integrity error. Large files are processed in chunks to minimize memory usage. External data unavailability is surfaced as an error; there is no automatic retries in this specification. Industry/Region & Localization: Follows RFC 1952 gzip structure; uses standard file size units (bytes, KB, MB) and is agnostic to regional settings. Assumptions & Exclusions: Assumes single-member gzip archives; does not unpack tar.gz, password-protected gzip, or other compression formats. It does not provide content previews or editing; only extraction to a downloadable result.