store-gateway-py 0.1.1__tar.gz

store_gateway_py-0.1.1/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: store-gateway-py
+Version: 0.1.1
+Summary: Optional combiner for the three py-store API skins (REST store-api-py / GraphQL store-graphql-py / gRPC store-grpc-py): config-driven per-skin enable switches
+License: MIT
+Keywords: py-store,storepy,gateway,rest,graphql,grpc,pluggable
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn>=0.29
+Provides-Extra: rest
+Requires-Dist: store-api-py; extra == "rest"
+Provides-Extra: graphql
+Requires-Dist: store-graphql-py; extra == "graphql"
+Provides-Extra: grpc
+Requires-Dist: store-grpc-py; extra == "grpc"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+
+# store-gateway-py
+
+py-store 三层 API 皮肤（REST / GraphQL / gRPC）的可选组合器（`store-gateway-py`）。规范与用法见仓库根 README 与 `../spec/`。
+
+本地开发时三皮肤以各自仓库 editable 安装：
+
+```bash
+pip install -e ../store-api/py ../store-graphql/py ../store-grpc/py
+```

store_gateway_py-0.1.1/README.md

@@ -0,0 +1,9 @@
+# store-gateway-py
+
+py-store 三层 API 皮肤（REST / GraphQL / gRPC）的可选组合器（`store-gateway-py`）。规范与用法见仓库根 README 与 `../spec/`。
+
+本地开发时三皮肤以各自仓库 editable 安装：
+
+```bash
+pip install -e ../store-api/py ../store-graphql/py ../store-grpc/py
+```

store_gateway_py-0.1.1/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "store-gateway-py"
+version = "0.1.1"
+description = "Optional combiner for the three py-store API skins (REST store-api-py / GraphQL store-graphql-py / gRPC store-grpc-py): config-driven per-skin enable switches"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["py-store", "storepy", "gateway", "rest", "graphql", "grpc", "pluggable"]
+dependencies = ["fastapi>=0.110", "uvicorn>=0.29"]
+
+[project.optional-dependencies]
+rest = ["store-api-py"]
+graphql = ["store-graphql-py"]
+grpc = ["store-grpc-py"]
+# 皮肤包（store-api-py / store-graphql-py / store-grpc-py）本地开发时以
+# `pip install -e` 各自仓库路径安装（发布 PyPI 前不进 dev extras）
+dev = ["pytest>=8", "httpx>=0.27"]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

store_gateway_py-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

store_gateway_py-0.1.1/src/store_gateway/__init__.py

