tigrbl_tests 0.4.4.dev1__tar.gz → 0.4.4.dev7__tar.gz

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl_tests
-Version: 0.4.4.dev1
+Version: 0.4.4.dev7
 Summary: Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
 License: Apache License
                                     Version 2.0, January 2004

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl_tests"
-version = "0.4.4.dev1"
+version = "0.4.4.dev7"
 description = "Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities."
 readme = "README.md"
 license = { file = "LICENSE" }

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/architecture/test_runtime_structure.py

@@ -9,10 +9,14 @@ RUNTIME_PKG = _STANDARDS / "tigrbl_runtime" / "tigrbl_runtime"
 
 def test_dependency_invoke_is_runtime_event_anchor():
     system = (RUNTIME_PKG / "runtime" / "system.py").read_text()
-    invoke = (RUNTIME_PKG / "executors" / "invoke.py").read_text()
+    phase_runner = (RUNTIME_PKG / "executors" / "phase_runner.py").read_text()
+    executors_init = (RUNTIME_PKG / "executors" / "__init__.py").read_text()
+    assert not (RUNTIME_PKG / "executors" / "invoke.py").exists()
     assert "DEP_EXTRA" in system
     assert '"PRE_TX_BEGIN"' in system
-    assert '"PRE_TX_BEGIN"' in invoke
+    assert '"PRE_TX_BEGIN"' in phase_runner
+    assert "invoke_op" not in executors_init
+    assert "tigrbl_ops_oltp" not in phase_runner
 
 
 def test_runtime_gateway_owns_runtime_entrypoint_and_send():

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/i9n/test_batch_scheduler_i9n.py

@@ -53,7 +53,7 @@ async def test_batch_scheduler_i9n_executemany_to_grouped_fanout() -> None:
         db=Db(),
         op="create",
         model=object,
-        batch_policy={"enabled": True, "max_size": 2},
+        batch_policy={"enabled": True, "max_size": 2, "max_delay_ms": 60_000},
         temp={},
     )
 

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/i9n/test_resident_batch_scheduler_runtime.py

@@ -31,7 +31,7 @@ class Hot:
     batch = {
         "enabled": True,
         "max_size": 2,
-        "max_delay_ms": 1,
+        "max_delay_ms": 60_000,
         "max_queue_depth": 8,
     }
 

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/i9n/test_webtransport_tigrcorn_bridge.py

@@ -7,6 +7,7 @@ from typing import Any
 import pytest
 
 from tigrbl import WebTransportBindingSpec
+from tigrbl_core._spec import TextFramingSpec
 from tigrbl_core._spec.hook_spec import HookSpec
 from tigrbl_core._spec.hook_types import HookPhase
 from tigrbl_concrete._concrete._app import App as TigrblApp
@@ -77,7 +78,7 @@ def _app(path: str) -> TigrblApp:
             proto="webtransport",
             path=path,
             profile="bidi_stream",
-            inner_framing="text",
+            inner_framing=TextFramingSpec(),
         ),
         tigrbl_exchange="bidirectional_stream",
     )
@@ -132,6 +133,7 @@ async def test_tigrbl_webtransport_bidi_stream_runs_over_tigrcorn_contract_event
         "session_id": "session-1",
         "stream_id": "stream-1",
         "stream_direction": "bidi",
+        "stream_initiator": "client",
         "framing": "text",
         "data": b"echo:hello",
         "more": False,
@@ -220,7 +222,7 @@ async def test_webtransport_bidi_and_unidi_lane_metadata_reaches_hooks() -> None
             proto="webtransport",
             path="/transport/lanes",
             profile="bidi_stream",
-            inner_framing="text",
+            inner_framing=TextFramingSpec(),
         ),
         tigrbl_exchange="bidirectional_stream",
     )

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/i9n/test_webtransport_tigrcorn_session_multiplexing.py

@@ -8,6 +8,7 @@ from typing import Any
 import pytest
 
 from tigrbl import WebTransportBindingSpec
+from tigrbl_core._spec import TextFramingSpec
 from tigrbl_core._spec.hook_spec import HookSpec
 from tigrbl_core._spec.hook_types import HookPhase
 from tigrbl_concrete._concrete._app import App as TigrblApp
