pdf-tool-cli 1.1.0__tar.gz → 1.1.1__tar.gz

{pdf_tool_cli-1.1.0 → pdf_tool_cli-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdf-tool-cli
-Version: 1.1.0
+Version: 1.1.1
 Summary: Herramientas PDF (unir, dividir, comprimir, proteger…) como CLI para agentes y app de escritorio.
 License: MIT
 License-File: LICENSE
@@ -31,9 +31,10 @@ Description-Content-Type: text/markdown
 
 # 📄 PDF Tool
 
-**Una app de escritorio sencilla para trabajar con tus PDFs — sin subir nada a internet.**
+**Herramientas para tus PDFs — sin subir nada a internet. Como app de escritorio
+o como comando para agentes de IA y scripts.**
 
-<img width="980" height="680" alt="Screenshot 2026-06-15 at 6 54 49 PM" src="https://github.com/user-attachments/assets/adf416d8-bb05-478d-8a6d-31a35410af28" />
+<img width="980" alt="pdf-tool: pantalla de inicio con las seis herramientas" src="https://raw.githubusercontent.com/juanMaAV92/pdf-tool/main/docs/screenshot.png" />
 
 Comprime, une, divide, protege y marca tus documentos —y conviértelos desde imágenes—
 desde tu propio ordenador. Gratis, de código abierto y sin anuncios.
@@ -42,15 +43,12 @@ desde tu propio ordenador. Gratis, de código abierto y sin anuncios.
 
 [![CI](https://github.com/juanMaAV92/pdf-tool/actions/workflows/ci.yml/badge.svg)](https://github.com/juanMaAV92/pdf-tool/actions/workflows/ci.yml)
 [![Release](https://img.shields.io/github/v/release/juanMaAV92/pdf-tool?label=versión)](https://github.com/juanMaAV92/pdf-tool/releases/latest)
-[![License: MIT](https://img.shields.io/badge/Licencia-MIT-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/pdf-tool-cli?label=PyPI)](https://pypi.org/project/pdf-tool-cli/)
+[![License: MIT](https://img.shields.io/badge/Licencia-MIT-blue.svg)](https://github.com/juanMaAV92/pdf-tool/blob/main/LICENSE)
 ![Platform](https://img.shields.io/badge/macOS_·_Windows-lightgrey)
 
 </div>
 
-<!-- 📸 Añade aquí un screenshot o GIF de la app:
-     ![PDF Tool](docs/screenshot.png)
-     Es lo que más convence a quien entra al repo. -->
-
 ---
 
 ## ✨ Qué puedes hacer
@@ -66,9 +64,10 @@ desde tu propio ordenador. Gratis, de código abierto y sin anuncios.
 
 > 🔐 **Todo ocurre en tu equipo.** Tus archivos nunca salen de tu ordenador.
 
-En **Comprimir PDF**, el modo predeterminado busca la reducción máxima. También
-puedes elegir **Conservar texto y enlaces** desde el selector de modo; el icono
-de ayuda explica la diferencia.
+En **Comprimir PDF**, el modo predeterminado busca la reducción máxima: primero
+reduce las imágenes y, solo si no basta, convierte páginas en imagen (lo avisa,
+porque se pierde el texto seleccionable). Con **Conservar texto y enlaces** nunca
+lo hace; el icono de ayuda explica la diferencia.
 
 ---
 
@@ -112,14 +111,26 @@ Cada herramienta tiene su ayuda (`pdf-tool compress --help`). Códigos de salida
 `0` ok · `1` error al procesar · `2` uso inválido · `3` algún archivo del lote falló.
 `pipx install 'pdf-tool-cli[gui]'` instala además la app (comando `pdftool`).
 
+### Plugin para Claude Code
+
+Una [skill](https://github.com/juanMaAV92/pdf-tool/blob/main/skills/pdf-tool/SKILL.md)
+le enseña a Claude Code a usar `pdf-tool` para crear o modificar PDFs en lugar de
+escribir scripts: pide permiso antes de instalar la CLI, ejecuta las herramientas
+con `--json` y te explica el resultado. Para instalarla, dentro de Claude Code:
+
+```text
+/plugin marketplace add juanMaAV92/pdf-tool
+/plugin install pdf-tool@pdf-tool
+```
+
 ---
 
 ## 🤝 Contribuir
 
 ¡Las contribuciones son bienvenidas! Puedes abrir un *issue* con ideas o errores,
 o mandar un *pull request*. La arquitectura es modular: añadir una herramienta nueva
-es crear una carpeta y la app la descubre sola. En el [roadmap](docs/roadmap.md)
-está lo que viene: una CLI para agentes de IA, a la par con la app.
+es crear una carpeta y la app y la CLI la descubren solas. En el [roadmap](https://github.com/juanMaAV92/pdf-tool/blob/main/docs/roadmap.md)
+está lo que viene: una skill para que los agentes de IA usen la CLI.
 
 <details>
 <summary><b>🛠️ Para desarrolladores (montar el proyecto en local)</b></summary>
@@ -141,39 +152,43 @@ poetry run pytest         # corre los tests
    las dos automáticamente.
 
 La **lógica** (`logic.py`) no importa Flet y se prueba sin UI; la **UI** (`panel.py`)
-solo arma controles. Detalles en [AGENTS.md](AGENTS.md).
+solo arma controles. Detalles en [AGENTS.md](https://github.com/juanMaAV92/pdf-tool/blob/main/AGENTS.md).
 
 ### Publicar una versión (automatizado con GitHub Actions)
 ```bash
-git tag v0.2.0
-git push origin v0.2.0
+git tag vX.Y.Z
+git push origin vX.Y.Z
 ```
 Eso dispara `release.yml`, que corre los tests, construye macOS (`.dmg`) y Windows
 (instalador Inno Setup) en paralelo, hornea la versión del tag en el build y crea
 un **GitHub Release en borrador** con ambos instaladores. Revísalo y pulsa
 **Publish release** para que las apps instaladas detecten la actualización.
 Si los instaladores se construyen bien, publica también el paquete en **PyPI**
-(Trusted Publishing, entorno `pypi` de GitHub; sin tokens).
+(`pdf-tool-cli`, por Trusted Publishing y sin tokens). Ese paso espera a que lo
+apruebes en Actions (entorno `pypi`), porque una versión en PyPI no se puede
+reemplazar.
 
 Los PRs que cambian la app, el empaquetado o sus dependencias ejecutan además
 **Package smoke**: construye e inspecciona el DMG de macOS y compila e instala de
 forma silenciosa el instalador de Windows. Antes de una release importante,
-seguir la [checklist manual](docs/release-smoke.md) para validar la ventana y los
+seguir la [checklist manual](https://github.com/juanMaAV92/pdf-tool/blob/main/docs/release-smoke.md) para validar la ventana y los
 diálogos nativos.
 
 El número de versión es **el tag** — única fuente de verdad.
 
 ### Build local (para depurar el empaquetado)
 ```bash
-poetry run flet build macos      # -> build/macos/pdf-tool.app
-poetry run flet build windows    # -> build/windows/
+poetry run flet build macos --project pdf-tool --product pdf-tool     # -> build/macos/pdf-tool.app
+poetry run flet build windows --project pdf-tool --product pdf-tool   # -> build/windows/
 ```
+`--project pdf-tool` es obligatorio: sin él, `flet build` toma el nombre del
+paquete (`pdf-tool-cli`) y la app cambia de identidad.
 
 </details>
 
 ---
 
 <div align="center">
-<sub>Hecho con 🐍 Python + <a href="https://flet.dev">Flet</a> · Licencia <a href="LICENSE">MIT</a></sub>
+<sub>Hecho con 🐍 Python + <a href="https://flet.dev">Flet</a> · Licencia <a href="https://github.com/juanMaAV92/pdf-tool/blob/main/LICENSE">MIT</a></sub>
 </div>
 

{pdf_tool_cli-1.1.0 → pdf_tool_cli-1.1.1}/README.md

@@ -2,9 +2,10 @@
 
 # 📄 PDF Tool
 
-**Una app de escritorio sencilla para trabajar con tus PDFs — sin subir nada a internet.**
+**Herramientas para tus PDFs — sin subir nada a internet. Como app de escritorio
+o como comando para agentes de IA y scripts.**
 
-<img width="980" height="680" alt="Screenshot 2026-06-15 at 6 54 49 PM" src="https://github.com/user-attachments/assets/adf416d8-bb05-478d-8a6d-31a35410af28" />
+<img width="980" alt="pdf-tool: pantalla de inicio con las seis herramientas" src="https://raw.githubusercontent.com/juanMaAV92/pdf-tool/main/docs/screenshot.png" />
 
 Comprime, une, divide, protege y marca tus documentos —y conviértelos desde imágenes—
 desde tu propio ordenador. Gratis, de código abierto y sin anuncios.
@@ -13,15 +14,12 @@ desde tu propio ordenador. Gratis, de código abierto y sin anuncios.
 
 [![CI](https://github.com/juanMaAV92/pdf-tool/actions/workflows/ci.yml/badge.svg)](https://github.com/juanMaAV92/pdf-tool/actions/workflows/ci.yml)
 [![Release](https://img.shields.io/github/v/release/juanMaAV92/pdf-tool?label=versión)](https://github.com/juanMaAV92/pdf-tool/releases/latest)
-[![License: MIT](https://img.shields.io/badge/Licencia-MIT-blue.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/pdf-tool-cli?label=PyPI)](https://pypi.org/project/pdf-tool-cli/)
+[![License: MIT](https://img.shields.io/badge/Licencia-MIT-blue.svg)](https://github.com/juanMaAV92/pdf-tool/blob/main/LICENSE)
 ![Platform](https://img.shields.io/badge/macOS_·_Windows-lightgrey)
 
 </div>
 
-<!-- 📸 Añade aquí un screenshot o GIF de la app:
-     ![PDF Tool](docs/screenshot.png)
-     Es lo que más convence a quien entra al repo. -->
-
 ---
 
 ## ✨ Qué puedes hacer
@@ -37,9 +35,10 @@ desde tu propio ordenador. Gratis, de código abierto y sin anuncios.
 
 > 🔐 **Todo ocurre en tu equipo.** Tus archivos nunca salen de tu ordenador.
 
-En **Comprimir PDF**, el modo predeterminado busca la reducción máxima. También
-puedes elegir **Conservar texto y enlaces** desde el selector de modo; el icono
-de ayuda explica la diferencia.
+En **Comprimir PDF**, el modo predeterminado busca la reducción máxima: primero
+reduce las imágenes y, solo si no basta, convierte páginas en imagen (lo avisa,
+porque se pierde el texto seleccionable). Con **Conservar texto y enlaces** nunca
+lo hace; el icono de ayuda explica la diferencia.
 
 ---
 
@@ -83,14 +82,26 @@ Cada herramienta tiene su ayuda (`pdf-tool compress --help`). Códigos de salida
 `0` ok · `1` error al procesar · `2` uso inválido · `3` algún archivo del lote falló.
 `pipx install 'pdf-tool-cli[gui]'` instala además la app (comando `pdftool`).
 
+### Plugin para Claude Code
+
+Una [skill](https://github.com/juanMaAV92/pdf-tool/blob/main/skills/pdf-tool/SKILL.md)
+le enseña a Claude Code a usar `pdf-tool` para crear o modificar PDFs en lugar de
+escribir scripts: pide permiso antes de instalar la CLI, ejecuta las herramientas
+con `--json` y te explica el resultado. Para instalarla, dentro de Claude Code:
+
+```text
+/plugin marketplace add juanMaAV92/pdf-tool
+/plugin install pdf-tool@pdf-tool
+```
+
 ---
 
 ## 🤝 Contribuir
 
 ¡Las contribuciones son bienvenidas! Puedes abrir un *issue* con ideas o errores,
 o mandar un *pull request*. La arquitectura es modular: añadir una herramienta nueva
-es crear una carpeta y la app la descubre sola. En el [roadmap](docs/roadmap.md)
-está lo que viene: una CLI para agentes de IA, a la par con la app.
+es crear una carpeta y la app y la CLI la descubren solas. En el [roadmap](https://github.com/juanMaAV92/pdf-tool/blob/main/docs/roadmap.md)
+está lo que viene: una skill para que los agentes de IA usen la CLI.
 
 <details>
 <summary><b>🛠️ Para desarrolladores (montar el proyecto en local)</b></summary>
@@ -112,38 +123,42 @@ poetry run pytest         # corre los tests
    las dos automáticamente.
 
 La **lógica** (`logic.py`) no importa Flet y se prueba sin UI; la **UI** (`panel.py`)
-solo arma controles. Detalles en [AGENTS.md](AGENTS.md).
+solo arma controles. Detalles en [AGENTS.md](https://github.com/juanMaAV92/pdf-tool/blob/main/AGENTS.md).
 
 ### Publicar una versión (automatizado con GitHub Actions)
 ```bash
-git tag v0.2.0
-git push origin v0.2.0
+git tag vX.Y.Z
+git push origin vX.Y.Z
 ```
 Eso dispara `release.yml`, que corre los tests, construye macOS (`.dmg`) y Windows
 (instalador Inno Setup) en paralelo, hornea la versión del tag en el build y crea
 un **GitHub Release en borrador** con ambos instaladores. Revísalo y pulsa
 **Publish release** para que las apps instaladas detecten la actualización.
 Si los instaladores se construyen bien, publica también el paquete en **PyPI**
-(Trusted Publishing, entorno `pypi` de GitHub; sin tokens).
+(`pdf-tool-cli`, por Trusted Publishing y sin tokens). Ese paso espera a que lo
+apruebes en Actions (entorno `pypi`), porque una versión en PyPI no se puede
+reemplazar.
 
 Los PRs que cambian la app, el empaquetado o sus dependencias ejecutan además
 **Package smoke**: construye e inspecciona el DMG de macOS y compila e instala de
 forma silenciosa el instalador de Windows. Antes de una release importante,
-seguir la [checklist manual](docs/release-smoke.md) para validar la ventana y los
+seguir la [checklist manual](https://github.com/juanMaAV92/pdf-tool/blob/main/docs/release-smoke.md) para validar la ventana y los
 diálogos nativos.
 
 El número de versión es **el tag** — única fuente de verdad.
 
 ### Build local (para depurar el empaquetado)
 ```bash
-poetry run flet build macos      # -> build/macos/pdf-tool.app
-poetry run flet build windows    # -> build/windows/
+poetry run flet build macos --project pdf-tool --product pdf-tool     # -> build/macos/pdf-tool.app
+poetry run flet build windows --project pdf-tool --product pdf-tool   # -> build/windows/
 ```
+`--project pdf-tool` es obligatorio: sin él, `flet build` toma el nombre del
+paquete (`pdf-tool-cli`) y la app cambia de identidad.
 
 </details>
 
 ---
 
 <div align="center">
-<sub>Hecho con 🐍 Python + <a href="https://flet.dev">Flet</a> · Licencia <a href="LICENSE">MIT</a></sub>
+<sub>Hecho con 🐍 Python + <a href="https://flet.dev">Flet</a> · Licencia <a href="https://github.com/juanMaAV92/pdf-tool/blob/main/LICENSE">MIT</a></sub>
 </div>

{pdf_tool_cli-1.1.0 → pdf_tool_cli-1.1.1}/pdftool/__init__.py

@@ -1,3 +1,3 @@
 # La versión real la hornea CI desde el tag git al construir el release
 # (ver .github/workflows/release.yml). En desarrollo local queda como dev.
-__version__ = "1.1.0"
+__version__ = "1.1.1"

{pdf_tool_cli-1.1.0 → pdf_tool_cli-1.1.1}/pdftool/tools/compress/logic.py

@@ -232,6 +232,31 @@ def _saved_label(original: float, final: float) -> str:
     return f" · {saved:.0f} % menos" if saved >= 0.5 else ""
 
 
+def _reduce_images(
+    candidates: _Candidates,
+    src: Path,
+    target_mb: float,
+    progress: Progress,
+    span: float,
+) -> bool:
+    """Prueba a recomprimir solo las imágenes. True si alcanzó el objetivo."""
+    n = len(_PRESERVE_ATTEMPTS)
+    for i, attempt in enumerate(_PRESERVE_ATTEMPTS):
+        progress(0.1 + span * i / n, f"Reduciendo imágenes (paso {i + 1} de {n})…")
+        size = candidates.attempt(
+            partial(
+                _preserve_compress,
+                src,
+                dpi_threshold=attempt["dpi_threshold"],
+                dpi_target=attempt["dpi_target"],
+                quality=attempt["quality"],
+            )
+        )
+        if size <= target_mb:
+            return True
+    return False
+
+
 def _compress_one(
     input_path: Path,
     out: Path,
@@ -243,6 +268,9 @@ def _compress_one(
     progress(0.0, f"Tamaño original: {original:.2f} MB")
 
     if original <= target_mb:
+        # Abrirlo antes de copiar: un archivo dañado o que no es PDF debe
+        # fallar aquí, no reportarse como «sin cambios».
+        pymupdf.open(str(input_path)).close()
         atomic_copy(input_path, out)
         progress(1.0, "Ya está bajo el objetivo")
         return _Compressed(
@@ -275,38 +303,30 @@ def _compress_one(
         ):
             return publish()
 
+        # Primero se recomprimen solo las imágenes: conserva texto y enlaces y,
+        # con fotos de mucha resolución, suele dar el archivo más pequeño.
+        span = 0.9 if mode == "preserve" else 0.2
+        if _reduce_images(candidates, input_path, target_mb, progress, span):
+            return publish(" (contenido preservado)")
         if mode == "preserve":
-            n = len(_PRESERVE_ATTEMPTS)
-            for i, attempt in enumerate(_PRESERVE_ATTEMPTS):
-                progress(
-                    0.1 + 0.9 * i / n, f"Reduciendo imágenes (paso {i + 1} de {n})…"
-                )
-                size = candidates.attempt(
-                    partial(
-                        _preserve_compress,
-                        input_path,
-                        dpi_threshold=attempt["dpi_threshold"],
-                        dpi_target=attempt["dpi_target"],
-                        quality=attempt["quality"],
-                    )
-                )
-                if size <= target_mb:
-                    return publish(" (contenido preservado)")
             return publish(
                 " (no se alcanzó el objetivo; se guardó la versión más pequeña "
                 "con el contenido preservado)"
             )
 
+        # `max`: si no bastó, convertir páginas en imagen. Gana el intento más
+        # pequeño de todos, también si fue uno de los anteriores.
+        start = 0.1 + span
         n = len(_ATTEMPTS)
         for i, attempt in enumerate(_ATTEMPTS):
-            base = 0.1 + 0.9 * i / n
+            base = start + (1 - start) * i / n
             step = f"Reduciendo calidad (paso {i + 1} de {n})"
             progress(base, f"{step}…")
 
             def step_progress(
                 pct: float, msg: str, _base: float = base, _step: str = step
             ) -> None:
-                progress(_base + 0.9 / n * pct, f"{_step}: {msg}")
+                progress(_base + (1 - start) / n * pct, f"{_step}: {msg}")
 
             size = candidates.attempt(
                 partial(

{pdf_tool_cli-1.1.0 → pdf_tool_cli-1.1.1}/pyproject.toml

@@ -2,7 +2,7 @@
 # Nombre en PyPI: «pdf-tool» choca con «pdftool» (ya existe). El comando sigue
 # siendo `pdf-tool` y la app conserva su identidad con `flet build --project`.
 name = "pdf-tool-cli"
-version = "1.1.0"
+version = "1.1.1"
 description = "Herramientas PDF (unir, dividir, comprimir, proteger…) como CLI para agentes y app de escritorio."
 authors = ["Juan Manuel Armero <juanmanuel.armero@gmail.com>"]
 license = "MIT"
@@ -35,7 +35,7 @@ gui = ["flet"]
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^9.0.3"
-ruff = "^0.16.8"
+ruff = ">=0.16.8,<0.18.0"
 mypy = "^2.3.1"
 pytest-cov = "^7.1.0"
 # flet lo instala solo al primer `flet build`; declararlo deja el entorno