@@ -0,0 +1,201 @@
+"""store_gateway_py — 三层皮肤（REST / GraphQL / gRPC）的可选组合器。
+
+语义依据：../../spec/00-protocol.md（插拔协议唯一事实源）。
+本层零业务语义：读配置 → 按需实例化各皮肤 → 挂到各自 server。
+三皮肤一律 optional：enabled=True 才导入，缺失时抛带安装指引的 ImportError（禁静默降级）。
+
+运行期重装配（对齐 node store-gateway）：HTTP 侧（REST + GraphQL）的装配抽为 `_assemble()`，
+`POST /-/reload` 经 `Gateway.reload()` 重建后**原子替换**在途 ASGI 应用（构建成功才替换；
+失败保留旧 app 并返回 500）。gRPC 为独立 server，不在 reload 范围（spec/00 规则 5）。
+D1 闭环桥：配置 `opts['reload'] = {'tenant','env'}` 时，reload 在重装配**之前**先按 ns 调
+`store.restore_defs({tenant, env})`（宿主提供），使控制面 publish 落库的新定义经一次 reload 可见。
+"""
+
+from __future__ import annotations
+
+import asyncio
+import importlib
+import inspect
+import json
+from typing import Any
+
+__all__ = ["build"]
+
+
+def _optional_import(module_name: str, pip_hint: str):
+    try:
+        return importlib.import_module(module_name)
+    except ImportError as e:
+        raise ImportError(f"启用该皮肤需要安装 {module_name}（pip install '{pip_hint}'）") from e
+
+
+def _read_skins(opts: dict) -> dict:
+    rest = {"enabled": False, **(opts.get("rest") or {})}
+    graphql = {"enabled": False, **(opts.get("graphql") or {})}
+    grpc = {"enabled": False, **(opts.get("grpc") or {})}
+    if not (rest["enabled"] or graphql["enabled"] or grpc["enabled"]):
+        raise ValueError("ERR_NO_SKIN:rest / graphql / grpc 至少启用一项（spec/00-protocol.md 插拔规则 2）")
+    return {"rest": rest, "graphql": graphql, "grpc": grpc}
+
+
+def _read_reload(opts: dict) -> dict | None:
+    """解析 reload 重建配置（进程级单 ns）：`opts['reload'] = {'tenant','env'}`。
+
+    未配置 → None（reload 只重跑既有装配，保持既有语义）；配置但缺 tenant/env → 显式报错（fail-fast）。
+    """
+    cfg = opts.get("reload")
+    if not cfg:
+        return None
+    tenant, env = cfg.get("tenant"), cfg.get("env")
+    if not tenant or not env:
+        raise ValueError("ERR_RELOAD_CONFIG:opts.reload 须提供 tenant 与 env（进程级单 ns）")
+    return {"tenant": tenant, "env": env}
+
+
+def _active_resources(names: list) -> list:
+    """归档表过滤（与 store-api spec/01-routing.md 同规则）：`XxxDeleted` 且 `Xxx` 在列表中 ⇒ 归档表。"""
+    s = set(names)
+    return [n for n in names if not (n.endswith("Deleted") and n[: -len("Deleted")] in s)]
+
+
+def _assemble(store: Any, skins: dict) -> tuple[Any, int]:
+    """装配 HTTP 侧（REST + GraphQL）→ `(FastAPI app, 暴露资源数)`。
+
+    每次调用都遍历 `store.list()` 生成路由 → 反映当下注册表（reload 的语义来源）。
+    """
+    fastapi = _optional_import("fastapi", "fastapi")
+    app = fastapi.FastAPI(title="store-gateway")
+
+    if skins["rest"].get("enabled"):
+        rest_cfg = dict(skins["rest"])
+        rest_prefix = rest_cfg.pop("prefix", "/api") or ""  # prefix 由 gateway 按 mount 应用（spec/00 规则 4）
+        mod = _optional_import("store_api_py", "store-api-py")
+        rest_cfg.pop("enabled", None)
+        # 皮肤路由建在根，gateway 按前缀 mount（保持既有 py 行为，前缀可配）
+        app.mount(rest_prefix, mod.create_app(store, prefix="", **rest_cfg))
+
+    if skins["graphql"].get("enabled"):
+        gql_cfg = dict(skins["graphql"])
+        gql_path = gql_cfg.pop("path", "/graphql")
+        gql_cfg.pop("enabled", None)
+        mod = _optional_import("store_graphql", "store-graphql-py")
+        if inspect.iscoroutinefunction(mod.create_app):
+            raise TypeError("store_graphql.create_app 不应为 async")
+        app.mount("/", mod.create_app(store, path=gql_path, **gql_cfg))
+
+    names = skins["rest"].get("resources") or store.list()
+    return app, len(_active_resources(names))
+
+
+class ReloadUnsupportedError(RuntimeError):
+    """reload 已配置却无宿主重建能力（显式失败，禁静默失守）"""
+
+    code = "ERR_RELOAD_UNSUPPORTED"
+
+
+async def _hydrate(store: Any, reload_cfg: dict | None) -> None:
+    """reload 前的注册表重建（D1 闭环桥）：按 ns 从持久化定义 restore 到本进程注册表。
+
+    未配置 reload → 空操作；配置了但 store 无 `restore_defs`/`restoreDefs` 能力 → 显式报错
+    （禁静默：配置了要重建却重建不了，必须让 reload 失败而非假装成功）。
+    """
+    if not reload_cfg:
+        return
+    fn = getattr(store, "restore_defs", None) or getattr(store, "restoreDefs", None)
+    if not callable(fn):
+        raise ReloadUnsupportedError(
+            "ERR_RELOAD_UNSUPPORTED:opts.reload 已配置，但 store 未提供 restore_defs/restoreDefs"
+            "（无法从持久化定义重建注册表）"
+        )
+    res = fn({"tenant": reload_cfg["tenant"], "env": reload_cfg["env"]})
+    if inspect.isawaitable(res):
+        await res
+
+
+class _Dispatch:
+    """稳定 ASGI 入口：http 委托 `state['app']`；`POST /-/reload` 自身承接（不进在途快照）。"""
+
+    def __init__(self, state: dict, reload_fn) -> None:
+        self._state = state
+        self._reload = reload_fn  # async () -> int（Gateway.reload）
+
+    async def __call__(self, scope, receive, send) -> None:
+        if scope["type"] == "http" and scope["method"] == "POST" and scope["path"] == "/-/reload":
+            await self._handle_reload(send)
+            return
+        await self._state["app"](scope, receive, send)
+
+    async def _handle_reload(self, send) -> None:
+        try:
+            resources = await self._reload()
+            status = 200
+            body = {"data": {"reloaded": True, "resources": resources}}
+        except Exception as e:  # noqa: BLE001 — reload 失败显式 500，禁静默
+            status = 500
+            body = {"error": {"code": getattr(e, "code", None) or "ERR_RELOAD_FAILED",
+                              "message": str(e) or None}}
+        payload = json.dumps(body).encode("utf-8")
+        await send({"type": "http.response.start", "status": status,
+                    "headers": [(b"content-type", b"application/json; charset=utf-8")]})
+        await send({"type": "http.response.body", "body": payload})
+
+
+class Gateway:
+    """承载句柄：`.app`（稳定 ASGI dispatch，REST+GraphQL 共享）/ `.grpc` / `.run` / `.reload` / `.stop`。"""
+
+    def __init__(self, state: dict, grpc: Any, rest_prefix: str,
+                 skins: dict, store: Any, reload_cfg: dict | None) -> None:
+        self._state = state
+        self._skins = skins
+        self._store = store
+        self._reload_cfg = reload_cfg
+        self._reload_lock = asyncio.Lock()  # 重装配串行化（互斥）
+        self.grpc = grpc
+        self._rest_prefix = rest_prefix
+        self.app: Any = None  # 由 build() 赋为 _Dispatch
+
+    def run(self, host: str = "127.0.0.1", port: int = 3000) -> None:
+        """uvicorn 阻塞承载 HTTP（gRPC server 已在 build 时 start）。"""
+        import uvicorn
+
+        uvicorn.run(self.app, host=host, port=port, log_level="warning")
+
+    async def reload(self) -> int:
+        """原子重装配：先在锁内 hydrate（失败同样不半替换），构建成功才替换在途 app。"""
+        async with self._reload_lock:
+            await _hydrate(self._store, self._reload_cfg)
+            app, resources = _assemble(self._store, self._skins)  # 失败向上抛（调用方映射 500）
+            self._state["app"] = app
+            return resources
+
+    def stop(self) -> None:
+        if self.grpc is not None:
+            self.grpc.stop(None)
+
+
+def build(store: Any, **opts: Any) -> Gateway:
+    """spec/00：读配置 → 组合三皮肤 → Gateway。
+
+    - rest: { enabled, prefix='/api', **store-api-py 选项 }
+    - graphql: { enabled, path='/graphql', **store-graphql-py 选项 }
+    - grpc: { enabled, host='127.0.0.1', port=50051, **store-grpc-py 选项 }
+    - reload: { tenant, env }（可选；reload 前按 ns 调 store.restore_defs 重建注册表）
+    """
+    skins = _read_skins(opts)
+    reload_cfg = _read_reload(opts)
+
+    app, _ = _assemble(store, skins)
+    state = {"app": app}
+
+    grpc_handle = None
+    if skins["grpc"].get("enabled"):
+        grpc_cfg = dict(skins["grpc"])
+        grpc_cfg.pop("enabled", None)
+        host = grpc_cfg.pop("host", "127.0.0.1")
+        port = grpc_cfg.pop("port", 50051)
+        mod = _optional_import("store_grpc", "store-grpc-py")
+        grpc_handle = mod.create_server(store, host=host, port=port, **grpc_cfg)
+
+    gw = Gateway(state, grpc_handle, skins["rest"].get("prefix") or "/api", skins, store, reload_cfg)
+    gw.app = _Dispatch(state, gw.reload)
+    return gw