@@ -87,7 +88,7 @@ def _app(path: str) -> TigrblApp:
             proto="webtransport",
             path=path,
             profile="bidi_stream",
-            inner_framing="text",
+            inner_framing=TextFramingSpec(),
         ),
         tigrbl_exchange="bidirectional_stream",
     )
@@ -239,7 +240,7 @@ async def test_webtransport_tigrcorn_session_stays_open_for_delayed_lanes() -> N
             proto="webtransport",
             path="/transport/echo-live",
             profile="bidi_stream",
-            inner_framing="text",
+            inner_framing=TextFramingSpec(),
         ),
         tigrbl_exchange="bidirectional_stream",
     )
@@ -266,20 +267,22 @@ async def test_webtransport_tigrcorn_session_stays_open_for_delayed_lanes() -> N
     assert stream_sends == [
         {
             "type": "webtransport.stream.send",
-            "session_id": "session-1",
-            "stream_id": "bidi-1",
-            "stream_direction": "bidi",
-            "framing": "text",
-            "data": b"echo:alpha",
+                "session_id": "session-1",
+                "stream_id": "bidi-1",
+                "stream_direction": "bidi",
+                "stream_initiator": "client",
+                "framing": "text",
+                "data": b"echo:alpha",
             "more": False,
         },
         {
             "type": "webtransport.stream.send",
-            "session_id": "session-1",
-            "stream_id": "bidi-2",
-            "stream_direction": "bidi",
-            "framing": "text",
-            "data": b"echo:beta",
+                "session_id": "session-1",
+                "stream_id": "bidi-2",
+                "stream_direction": "bidi",
+                "stream_initiator": "client",
+                "framing": "text",
+                "data": b"echo:beta",
             "more": False,
         },
     ]
@@ -297,11 +300,11 @@ async def test_webtransport_tigrcorn_session_stays_open_for_delayed_lanes() -> N
     assert [
         (item["direction"], item["type"], item.get("stream_id"), item.get("datagram_id"))
         for item in trace
-        if item["direction"] == "receive"
+        if item["phase"] == "ctx.channel_message"
     ] == [
         ("receive", "webtransport.connect", None, None),
-        ("receive", "webtransport.stream.receive", "bidi-1", None),
-        ("receive", "webtransport.stream.receive", "bidi-2", None),
+        ("bidirectional", "webtransport.stream.receive", "bidi-1", None),
+        ("bidirectional", "webtransport.stream.receive", "bidi-2", None),
         ("receive", "webtransport.datagram.receive", None, "dg-client-1"),
         ("receive", "webtransport.disconnect", None, None),
     ]

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/test_secdeps_execute_in_pre_tx.py

@@ -8,7 +8,7 @@ from tigrbl._spec import OpSpec
 from tigrbl.runtime import events as _ev
 from tigrbl.runtime import system as _sys
 from tigrbl_kernel import Kernel
-from tigrbl_runtime.executors.invoke import invoke_op
+from tigrbl_concrete._mapping.invoke import invoke_op
 
 
 class _FakeDB:

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/unit/decorators/test_declarative_surface.py

@@ -20,6 +20,7 @@ from tigrbl import (
     webtransport_ctx,
 )
 from tigrbl_core.config.constants import HOOK_DECLS_ATTR
+from tigrbl_core._spec import JsonRpcFramingSpec, StreamFramingSpec
 from tests.conftest import mro_collect_decorated_ops
 
 
@@ -80,10 +81,10 @@ def test_alias_surface_decorators_attach_expected_bindings() -> None:
 
     specs = {spec.alias: spec for spec in mro_collect_decorated_ops(Widget)}
     assert isinstance(specs["socket"].bindings[0], WsBindingSpec)
-    assert specs["socket"].bindings[0].framing == "jsonrpc"
+    assert specs["socket"].bindings[0].framing == JsonRpcFramingSpec()
     assert isinstance(specs["events"].bindings[0], SseBindingSpec)
     assert specs["events"].exchange == "server_stream"
-    assert specs["stream"].bindings[0].framing == "stream"
+    assert specs["stream"].bindings[0].framing == StreamFramingSpec()
     assert specs["transport"].bindings[0].proto == "webtransport"
 
 

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/unit/runtime/test_binding_exchange_normalization_contract.py

