xmemcli 0.0.1__py3-none-any.whl

xmemcli/__init__.py

@@ -0,0 +1,3 @@
+"""Standalone xmemcli package (``xmemcli`` console script)."""
+
+__version__ = "0.0.1"

xmemcli/_envelope.py

@@ -0,0 +1,24 @@
+"""Batch API envelope helpers shared by stdlib-only CLI modules.
+
+The HTTP API returns ``{"items": [...], "errors": [...]}`` on success paths too.
+Callers must reject a non-empty ``errors`` array before reading ``items``.
+"""
+
+from typing import Any
+
+
+def batch_envelope_error(envelope: Any) -> str | None:
+    """Return the first API error message when the batch ``errors`` array is non-empty."""
+    if not isinstance(envelope, dict):
+        return "API returned non-object envelope"
+    errors = envelope.get("errors")
+    if not isinstance(errors, list) or not errors:
+        return None
+    first = errors[0]
+    if not isinstance(first, dict):
+        return "API error"
+    message = first.get("message")
+    if isinstance(message, str) and message:
+        return message
+    code = first.get("code")
+    return str(code) if code else "API error"