xmemcli 0.0.1__tar.gz

xmemcli-0.0.1/.gitignore

@@ -0,0 +1,4 @@
+.venv/
+__pycache__/
+*.egg-info/
+.dist/

xmemcli-0.0.1/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: xmemcli
+Version: 0.0.1
+Summary: xmemory CLI tool
+Requires-Python: <4,>=3.12
+Description-Content-Type: text/markdown
+
+# xmemcli
+
+Standalone UV-managed CLI for the xmemory HTTP API (stdlib only). PyPI package
+name: **xmemcli**; console command: ``xmemcli``.
+
+This tree is generated by ``scripts/prepare_xmemcli_release.py`` from the
+monorepo ``cli/`` sources. Version: **0.0.1**.
+
+## Quick check
+
+```bash
+uv sync
+uv run xmemcli version
+uv run xmemcli status
+```

xmemcli-0.0.1/README.md

@@ -0,0 +1,15 @@
+# xmemcli
+
+Standalone UV-managed CLI for the xmemory HTTP API (stdlib only). PyPI package
+name: **xmemcli**; console command: ``xmemcli``.
+
+This tree is generated by ``scripts/prepare_xmemcli_release.py`` from the
+monorepo ``cli/`` sources. Version: **0.0.1**.
+
+## Quick check
+
+```bash
+uv sync
+uv run xmemcli version
+uv run xmemcli status
+```

xmemcli-0.0.1/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "xmemcli"
+version = "0.0.1"
+description = "xmemory CLI tool"
+readme = "README.md"
+requires-python = ">=3.12,<4"
+dependencies = []
+
+[project.scripts]
+xmemcli = "xmemcli.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["xmemcli"]
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests"]

xmemcli-0.0.1/uv.lock

@@ -0,0 +1,8 @@
+version = 1
+revision = 3
+requires-python = ">=3.12, <4"
+
+[[package]]
+name = "xmemcli"
+version = "0.0.1"
+source = { editable = "." }

xmemcli-0.0.1/xmemcli/__init__.py

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

xmemcli-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"