@@ -66,12 +66,12 @@ def test_transport_bindings_project_canonical_exchange_family_and_subevents() ->
         ),
         (
             binding_spec.HttpStreamBindingSpec(proto="http.stream", path="/items/stream"),
-            {
-                "proto": "http.stream",
-                "exchange": "server_stream",
-                "framing": "stream",
-                "family": "stream",
-            },
+                {
+                    "proto": "http.stream",
+                    "exchange": "server_stream",
+                    "framing": "stream",
+                    "family": "stream",
+                },
         ),
         (
             binding_spec.SseBindingSpec(path="/items/events"),
@@ -96,7 +96,7 @@ def test_transport_bindings_project_canonical_exchange_family_and_subevents() ->
             {
                 "proto": "webtransport",
                 "exchange": "bidirectional_stream",
-                "framing": "webtransport",
+                "framing": "",
                 "family": "session",
             },
         ),

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/unit/runtime/test_binding_token_lowering_contract.py

@@ -20,6 +20,10 @@ from tigrbl import (
 )
 from tigrbl_core._spec import (
     HttpStreamBindingSpec,
+    BytesFramingSpec,
+    JsonFramingSpec,
+    JsonRpcFramingSpec,
+    NdjsonFramingSpec,
     OpSpec,
     TableProfileError,
     TableProfileSpec,
@@ -44,7 +48,7 @@ def test_binding_tokens_have_canonical_shape() -> None:
     assert token.op_alias == "create"
     assert token.op_target == "create"
     assert token.binding_kind == "http.rest"
-    assert token.path == "/create"
+    assert token.path == "/resttable"
     assert token.methods == ("POST",)
     assert token.framing == "json"
     assert token.exchange == "request_response"
@@ -136,9 +140,9 @@ def test_oltp_and_olap_token_details_preserve_protocol_specific_selectors() -> N
     jsonrpc_olap = {token.op_alias: token for token in _tokens(JsonRpcOlapTable)}
 
     assert rest_oltp["merge"].methods == ("PATCH",)
-    assert rest_oltp["merge"].path == "/merge"
-    assert rest_olap["aggregate"].methods == ("GET",)
-    assert rest_olap["aggregate"].path == "/aggregate"
+    assert rest_oltp["merge"].path == "/restoltptable/{item_id}"
+    assert rest_olap["aggregate"].methods == ("POST",)
+    assert rest_olap["aggregate"].path == "/restolaptable"
     assert jsonrpc_oltp["merge"].rpc_method == "JsonRpcOltpTable.merge"
     assert jsonrpc_oltp["merge"].framing == "jsonrpc"
     assert jsonrpc_olap["aggregate"].rpc_method == "JsonRpcOlapTable.aggregate"
@@ -152,7 +156,7 @@ def test_dual_tokens_keep_independent_rest_path_and_jsonrpc_method() -> None:
 
     merge = pairs["merge"]
 
-    assert merge["http.rest"].path == "/merge"
+    assert merge["http.rest"].path == "/restjsonrpcoltptable/{item_id}"
     assert merge["http.rest"].methods == ("PATCH",)
     assert merge["http.rest"].rpc_method is None
     assert merge["http.jsonrpc"].path == ""
@@ -189,7 +193,7 @@ def test_rest_binding_tokens_include_method_path_and_media_type() -> None:
     assert tokens["update"].methods == ("PATCH",)
     assert tokens["replace"].methods == ("PUT",)
     assert tokens["delete"].methods == ("DELETE",)
-    assert tokens["list"].path == "/list"
+    assert tokens["list"].path == "/resttable"
     assert tokens["list"].framing == "json"
 
 
@@ -205,7 +209,11 @@ def test_websocket_binding_tokens_include_framing_and_session_lanes() -> None:
     tokens = _tokens(WebSocketJsonRpcTable)
 
     assert {token.binding_kind for token in tokens} == {"ws"}
+    assert {token.protocol_kind for token in tokens} == {"ws"}
     assert {token.framing for token in tokens} == {"jsonrpc"}
+    assert {token.framing_kind for token in tokens} == {"jsonrpc"}
+    assert {token.framing_spec for token in tokens} == {"JsonRpcFramingSpec"}
+    assert {token.required_subprotocol for token in tokens} == {"jsonrpc"}
     assert {tuple(binding.subprotocols) for op in TableSpec.collect(WebSocketJsonRpcTable).ops for binding in op.bindings} == {
         ("jsonrpc",)
     }
@@ -221,6 +229,73 @@ def test_webtransport_binding_tokens_include_stream_and_datagram_lanes() -> None
     assert {token.op_target for token in datagram_tokens} == {"send_datagram"}
 
 
+def test_webtransport_op_lane_binding_contract() -> None:
+    profile = TableProfileSpec(
+        kind="webtransport_ops",
+        ops=(
+            OpSpec(alias="create", target="create"),
+            OpSpec(alias="tail", target="tail"),
+            OpSpec(alias="append_chunk", target="append_chunk"),
+            OpSpec(alias="send_datagram", target="send_datagram"),
+            OpSpec(alias="open_unidi_stream", target="open_unidi_stream"),
+        ),
+    )
+
+    lowered = lower_table_profile_bindings(WebTransportBidiTable, profile, tuple(profile.ops))
+    by_target = {op.target: op.bindings[0] for op in lowered}
+
+    assert (by_target["create"].lane, by_target["create"].inner_framing) == (
+        "bidi_stream",
+        JsonRpcFramingSpec(),
+    )
+    assert (by_target["tail"].lane, by_target["tail"].inner_framing) == (
+        "unidi_server_stream",
+        NdjsonFramingSpec(),
+    )
+    assert (
+        by_target["append_chunk"].lane,
+        by_target["append_chunk"].inner_framing,
+    ) == ("unidi_client_stream", BytesFramingSpec())
+    assert (
+        by_target["send_datagram"].lane,
+        by_target["send_datagram"].inner_framing,
+    ) == ("datagram", JsonFramingSpec())
+    assert (
+        by_target["open_unidi_stream"].lane,
+        by_target["open_unidi_stream"].inner_framing,
+    ) == ("bidi_stream", JsonRpcFramingSpec())
+
+
+def test_canonical_binding_token_typed_framing_fields() -> None:
+    profile = TableProfileSpec(
+        kind="tests.explicit-ws-jsonrpc",
+        ops=(
+            OpSpec(
+                alias="create",
+                target="create",
+                bindings=(
+                    WebTransportBindingSpec(
+                        profile="bidi_stream",
+                        inner_framing=JsonRpcFramingSpec(),
+                    ),
+                ),
+            ),
+        ),
+        custom=True,
+        namespace="tests",
+    )
+    op = tuple(profile.ops)[0]
+
+    token = lower_binding_tokens_for_ops(WebTransportBidiTable, profile, (op,))[0]
+
+    assert token.protocol_kind == "webtransport"
+    assert token.framing == ""
+    assert token.framing_kind == ""
+    assert token.framing_spec == ""
+    assert token.lane == "bidi_stream"
+    assert token.inner_framing == "jsonrpc"
+
+
 def test_binding_token_lowering_rejects_unsupported_transport_profile_pairs() -> None:
     profile = make_table_profile("stream", ())
     op = OpSpec(alias="create", target="create")
@@ -230,8 +305,8 @@ def test_binding_token_lowering_rejects_unsupported_transport_profile_pairs() ->
 
 
 def test_binding_token_lowering_rejects_unsupported_framing_fallback() -> None:
-    with pytest.raises(ValueError, match="inner framing"):
-        WebTransportBindingSpec(profile="datagram", inner_framing="jsonrpc")
+    with pytest.raises(TypeError, match="FramingSpec"):
+        WebTransportBindingSpec(profile="datagram", inner_framing="ndjson")
 
 
 def test_binding_token_lowering_reports_source_precedence() -> None:

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/unit/runtime/test_bindingspec_event_subevent_schema_contract.py

@@ -69,7 +69,7 @@ def _require(module_name: str, attr_name: str):
             {
                 "exchange": "bidirectional_stream",
                 "family": "session",
-                "framing": "webtransport",
+                "framing": "",
                 "subevents": ("session.open", "stream.received", "datagram.received", "session.close"),
             },
         ),

