GZ File Extractor

Propósito e Intenção do Usuário: Esta ferramenta Web é um extrator de arquivos GZ que descompacta arquivos gzip de um único membro (.gz). Destina-se a desenvolvedores, engenheiros de dados, administradores de TI e cientistas de dados que recebem arquivos comprimidos e precisam inspecionar ou reutilizar seu conteúdo sem ferramentas de desktop. Ao receber um anexo .gz ou um feed de dados comprimido, você pode enviá-lo para obter o conteúdo do arquivo original para análise ou integração em pipelines.
Lógica Central e Funcionalidades: O sistema valida a entrada como gzip e aplica descompressão baseada em DEFLATE conforme RFC 1951. Opera em modo streaming para suportar arquivos grandes e evitar carregamento total na memória. Funcionalidades obrigatórias: entrada de upload de arquivo, validação do cabeçalho gzip, descompressão em streaming, verificação CRC32 e entrega segura de saídas. Funcionalidades opcionais/avançadas: suporte para gzip de membro único com restauração opcional do nome do arquivo a partir do cabeçalho, opção para preservar o caminho interno original e opção de saída para baixar o arquivo descomprimido diretamente.
Entradas e Saídas: Entradas: gzip_file (tipo: arquivo, obrigatório), exemplo: logs.gz, validação: extensão .gz ou MIME-type application/gzip). Opcional: preserve_filename (Boolean), preserve_path (Boolean). Saídas: decompressed_file (tipo: arquivo, unidades: bytes), decompressed_size (bytes), content_type (String).
Algoritmos & Cálculos: a ferramenta analisa o cabeçalho gzip (ID1, ID2, CM, FLG), processa campos opcionais extras e descompacta blocos com o algoritmo DEFLATE. Calcula e verifica CRC32 e ISIZE contra os dados descompactados. Para desempenho, a descompressão é realizada em streaming por blocos; um tamanho de saída é informado ao usuário.
Erros & Casos Limites: Se a entrada não for gzip válido, estiver truncada ou contiver múltiplos membros ou extensões não suportadas, a descompressão falha com erro de integridade. Arquivos grandes são processados em blocos para minimizar o uso de memória. Disponibilidade de dados externos é sinalizada como erro; não há tentativas automáticas nesta especificação. Indústria/Região & Localização: Segue a estrutura gzip RFC 1952; usa unidades padrão (bytes, KB, MB) e é independente de configurações regionais. Suposições & Exclusões: Pressupõe arquivos gzip de membro único; não descompacta tar.gz, gzip protegido por senha ou outros formatos de compressão. Não fornece visualização de conteúdo ou edição; apenas extração para um resultado baixável.