everypixel-cli 0.1.0__py3-none-any.whl

everypixel_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

everypixel_cli/__main__.py

@@ -0,0 +1,5 @@
+from .cli import app
+
+
+if __name__ == "__main__":
+    app()

everypixel_cli/application/__init__.py

@@ -0,0 +1,10 @@
+"""CLI-independent application services for Everypixel operations."""
+
+from .models import ExecutionOptions, OperationResult
+from .services import ApplicationServices
+
+__all__ = [
+    "ApplicationServices",
+    "ExecutionOptions",
+    "OperationResult",
+]

everypixel_cli/application/models.py

@@ -0,0 +1,59 @@
+"""Typed request and result models used independently from the CLI."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from pathlib import Path
+from threading import Event
+from typing import Any, Mapping
+
+
+class OperationCancelled(Exception):
+    """Internal control flow raised when a caller abandons an operation."""
+
+
+@dataclass(frozen=True)
+class ExecutionOptions:
+    """Execution concerns shared by synchronous and asynchronous operations."""
+
+    wait: bool = False
+    download_directory: Path | None = None
+    timeout: float = 300.0
+    poll_interval: float = 2.0
+    cancel_event: Event | None = field(
+        default=None,
+        repr=False,
+        compare=False,
+    )
+
+    @property
+    def wait_for_result(self) -> bool:
+        """Downloads always require a completed task."""
+
+        return self.wait or self.download_directory is not None
+
+    def check_cancelled(self) -> None:
+        """Raise when the caller no longer wants this operation to continue."""
+
+        if self.cancel_event is not None and self.cancel_event.is_set():
+            raise OperationCancelled
+
+
+@dataclass(frozen=True)
+class OperationRequest:
+    """Transport-independent API operation request."""
+
+    endpoint: str
+    payload: Mapping[str, Any]
+    method: str = "POST"
+    execution: ExecutionOptions = ExecutionOptions()
+    fallback_extension: str = ".bin"
+
+
+@dataclass(frozen=True)
+class OperationResult:
+    """Application result that contains no presentation or HTTP objects."""
+
+    value: Any
+    task: Mapping[str, Any] | None = None
+    saved_files: tuple[Path, ...] = ()

everypixel_cli/application/serialization.py

@@ -0,0 +1,20 @@
+"""Convert application results into the public CLI/MCP-safe data contract."""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+from .models import OperationResult
+
+
+def serialize_operation_result(result: OperationResult) -> Any:
+    """Preserve the existing CLI success payload shape."""
+
+    value = result.value
+    if isinstance(value, Mapping):
+        payload = dict(value)
+        if result.saved_files:
+            payload["downloaded"] = [str(path) for path in result.saved_files]
+        return payload
+    return value