{tigrbl_tests-0.4.4.dev1 → tigrbl_tests-0.4.4.dev7}/tests/unit/runtime/test_bindingspec_kernelplan_protocol_compilation_contract.py

@@ -4,6 +4,8 @@ import importlib
 
 import pytest
 
+from tigrbl_core._spec.binding_spec import JsonRpcFramingSpec
+
 
 def _require(module_name: str, attr_name: str):
     try:
@@ -29,7 +31,7 @@ def _require(module_name: str, attr_name: str):
         ),
         (
             {"kind": "http.stream", "path": "/stream"},
-            {"family": "stream", "framing": "stream", "anchors": ("transport.emit", "transport.emit_complete")},
+            {"family": "stream", "framing": "bytes", "anchors": ("transport.emit", "transport.emit_complete")},
         ),
         (
             {"kind": "http.sse", "path": "/events"},
@@ -41,7 +43,7 @@ def _require(module_name: str, attr_name: str):
         ),
         (
             {"kind": "webtransport", "path": "/transport"},
-            {"family": "session", "framing": "webtransport", "anchors": ("transport.accept", "dispatch.subevent.derive", "transport.close")},
+            {"family": "session", "framing": "", "anchors": ("transport.accept", "dispatch.subevent.derive", "transport.close")},
         ),
     ),
 )
