Metadata-Version: 2.4
Name: zipfixx
Version: 0.1.0
Summary: CLI para corrigir e extrair arquivos ZIP com nomes Unicode no Windows.
Author: SouzaF19
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# ZipFix

**Um CLI para corrigir e extrair arquivos ZIP com nomes Unicode no Windows.**

[![CI](https://github.com/SouzaF19/zipfix/actions/workflows/ci.yml/badge.svg)](https://github.com/SouzaF19/zipfix/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/tag/SouzaF19/zipfix)](https://github.com/SouzaF19/zipfix/releases)
[![License](https://img.shields.io/badge/license-MIT-brightgreen)](https://github.com/SouzaF19/zipfix/blob/main/LICENSE)

---

## 🎯 Sobre o problema

Ao descompactar arquivos `.zip` no Windows, nomes de arquivos que contêm caracteres
especiais ou Unicode (acentuação, símbolos, emojis) podem chegar corrompidos — virando
`????`, `Ã£`, ou sequências ininteligíveis.

Isso acontece porque a especificação do formato ZIP exige que nomes não-ASCII sejam
marcados com o *flag* de UTF-8 (bit `0x800`) na entrada. Dependendo da ferramenta que
escreveu ou leu o ZIP, esse flag é ignorado ou aplicado de forma inconsistente, resultando
em perda de caracteres.

### Por que isso importa

- Extrair um ZIP com `Compress-Archive` / `Expand-Archive` no PowerShell pode gerar nomes
  quebrados;
- Prefixos e nomes com `ä`, `ç`, `ã`, `€`, emojis e combinações passam a ser ininteligíveis;
- Leitores em outras plataformas (Linux, Web, Android) reagem mal a nomes malformados.

---

## 🔧 A solução

O **ZipFix** é um pequeno CLI que:

1. Lê um arquivo `.zip`;
2. Valida e sanitiza cada entrada (remove caracteres proibidos e limita o tamanho);
3. Reescreve o ZIP com nomes seguros e com encoding correto (UTF-8);
4. Extrai os arquivos de forma determinística.

---

## ✨ Funcionalidades

- ✅ Correção de nomes em entradas de ZIP;
- ✅ Sanitização de caracteres inválidos no Windows;
- ✅ Limitação de tamanho de nome;
- ✅ Reescrita de ZIP com encoding correto;
- ✅ Extração com nomes sanitizados;
- ✅ Relatório de entradas reescritas/extraídas.

---

## 🧰 Instalação

```bash
pip install zipfix
```

ou, via ferramenta de empacotamento:

```bash
uv tool install zipfix
```

---

## 🚀 Uso

```bash
# Corrigir (reescrever) um ZIP
zipflix fix entrada.zip --out saida_corrigida.zip

# Extrair um ZIP com nomes sanitizados
zipflix extract entrada.zip destino/
```

### Exemplo

```bash
zipflix fix ./downloads/arquivo.zip --out ./downloads/arquivo_corrigido.zip
zipflix extract ./downloads/arquivo_corrigido.zip ./extraido/
```

---

## 🧠 Como funciona

- Usa o módulo nativo de ZIP (stdlib) que trata UTF-8;
- Emite o novo arquivo com o flag UTF-8 nas entradas;
- Sanitiza nomes proibidos no Windows (`|`, `<`, `>`, `:`, `"`, `?`, `*`, `\`) e caracteres de controle.

---

## 🗂️ Estrutura do projeto

```text
C:/zipflix
├── zipflix/
│   ├── __init__.py
│   ├── cli.py
│   ├── fixer.py
│   └── __main__.py
├── tests/
│   └── test_fixer.py
├── .github/
│   └── workflows/
│       └── ci.yml
├── Makefile
├── pyproject.toml
├── README.md
└── LICENSE
```

---

## 🔭 Próximos passos

- Testes com ZIPs reais, incluindo nomes com emoji;
- Suporte a criptografia (AES).

---

## 📄 Licença

MIT

---

## 📦 WinPathFix

**Um CLI para renomear arquivos soltos com caracteres invalidos no Windows.**

- Detecta e renomeia arquivos com caracteres proibidos (`|`, `<`, `>`, `:`, `"`, `?`, `*`, `\`).
- Preserva Unicode e estrutura de pastas.
- Limita tamanho de nome a 255 caracteres por segmento.

```bash
winpathfix fix ./pastainvalida/
```

---

## 📦 PyPI

```bash
pip install zipfix
```

ou

```bash
pip install git+https://github.com/SouzaF19/zipfix.git
```

---

## 📄 Licença

MIT — ver [LICENSE](LICENSE).

---

## 📬 Contato

- GitHub: [@SouzaF19](https://github.com/SouzaF19)
