tigrbl-ops-realtime 0.1.10.dev1__tar.gz

tigrbl_ops_realtime-0.1.10.dev1/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: tigrbl-ops-realtime
+Version: 0.1.10.dev1
+Summary: Realtime, stream, and datagram operation implementations for Tigrbl.
+License-Expression: Apache-2.0
+Keywords: tigrbl,sdk,standards,framework,realtime,stream
+Author: Jacob Stewart
+Author-email: jacob@swarmauri.com
+Requires-Python: >=3.10,<3.14
+Classifier: Development Status :: 1 - Planning
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Description-Content-Type: text/markdown
+
+# tigrbl-ops-realtime
+
+Builtin realtime, stream, transfer, and datagram verbs for the next-target Tigrbl surface.
+## Canonical documentation
+
+This file is a package-local distribution entry point. Authoritative workspace guidance lives in:
+
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+
+

tigrbl_ops_realtime-0.1.10.dev1/README.md

@@ -0,0 +1,15 @@
+# tigrbl-ops-realtime
+
+Builtin realtime, stream, transfer, and datagram verbs for the next-target Tigrbl surface.
+## Canonical documentation
+
+This file is a package-local distribution entry point. Authoritative workspace guidance lives in:
+
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+

tigrbl_ops_realtime-0.1.10.dev1/pyproject.toml

@@ -0,0 +1,35 @@
+[project]
+name = "tigrbl-ops-realtime"
+version = "0.1.10.dev1"
+description = "Realtime, stream, and datagram operation implementations for Tigrbl."
+license = "Apache-2.0"
+readme = "README.md"
+repository = "http://github.com/swarmauri/swarmauri-sdk"
+requires-python = ">=3.10,<3.14"
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+]
+authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
+keywords = ["tigrbl", "sdk", "standards", "framework", "realtime", "stream"]
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+packages = [
+    { include = "tigrbl_ops_realtime" },
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "ruff>=0.9",
+]

tigrbl_ops_realtime-0.1.10.dev1/tigrbl_ops_realtime/__init__.py

@@ -0,0 +1,23 @@
+"""Realtime operation implementations for Tigrbl."""
+
+from .ops import (
+    append_chunk,
+    checkpoint,
+    download,
+    publish,
+    send_datagram,
+    subscribe,
+    tail,
+    upload,
+)
+
+__all__ = [
+    "publish",
+    "subscribe",
+    "tail",
+    "upload",
+    "download",
+    "append_chunk",
+    "send_datagram",
+    "checkpoint",
+]

tigrbl_ops_realtime-0.1.10.dev1/tigrbl_ops_realtime/ops.py

@@ -0,0 +1,63 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Mapping
+
+
+def _body(payload: Any) -> Mapping[str, Any]:
+    if not isinstance(payload, Mapping):
+        raise TypeError("Realtime operations require mapping payloads")
+    return payload
+
+
+async def publish(payload: Any) -> Dict[str, Any]:
+    body = _body(payload)
+    channel = str(body.get("channel", "default"))
+    event = body.get("event")
+    return {"published": True, "channel": channel, "event": event}
+
+
+async def subscribe(payload: Any) -> Dict[str, Any]:
+    body = _body(payload)
+    channel = str(body.get("channel", "default"))
+    cursor = body.get("cursor")
+    return {"subscribed": True, "channel": channel, "cursor": cursor}
+
+
+async def tail(payload: Any) -> Dict[str, Any]:
+    body = _body(payload)
+    stream = str(body.get("stream", body.get("channel", "default")))
+    limit = int(body.get("limit", 50))
+    return {"stream": stream, "limit": limit, "tailed": True}
+
+
+async def upload(payload: Any) -> Dict[str, Any]:
+    body = _body(payload)
+    name = str(body.get("name", "blob"))
+    size = len(body.get("content", b"")) if isinstance(body.get("content"), (bytes, bytearray)) else body.get("size")
+    return {"uploaded": True, "name": name, "size": size}
+
+
+async def download(payload: Any) -> Dict[str, Any]:
+    body = _body(payload)
+    name = str(body.get("name", "blob"))
+    return {"downloaded": True, "name": name, "checkpoint": body.get("checkpoint")}
+
+
+async def append_chunk(payload: Any) -> Dict[str, Any]:
+    body = _body(payload)
+    stream = str(body.get("stream", "default"))
+    chunk = body.get("chunk", b"")
+    size = len(chunk) if isinstance(chunk, (bytes, bytearray, str)) else None
+    return {"appended": True, "stream": stream, "size": size}
+
+
+async def send_datagram(payload: Any) -> Dict[str, Any]:
+    body = _body(payload)
+    route = str(body.get("route", body.get("channel", "default")))
+    return {"sent": True, "route": route, "ttl": body.get("ttl")}
+
+
+async def checkpoint(payload: Any) -> Dict[str, Any]:
+    body = _body(payload)
+    cursor = body.get("cursor") or body.get("offset") or body.get("sequence")
+    return {"checkpointed": True, "cursor": cursor}