@@ -71,6 +73,59 @@ def test_protocol_compilation_is_deterministic_for_equivalent_bindings() -> None
     assert first == second
 
 
+def test_kernel_protocol_plan_accepts_typed_websocket_framing_spec() -> None:
+    compile_binding = _require("tigrbl_kernel.protocol_bindings", "compile_binding_protocol_plan")
+
+    plan = compile_binding(
+        op_id="Socket.rpc",
+        binding={"kind": "ws", "path": "/socket", "framing": JsonRpcFramingSpec()},
+    )
+
+    assert plan["framing"] == "jsonrpc"
+    assert plan["framing_kind"] == "jsonrpc"
+    assert plan["framing_spec"] == "JsonRpcFramingSpec"
+    assert plan["websocket_subprotocol"] == "jsonrpc"
+    assert "required_subprotocol" not in plan
+    assert "subprotocols" not in plan
+    assert plan["event_key_inputs"]["websocket_subprotocol"] == "jsonrpc"
+
+
+def test_kernel_protocol_plan_rejects_conflicting_websocket_subprotocol() -> None:
+    compile_binding = _require("tigrbl_kernel.protocol_bindings", "compile_binding_protocol_plan")
+
+    with pytest.raises(ValueError, match="conflicts with subprotocols"):
+        compile_binding(
+            op_id="Socket.rpc",
+            binding={
+                "kind": "ws",
+                "path": "/socket",
+                "framing": JsonRpcFramingSpec(),
+                "subprotocols": ("graphql-ws",),
+            },
+        )
+
+
+def test_kernel_protocol_plan_normalizes_webtransport_inner_framing_spec() -> None:
+    compile_binding = _require("tigrbl_kernel.protocol_bindings", "compile_binding_protocol_plan")
+
+    plan = compile_binding(
+        op_id="Transport.create",
+        binding={
+            "kind": "webtransport",
+            "path": "/wt",
+            "profile": "bidi_stream",
+            "inner_framing": JsonRpcFramingSpec(),
+        },
+    )
+
+    assert plan["framing"] == "jsonrpc"
+    assert plan["framing_kind"] == "jsonrpc"
+    assert plan["framing_spec"] == "JsonRpcFramingSpec"
+    assert plan["inner_framing"] == "jsonrpc"
+    assert plan["inner_framing_spec"] == "JsonRpcFramingSpec"
+    assert plan["event_key_inputs"]["inner_framing"] == "jsonrpc"
+
+
 def test_protocol_compilation_emits_lifecycle_matrix_rows_for_each_subevent() -> None:
     compile_binding = _require("tigrbl_kernel.protocol_bindings", "compile_binding_protocol_plan")
 
@@ -98,6 +153,7 @@ def test_protocol_compilation_uses_bindingspec_as_source_of_truth_not_transport_
         {"kind": "http.rest", "path": "/items", "framing": "sse"},
         {"kind": "http.jsonrpc", "path": "/rpc"},
         {"kind": "ws", "path": "/socket", "methods": ("GET",)},
+        {"kind": "webtransport", "path": "/transport", "framing": "webtransport"},
         {"kind": "webtransport", "path": "/transport", "exchange": "request_response"},
     ),
 )