zipfixx 0.1.0__tar.gz

zipfixx-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SouzaF19
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

zipfixx-0.1.0/PKG-INFO

@@ -0,0 +1,179 @@
+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)

zipfixx-0.1.0/README.md

@@ -0,0 +1,165 @@
+# 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)

zipfixx-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zipfixx"
+version = "0.1.0"
+description = "CLI para corrigir e extrair arquivos ZIP com nomes Unicode no Windows."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "SouzaF19" }]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.scripts]
+zipfix = "zipflix.cli:main"
+
+[tool.setuptools]
+packages = ["zipflix"]

zipfixx-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zipfixx-0.1.0/tests/test_fixer.py

@@ -0,0 +1,74 @@
+"""Testes do ZipFix: sanitização e reescrita/extração de nomes em ZIP."""
+
+import os
+import tempfile
+import unittest
+import zipfile
+
+from zipflix import fixer
+
+
+class TestFixer(unittest.TestCase):
+    def setUp(self):
+        self.tmp = tempfile.TemporaryDirectory()
+        self.addCleanup(self.tmp.cleanup)
+        self.tmpdir = self.tmp.name
+
+    def _make_zip(self, path):
+        entries = {
+            "docs/relatorio-final.txt": b"conteudo final\n",
+            "docs/relatorio com acento-ãã.txt": b"acentos\n",
+            "emoji-🚀-teste.txt": b"emoji\n",
+            "invalid|name*.txt": b"invalido\n",
+        }
+        with zipfile.ZipFile(path, "w", zipfile.ZIP_DEFLATED) as zf:
+            for name, data in entries.items():
+                info = zipfile.ZipInfo(filename=name, date_time=(2026, 11, 7, 12, 0, 0))
+                info.compress_type = zipfile.ZIP_DEFLATED
+                zf.writestr(info, data)
+
+    def test_sanitize_name(self):
+        self.assertEqual(fixer.sanitize_name("docs/relatorio-ãã.txt"), "docs/relatorio-ãã.txt")
+        self.assertEqual(fixer.sanitize_name("invalid|name*.txt"), "invalidname.txt")
+        self.assertEqual(fixer.sanitize_name("bad:char*|name?.txt"), "badcharname.txt")
+
+    def test_sanitize_blocks_parent_traversal(self):
+        self.assertEqual(fixer.sanitize_name("../../evil.txt"), "evil.txt")
+        self.assertEqual(fixer.sanitize_name("../evil.txt"), "evil.txt")
+        self.assertNotIn("..", fixer.sanitize_name("../../evil.txt"))
+
+    def test_sanitize_truncates_per_segment(self):
+        long_name = "a" * 300
+        self.assertEqual(len(fixer.sanitize_name(long_name)) <= 255, True)
+
+    def test_fix_zip_rewrites_names(self):
+        src = os.path.join(self.tmpdir, "entrada.zip")
+        dst = os.path.join(self.tmpdir, "saida.zip")
+        self._make_zip(src)
+        results = fixer.fix_zip(src, dst)
+        self.assertTrue(len(results) > 0)
+        with zipfile.ZipFile(dst, "r") as zf:
+            names = zf.namelist()
+        self.assertIn("docs/relatorio-final.txt", names)
+        self.assertIn("docs/relatorio com acento-ãã.txt", names)
+        self.assertIn("emoji-🚀-teste.txt", names)
+        self.assertIn("invalidname.txt", names)
+        self.assertNotIn("invalid|name*.txt", names)
+
+    def test_fix_zip_same_path_raises(self):
+        src = os.path.join(self.tmpdir, "entrada.zip")
+        self._make_zip(src)
+        with self.assertRaises(ValueError):
+            fixer.fix_zip(src, src)
+
+    def test_extract_zip_sanitizes(self):
+        src = os.path.join(self.tmpdir, "entrada2.zip")
+        dest = os.path.join(self.tmpdir, "destino")
+        self._make_zip(src)
+        count = fixer.extract_zip(src, dest)
+        self.assertEqual(count, 4)
+        self.assertTrue(os.path.exists(os.path.join(dest, "emoji-🚀-teste.txt")))
+
+
+if __name__ == "__main__":
+    unittest.main()

