makea-cli 0.2.27__py3-none-any.whl → 0.2.28__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.27"
+__version__ = "0.2.28"

makea_cli/commands/__init__.py

@@ -11,6 +11,7 @@ from makea_cli.commands.directory.cmd import register as register_directory
 from makea_cli.commands.document.cmd import register as register_document
 from makea_cli.commands.email.cmd import register as register_email
 from makea_cli.commands.factory.cmd import register as register_factory
+from makea_cli.commands.files.cmd import register as register_files
 from makea_cli.commands.flags.cmd import register as register_flags
 from makea_cli.commands.library.cmd import register as register_library
 from makea_cli.commands.metrics.cmd import register as register_metrics
@@ -38,6 +39,7 @@ def register_all(app: typer.Typer) -> None:
     register_email(app)
     register_library(app)
     register_factory(app)
+    register_files(app)
     register_brand(app)
     register_playbook(app)
     register_about(app)

makea_cli/commands/files/cmd.py

@@ -0,0 +1,84 @@
+"""``makea-cli <persona> get file PATH``: read a file a brand sent, locally.
+
+Pattern DXF/RUL, Illustrator, EPS, Photoshop, embroidery (PES/DST/EMB), ZIP,
+AVIF/TIFF/SVG. No API call: the file never leaves the machine. Pictures of what
+the file draws are saved next to it so the caller can look at them (an agent
+reads them with its image tool).
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import typer
+from rich.console import Console
+
+from makea_cli.commands._util import print_json_or_exit
+from makea_cli.file_reader import read_path
+from makea_cli.registry import command
+
+console = Console()
+
+_HELP = (
+    "Read a pattern (DXF/RUL), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or "
+    "AVIF/TIFF file on this machine: what it states plus PNG pictures of what it draws."
+)
+
+
+def _slug(text: str) -> str:
+    return re.sub(r"[^A-Za-z0-9]+", "-", text).strip("-").lower()[:40] or "picture"
+
+
+def read_file_payload(path: Path, pictures_dir: Path | None) -> dict:
+    if not path.is_file():
+        raise FileNotFoundError(f"{path} is not a file")
+    reading = read_path(str(path))
+    out_dir = pictures_dir or path.parent
+    saved = []
+    pictures = reading.all_pictures()
+    if pictures:
+        out_dir.mkdir(parents=True, exist_ok=True)
+    for i, pic in enumerate(pictures, 1):
+        target = out_dir / f"{path.stem}.{i}-{_slug(pic.label)}.png"
+        target.write_bytes(pic.png)
+        saved.append({"label": pic.label, "path": str(target)})
+    payload = {
+        "file": str(path),
+        "kind": reading.kind,
+        "format": reading.format,
+        "readable": reading.readable,
+        "readout": reading.markdown(),
+        "pictures": saved,
+    }
+    if saved:
+        payload["next"] = (
+            "Look at each picture to read what it shows; the readout lists only stated facts."
+        )
+    return payload
+
+
+def register(app: typer.Typer) -> None:
+    for persona in ("designer", "supplier", "admin"):
+        _register_for(app, persona)
+
+
+def _register_for(app: typer.Typer, persona: str) -> None:
+    @command(
+        app,
+        persona,
+        "get",
+        "file",
+        api="LOCAL file_reader",
+        external="local",
+        help=_HELP,
+    )
+    def get_file(
+        path: Path = typer.Argument(..., help="The file to read."),
+        pictures_dir: Path | None = typer.Option(
+            None,
+            "--pictures-dir",
+            help="Where to save the PNG pictures (default: next to the file).",
+        ),
+    ) -> None:
+        print_json_or_exit(console, lambda: read_file_payload(path, pictures_dir))