zipfixx 0.1.0__py3-none-any.whl

zipfixx-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,10 @@
+zipfixx-0.1.0.dist-info/licenses/LICENSE,sha256=-0LgJTg5ItbQUt96iJXvhM1AWd8vXhX14GZG5SaNp8E,1065
+zipflix/__init__.py,sha256=is-P7gkWJVZhBD29AkOdwDekX4hjCk-Ntl01GFM9bc0,113
+zipflix/__main__.py,sha256=Q5bWlxC9W0jbNlN4ITQJzwOJvbhpjhyQS8XWRTb6GNo,86
+zipflix/cli.py,sha256=ekwPUyqBZR70e4WBJi0rYmuanLo9N4BF6c9DC7-X9-s,1922
+zipflix/fixer.py,sha256=a8bpJid03QuZEyS9ZCm0eH5Ct_OVYGIt6YSxBN0rYXU,2942
+zipfixx-0.1.0.dist-info/METADATA,sha256=nM403gQfKSo4K9i2CyZqcDPmyGxusbajJvVih0oojU4,4199
+zipfixx-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+zipfixx-0.1.0.dist-info/entry_points.txt,sha256=ziBq2maYudE-hDZ7e__QtBl-hEV6P-aAb2dvABDTcvw,44
+zipfixx-0.1.0.dist-info/top_level.txt,sha256=RfMSqKzbGEAMCjbaU8HJKbypUBpgRu-18eIPZJlIXq4,8
+zipfixx-0.1.0.dist-info/RECORD,,

zipfixx-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

zipfixx-0.1.0.dist-info/entry_points.txt

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

zipfixx-0.1.0.dist-info/licenses/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.dist-info/top_level.txt

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

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"

zipflix/__main__.py

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

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())

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