zipfixx-0.1.0/tests/test_winpathfix.py

@@ -0,0 +1,26 @@
+"""Testes do WinPathFix: coleta de renomes em diretorio."""
+
+import os
+import tempfile
+import unittest
+
+from winpathfix import fixer
+from winpathfix import cli
+
+
+class TestWinPathFix(unittest.TestCase):
+    def setUp(self):
+        self.tmp = tempfile.TemporaryDirectory()
+        self.addCleanup(self.tmp.cleanup)
+        self.tmpdir = self.tmp.name
+
+    def test_collect_renames_empty_for_clean_dir(self):
+        open(os.path.join(self.tmpdir, "ok_renome.txt"), "w").write("x")
+        self.assertEqual(fixer.collect_renames(self.tmpdir), [])
+
+    def test_collect_renames_blocks_traversal(self):
+        self.assertEqual(fixer.sanitize_name("../../evil.txt"), "evil.txt")
+
+
+if __name__ == "__main__":
+    unittest.main()

zipfixx-0.1.0/zipfixx.egg-info/PKG-INFO

@@ -0,0 +1,179 @@
+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)

zipfixx-0.1.0/zipfixx.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+tests/test_fixer.py
+tests/test_winpathfix.py
+zipfixx.egg-info/PKG-INFO
+zipfixx.egg-info/SOURCES.txt
+zipfixx.egg-info/dependency_links.txt
+zipfixx.egg-info/entry_points.txt
+zipfixx.egg-info/top_level.txt
+zipflix/__init__.py
+zipflix/__main__.py
+zipflix/cli.py
+zipflix/fixer.py

zipfixx-0.1.0/zipfixx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

zipfixx-0.1.0/zipfixx.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+zipfix = zipflix.cli:main

zipfixx-0.1.0/zipfixx.egg-info/top_level.txt

@@ -0,0 +1 @@
+zipflix

zipfixx-0.1.0/zipflix/__init__.py

@@ -0,0 +1,3 @@
+"""ZipFix - CLI para correção e extração segura de arquivos ZIP com nomes Unicode."""
+
+__version__ = "0.1.0"

zipfixx-0.1.0/zipflix/__main__.py

@@ -0,0 +1,4 @@
+from zipflix.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

zipfixx-0.1.0/zipflix/cli.py

@@ -0,0 +1,59 @@
+"""Interface de linha de comando do ZipFix."""
+
+import argparse
+import sys
+import zipfile
+
+from zipflix import __version__
+from zipflix import fixer
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="zipflix",
+        description="Corrige e extrai arquivos ZIP com nomes Unicode no Windows.",
+    )
+    parser.add_argument("--version", action="version", version=f"zipflix {__version__}")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_fix = sub.add_parser("fix", help="Reescreve um ZIP com nomes sanitizados.")
+    p_fix.add_argument("input", help="Caminho do ZIP de entrada.")
+    p_fix.add_argument("--out", required=True, help="Caminho de saída do ZIP corrigido.")
+
+    p_extract = sub.add_parser("extract", help="Extrai um ZIP com nomes sanitizados.")
+    p_extract.add_argument("input", help="Caminho do ZIP de entrada.")
+    p_extract.add_argument("dest", help="Diretório de destino da extração.")
+
+    return parser
+
+
+def main(argv=None) -> int:
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(encoding="utf-8")
+        except Exception:
+            pass
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+
+    try:
+        if args.command == "fix":
+            results = fixer.fix_zip(args.input, args.out)
+            print(f"OK: {len(results)} entries reescritas -> {args.out}")
+            for orig, new in results:
+                print(f"  {orig}  ==>  {new}")
+            return 0
+
+        if args.command == "extract":
+            count = fixer.extract_zip(args.input, args.dest)
+            print(f"OK: {count} entries extraidos para {args.dest}")
+            return 0
+    except (OSError, ValueError, zipfile.BadZipFile) as exc:
+        print(f"zipflix: erro: {exc}", file=sys.stderr)
+        return 1
+
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

