mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-07-01 17:39:39 +02:00
4fb0b4d8e8
Remove Pulsar-specific concepts from application code so that the pub/sub backend is swappable via configuration. Rename translators: - to_pulsar/from_pulsar → decode/encode across all translator classes, dispatch handlers, and tests (55+ files) - from_response_with_completion → encode_with_completion - Remove pulsar.schema.Record from translator base class Queue naming (CLASS:TOPICSPACE:TOPIC): - Replace topic() helper with queue() using new format: flow:tg:name, request:tg:name, response:tg:name, state:tg:name - Queue class implies persistence/TTL (no QoS in names) - Update Pulsar backend map_topic() to parse new format - Librarian queues use flow class (persistent, for chunking) - Config push uses state class (persistent, last-value) - Remove 15 dead topic imports from schema files - Update init_trustgraph.py namespace: config → state Confine Pulsar to pulsar_backend.py: - Delete legacy PulsarClient class from pubsub.py - Move add_args to add_pubsub_args() with standalone flag for CLI tools (defaults to localhost) - PulsarBackendConsumer.receive() catches _pulsar.Timeout, raises standard TimeoutError - Remove Pulsar imports from: async_processor, flow_processor, log_level, all 11 client files, 4 storage writers, gateway service, gateway config receiver - Remove log_level/LoggerLevel from client API - Rewrite tg-monitor-prompts to use backend abstraction - Update tg-dump-queues to use add_pubsub_args Also: pubsub-abstraction.md tech spec covering problem statement, design goals, as-is requirements, candidate broker assessment, approach, and implementation order.
46 lines
1.4 KiB
Python
46 lines
1.4 KiB
Python
from abc import ABC, abstractmethod
|
|
from typing import Dict, Any, Tuple
|
|
|
|
|
|
class Translator(ABC):
|
|
"""Base class for bidirectional schema ↔ dict translation.
|
|
|
|
Translates between external API dicts (JSON from HTTP/WebSocket)
|
|
and internal schema objects (dataclasses).
|
|
"""
|
|
|
|
@abstractmethod
|
|
def decode(self, data: Dict[str, Any]) -> Any:
|
|
"""Convert external dict to schema object."""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def encode(self, obj: Any) -> Dict[str, Any]:
|
|
"""Convert schema object to external dict."""
|
|
pass
|
|
|
|
|
|
class MessageTranslator(Translator):
|
|
"""For complete request/response message translation."""
|
|
|
|
def encode_with_completion(self, obj: Any) -> Tuple[Dict[str, Any], bool]:
|
|
"""Returns (response_dict, is_final) — for streaming responses."""
|
|
return self.encode(obj), True
|
|
|
|
|
|
class SendTranslator(Translator):
|
|
"""For fire-and-forget send operations."""
|
|
|
|
def encode(self, obj: Any) -> Dict[str, Any]:
|
|
"""Usually not needed for send-only operations."""
|
|
raise NotImplementedError("Send translators don't need encode")
|
|
|
|
|
|
def handle_optional_fields(obj: Any, fields: list) -> Dict[str, Any]:
|
|
"""Helper to extract optional fields from a schema object."""
|
|
result = {}
|
|
for field in fields:
|
|
value = getattr(obj, field, None)
|
|
if value is not None:
|
|
result[field] = value
|
|
return result
|