refactor: rename project from Freepik to Magnific

Rename all identifiers, strings, file names, env vars, CLI entry point, ASCII banner, and API endpoint to reflect the company rebrand. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-16 13:06:16 +02:00
parent e013db9065
commit 941fd14ccf
24 changed files with 294 additions and 294 deletions
@@ -0,0 +1,97 @@
+"""describe-image command."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Annotated, Optional
+
+import typer
+
+from magnific_cli.api.client import MagnificAPIError, MagnificClient
+from magnific_cli.api.images import ImageAPI
+from magnific_cli.utils.config import MagnificConfig
+from magnific_cli.utils.console import console, print_describe_result, print_error, print_no_wait
+from magnific_cli.utils.files import image_to_base64
+from magnific_cli.utils.polling import MagnificTaskError, MagnificTimeoutError, PollConfig, poll_task
+
+
+def _get_api_key(api_key: Optional[str], config: MagnificConfig) -> str:
+    key = api_key or config.api_key
+    if not key:
+        print_error("No API key found.", hint="Set [cyan]MAGNIFIC_API_KEY[/cyan] or pass [cyan]--api-key[/cyan].")
+        raise typer.Exit(1)
+    return key
+
+
+def describe_image(
+    image: Annotated[
+        Path,
+        typer.Argument(
+            help="Image to analyze and describe",
+            exists=True, file_okay=True, dir_okay=False,
+        ),
+    ],
+    output: Annotated[
+        Optional[Path],
+        typer.Option("--output", "-o", help="Save the generated prompt to a text file"),
+    ] = None,
+    wait: Annotated[
+        bool,
+        typer.Option("--wait/--no-wait"),
+    ] = True,
+    api_key: Annotated[
+        Optional[str],
+        typer.Option("--api-key", envvar="MAGNIFIC_API_KEY"),
+    ] = None,
+) -> None:
+    """
+    [bold]Describe an image[/bold] and generate a text prompt for it.
+
+    Reverse-engineers the image into an AI-ready prompt you can use with
+    [cyan]generate-image[/cyan].
+
+    [dim]Examples:[/dim]
+      magnific describe-image photo.jpg
+      magnific describe-image scene.png --output prompt.txt
+    """
+    config = MagnificConfig.load()
+    key = _get_api_key(api_key, config)
+    image_b64 = image_to_base64(image)
+
+    with MagnificClient(key, base_url=config.base_url) as client:
+        api = ImageAPI(client)
+
+        with console.status("[info]Submitting image analysis…[/info]"):
+            try:
+                task_id = api.describe_submit(image_b64)
+            except MagnificAPIError as exc:
+                print_error(str(exc))
+                raise typer.Exit(1)
+
+        if not wait:
+            print_no_wait(task_id, "describe-image", "image-to-prompt")
+            return
+
+        poll_config = PollConfig(task_type="describe", max_wait=config.poll_timeout)
+        try:
+            result = poll_task(
+                check_fn=lambda tid: api.describe_status(tid),
+                task_id=task_id,
+                config=poll_config,
+                console=console,
+            )
+        except (MagnificTaskError, MagnificTimeoutError) as exc:
+            print_error(str(exc))
+            raise typer.Exit(1)
+
+        prompt_text = api.get_prompt_text(result)
+        if not prompt_text:
+            print_error("Analysis completed but no prompt text found.")
+            raise typer.Exit(1)
+
+        saved_path: Optional[Path] = None
+        if output:
+            output.write_text(prompt_text, encoding="utf-8")
+            saved_path = output
+
+        print_describe_result(task_id, prompt_text, saved_path)