store_gateway_py-0.1.1/src/store_gateway_py.egg-info/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: store-gateway-py
+Version: 0.1.1
+Summary: Optional combiner for the three py-store API skins (REST store-api-py / GraphQL store-graphql-py / gRPC store-grpc-py): config-driven per-skin enable switches
+License: MIT
+Keywords: py-store,storepy,gateway,rest,graphql,grpc,pluggable
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn>=0.29
+Provides-Extra: rest
+Requires-Dist: store-api-py; extra == "rest"
+Provides-Extra: graphql
+Requires-Dist: store-graphql-py; extra == "graphql"
+Provides-Extra: grpc
+Requires-Dist: store-grpc-py; extra == "grpc"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+
+# store-gateway-py
+
+py-store 三层 API 皮肤（REST / GraphQL / gRPC）的可选组合器（`store-gateway-py`）。规范与用法见仓库根 README 与 `../spec/`。
+
+本地开发时三皮肤以各自仓库 editable 安装：
+
+```bash
+pip install -e ../store-api/py ../store-graphql/py ../store-grpc/py
+```

store_gateway_py-0.1.1/src/store_gateway_py.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/store_gateway/__init__.py
+src/store_gateway_py.egg-info/PKG-INFO
+src/store_gateway_py.egg-info/SOURCES.txt
+src/store_gateway_py.egg-info/dependency_links.txt
+src/store_gateway_py.egg-info/requires.txt
+src/store_gateway_py.egg-info/top_level.txt
+tests/test_gateway.py

