@rainbow-robotics/muscat-plugin-kit 0.1.2-dev.6 → 0.1.2-dev.7

package/cli/templates/common/main.py

@@ -1,24 +1,114 @@
+"""
+Muscat plugin backend — __PLUGIN_NAME__
+
+플러그인 UI(브라우저)와 Socket.IO로 통신한다.
+`muscat-pk dev:back` 또는 `python main.py`로 실행.
+
+토픽 자동 네임스페이스:
+  "sensor/data"  →  plugin/__PLUGIN_ID__/sensor/data  (자동)
+  "/broadcast/x" →  broadcast/x                       (앞 / = 절대경로)
+"""
+
 import asyncio
+import socketio
+from aiohttp import web
+
+sio = socketio.AsyncServer(async_mode="aiohttp", cors_allowed_origins="*")
+app = web.Application()
+sio.attach(app)
+
+PLUGIN_ID = "__PLUGIN_ID__"
+_PREFIX = f"plugin/{PLUGIN_ID}"
+
+
+def _topic(relative: str) -> str:
+    """상대 토픽 → 전체 네임스페이스 토픽."""
+    return relative if relative.startswith("/") else f"{_PREFIX}/{relative}"
+
+
+# ── 구독·쿼리어블 핸들러 저장소 ────────────────────────────────────────────────
+_sub_handlers: dict[str, list] = {}
+_queryable_handlers: dict[str, object] = {}
+_serve_pending: dict[str, asyncio.Future] = {}
+
+
+# ── Socket.IO 이벤트 ───────────────────────────────────────────────────────────
+
+@sio.event
+async def sub(sid, data):
+    """브라우저가 토픽을 구독."""
+    await sio.enter_room(sid, f"t:{data['topic']}")
+
+
+@sio.event
+async def unsub(sid, data):
+    await sio.leave_room(sid, f"t:{data['topic']}")
+
+
+@sio.event
+async def pub(sid, data):
+    """브라우저가 발행 → Python 구독 핸들러로 전달."""
+    topic = data.get("topic", "")
+    payload = data.get("payload")
+    for handler in _sub_handlers.get(topic, []):
+        asyncio.create_task(handler(payload))
+
+
+@sio.event
+async def action(sid, data):
+    """브라우저 rb.action() 호출 → Python queryable 핸들러 → ack 반환."""
+    topic = data.get("topic", "")
+    handler = _queryable_handlers.get(topic)
+    if handler:
+        return await handler(data.get("payload"))
+
+
+@sio.event
+async def serve_reply(sid, data):
+    """브라우저가 serve_call에 응답."""
+    fut = _serve_pending.pop(data.get("id", ""), None)
+    if fut and not fut.done():
+        fut.set_result(data.get("payload"))
+
+
+# ── 헬퍼 데코레이터 ────────────────────────────────────────────────────────────
+
+def subscribe(relative_topic: str):
+    """브라우저 → Python 메시지 구독 핸들러 등록."""
+    def decorator(fn):
+        _sub_handlers.setdefault(_topic(relative_topic), []).append(fn)
+        return fn
+    return decorator
+
+
+def queryable(relative_topic: str):
+    """브라우저 rb.action() 호출을 처리할 핸들러 등록."""
+    def decorator(fn):
+        _queryable_handlers[_topic(relative_topic)] = fn
+        return fn
+    return decorator
 
-from rainbow_rb_zenoh import ZenohRouter
 
-router = ZenohRouter(prefix="plugin/__PLUGIN_ID__")
+async def publish(relative_topic: str, payload) -> None:
+    """Python → 브라우저 구독자에게 메시지 발행."""
+    full = _topic(relative_topic)
+    await sio.emit("msg", {"topic": full, "payload": payload}, room=f"t:{full}")
 
 
-@router.subscribe("sensor/data")
-async def on_sensor(*, dict_payload, **_):
-    print(f"[__PLUGIN_NAME__] received: {dict_payload}")
+# ── 플러그인 로직 ──────────────────────────────────────────────────────────────
 
+@subscribe("sensor/data")
+async def on_sensor_data(payload):
+    print(f"[__PLUGIN_NAME__] sensor/data: {payload}")
 
-@router.queryable("get-status")
-async def get_status(req=None, **_):
-    return {"ok": True}
 
+@queryable("get-status")
+async def get_status(payload=None):
+    return {"ok": True, "plugin": "__PLUGIN_NAME__"}
 
-async def main():
-    await router.startup()
-    await asyncio.Event().wait()
 
+# ── 진입점 ─────────────────────────────────────────────────────────────────────
 
 if __name__ == "__main__":
-    asyncio.run(main())
+    print("[__PLUGIN_NAME__] Socket.IO server starting on :10000")
+    web.run_app(app, host="0.0.0.0", port=10000)

package/cli/templates/common/requirements.txt

@@ -1,2 +1,3 @@
 rainbow-rb-sdk
 rainbow-rb-flat-buffers
+python-socketio[aiohttp]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rainbow-robotics/muscat-plugin-kit",
-  "version": "0.1.2-dev.6",
+  "version": "0.1.2-dev.7",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -31,7 +31,7 @@
     "@types/react-dom": "^19.0.4"
   },
   "dependencies": {
-    "@rainbow-robotics/preview-host": "*",
+    "@rainbow-robotics/preview-host": "0.1.2-dev.7",
     "esbuild": "^0.25.0"
   },
   "optionalDependencies": {