deepflow-opendesk-cli 0.1.0__py3-none-any.whl

deepflow_opendesk_cli/__init__.py

@@ -0,0 +1,3 @@
+"""OpenDesk admin configuration API CLI."""
+
+__version__ = "0.1.0"

deepflow_opendesk_cli/__main__.py

@@ -0,0 +1,7 @@
+"""Module entrypoint for ``python -m deepflow_opendesk_cli``."""
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

deepflow_opendesk_cli/batch.py

@@ -0,0 +1,53 @@
+"""JSONL batch helpers for OpenDesk CLI."""
+
+from __future__ import annotations
+
+import json
+from collections.abc import Callable
+from pathlib import Path
+from typing import Any
+
+from .client import CliError, HttpResult
+
+OperationRunner = Callable[[dict[str, Any]], HttpResult]
+
+
+def load_jsonl(path: str | Path) -> list[dict[str, Any]]:
+    """Load batch operations from a JSONL file."""
+    operations: list[dict[str, Any]] = []
+    for lineno, raw in enumerate(Path(path).read_text(encoding="utf-8").splitlines(), start=1):
+        line = raw.strip()
+        if not line or line.startswith("#"):
+            continue
+        try:
+            payload = json.loads(line)
+        except json.JSONDecodeError as exc:
+            raise CliError(f"Invalid JSONL at line {lineno}: {exc.msg}") from exc
+        if not isinstance(payload, dict):
+            raise CliError(f"Batch line {lineno} must be a JSON object")
+        operations.append(payload)
+    return operations
+
+
+def run_batch(
+    operations: list[dict[str, Any]],
+    runner: OperationRunner,
+    *,
+    continue_on_error: bool = False,
+) -> list[dict[str, Any]]:
+    """Run operations through a callback and return structured line results."""
+    results: list[dict[str, Any]] = []
+    for index, operation in enumerate(operations, start=1):
+        try:
+            result = runner(operation)
+            item = {"index": index, **result.to_dict()}
+        except Exception as exc:  # noqa: BLE001 - batch output should capture user-facing failures.
+            item = {"index": index, "ok": False, "error": str(exc), "operation": operation}
+            results.append(item)
+            if not continue_on_error:
+                break
+            continue
+        results.append(item)
+        if not result.ok and not continue_on_error:
+            break
+    return results