store_gateway_py-0.1.1/src/store_gateway_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

store_gateway_py-0.1.1/src/store_gateway_py.egg-info/requires.txt

@@ -0,0 +1,15 @@
+fastapi>=0.110
+uvicorn>=0.29
+
+[dev]
+pytest>=8
+httpx>=0.27
+
+[graphql]
+store-graphql-py
+
+[grpc]
+store-grpc-py
+
+[rest]
+store-api-py

store_gateway_py-0.1.1/src/store_gateway_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+store_gateway

store_gateway_py-0.1.1/tests/test_gateway.py

@@ -0,0 +1,230 @@
+"""gateway 冒烟测试 — 三层皮肤插拔组合（mock store；HTTP 走 TestClient，gRPC 走真实端口）。
+
+语义依据：../../spec/00-protocol.md。
+"""
+
+import json
+import re
+
+import pytest
+
+from store_gateway import build
+
+pytest.importorskip("store_api_py")
+pytest.importorskip("store_graphql")
+pytest.importorskip("store_grpc")
+pytest.importorskip("httpx")
+grpc = pytest.importorskip("grpc")
+
+from fastapi.testclient import TestClient  # noqa: E402
+
+DEFN = {
+    "name": "User",
+    "description": "用户表",
+    "fields": {
+        "_id": {"type": "string"},
+        "name": {"type": "string"},
+        "age": {"type": "int"},
+    },
+}
+
+
+class PermissionErrorMock(Exception):
+    pass
+
+
+def make_mock_store():
+    rows = []
+
+    class Store:
+        PermissionError = PermissionErrorMock
+
+        def __init__(self):
+            self.names = ["User"]          # 可变列表：reload 用例据此调整暴露资源
+            self.restore_calls = []        # 记录 reload 前 hydrate 的调用参数
+
+        def list(self):
+            return self.names
+
+        get = staticmethod(lambda name: DEFN)
+
+        async def restore_defs(self, opts):
+            self.restore_calls.append(opts)
+
+        @staticmethod
+        async def query(gql, params=None):
+            cond = (params or {}).get("c0")
+            return [r for r in rows if not cond or all(r.get(k) == v for k, v in cond.items())]
+
+        @staticmethod
+        async def query_one(gql, params=None):
+            cond = (params or {}).get("c0")
+            return next((r for r in rows if all(r.get(k) == v for k, v in cond.items())), None)
+
+        @staticmethod
+        async def insert(name, data):
+            doc = {"_id": f"u{len(rows) + 1}", **data}
+            rows.append(doc)
+            return doc
+
+        @staticmethod
+        async def update(name, cond, data):
+            row = next(r for r in rows if all(r.get(k) == v for k, v in cond.items()))
+            row.update(data)
+            return row
+
+        @staticmethod
+        async def remove(name, cond):
+            for i, r in enumerate(rows):
+                if all(r.get(k) == v for k, v in cond.items()):
+                    rows.pop(i)
+                    return 1
+            return 0
+
+        @staticmethod
+        async def set_context(ctx):
+            pass
+
+    return Store()
+
+
+def test_no_skin_raises():
+    store = make_mock_store()
+    with pytest.raises(ValueError, match="ERR_NO_SKIN"):
+        build(store)
+
+
+def test_rest_only():
+    store = make_mock_store()
+    gw = build(store, rest={"enabled": True, "prefix": "/api"})
+    try:
+        client = TestClient(gw.app)
+        r = client.get("/api/User")
+        assert r.status_code == 200
+        assert r.json() == {"data": []}
+    finally:
+        if gw.grpc is not None:
+            gw.stop()
+
+
+def test_graphql_only():
+    store = make_mock_store()
+    gw = build(store, graphql={"enabled": True})
+    try:
+        client = TestClient(gw.app)
+        r = client.post("/graphql", json={"query": "{ __typename }"})
+        assert r.status_code == 200
+        assert r.json()["data"]["__typename"] == "Query"
+    finally:
+        if gw.grpc is not None:
+            gw.stop()
+
+
+def test_all_three_skins():
+    store = make_mock_store()
+    gw = build(
+        store,
+        rest={"enabled": True, "prefix": "/api"},
+        graphql={"enabled": True, "path": "/gql"},
+        grpc={"enabled": True, "port": 0},
+    )
+    try:
+        client = TestClient(gw.app)
+        # REST：写入
+        r = client.post("/api/User", json={"name": "alice", "age": 30})
+        assert r.status_code == 201, r.text
+        # GraphQL：读回（自定义 path）
+        r = client.post("/gql", json={"query": "{ list_User { name age } }"})
+        assert r.status_code == 200, r.text
+        assert r.json()["data"]["list_User"] == [{"name": "alice", "age": 30}]
+
+        # gRPC：ListUser 读回同一份数据（同一 store 实例）
+        pb = gw.grpc.pb
+        channel = grpc.insecure_channel(f"127.0.0.1:{gw.grpc.port}")
+        try:
+            unary = channel.unary_unary(
+                "/store.v0.User/ListUser",
+                request_serializer=pb.ListRequest.SerializeToString,
+                response_deserializer=pb.StoreReply.FromString,
+            )
+            reply = unary(pb.ListRequest(q=" { name, age }"), timeout=10)
+            assert json.loads(reply.data_json) == [{"_id": "u1", "name": "alice", "age": 30}]
+        finally:
+            channel.close()
+    finally:
+        gw.stop()
+
+
+def test_missing_skin_package_raises(monkeypatch):
+    store = make_mock_store()
+    import importlib
+
+    real_import_module = importlib.import_module
+
+    def fake_import_module(name, *args, **kwargs):
+        if name == "store_api_py":
+            raise ImportError("No module named 'store_api_py'")
+        return real_import_module(name, *args, **kwargs)
+
+    monkeypatch.setattr(importlib, "import_module", fake_import_module)
+    with pytest.raises(ImportError, match="store_api_py"):
+        build(store, rest={"enabled": True})
+
+
+# ─── 运行期重装配（reload；对齐 node store-gateway） ───────────────────
+
+
+def test_reload_reassembles():
+    """POST /-/reload 重装配 HTTP 侧：资源数反映当下注册表，新资源路由可访问。"""
+    store = make_mock_store()
+    gw = build(store, rest={"enabled": True, "prefix": "/api"})
+    try:
+        client = TestClient(gw.app)
+        r = client.post("/-/reload")
+        assert r.status_code == 200
+        assert r.json() == {"data": {"reloaded": True, "resources": 1}}
+
+        store.names.append("Order")  # 运行期新注册（快照外）→ 仅经 reload 进入路由
+        r2 = client.post("/-/reload")
+        assert r2.status_code == 200
+        assert r2.json()["data"]["resources"] == 2  # 递增
+        assert client.get("/api/Order").status_code == 200
+    finally:
+        if gw.grpc is not None:
+            gw.stop()
+
+
+def test_reload_hydrates_registry():
+    """配 reload={tenant,env} → 重装配前按 ns 调 store.restore_defs（D1 闭环桥）。"""
+    store = make_mock_store()
+    gw = build(store, rest={"enabled": True}, reload={"tenant": "t1", "env": "dev"})
+    try:
+        client = TestClient(gw.app)
+        r = client.post("/-/reload")
+        assert r.status_code == 200
+        assert store.restore_calls == [{"tenant": "t1", "env": "dev"}]
+    finally:
+        if gw.grpc is not None:
+            gw.stop()
+
+
+def test_reload_unsupported_store():
+    """配 reload 但 store 无重建能力 → 500 ERR_RELOAD_UNSUPPORTED（禁静默）。"""
+    store = make_mock_store()
+    store.restore_defs = None  # 显式移除重建能力
+    gw = build(store, rest={"enabled": True}, reload={"tenant": "t1", "env": "dev"})
+    try:
+        client = TestClient(gw.app)
+        r = client.post("/-/reload")
+        assert r.status_code == 500
+        assert r.json()["error"]["code"] == "ERR_RELOAD_UNSUPPORTED"
+    finally:
+        if gw.grpc is not None:
+            gw.stop()
+
+
+def test_reload_missing_ns_raises():
+    """reload 缺 tenant/env → 构造期 fail-fast（ERR_RELOAD_CONFIG）。"""
+    store = make_mock_store()
+    with pytest.raises(ValueError, match="ERR_RELOAD_CONFIG"):
+        build(store, rest={"enabled": True}, reload={"tenant": "t1"})