tigrbl_tests 0.3.9.dev4__tar.gz → 0.3.10__tar.gz

{tigrbl_tests-0.3.9.dev4 → tigrbl_tests-0.3.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl_tests
-Version: 0.3.9.dev4
+Version: 0.3.10
 Summary: Test suite and fixtures for the Tigrbl framework.
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -33,7 +33,7 @@ Requires-Dist: tigrbl
 Requires-Dist: tigrbl_client
 Description-Content-Type: text/markdown
 
-![Tigrbl Logo](https://github.com/swarmauri/swarmauri-sdk/blob/a170683ecda8ca1c4f912c966d4499649ffb8224/assets/tigrbl.brand.theme.svg)
+![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
 
 <p align="center">
     <a href="https://pypi.org/project/tigrbl-tests/">

{tigrbl_tests-0.3.9.dev4 → tigrbl_tests-0.3.10}/README.md

@@ -1,4 +1,4 @@
-![Tigrbl Logo](https://github.com/swarmauri/swarmauri-sdk/blob/a170683ecda8ca1c4f912c966d4499649ffb8224/assets/tigrbl.brand.theme.svg)
+![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
 
 <p align="center">
     <a href="https://pypi.org/project/tigrbl-tests/">

{tigrbl_tests-0.3.9.dev4 → tigrbl_tests-0.3.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl_tests"
-version = "0.3.9.dev4"
+version = "0.3.10"
 description = "Test suite and fixtures for the Tigrbl framework."
 license = "Apache-2.0"
 readme = "README.md"

{tigrbl_tests-0.3.9.dev4 → tigrbl_tests-0.3.10}/tests/i9n/test_mountable_lens_uvicorn.py

@@ -26,7 +26,7 @@ async def test_lens_mountable_on_tigrbl_app_uvicorn():
             in response.text
         )
         assert (
-            'href="https://esm.sh/@tigrbljs/tigrbl-lens@latest/dist/tigrbl-lens.css"'
+            'href="https://esm.sh/@tigrbljs/tigrbl-lens@latest/dist/tigrbl-lens.css?css"'
             in response.text
         )
         assert 'import { createRoot } from "react-dom/client";' in response.text

{tigrbl_tests-0.3.9.dev4 → tigrbl_tests-0.3.10}/tests/i9n/test_v3_default_rpc_ops.py

@@ -140,6 +140,96 @@ async def test_bulk_methods_absent(client_and_model):
         assert not hasattr(Gadget.rpc, name)
 
 
+@pytest_asyncio.fixture()
+async def wrapper_field_client_and_model():
+    Base3.metadata.clear()
+    Base3.registry.dispose()
+
+    class WrapperNamed(Base3):
+        __tablename__ = "wrapper_named"
+        __allow_unmapped__ = True
+
+        id: Mapped[int] = acol(
+            storage=S(type_=Integer, primary_key=True, autoincrement=True)
+        )
+        data: Mapped[str] = acol(
+            storage=S(type_=String, nullable=False),
+            field=F(required_in=("create",)),
+            io=IO(in_verbs=("create", "update"), out_verbs=("read", "list")),
+        )
+
+        __tigrbl_cols__ = {"id": id, "data": data}
+
+    app = Tigrblv3()
+    api = Tigrblv3(engine=mem())
+    api.include_model(WrapperNamed, prefix="")
+    api.mount_jsonrpc(prefix="/rpc")
+    await api.initialize()
+    app.include_router(api.router)
+    transport = ASGITransport(app=app)
+    client = AsyncClient(transport=transport, base_url="http://test")
+    try:
+        yield client, WrapperNamed
+    finally:
+        await client.aclose()
+
+
+@pytest.mark.i9n
+@pytest.mark.asyncio
+async def test_rpc_create_allows_schema_defined_wrapper_like_fields(
+    wrapper_field_client_and_model,
+):
+    client, _ = wrapper_field_client_and_model
+    payload = {
+        "jsonrpc": "2.0",
+        "method": "WrapperNamed.create",
+        "params": {"data": "legit"},
+        "id": 99,
+    }
+
+    response = await client.post("/rpc", json=payload)
+
+    assert response.status_code == 200
+    body = response.json()
+    assert "error" not in body
+    assert body["result"]["data"] == "legit"
+
+
+@pytest.mark.i9n
+@pytest.mark.asyncio
+@pytest.mark.parametrize("wrapper_key", ["data", "payload", "body", "item"])
+async def test_rpc_create_rejects_wrapper_object(wrapper_key, client_and_model):
+    client, _ = client_and_model
+    payload = {
+        "jsonrpc": "2.0",
+        "method": "Gadget.create",
+        "params": {wrapper_key: {"name": "Wrapped", "age": 7}},
+        "id": 11,
+    }
+
+    response = await client.post("/rpc", json=payload)
+
+    assert response.status_code == 200
+    error = response.json()["error"]
+    assert error["code"] == -32602
+    assert error["message"] == "Invalid params"
+    assert error["data"]["disallowed_keys"] == [wrapper_key]
+
+
+@pytest.mark.i9n
+@pytest.mark.asyncio
+@pytest.mark.parametrize("wrapper_key", ["data", "payload", "body", "item"])
+async def test_rest_create_rejects_wrapper_object(wrapper_key, client_and_model):
+    client, _ = client_and_model
+
+    response = await client.post(
+        "/gadget",
+        json={wrapper_key: {"name": "Wrapped", "age": 7}},
+    )
+
+    assert response.status_code == 422
+
+
 @pytest_asyncio.fixture()
 async def bulk_client_and_model():
     Base3.metadata.clear()
@@ -184,6 +274,31 @@ async def bulk_client_and_model():
         await client.aclose()
 
 
+@pytest.mark.i9n
+@pytest.mark.asyncio
+@pytest.mark.parametrize("wrapper_key", ["data", "payload", "body", "item"])
+async def test_rpc_bulk_create_rejects_wrapper_object_items(
+    wrapper_key,
+    bulk_client_and_model,
+):
+    client, _ = bulk_client_and_model
+
+    payload = {
+        "jsonrpc": "2.0",
+        "method": "Gadget.bulk_create",
+        "params": [{wrapper_key: {"name": "Wrapped", "age": 7}}],
+        "id": 20,
+    }
+
+    response = await client.post("/rpc", json=payload)
+
+    assert response.status_code == 200
+    error = response.json()["error"]
+    assert error["code"] == -32602
+    assert error["message"] == "Invalid params"
+    assert error["data"]["disallowed_keys"] == [wrapper_key]
+
+
 @pytest.mark.i9n
 @pytest.mark.asyncio
 async def test_rpc_bulk_ops(bulk_client_and_model):

tigrbl_tests-0.3.10/tests/request/test_request_asgi_scope_compat.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+from tigrbl.requests import Request
+
+
+def test_request_accepts_scope_with_receive_kwarg_for_compatibility() -> None:
+    scope = {
+        "type": "http",
+        "method": "post",
+        "path": "/rpc",
+        "root_path": "/api",
+        "headers": [(b"authorization", b"Bearer test-token")],
+        "query_string": b"a=1&a=2&b=3",
+        "path_params": {"tenant_id": "abc"},
+        "client": ("198.51.100.77", 443),
+    }
+
+    async def _receive() -> dict[str, object]:
+        return {"type": "http.request", "body": b"", "more_body": False}
+
+    request = Request(scope, receive=_receive)
+
+    assert request.method == "POST"
+    assert request.path == "/rpc"
+    assert str(request.url) == "/api/rpc?a=1&a=2&b=3"
+    assert request.query == {"a": ["1", "2"], "b": ["3"]}
+    assert request.path_params == {"tenant_id": "abc"}
+    assert request.headers.authorization == "Bearer test-token"
+    assert request.bearer_token == "test-token"
+    assert request.client.ip == "198.51.100.77"
+
+
+def test_request_rejects_duplicated_scope_inputs() -> None:
+    scope = {"type": "http", "method": "GET", "path": "/"}
+
+    try:
+        Request(scope, scope=scope)
+    except TypeError as exc:
+        assert "scope cannot be provided" in str(exc)
+    else:  # pragma: no cover - explicit failure branch
+        raise AssertionError("expected Request to reject duplicate scope inputs")

tigrbl_tests-0.3.10/tests/unit/test_jsonrpc_openrpc.py

@@ -0,0 +1,122 @@
+from httpx import ASGITransport, Client
+from sqlalchemy import Column, String
+from tigrbl import Base, TigrblApi, TigrblApp
+from tigrbl.engine.shortcuts import mem
+from tigrbl.orm.mixins import GUIDPk
+
+
+def _build_app():
+    class Widget(Base, GUIDPk):
+        __tablename__ = "widgets_openrpc"
+        name = Column(String, nullable=False)
+
+    app = TigrblApp(engine=mem(async_=False))
+    app.include_model(Widget)
+    app.initialize()
+    app.mount_jsonrpc()
+    return app, Widget
+
+
+def test_openrpc_endpoint_exposed():
+    app, _ = _build_app()
+    transport = ASGITransport(app=app)
+    with Client(transport=transport, base_url="http://test") as client:
+        response = client.get("/openrpc.json")
+
+        assert response.status_code == 200
+        payload = response.json()
+        assert payload["openrpc"] == "1.2.6"
+        assert payload["servers"] == [{"name": app.title, "url": "/rpc"}]
+        assert "methods" in payload
+
+
+def test_openrpc_server_url_respects_jsonrpc_prefix():
+    app, _ = _build_app()
+    app.jsonrpc_prefix = "/rpc/custom"
+    transport = ASGITransport(app=app)
+
+    with Client(transport=transport, base_url="http://test") as client:
+        payload = client.get("/openrpc.json").json()
+
+    assert payload["servers"] == [{"name": app.title, "url": "/rpc/custom"}]
+
+
+def test_openrpc_includes_method_schema():
+    app, model = _build_app()
+    transport = ASGITransport(app=app)
+    with Client(transport=transport, base_url="http://test") as client:
+        payload = client.get("/openrpc.json").json()
+        methods = {method["name"]: method for method in payload["methods"]}
+
+        create_method = methods[f"{model.__name__}.create"]
+        assert create_method["paramStructure"] == "by-name"
+
+        params = create_method["params"][0]["schema"]
+        assert params["title"].startswith(model.__name__)
+        assert "Create" in params["title"]
+
+        result = create_method["result"]["schema"]
+        assert result["title"].startswith(model.__name__)
+        assert "Response" in result["title"]
+
+
+def test_mount_jsonrpc_updates_openrpc_server_url() -> None:
+    app, _ = _build_app()
+    app.mount_jsonrpc(prefix="/jsonrpc")
+    transport = ASGITransport(app=app)
+
+    with Client(transport=transport, base_url="http://test") as client:
+        payload = client.get("/openrpc.json").json()
+
+    assert payload["servers"] == [{"name": app.title, "url": "/jsonrpc"}]
+
+
+def test_jsonrpc_create_accepts_nested_params_mapping() -> None:
+    app, model = _build_app()
+    transport = ASGITransport(app=app)
+
+    request_payload = {
+        "jsonrpc": "2.0",
+        "method": f"{model.__name__}.create",
+        "params": {"params": {"name": "New Widget"}},
+        "id": 1,
+    }
+
+    with Client(transport=transport, base_url="http://test") as client:
+        response = client.post("/rpc", json=request_payload)
+
+    assert response.status_code == 200
+    data = response.json()
+    assert data["id"] == 1
+    assert "error" not in data
+    assert data["result"]["name"] == "New Widget"
+
+
+def test_mount_lens_uses_latest_openrpc_path_by_default() -> None:
+    app, _ = _build_app()
+    app.mount_openrpc(path="/schema/openrpc.json")
+    app.mount_lens(path="/lens-custom")
+
+    transport = ASGITransport(app=app)
+    with Client(transport=transport, base_url="http://test") as client:
+        html = client.get("/lens-custom").text
+
+    assert "/schema/openrpc.json" in html
+
+
+def test_openrpc_server_url_respects_api_mount_jsonrpc_prefix_argument():
+    class Widget(Base, GUIDPk):
+        __tablename__ = "widgets_openrpc_api_mount_prefix"
+        name = Column(String, nullable=False)
+
+    api = TigrblApi(engine=mem(async_=False))
+    api.include_model(Widget)
+    api.initialize()
+    api.mount_jsonrpc(prefix="/jsonrpc")
+    api.mount_openrpc()
+
+    transport = ASGITransport(app=api)
+    with Client(transport=transport, base_url="http://test") as client:
+        payload = client.get("/openrpc.json").json()
+
+    assert payload["servers"] == [{"name": api.title, "url": "/jsonrpc"}]

tigrbl_tests-0.3.10/tests/unit/test_openapi_openrpc_schema_separation.py

@@ -0,0 +1,71 @@
+from httpx import ASGITransport, Client
+
+from tigrbl import Base, TigrblApp
+from tigrbl.engine.shortcuts import mem
+from tigrbl.orm.mixins import GUIDPk
+from tigrbl.specs import F, IO, S, acol
+from tigrbl.types import Mapped, String
+
+
+class Widget(Base, GUIDPk):
+    __tablename__ = "widgets_openapi_openrpc_separation"
+    __allow_unmapped__ = True
+
+    name: Mapped[str] = acol(
+        storage=S(type_=String, nullable=False),
+        field=F(py_type=str),
+        io=IO(in_verbs=("create",), out_verbs=("read", "list")),
+    )
+
+    __tigrbl_cols__ = {"id": GUIDPk.id, "name": name}
+
+
+def _build_app() -> TigrblApp:
+    app = TigrblApp(engine=mem(async_=False))
+    app.include_model(Widget)
+    app.initialize()
+    app.mount_jsonrpc()
+    return app
+
+
+def test_openapi_schema_excludes_openrpc_endpoint() -> None:
+    app = _build_app()
+    transport = ASGITransport(app=app)
+
+    with Client(transport=transport, base_url="http://test") as client:
+        payload = client.get("/openapi.json").json()
+
+    assert "/openrpc.json" not in payload["paths"]
+
+
+def test_openrpc_schema_excludes_openapi_endpoint() -> None:
+    app = _build_app()
+    transport = ASGITransport(app=app)
+
+    with Client(transport=transport, base_url="http://test") as client:
+        payload = client.get("/openrpc.json").json()
+
+    method_names = {method["name"].lower() for method in payload["methods"]}
+    assert all("openapi" not in name for name in method_names)
+    assert all("openrpc" not in name for name in method_names)
+
+
+def test_openapi_schema_excludes_openrpc_even_if_route_is_schema_visible() -> None:
+    app = _build_app()
+
+    def openrpc_override(_request):
+        return {"openrpc": "1.2.6"}
+
+    app.add_api_route(
+        "/openrpc.json",
+        openrpc_override,
+        methods=["GET"],
+        name="openrpc_json",
+        include_in_schema=True,
+    )
+
+    transport = ASGITransport(app=app)
+    with Client(transport=transport, base_url="http://test") as client:
+        payload = client.get("/openapi.json").json()
+
+    assert "/openrpc.json" not in payload["paths"]

tigrbl_tests-0.3.10/tests/unit/test_system_docs_builders.py

@@ -0,0 +1,122 @@
+import pytest
+
+from tigrbl import TigrblApp
+from tigrbl.system import build_lens, build_openapi, build_openrpc_spec, build_swagger
+from tigrbl.types import Request
+
+
+@pytest.mark.unit
+def test_system_build_helpers_return_documents() -> None:
+    app = TigrblApp()
+    request = Request(
+        method="GET", path="/docs", headers={}, query={}, path_params={}, body=b""
+    )
+
+    openapi_doc = build_openapi(app)
+    openrpc_doc = build_openrpc_spec(app)
+    swagger_html = build_swagger(app, request)
+    lens_html = build_lens(app, request, spec_path="/openrpc.json")
+
+    assert openapi_doc["openapi"].startswith("3.")
+    assert openrpc_doc["openrpc"] == "1.2.6"
+    assert openrpc_doc["servers"] == [{"name": app.title, "url": "/rpc"}]
+    assert "swagger-ui" in swagger_html
+    assert "tigrbl-lens" in lens_html
+
+
+@pytest.mark.unit
+def test_openrpc_builder_uses_request_origin_and_jsonrpc_prefix() -> None:
+    app = TigrblApp(jsonrpc_prefix="/gateway/rpc")
+    request = Request(
+        method="GET",
+        path="/openrpc.json",
+        headers={"host": "api.example.com", "x-forwarded-proto": "https"},
+        query={},
+        path_params={},
+        body=b"",
+    )
+
+    openrpc_doc = build_openrpc_spec(app, request=request)
+
+    assert openrpc_doc["servers"] == [
+        {"name": app.title, "url": "https://api.example.com/gateway/rpc"}
+    ]
+
+
+@pytest.mark.unit
+def test_openrpc_builder_normalizes_forwarded_host_header_values() -> None:
+    app = TigrblApp(jsonrpc_prefix="/gateway/rpc")
+    request = Request(
+        method="GET",
+        path="/openrpc.json",
+        headers={
+            "x-forwarded-host": "api.example.com,edge.proxy.internal",
+            "x-forwarded-proto": "https, http",
+        },
+        query={},
+        path_params={},
+        body=b"",
+    )
+
+    openrpc_doc = build_openrpc_spec(app, request=request)
+
+    assert openrpc_doc["servers"] == [
+        {"name": app.title, "url": "https://api.example.com/gateway/rpc"}
+    ]
+
+
+@pytest.mark.unit
+def test_openrpc_builder_prefers_request_scheme_without_forwarded_proto() -> None:
+    app = TigrblApp(jsonrpc_prefix="/gateway/rpc")
+    request = Request(
+        method="GET",
+        path="/openrpc.json",
+        headers={"x-forwarded-host": "api.example.com"},
+        query={},
+        path_params={},
+        body=b"",
+        scope={"scheme": "https"},
+    )
+
+    openrpc_doc = build_openrpc_spec(app, request=request)
+
+    assert openrpc_doc["servers"] == [
+        {"name": app.title, "url": "https://api.example.com/gateway/rpc"}
+    ]
+
+
+@pytest.mark.unit
+def test_openrpc_builder_prefers_forwarded_proto_over_request_scheme() -> None:
+    app = TigrblApp(jsonrpc_prefix="/gateway/rpc")
+    request = Request(
+        method="GET",
+        path="/openrpc.json",
+        headers={"host": "api.example.com", "x-forwarded-proto": "https"},
+        query={},
+        path_params={},
+        body=b"",
+        scope={"scheme": "http"},
+    )
+
+    openrpc_doc = build_openrpc_spec(app, request=request)
+
+    assert openrpc_doc["servers"] == [
+        {"name": app.title, "url": "https://api.example.com/gateway/rpc"}
+    ]
+
+
+@pytest.mark.unit
+def test_openrpc_builder_keeps_relative_server_url_without_forwarding_headers() -> None:
+    app = TigrblApp(jsonrpc_prefix="/gateway/rpc")
+    request = Request(
+        method="GET",
+        path="/openrpc.json",
+        headers={"host": "api.example.com"},
+        query={},
+        path_params={},
+        body=b"",
+    )
+
+    openrpc_doc = build_openrpc_spec(app, request=request)
+
+    assert openrpc_doc["servers"] == [{"name": app.title, "url": "/gateway/rpc"}]

tigrbl_tests-0.3.9.dev4/tests/unit/test_jsonrpc_openrpc.py

@@ -1,49 +0,0 @@
-from httpx import ASGITransport, Client
-from sqlalchemy import Column, String
-from tigrbl import Base, TigrblApp
-from tigrbl.engine.shortcuts import mem
-from tigrbl.orm.mixins import GUIDPk
-
-
-def _build_app():
-    class Widget(Base, GUIDPk):
-        __tablename__ = "widgets_openrpc"
-        name = Column(String, nullable=False)
-
-    app = TigrblApp(engine=mem(async_=False))
-    app.include_model(Widget)
-    app.initialize()
-    app.mount_jsonrpc()
-    return app, Widget
-
-
-def test_openrpc_endpoint_exposed():
-    app, _ = _build_app()
-    transport = ASGITransport(app=app)
-    with Client(transport=transport, base_url="http://test") as client:
-        response = client.get("/openrpc.json")
-
-        assert response.status_code == 200
-        payload = response.json()
-        assert payload["openrpc"] == "1.2.6"
-        assert payload["servers"] == [{"name": app.title, "url": "/jsonrpc"}]
-        assert "methods" in payload
-
-
-def test_openrpc_includes_method_schema():
-    app, model = _build_app()
-    transport = ASGITransport(app=app)
-    with Client(transport=transport, base_url="http://test") as client:
-        payload = client.get("/openrpc.json").json()
-        methods = {method["name"]: method for method in payload["methods"]}
-
-        create_method = methods[f"{model.__name__}.create"]
-        assert create_method["paramStructure"] == "by-name"
-
-        params = create_method["params"][0]["schema"]
-        assert params["title"].startswith(model.__name__)
-        assert "Create" in params["title"]
-
-        result = create_method["result"]["schema"]
-        assert result["title"].startswith(model.__name__)
-        assert "Response" in result["title"]

tigrbl_tests-0.3.9.dev4/tests/unit/test_system_docs_builders.py

@@ -1,24 +0,0 @@
-import pytest
-
-from tigrbl import TigrblApp
-from tigrbl.system import build_lens, build_openapi, build_openrpc_spec, build_swagger
-from tigrbl.types import Request
-
-
-@pytest.mark.unit
-def test_system_build_helpers_return_documents() -> None:
-    app = TigrblApp()
-    request = Request(
-        method="GET", path="/docs", headers={}, query={}, path_params={}, body=b""
-    )
-
-    openapi_doc = build_openapi(app)
-    openrpc_doc = build_openrpc_spec(app)
-    swagger_html = build_swagger(app, request)
-    lens_html = build_lens(app, request, spec_path="/openrpc.json")
-
-    assert openapi_doc["openapi"].startswith("3.")
-    assert openrpc_doc["openrpc"] == "1.2.6"
-    assert openrpc_doc["servers"] == [{"name": app.title, "url": "/jsonrpc"}]
-    assert "swagger-ui" in swagger_html
-    assert "tigrbl-lens" in lens_html