zipfixx-0.1.0/zipflix/fixer.py

@@ -0,0 +1,84 @@
+"""Correção de nomes em arquivos ZIP com suporte a Unicode."""
+
+import os
+import re
+import shutil
+import zipfile
+
+INVALID_CHARS = re.compile(r'[<>:\"|?*\x00-\x1f]')
+MAX_NAME_LENGTH = 255
+
+
+def sanitize_name(name: str) -> str:
+    r"""Remove caracteres proibidos no Windows, descarta segmentos perigosos e limita tamanhos.
+
+    - Normaliza `\` -> `/`.
+    - Remove caracteres inválidos (<>:"/\|?* e controle) e descarta segmentos vazios/`.`/`..`.
+    - Limita cada componente a `MAX_NAME_LENGTH`.
+    """
+    cleaned = name.replace("\\", "/")
+    trailing = cleaned.endswith("/")
+    parts = []
+    for part in cleaned.split("/"):
+        p = INVALID_CHARS.sub("", part).strip()
+        if p and p not in (".", ".."):
+            parts.append(p)
+    cleaned = "/".join(parts)
+    cleaned = cleaned.rstrip(".")
+    segments = cleaned.split("/") if cleaned else []
+    cleaned = "/".join(seg[:MAX_NAME_LENGTH].rstrip() for seg in segments)
+    if trailing and cleaned and not cleaned.endswith("/"):
+        cleaned = cleaned + "/"
+    return cleaned
+
+
+def read_entries(path: str) -> list:
+    with zipfile.ZipFile(path, "r") as zf:
+        return zf.infolist()
+
+
+def _clean_entries(path: str) -> list:
+    cleaned = []
+    seen = set()
+    with zipfile.ZipFile(path, "r") as zf:
+        for info in zf.infolist():
+            name = sanitize_name(info.filename)
+            if not name or name in seen:
+                continue
+            seen.add(name)
+            cleaned.append((name, info))
+    return cleaned
+
+
+def fix_zip(src: str, dst: str) -> list:
+    """Reescreve o ZIP de entrada com nomes sanitizados (UTF-8) em um novo ZIP."""
+    if os.path.abspath(src) == os.path.abspath(dst):
+        raise ValueError("src and dst must differ")
+    results = []
+    with zipfile.ZipFile(src, "r") as zin, \
+         zipfile.ZipFile(dst, "w", zipfile.ZIP_DEFLATED) as zout:
+        for name, info in _clean_entries(src):
+            new_info = zipfile.ZipInfo(filename=name, date_time=info.date_time)
+            new_info.compress_type = info.compress_type
+            new_info.external_attr = info.external_attr
+            new_info.create_system = info.create_system
+            zout.writestr(new_info, zin.read(info))
+            results.append((info.filename, name))
+    return results
+
+
+def extract_zip(src: str, dest: str) -> int:
+    """Extrai um ZIP para o diretório, com nomes sanitizados."""
+    os.makedirs(dest, exist_ok=True)
+    count = 0
+    with zipfile.ZipFile(src, "r") as zf:
+        for name, info in _clean_entries(src):
+            target = os.path.join(dest, *name.split("/"))
+            if info.filename.endswith("/"):
+                os.makedirs(target, exist_ok=True)
+                continue
+            os.makedirs(os.path.dirname(target) or dest, exist_ok=True)
+            with zf.open(info) as srcf, open(target, "wb") as f:
+                shutil.copyfileobj(srcf, f)
+            count += 1
+    return count