airbus-client 0.1.0__tar.gz

airbus_client-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

airbus_client-0.1.0/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.5
+Name: airbus-client
+Version: 0.1.0
+Summary: Python client for the Airbus JSON-RPC event bus
+Project-URL: Homepage, https://github.com/ghhwer/airbus
+Project-URL: Repository, https://github.com/ghhwer/airbus
+Author: Airbus contributors
+License: MIT
+Requires-Python: >=3.13
+Requires-Dist: jsonschema>=4.26.0
+Description-Content-Type: text/markdown
+
+# airbus-client
+
+Python SDK for the [Airbus](https://github.com/ghhwer/airbus) JSON-RPC event bus.
+
+```bash
+pip install airbus-client
+```
+
+```python
+from airbus_client import RpcClient, Queue
+
+client = RpcClient()  # AIRBUS_URL / AIRBUS_HOST:AIRBUS_PORT
+assert client.ping() == "pong"
+```
+
+The daemon is distributed separately (container image or `cargo`/`make build`).
+See the [repository README](https://github.com/ghhwer/airbus) for run instructions.

airbus_client-0.1.0/README.md

@@ -0,0 +1,17 @@
+# airbus-client
+
+Python SDK for the [Airbus](https://github.com/ghhwer/airbus) JSON-RPC event bus.
+
+```bash
+pip install airbus-client
+```
+
+```python
+from airbus_client import RpcClient, Queue
+
+client = RpcClient()  # AIRBUS_URL / AIRBUS_HOST:AIRBUS_PORT
+assert client.ping() == "pong"
+```
+
+The daemon is distributed separately (container image or `cargo`/`make build`).
+See the [repository README](https://github.com/ghhwer/airbus) for run instructions.

airbus_client-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "airbus-client"
+version = "0.1.0"
+description = "Python client for the Airbus JSON-RPC event bus"
+readme = "README.md"
+requires-python = ">=3.13"
+license = { text = "MIT" }
+dependencies = ["jsonschema>=4.26.0"]
+authors = [{ name = "Airbus contributors" }]
+urls = { Homepage = "https://github.com/ghhwer/airbus", Repository = "https://github.com/ghhwer/airbus" }
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/airbus_client"]
+
+[dependency-groups]
+dev = [
+    "datamodel-code-generator==0.78.0",
+    "pytest>=9.1.1",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

airbus_client-0.1.0/src/airbus_client/__init__.py

@@ -0,0 +1,34 @@
+"""Public airbus_client API.
+
+Import from this package root for application use. Wire ``*Params`` / ``*Result``
+types live under ``airbus_client.payloads`` for raw RPC. ``protocol``, ``contracts``,
+``binary``, and ``endpoint`` are operational internals.
+
+Endpoint defaults: ``AIRBUS_URL`` or ``AIRBUS_HOST``/``AIRBUS_PORT`` (else
+``127.0.0.1:9097``). ``RpcClient()`` and ``Queue(name)`` use that resolution;
+pass ``client=`` for ephemeral test servers.
+"""
+
+from airbus_client.binary import run_airbus
+from airbus_client.payloads import (
+    DispatchStrategy,
+    DuplexSide,
+    ListenerEventParams,
+    QueueMode,
+)
+from airbus_client.queue import Queue
+from airbus_client.rpc import EventListener, RpcClient, RpcError
+from airbus_client.server import start_server
+
+__all__ = [
+    "DispatchStrategy",
+    "DuplexSide",
+    "EventListener",
+    "ListenerEventParams",
+    "Queue",
+    "QueueMode",
+    "RpcClient",
+    "RpcError",
+    "run_airbus",
+    "start_server",
+]

airbus_client-0.1.0/src/airbus_client/__main__.py

@@ -0,0 +1,10 @@
+from airbus_client.server import start_server
+
+
+def main() -> None:
+    with start_server("127.0.0.1:0") as rpc:
+        print(rpc.ping())
+
+
+if __name__ == "__main__":
+    main()

airbus_client-0.1.0/src/airbus_client/binary.py

@@ -0,0 +1,20 @@
+import os
+import subprocess
+from pathlib import Path
+
+
+def airbus_bin() -> Path:
+    env = os.environ.get("AIRBUS_BIN")
+    if env:
+        return Path(env)
+    return Path(__file__).resolve().parents[3] / "out" / "airbus"
+
+
+def run_airbus(*args: str, input_text: str | None = None) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        [str(airbus_bin()), *args],
+        input=input_text,
+        capture_output=True,
+        text=True,
+        check=True,
+    )

airbus_client-0.1.0/src/airbus_client/contracts.py

@@ -0,0 +1,5 @@
+# @generated by scripts/generate_payloads.py — do not edit by hand.
+import json
+
+SCHEMAS = json.loads('{"add_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "items": {"type": "number"}, "maxItems": 2, "minItems": 2, "title": "AddParams", "type": "array"}, "add_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "title": "AddResult", "type": "number"}, "attach_listener_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"exhaustion_timeout_ms": {"minimum": 0, "type": "integer"}, "host": {"type": "string"}, "max_retries": {"minimum": 0, "type": "integer"}, "port": {"maximum": 65535, "minimum": 1, "type": "integer"}, "queue": {"$ref": "#/$defs/QueueName"}, "side": {"$ref": "#/$defs/DuplexSide", "description": "Listener side for full-duplex queues; required when mode is full-duplex, rejected otherwise"}}, "required": ["queue", "port"], "title": "AttachListenerParams", "type": "object"}, "attach_listener_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"listener_id": {"minLength": 1, "type": "string"}, "queue": {"$ref": "#/$defs/QueueName"}, "status": {"type": "string"}}, "required": ["listener_id", "queue", "status"], "title": "AttachListenerResult", "type": "object"}, "create_queue_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"dispatch_strategy": {"$ref": "#/$defs/DispatchStrategy", "description": "Fifo only; rejected for broadcast and full-duplex. Default when omitted on fifo: round_robin"}, "mode": {"$ref": "#/$defs/QueueMode"}, "queue": {"$ref": "#/$defs/QueueName"}}, "required": ["queue"], "title": "CreateQueueParams", "type": "object"}, "create_queue_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"created": {"type": "boolean"}, "mode": {"$ref": "#/$defs/QueueMode"}, "queue": {"$ref": "#/$defs/QueueName"}}, "required": ["queue", "mode", "created"], "title": "CreateQueueResult", "type": "object"}, "detach_listener_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"listener_id": {"minLength": 1, "type": "string"}}, "required": ["listener_id"], "title": "DetachListenerParams", "type": "object"}, "detach_listener_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"detached": {"type": "boolean"}, "listener_id": {"minLength": 1, "type": "string"}}, "required": ["listener_id", "detached"], "title": "DetachListenerResult", "type": "object"}, "list_listeners_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"queue": {"$ref": "#/$defs/QueueName"}}, "title": "ListListenersParams", "type": "object"}, "list_listeners_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"listeners": {"items": {"additionalProperties": false, "properties": {"active": {"type": "boolean"}, "failure_count": {"minimum": 0, "type": "integer"}, "host": {"type": "string"}, "id": {"minLength": 1, "type": "string"}, "mode": {"$ref": "#/$defs/QueueMode"}, "port": {"maximum": 65535, "minimum": 1, "type": "integer"}, "queue": {"$ref": "#/$defs/QueueName"}, "side": {"$ref": "#/$defs/DuplexSide", "description": "Present for full-duplex listeners"}}, "required": ["id", "queue", "host", "port", "mode", "failure_count", "active"], "type": "object"}, "type": "array"}}, "required": ["listeners"], "title": "ListListenersResult", "type": "object"}, "list_queues_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"queues": {"items": {"$ref": "#/$defs/QueueInfo"}, "type": "array"}}, "required": ["queues"], "title": "ListQueuesResult", "type": "object"}, "listener_event_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"event": {"$ref": "#/$defs/EventObject"}, "id": {"minLength": 1, "type": "string"}, "queue": {"$ref": "#/$defs/QueueName"}}, "required": ["queue", "id", "event"], "title": "ListenerEventParams", "type": "object"}, "listener_event_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"status": {"enum": ["ok"], "type": "string"}}, "required": ["status"], "title": "ListenerEventResult", "type": "object"}, "peek_events_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"count": {"default": 1, "type": "integer"}, "queue": {"$ref": "#/$defs/QueueName"}}, "required": ["queue"], "title": "PeekEventsParams", "type": "object"}, "peek_events_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"events": {"items": {"additionalProperties": false, "properties": {"event": {"$ref": "#/$defs/EventObject"}, "id": {"minLength": 1, "type": "string"}}, "required": ["id", "event"], "type": "object"}, "type": "array"}, "queue": {"$ref": "#/$defs/QueueName"}}, "required": ["queue", "events"], "title": "PeekEventsResult", "type": "object"}, "ping_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "title": "PingResult", "type": "string"}, "post_event_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"event": {"$ref": "#/$defs/EventObject"}, "queue": {"$ref": "#/$defs/QueueName"}, "side": {"$ref": "#/$defs/DuplexSide", "description": "Publisher side for full-duplex queues; required when mode is full-duplex, rejected otherwise"}}, "required": ["queue", "event"], "title": "PostEventParams", "type": "object"}, "post_event_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"id": {"minLength": 1, "type": "string"}, "queue": {"$ref": "#/$defs/QueueName"}}, "required": ["id", "queue"], "title": "PostEventResult", "type": "object"}, "queue_ready_params.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"queue": {"$ref": "#/$defs/QueueName"}}, "required": ["queue"], "title": "QueueReadyParams", "type": "object"}, "queue_ready_result.schema.json": {"$defs": {"DispatchStrategy": {"enum": ["round_robin", "single_node"], "title": "DispatchStrategy", "type": "string"}, "DuplexSide": {"enum": ["host", "device"], "title": "DuplexSide", "type": "string"}, "EventObject": {"additionalProperties": true, "title": "EventObject", "type": "object"}, "QueueInfo": {"additionalProperties": false, "properties": {"depth": {"minimum": 0, "type": "integer"}, "listener_count": {"minimum": 0, "type": "integer"}, "mode": {"$ref": "#/$defs/QueueMode"}, "name": {"$ref": "#/$defs/QueueName"}}, "required": ["name", "depth", "mode", "listener_count"], "title": "QueueInfo", "type": "object"}, "QueueMode": {"enum": ["broadcast", "fifo", "full-duplex"], "title": "QueueMode", "type": "string"}, "QueueName": {"minLength": 1, "title": "QueueName", "type": "string"}}, "additionalProperties": false, "properties": {"queue": {"$ref": "#/$defs/QueueName"}, "ready": {"description": "Mode-aware readiness: exists for fifo/broadcast; both duplex sides attached for full-duplex", "type": "boolean"}}, "required": ["queue", "ready"], "title": "QueueReadyResult", "type": "object"}}')
+METHODS = json.loads('{"add": {"params": "add_params.schema.json", "params_required": true, "receiver": "server", "result": "add_result.schema.json"}, "attach_listener": {"params": "attach_listener_params.schema.json", "params_required": true, "receiver": "server", "result": "attach_listener_result.schema.json"}, "create_queue": {"params": "create_queue_params.schema.json", "params_required": true, "receiver": "server", "result": "create_queue_result.schema.json"}, "detach_listener": {"params": "detach_listener_params.schema.json", "params_required": true, "receiver": "server", "result": "detach_listener_result.schema.json"}, "list_listeners": {"params": "list_listeners_params.schema.json", "params_required": false, "receiver": "server", "result": "list_listeners_result.schema.json"}, "list_queues": {"params": null, "params_required": false, "receiver": "server", "result": "list_queues_result.schema.json"}, "on_event": {"params": "listener_event_params.schema.json", "params_required": true, "receiver": "listener", "result": "listener_event_result.schema.json"}, "peek_events": {"params": "peek_events_params.schema.json", "params_required": true, "receiver": "server", "result": "peek_events_result.schema.json"}, "ping": {"params": null, "params_required": false, "receiver": "server", "result": "ping_result.schema.json"}, "post_event": {"params": "post_event_params.schema.json", "params_required": true, "receiver": "server", "result": "post_event_result.schema.json"}, "queue_ready": {"params": "queue_ready_params.schema.json", "params_required": true, "receiver": "server", "result": "queue_ready_result.schema.json"}}')

airbus_client-0.1.0/src/airbus_client/endpoint.py

@@ -0,0 +1,36 @@
+"""Resolve the Airbus TCP endpoint from the environment.
+
+Precedence: ``AIRBUS_URL`` (``host:port``), else ``AIRBUS_HOST`` / ``AIRBUS_PORT``,
+else ``127.0.0.1:9097``.
+"""
+
+from __future__ import annotations
+
+import os
+
+_DEFAULT_HOST = "127.0.0.1"
+_DEFAULT_PORT = 9097
+
+
+def parse_endpoint(url: str) -> tuple[str, int]:
+    """Parse ``host:port`` into a host/port pair."""
+    host, _, port_s = url.rpartition(":")
+    if not host or not port_s.isdigit():
+        raise ValueError(f"Airbus endpoint must be host:port (got {url!r}); example: 127.0.0.1:9097")
+    return host, int(port_s)
+
+
+def airbus_endpoint() -> tuple[str, int]:
+    """Resolve host/port from ``AIRBUS_URL`` or ``AIRBUS_HOST`` / ``AIRBUS_PORT``."""
+    url = os.environ.get("AIRBUS_URL", "").strip()
+    if url:
+        return parse_endpoint(url)
+    host = os.environ.get("AIRBUS_HOST", _DEFAULT_HOST)
+    port = int(os.environ.get("AIRBUS_PORT", str(_DEFAULT_PORT)))
+    return host, port
+
+
+def airbus_url() -> str:
+    """Return ``host:port`` for the resolved endpoint."""
+    host, port = airbus_endpoint()
+    return f"{host}:{port}"

airbus_client-0.1.0/src/airbus_client/payloads.py

@@ -0,0 +1,164 @@
+# @generated by scripts/generate_payloads.py — do not edit by hand.
+# Source of truth: schema/payloads/*.schema.json
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import StrEnum
+from typing import Any
+
+type PingResult = str
+type AddResult = float
+
+class QueueMode(StrEnum):
+    broadcast = 'broadcast'
+    fifo = 'fifo'
+    full_duplex = 'full-duplex'
+
+
+class DispatchStrategy(StrEnum):
+    round_robin = 'round_robin'
+    single_node = 'single_node'
+
+
+class DuplexSide(StrEnum):
+    host = 'host'
+    device = 'device'
+
+
+@dataclass
+class QueueInfo:
+    name: str
+    depth: int
+    mode: QueueMode
+    listener_count: int
+
+
+type AddParams = list[float]
+
+
+@dataclass
+class PostEventParams:
+    queue: str
+    event: dict[str, Any]
+    side: DuplexSide | None = None
+
+
+@dataclass
+class PostEventResult:
+    id: str
+    queue: str
+
+
+@dataclass
+class ListQueuesResult:
+    queues: list[QueueInfo]
+
+
+@dataclass
+class PeekEventsParams:
+    queue: str
+    count: int | None = 1
+
+
+@dataclass
+class Event:
+    id: str
+    event: dict[str, Any]
+
+
+@dataclass
+class PeekEventsResult:
+    queue: str
+    events: list[Event]
+
+
+@dataclass
+class CreateQueueParams:
+    queue: str
+    mode: QueueMode | None = None
+    dispatch_strategy: DispatchStrategy | None = None
+
+
+@dataclass
+class CreateQueueResult:
+    queue: str
+    mode: QueueMode
+    created: bool
+
+
+@dataclass
+class AttachListenerParams:
+    queue: str
+    port: int
+    host: str | None = None
+    exhaustion_timeout_ms: int | None = None
+    max_retries: int | None = None
+    side: DuplexSide | None = None
+
+
+@dataclass
+class AttachListenerResult:
+    listener_id: str
+    queue: str
+    status: str
+
+
+@dataclass
+class DetachListenerParams:
+    listener_id: str
+
+
+@dataclass
+class DetachListenerResult:
+    listener_id: str
+    detached: bool
+
+
+@dataclass
+class ListListenersParams:
+    queue: str | None = None
+
+
+@dataclass
+class Listener:
+    id: str
+    queue: str
+    host: str
+    port: int
+    mode: QueueMode
+    failure_count: int
+    active: bool
+    side: DuplexSide | None = None
+
+
+@dataclass
+class ListListenersResult:
+    listeners: list[Listener]
+
+
+@dataclass
+class QueueReadyParams:
+    queue: str
+
+
+@dataclass
+class QueueReadyResult:
+    queue: str
+    ready: bool
+
+
+@dataclass
+class ListenerEventParams:
+    queue: str
+    id: str
+    event: dict[str, Any]
+
+
+class Status(StrEnum):
+    ok = 'ok'
+
+
+@dataclass
+class ListenerEventResult:
+    status: Status

airbus_client-0.1.0/src/airbus_client/protocol.py

@@ -0,0 +1,185 @@
+"""JSON-RPC envelopes and schema-backed payload codecs; no sockets or threads."""
+
+from __future__ import annotations
+
+import json
+import types
+from collections.abc import Callable
+from dataclasses import fields, is_dataclass
+from enum import Enum
+from typing import Any, get_args, get_origin, get_type_hints
+
+from jsonschema import Draft202012Validator, ValidationError
+
+from airbus_client import payloads
+from airbus_client.contracts import METHODS, SCHEMAS
+
+VERSION = "2.0"
+_ABSENT = object()
+_VALIDATORS = {name: Draft202012Validator(schema) for name, schema in SCHEMAS.items()}
+
+
+class RpcError(Exception):
+    def __init__(self, code: int, message: str, data: Any = None, *, id: int | str | None = None):
+        super().__init__(f"{code}: {message}")
+        self.code, self.message, self.data, self.id = code, message, data, id
+
+
+def to_wire(value: Any) -> Any:
+    if is_dataclass(value) and not isinstance(value, type):
+        # Omit absent optional fields, but preserve nulls inside user event dictionaries.
+        return {
+            field.name: to_wire(item)
+            for field in fields(value)
+            if (item := getattr(value, field.name)) is not None
+        }
+    if isinstance(value, Enum):
+        return value.value
+    if isinstance(value, dict):
+        return {key: to_wire(item) for key, item in value.items()}
+    if isinstance(value, list):
+        return [to_wire(item) for item in value]
+    return value
+
+
+def validate_payload(method: str, kind: str, value: Any) -> None:
+    if kind == "params" and value is None and not METHODS[method]["params_required"]:
+        return
+    schema = METHODS[method][kind]
+    if schema is None:
+        if value not in (None, {}):
+            raise ValueError(f"{method} takes no parameters")
+        return
+    try:
+        _VALIDATORS[schema].validate(value)
+    except ValidationError as error:
+        raise ValueError(f"{method} {kind}: {error.message}") from error
+
+
+def _decode(model: Any, value: Any) -> Any:
+    if value is None:
+        return None
+    origin, args = get_origin(model), get_args(model)
+    if origin is types.UnionType:
+        model = next(choice for choice in args if choice is not type(None))
+        return _decode(model, value)
+    if origin is list:
+        return [_decode(args[0], item) for item in value]
+    if is_dataclass(model):
+        hints = get_type_hints(model)
+        return model(
+            **{
+                field.name: _decode(hints[field.name], value[field.name])
+                for field in fields(model)
+                if field.name in value
+            }
+        )
+    if isinstance(model, type) and issubclass(model, Enum):
+        return model(value)
+    if model is float:
+        return float(value)
+    return value
+
+
+def decode_result(method: str, model: Any, value: Any) -> Any:
+    validate_payload(method, "result", value)
+    return _decode(model, value)
+
+
+def request(method: str, params: Any = None, id: Any = _ABSENT) -> dict[str, Any]:
+    document = {"jsonrpc": VERSION, "method": method}
+    if id is not _ABSENT:
+        document["id"] = id
+    if params is not None:
+        document["params"] = to_wire(params)
+    return document
+
+
+def _valid_id(value: Any) -> bool:
+    return value is None or type(value) in (int, str)
+
+
+def validate_response(response: Any, expected_id: Any) -> dict[str, Any]:
+    if not isinstance(response, dict) or response.get("jsonrpc") != VERSION:
+        raise ValueError("invalid JSON-RPC response version")
+    if "id" not in response or not _valid_id(response["id"]):
+        raise ValueError("invalid JSON-RPC response id")
+    if type(response["id"]) is not type(expected_id) or response["id"] != expected_id:
+        raise ValueError("JSON-RPC response id does not match request")
+    if ("result" in response) == ("error" in response):
+        raise ValueError("response must contain exactly one of result or error")
+    if "error" in response:
+        error = response["error"]
+        if (
+            not isinstance(error, dict)
+            or type(error.get("code")) is not int
+            or not isinstance(error.get("message"), str)
+        ):
+            raise ValueError("invalid JSON-RPC error object")
+    return response
+
+
+def response_result(response: dict[str, Any]) -> Any:
+    if "error" in response:
+        error = response["error"]
+        raise RpcError(error["code"], error["message"], error.get("data"), id=response["id"])
+    return response["result"]
+
+
+def batch_responses(requests: list[dict], response: Any) -> list[dict | None]:
+    expected = {item["id"] for item in requests if "id" in item}
+    if not expected:
+        if response is not None:
+            raise ValueError("notifications must not receive a response")
+        return [None] * len(requests)
+    if not isinstance(response, list):
+        raise ValueError("batch response must be an array")
+    by_id = {}
+    for item in response:
+        if not isinstance(item, dict) or not _valid_id(item.get("id")):
+            raise ValueError("invalid batch response")
+        id = item.get("id")
+        if id not in expected or id in by_id:
+            raise ValueError("unexpected or duplicate batch response id")
+        by_id[id] = validate_response(item, next(value for value in expected if value == id))
+    if set(by_id) != expected:
+        raise ValueError("missing batch response")
+    return [by_id[item["id"]] if "id" in item else None for item in requests]
+
+
+def _error_response(id: Any, code: int, message: str) -> dict[str, Any]:
+    return {"jsonrpc": VERSION, "id": id, "error": {"code": code, "message": message}}
+
+
+def handle_event(body: str, callback: Callable[[dict[str, Any]], Any]) -> dict[str, Any] | None:
+    try:
+        document = json.loads(body)
+    except ValueError:
+        return _error_response(None, -32700, "invalid JSON")
+    if not isinstance(document, dict):
+        return _error_response(None, -32600, "invalid request")
+    id = document.get("id")
+    if (
+        document.get("jsonrpc") != VERSION
+        or not _valid_id(id)
+        or not isinstance(document.get("method"), str)
+    ):
+        return _error_response(id if _valid_id(id) else None, -32600, "invalid request")
+    notification = "id" not in document
+    if document["method"] != "on_event":
+        return None if notification else _error_response(id, -32601, "method not found")
+    try:
+        validate_payload("on_event", "params", document.get("params"))
+        event = _decode(payloads.ListenerEventParams, document["params"])
+    except ValueError as error:
+        return None if notification else _error_response(id, -32602, str(error))
+    try:
+        callback(to_wire(event))
+    except Exception as error:
+        return None if notification else _error_response(id, -32603, str(error))
+    if notification:
+        return None
+    acknowledgment = payloads.ListenerEventResult(status=payloads.Status.ok)
+    result = to_wire(acknowledgment)
+    validate_payload("on_event", "result", result)
+    return {"jsonrpc": VERSION, "id": id, "result": result}