tigrbl 0.3.3.dev2__py3-none-any.whl → 0.3.4.dev2__py3-none-any.whl

tigrbl/deps/__init__.py

@@ -16,5 +16,5 @@ from .pydantic import *  # noqa: F403, F401
 # Re-export all FastAPI dependencies
 from .fastapi import *  # noqa: F403, F401
 
-# Note: starlette.py is reserved for future Starlette-specific imports
-# if we need to import directly from Starlette rather than through FastAPI
+# Re-export Starlette dependencies (Request/Response live here)
+from .starlette import *  # noqa: F403, F401

tigrbl/deps/fastapi.py

@@ -4,8 +4,6 @@ from fastapi import (
     FastAPI,
     Security,
     Depends,
-    Request,
-    Response,
     Path as FastAPIPath,
     Body,
     HTTPException,
@@ -36,8 +34,6 @@ __all__ = [
     "FastAPI",
     "Security",
     "Depends",
-    "Request",
-    "Response",
     "Path",
     "Body",
     "HTTPException",

tigrbl/runtime/executor/types.py

@@ -8,23 +8,17 @@ from typing import (
     Mapping,
     MutableMapping,
     Optional,
+    Protocol,
     Sequence,
     Union,
-    Protocol,
     runtime_checkable,
 )
 
-try:
-    from fastapi import Request  # type: ignore
-except Exception:  # pragma: no cover
-    Request = Any  # type: ignore
+from ...deps.starlette import Request as StarletteRequest
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy.orm import Session
 
-try:
-    from sqlalchemy.orm import Session  # type: ignore
-    from sqlalchemy.ext.asyncio import AsyncSession  # type: ignore
-except Exception:  # pragma: no cover
-    Session = Any  # type: ignore
-    AsyncSession = Any  # type: ignore
+Request = StarletteRequest if StarletteRequest is not None else Any  # type: ignore
 
 
 @runtime_checkable

tigrbl/transport/__init__.py

@@ -27,7 +27,7 @@ from __future__ import annotations
 from typing import Any, Callable, Optional, Sequence
 
 # JSON-RPC transport
-from .jsonrpc import build_jsonrpc_router
+from .jsonrpc import build_jsonrpc_router, build_openrpc_spec
 
 # REST transport (aggregator over per-model routers)
 from .rest import build_rest_router, mount_rest
@@ -67,6 +67,7 @@ def mount_jsonrpc(
 __all__ = [
     # JSON-RPC
     "build_jsonrpc_router",
+    "build_openrpc_spec",
     "mount_jsonrpc",
     # REST
     "build_rest_router",

tigrbl/transport/jsonrpc/__init__.py

@@ -6,14 +6,18 @@ Public helper:
   - build_jsonrpc_router(
         api, *, get_db=None, tags=("rpc",)
     ) -> Router
+  - build_openrpc_spec(api) -> dict
 
 Usage:
     from tigrbl.transport.jsonrpc import build_jsonrpc_router
     app.include_router(build_jsonrpc_router(api), prefix="/rpc")
+    # OpenRPC schema (JSON-RPC equivalent of OpenAPI)
+    build_openrpc_spec(api)
 """
 
 from __future__ import annotations
 
 from .dispatcher import build_jsonrpc_router
+from .openrpc import build_openrpc_spec
 
-__all__ = ["build_jsonrpc_router"]
+__all__ = ["build_jsonrpc_router", "build_openrpc_spec"]

tigrbl/transport/jsonrpc/dispatcher.py

@@ -78,6 +78,7 @@ except Exception:  # pragma: no cover
 from ...runtime.errors import ERROR_MESSAGES, http_exc_to_rpc
 from ...config.constants import TIGRBL_AUTH_CONTEXT_ATTR
 from .models import RPCRequest, RPCResponse
+from .openrpc import build_openrpc_spec
 from .helpers import (
     _authorize,
     _err,
@@ -337,6 +338,19 @@ def build_jsonrpc_router(
         # extra router deps already applied via Router(dependencies=...)
     )
 
+    def _openrpc_endpoint():
+        return build_openrpc_spec(api)
+
+    router.add_api_route(
+        path="/openrpc.json",
+        endpoint=_openrpc_endpoint,
+        methods=["GET"],
+        name="openrpc_json",
+        tags=list(tags) if tags else None,
+        summary="OpenRPC",
+        description="OpenRPC 1.2.6 schema for JSON-RPC methods.",
+    )
+
     # Compatibility: serve same endpoint without trailing slash
     router.add_api_route(
         path="/",

tigrbl/transport/jsonrpc/openrpc.py

@@ -0,0 +1,116 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Iterable, List, Mapping, Sequence
+
+from pydantic import BaseModel
+
+from ...op import OpSpec
+
+JsonObject = Dict[str, Any]
+
+
+def _iter_models(api: Any) -> List[type]:
+    seen: set[type] = set()
+    models: List[type] = []
+
+    def _add_from(container: Any) -> None:
+        if isinstance(container, Mapping):
+            items: Iterable[Any] = container.values()
+        elif isinstance(container, Sequence):
+            items = container
+        else:
+            return
+        for model in items:
+            if isinstance(model, type) and model not in seen:
+                seen.add(model)
+                models.append(model)
+
+    _add_from(getattr(api, "models", None) or {})
+    for child in getattr(api, "apis", ()) or ():
+        _add_from(getattr(child, "models", None) or {})
+
+    return models
+
+
+def _iter_ops(model: type) -> Sequence[OpSpec]:
+    ops = getattr(model, "ops", None)
+    if ops is not None:
+        all_ops = getattr(ops, "all", None)
+        if all_ops is not None:
+            return all_ops
+    opspecs = getattr(model, "opspecs", None)
+    if opspecs is not None:
+        all_ops = getattr(opspecs, "all", None)
+        if all_ops is not None:
+            return all_ops
+    return ()
+
+
+def _schema_with_defs(schema: type[BaseModel]) -> tuple[JsonObject, JsonObject]:
+    raw = schema.model_json_schema(ref_template="#/components/schemas/{model}")
+    defs = raw.pop("$defs", {})
+    return raw, defs
+
+
+def _describe_method(model: type, spec: OpSpec) -> str | None:
+    rpc_ns = getattr(model, "rpc", None)
+    rpc_call = getattr(rpc_ns, spec.alias, None)
+    if rpc_call is None:
+        return None
+    doc = getattr(rpc_call, "__doc__", None)
+    if doc:
+        return doc.strip()
+    return None
+
+
+def build_openrpc_spec(api: Any) -> JsonObject:
+    info_title = getattr(api, "title", None) or getattr(api, "name", None) or "API"
+    info_version = getattr(api, "version", None) or "0.1.0"
+    spec: JsonObject = {
+        "openrpc": "1.2.6",
+        "info": {"title": f"{info_title} JSON-RPC API", "version": info_version},
+        "methods": [],
+        "components": {"schemas": {}},
+    }
+
+    components = spec["components"]["schemas"]
+    methods: List[JsonObject] = []
+
+    for model in _iter_models(api):
+        for op in _iter_ops(model):
+            if not getattr(op, "expose_rpc", True):
+                continue
+
+            method: JsonObject = {"name": f"{model.__name__}.{op.alias}"}
+            description = _describe_method(model, op)
+            if description:
+                method["description"] = description
+
+            alias_ns = getattr(getattr(model, "schemas", None), op.alias, None)
+            in_schema = getattr(alias_ns, "in_", None)
+            out_schema = getattr(alias_ns, "out", None)
+
+            if in_schema is not None:
+                in_json, defs = _schema_with_defs(in_schema)
+                for key, value in defs.items():
+                    components.setdefault(key, value)
+                method["params"] = [
+                    {"name": "params", "schema": in_json, "required": True}
+                ]
+                method["paramStructure"] = "by-name"
+            else:
+                method["params"] = []
+
+            if out_schema is not None:
+                out_json, defs = _schema_with_defs(out_schema)
+                for key, value in defs.items():
+                    components.setdefault(key, value)
+                method["result"] = {"name": "result", "schema": out_json}
+
+            methods.append(method)
+
+    spec["methods"] = sorted(methods, key=lambda item: item["name"])
+    return spec
+
+
+__all__ = ["build_openrpc_spec"]

tigrbl/types/__init__.py

@@ -57,13 +57,12 @@ from ..deps.fastapi import (
     Router,
     Security,
     Depends,
-    Request,
-    Response,
     Path,
     Body,
     HTTPException,
     App,
 )
+from ..deps.starlette import Request, Response
 
 # ── Local Package ─────────────────────────────────────────────────────────
 from .op import _Op, _SchemaVerb

tigrbl/types/authn_abc.py

@@ -1,7 +1,8 @@
 # tigrbl/v3/types/authn_abc.py
 from __future__ import annotations
 from abc import ABC, abstractmethod
-from fastapi import Request
+
+from ..deps.starlette import Request
 
 
 class AuthNProvider(ABC):

{tigrbl-0.3.3.dev2.dist-info → tigrbl-0.3.4.dev2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl
-Version: 0.3.3.dev2
+Version: 0.3.4.dev2
 Summary: Automatic API generation tools by Swarmauri.
 License-Expression: Apache-2.0
 License-File: LICENSE

{tigrbl-0.3.3.dev2.dist-info → tigrbl-0.3.4.dev2.dist-info}/RECORD

@@ -77,8 +77,8 @@ tigrbl/core/crud/helpers/normalize.py,sha256=aDavCusuBDRltFX4baBlztDZ6dvgAG4Qs-D
 tigrbl/core/crud/ops.py,sha256=Qu0A4KNX0LuQdUXC5NcqzaN1aP49_ank4czEHArXcsQ,7900
 tigrbl/ddl/__init__.py,sha256=C9RQLef1l5XCE96CxCs0pN24fNATvOglK1zRYE7BdKY,11352
 tigrbl/decorators.py,sha256=U4iss3iN--4PPGJ90doAcYn4WuDx1dQMw-5Ar4SE7TU,445
-tigrbl/deps/__init__.py,sha256=yzhFPLJX8eXMIV41ar6IXh6ZXdjSlZ-ZYA_FKl-ZxFY,795
-tigrbl/deps/fastapi.py,sha256=qyRcu1c5Xy3RUgNEUxizxQbaZ8i4EdnBmQwJPDBdbCo,1181
+tigrbl/deps/__init__.py,sha256=2SJWOvz7cEMFSXFkeiLS3cOqjzm00nd_uxWKnQCEEYw,758
+tigrbl/deps/fastapi.py,sha256=SnrTwE7taghrkXEjQ8ZCGS8OYsv3E8s9A6u5s9nh5b8,1123
 tigrbl/deps/favicon.svg,sha256=C_S8UPLuLx4QIdP84OpzKw7IiwWjrHIzyKotoUKRLB4,195
 tigrbl/deps/jinja.py,sha256=dau8Y2v9UY3sptLhzP_8MpjKwlU-34_QraNgQXr4OCM,698
 tigrbl/deps/pydantic.py,sha256=cLReo5Gd3V7TDJ9L3sMOFD93FWMd5QnZZoCaOJ6ip14,497
@@ -193,7 +193,7 @@ tigrbl/runtime/executor/__init__.py,sha256=JuFfQo0xo9_C8XW014vdEtMvzNKaugXhLg8tW
 tigrbl/runtime/executor/guards.py,sha256=HiE9J_Y-AslRJZYBrjZmGFecq9Tx4nn6HMqL1jrezLY,4210
 tigrbl/runtime/executor/helpers.py,sha256=PU7Bj7VTdGaldNYuBRsrV4408G4UqxJIWwPUwtUgNaA,2239
 tigrbl/runtime/executor/invoke.py,sha256=IUSkjXXqRDX1cOmDcpXloKHgwI_HRYW2SsqOrKheB8U,4754
-tigrbl/runtime/executor/types.py,sha256=oxgyv5EI2hs2MixjXQAdhNu5nWpQ2F0kXC6pXNU_pSE,2386
+tigrbl/runtime/executor/types.py,sha256=4zQnvW7h3-8f67c2DF7rXGgRanjuGuHqHNo3XMyuS5g,2247
 tigrbl/runtime/kernel.py,sha256=cL1bnw2glp33AjiFchMg8MZsJ3lb7c2JPhz26JejP1I,22895
 tigrbl/runtime/labels.py,sha256=aBXx65lMPlR60wXH4M_xeuXN4w3z07ep6NxICAiSy68,13134
 tigrbl/runtime/opview.py,sha256=UHbQbGg5GGi2AWFip8qBUD6fe6h8VNU232GRly1aT-I,2792
@@ -243,16 +243,17 @@ tigrbl/table/_table.py,sha256=B7ft2SMnbp3aTWKO44M4EWTHmzFKyQlpdj-3QULRaGk,1740
 tigrbl/table/mro_collect.py,sha256=PbuSZnUvVbs3NCe2otie7pvcjxeF54hSiVp_VywclSA,2733
 tigrbl/table/shortcuts.py,sha256=-IZAZyMTsiCdKV0w7nq1C2YBsB6iE_uNGJb-PatlO8I,1716
 tigrbl/table/table_spec.py,sha256=dvilrGWX7fVc6ThTbAqJKxxl3r6_MKNFY0cs_wuyvC8,1001
-tigrbl/transport/__init__.py,sha256=Hq2yob_mvMOQdd8Ts04-rzL282rRpIXo2Prortk0fL4,1896
-tigrbl/transport/jsonrpc/__init__.py,sha256=YZKk9W1GSPkx98G0cshEcDKLWvmeJGjW90PeTJ0z_r4,438
-tigrbl/transport/jsonrpc/dispatcher.py,sha256=Eb-M_0n3npAWkw5NSIDDFklgj_J3p8-46yaXPtaiktI,12620
+tigrbl/transport/__init__.py,sha256=QanSh_0kxBFBg32KNSrrzsQjfV8Lp1BljsLiSnE8cbc,1942
+tigrbl/transport/jsonrpc/__init__.py,sha256=yIuAjf3zQsqezvS0TdzDlfIhtuzMi9_ykSIqjn-w8EM,618
+tigrbl/transport/jsonrpc/dispatcher.py,sha256=KKvN2_Ct1AYiQdww2VO_sgaSkNmL7hLcDEFIpq_ou1s,13018
 tigrbl/transport/jsonrpc/helpers.py,sha256=oyqx36m8n7EofciPVvTEM9Pz1l51zJwsI224AXkE7q8,3010
 tigrbl/transport/jsonrpc/models.py,sha256=omtjb-NN8HyWgIZ5tHafEsbwC7f1XlttAFHFA41Xn2k,973
+tigrbl/transport/jsonrpc/openrpc.py,sha256=FmczSrHkiS17Hdk6nVv_S8bi4oFFG8dPCdGSkJsNKqg,3706
 tigrbl/transport/rest/__init__.py,sha256=AU_twrP0A958FtXvLSf1i60Jn-UZSRUkAZ1Gd2TeYaw,764
 tigrbl/transport/rest/aggregator.py,sha256=V1zDvv1bwpNyt6rUPmEUEV5nORjb5sHU5LJ00m1ybYY,4454
-tigrbl/types/__init__.py,sha256=TSmKjMPDqn_AdZEfYKuGPRkBFsT2P7fqC-BSUXRwZlA,4120
+tigrbl/types/__init__.py,sha256=4Io80FQh3L_gkfsv-TwPnK2wNtEAOYQJHGg-UEEfOAQ,4140
 tigrbl/types/allow_anon_provider.py,sha256=5mWvSfk_eCY_o6oMm1gSEqz6cKyJyoZ1-DcVYm0KmpA,565
-tigrbl/types/authn_abc.py,sha256=GtlXkMb59GEEXNEfeRX_ZfNzu-S4hcLsESzBAaPT2Fg,769
+tigrbl/types/authn_abc.py,sha256=OrKSQQmeaCVh8vqnFM5oL--wdvhdKGocGpQKJjJoG8w,779
 tigrbl/types/nested_path_provider.py,sha256=1z-4Skz_X_hy-XGEAQnNv6vyrfFNsPIvlhBqf457Sjc,609
 tigrbl/types/op.py,sha256=-kdDABEyIBEAMMtatOXVPeMEaGFUiXtJSStZkNu3cnA,769
 tigrbl/types/op_config_provider.py,sha256=tYH_py9niHvLQF9c9OD13Wt8U4hoYxUatJO_Zp5Cs8Q,551
@@ -261,7 +262,7 @@ tigrbl/types/request_extras_provider.py,sha256=JOIpzx1PYA2AYYvkMiXrxlwpBLOPD2cQa
 tigrbl/types/response_extras_provider.py,sha256=sFB0R3vyUqmpT-o8983hH9FAlOq6-wwNVK6vfuCPHCg,653
 tigrbl/types/table_config_provider.py,sha256=EkfOhy9UDfy7EgiZddw9KIl5tRujRjXJlr4cSk1Rm5k,361
 tigrbl/types/uuid.py,sha256=pD-JrhS0L2GXeJ0Hv_oKzRuiXmxHDTVoMqExO48iqZE,1993
-tigrbl-0.3.3.dev2.dist-info/METADATA,sha256=HQ0hReGPk-P9BXAaggKyO3TqZgkOebhiqx2sBCvVSkc,17853
-tigrbl-0.3.3.dev2.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
-tigrbl-0.3.3.dev2.dist-info/licenses/LICENSE,sha256=djUXOlCxLVszShEpZXshZ7v33G-2qIC_j9KXpWKZSzQ,11359
-tigrbl-0.3.3.dev2.dist-info/RECORD,,
+tigrbl-0.3.4.dev2.dist-info/METADATA,sha256=7i4VQfEZPkC92J1q3LXsvLrff5ICX-xVYaXARKDGrT8,17853
+tigrbl-0.3.4.dev2.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+tigrbl-0.3.4.dev2.dist-info/licenses/LICENSE,sha256=djUXOlCxLVszShEpZXshZ7v33G-2qIC_j9KXpWKZSzQ,11359
+tigrbl-0.3.4.dev2.dist-info/RECORD,,

{tigrbl-0.3.3.dev2.dist-info → tigrbl-0.3.4.dev2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.3.0
+Generator: poetry-core 2.3.1
 Root-Is-Purelib: true
 Tag: py3-none-any