tigrbl_tests 0.3.12.dev16__tar.gz → 0.3.22.dev1__tar.gz

tigrbl_tests-0.3.22.dev1/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: tigrbl_tests
+Version: 0.3.22.dev1
+Summary: Test suite and fixtures for the Tigrbl framework.
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: tigrbl,tests,sdk,standards,pytest,fixtures,integration,performance
+Author: Jacob Stewart
+Author-email: jacob@swarmauri.com
+Requires-Python: >=3.10,<3.14
+Classifier: Development Status :: 1 - Planning
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Dist: asyncpg (>=0.30.0)
+Requires-Dist: flake8 (>=7.0)
+Requires-Dist: jinja2 (>=3.1.0)
+Requires-Dist: psycopg2-binary (>=2.9.9)
+Requires-Dist: pytest (>=8.0)
+Requires-Dist: pytest-asyncio (>=0.24.0)
+Requires-Dist: pytest-benchmark (>=4.0.0)
+Requires-Dist: pytest-json-report (>=1.5.0)
+Requires-Dist: pytest-timeout (>=2.3.1)
+Requires-Dist: pytest-xdist (>=3.6.1)
+Requires-Dist: python-dotenv
+Requires-Dist: requests (>=2.32.3)
+Requires-Dist: ruff (>=0.9.9)
+Requires-Dist: tigrbl
+Requires-Dist: tigrbl_client
+Description-Content-Type: text/markdown
+
+# tigrbl_tests
+
+This file is a package-local distribution entry point.
+It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
+
+## Canonical repository docs
+
+- `README.md`
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+
+## Package identity
+
+- workspace path: `pkgs/core/tigrbl_tests`
+- workspace class: core Python package
+- implementation layout: `tigrbl_tests/`
+
+Long-form repository documentation is governed from `docs/`.
+

tigrbl_tests-0.3.22.dev1/README.md

@@ -0,0 +1,23 @@
+# tigrbl_tests
+
+This file is a package-local distribution entry point.
+It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
+
+## Canonical repository docs
+
+- `README.md`
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+
+## Package identity
+
+- workspace path: `pkgs/core/tigrbl_tests`
+- workspace class: core Python package
+- implementation layout: `tigrbl_tests/`
+
+Long-form repository documentation is governed from `docs/`.

{tigrbl_tests-0.3.12.dev16 → tigrbl_tests-0.3.22.dev1}/pyproject.toml

@@ -1,18 +1,18 @@
 [project]
 name = "tigrbl_tests"
-version = "0.3.12.dev16"
+version = "0.3.22.dev1"
 description = "Test suite and fixtures for the Tigrbl framework."
 license = "Apache-2.0"
 readme = "README.md"
 repository = "http://github.com/swarmauri/swarmauri-sdk"
-requires-python = ">=3.10,<3.13"
+requires-python = ">=3.10,<3.14"
 classifiers = [
     "Development Status :: 1 - Planning",
-    "License :: OSI Approved :: Apache Software License",
     "Natural Language :: English",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
@@ -78,3 +78,8 @@ build-backend = "poetry.core.masonry.api"
 packages = [
     { include = "tests" },
 ]
+
+[dependency-groups]
+dev = [
+    "ruff>=0.11.0",
+]

tigrbl_tests-0.3.22.dev1/tests/__init__.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from tigrbl import TigrblApp, TigrblRouter
+
+
+app = TigrblApp(title="CLI Smoke App", version="8.0.0", mount_system=False)
+router = TigrblRouter()
+
+
+@router.get("/ping")
+def ping() -> dict[str, bool]:
+    return {"ok": True}
+
+
+@router.websocket("/ws/echo")
+async def echo_socket(ws) -> None:
+    await ws.accept()
+    await ws.close()
+
+
+app.include_router(router)
+
+
+def build_app() -> TigrblApp:
+    return app

{tigrbl_tests-0.3.12.dev16 → tigrbl_tests-0.3.22.dev1}/tests/architecture/test_runtime_structure.py

@@ -17,10 +17,13 @@ def test_runtime_gateway_owns_runtime_entrypoint_and_send():
     runtime_source = (RUNTIME_PKG / "runtime" / "runtime.py").read_text()
     executor_source = (RUNTIME_PKG / "executors" / "kernel_executor.py").read_text()
     packed_source = (RUNTIME_PKG / "executors" / "packed.py").read_text()
+    channel_source = (RUNTIME_PKG / "channel" / "websocket.py").read_text()
 
     assert "kernel.kernel_plan(app)" in runtime_source
     assert "await _invoke(" in executor_source
     assert "_send_transport_response" in packed_source
+    assert "dispatch_legacy_websocket" not in packed_source
+    assert "class RuntimeWebSocket" in channel_source
 
 
 def test_docs_generation_reads_secdeps_metadata():

{tigrbl_tests-0.3.12.dev16 → tigrbl_tests-0.3.22.dev1}/tests/conftest.py

@@ -17,7 +17,7 @@ from tigrbl_core._spec import StorageTransform
 from tigrbl_core.schema import builder as v3_builder
 from tigrbl_runtime.runtime import kernel as runtime_kernel
 from tigrbl_runtime.runtime import system as runtime_system
-from tigrbl.shortcuts.engine import mem, sqlitef
+from tigrbl.factories.engine import mem, sqlitef
 from tigrbl_concrete._concrete import engine_resolver as _resolver
 from tigrbl_concrete import (
     build_handlers as _materialize_handlers,
@@ -659,3 +659,4 @@ class mapping_plan:
     @staticmethod
     def plan(ctx):
         return SimpleNamespace(visible_specs=tuple(resolve_ops(ctx.model)))
+

tigrbl_tests-0.3.22.dev1/tests/fixtures/appspec_corpus.canonical.json

@@ -0,0 +1,55 @@
+{
+  "schema_version": "1.0.0",
+  "kind": "appspec_corpus",
+  "lane": "canonical",
+  "cases": [
+    {
+      "id": "appspec-canonical-rest-rpc-roundtrip-001",
+      "title": "Canonical REST and JSON-RPC create roundtrip",
+      "mode": "rest_rpc_roundtrip",
+      "app": {
+        "title": "CorpusHarness",
+        "version": "0.0.0",
+        "jsonrpc_prefix": "/rpcx",
+        "system_prefix": "/system"
+      },
+      "table": {
+        "tablename": "harness_appspec_corpus_roundtrip",
+        "resource": "widget"
+      },
+      "expect": {
+        "rest_status": [
+          200,
+          201
+        ],
+        "rpc_status": [
+          200
+        ]
+      }
+    },
+    {
+      "id": "appspec-canonical-rest-rpc-parity-002",
+      "title": "Canonical REST write is visible to JSON-RPC list",
+      "mode": "rest_rpc_parity",
+      "app": {
+        "title": "CorpusHarness",
+        "version": "0.0.0",
+        "jsonrpc_prefix": "/rpcx",
+        "system_prefix": "/system"
+      },
+      "table": {
+        "tablename": "harness_appspec_corpus_parity",
+        "resource": "widget"
+      },
+      "expect": {
+        "rest_status": [
+          200,
+          201
+        ],
+        "rpc_status": [
+          200
+        ]
+      }
+    }
+  ]
+}

tigrbl_tests-0.3.22.dev1/tests/fixtures/appspec_corpus.negative.json

@@ -0,0 +1,44 @@
+{
+  "schema_version": "1.0.0",
+  "kind": "appspec_corpus",
+  "lane": "negative",
+  "cases": [
+    {
+      "id": "appspec-negative-no-rpc-binding-no-mount-001",
+      "title": "Fail closed when AppSpec has no JSON-RPC bindings",
+      "mode": "no_rpc_binding_no_mount",
+      "app": {
+        "title": "CorpusHarnessNegative",
+        "version": "0.0.0",
+        "jsonrpc_prefix": "/rpcx",
+        "system_prefix": "/system"
+      },
+      "table": {
+        "tablename": "harness_appspec_corpus_no_rpc",
+        "resource": "widget"
+      },
+      "expect": {
+        "rpc_mount_absent": true
+      }
+    },
+    {
+      "id": "appspec-negative-unknown-rpc-method-404-002",
+      "title": "Fail closed when RPC method is not declared",
+      "mode": "unknown_rpc_method_404",
+      "app": {
+        "title": "CorpusHarnessNegative",
+        "version": "0.0.0",
+        "jsonrpc_prefix": "/rpcx",
+        "system_prefix": "/system"
+      },
+      "table": {
+        "tablename": "harness_appspec_corpus_unknown_rpc",
+        "resource": "widget"
+      },
+      "expect": {
+        "status": 404,
+        "detail": "No runtime operation matched request."
+      }
+    }
+  ]
+}

tigrbl_tests-0.3.22.dev1/tests/fixtures/appspec_corpus_loader.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+from typing import Any
+
+CASE_ID_RE = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*-\d{3}$")
+FIXTURE_DIR = Path(__file__).resolve().parent
+
+
+def load_corpus(filename: str) -> dict[str, Any]:
+    path = FIXTURE_DIR / filename
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def validate_corpus(document: dict[str, Any], *, lane: str) -> None:
+    if document.get("schema_version") != "1.0.0":
+        raise ValueError("schema_version must be 1.0.0")
+    if document.get("kind") != "appspec_corpus":
+        raise ValueError("kind must be appspec_corpus")
+    if document.get("lane") != lane:
+        raise ValueError(f"lane must be {lane}")
+
+    cases = document.get("cases")
+    if not isinstance(cases, list) or not cases:
+        raise ValueError("cases must be a non-empty list")
+
+    seen_ids: set[str] = set()
+    for case in cases:
+        if not isinstance(case, dict):
+            raise ValueError("every case must be an object")
+        case_id = case.get("id")
+        if not isinstance(case_id, str) or not CASE_ID_RE.fullmatch(case_id):
+            raise ValueError(f"invalid case id: {case_id!r}")
+        if case_id in seen_ids:
+            raise ValueError(f"duplicate case id: {case_id}")
+        seen_ids.add(case_id)
+
+        if not isinstance(case.get("mode"), str):
+            raise ValueError(f"case {case_id} must include mode")
+        if not isinstance(case.get("title"), str):
+            raise ValueError(f"case {case_id} must include title")
+        if not isinstance(case.get("app"), dict):
+            raise ValueError(f"case {case_id} must include app object")
+        if not isinstance(case.get("table"), dict):
+            raise ValueError(f"case {case_id} must include table object")
+        if not isinstance(case.get("expect"), dict):
+            raise ValueError(f"case {case_id} must include expect object")

tigrbl_tests-0.3.22.dev1/tests/fixtures/cli_smoke_app.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from tigrbl import TigrblApp, TigrblRouter
+
+
+app = TigrblApp(title="CLI Smoke App", version="8.0.0", mount_system=False)
+router = TigrblRouter()
+
+
+@router.get("/ping")
+def ping() -> dict[str, bool]:
+    return {"ok": True}
+
+
+@router.websocket("/ws/echo")
+async def echo_socket(ws) -> None:
+    await ws.accept()
+    await ws.close()
+
+
+app.include_router(router)
+
+
+def build_app() -> TigrblApp:
+    return app

{tigrbl_tests-0.3.12.dev16 → tigrbl_tests-0.3.22.dev1}/tests/harness/test_03_appspec_uvicorn_e2e.py

@@ -28,7 +28,7 @@ async def test_appspec_to_uvicorn_rest_and_rpc_roundtrip() -> None:
     from tigrbl import TableBase
     from tigrbl._spec import AppSpec
     from tigrbl import TigrblApp
-    from tigrbl.shortcuts.engine import mem
+    from tigrbl.factories.engine import mem
     from tigrbl.orm.mixins import GUIDPk
     from tigrbl._spec import OpSpec
     from tigrbl._spec import HttpJsonRpcBindingSpec, HttpRestBindingSpec
@@ -84,3 +84,4 @@ async def test_appspec_to_uvicorn_rest_and_rpc_roundtrip() -> None:
         assert body["result"]["name"] == "beta"
     finally:
         await stop_uvicorn_server(server, task)
+

tigrbl_tests-0.3.22.dev1/tests/harness/test_04_appspec_corpus_fixture.py

@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+from sqlalchemy import Column, String
+import pytest
+
+from tigrbl import TableBase, TigrblApp
+from tigrbl._spec import AppSpec, HttpJsonRpcBindingSpec, HttpRestBindingSpec, OpSpec
+from tigrbl.factories.engine import mem
+from tigrbl.orm.mixins import GUIDPk
+from tigrbl_tests.tests.fixtures.appspec_corpus_loader import load_corpus, validate_corpus
+
+
+def _make_widget_model(*, tablename: str, resource: str, include_jsonrpc: bool) -> type:
+    class Widget(TableBase, GUIDPk):
+        __tablename__ = tablename
+        __resource__ = resource
+        __allow_unmapped__ = True
+        name = Column(String, nullable=False)
+
+    bindings: list[object] = [
+        HttpRestBindingSpec(proto="http.rest", path=f"/{resource}", methods=("POST",))
+    ]
+    if include_jsonrpc:
+        bindings.append(
+            HttpJsonRpcBindingSpec(proto="http.jsonrpc", rpc_method="Widget.create")
+        )
+
+    Widget.__tigrbl_ops__ = (
+        OpSpec(alias="create", target="create", bindings=tuple(bindings)),
+    )
+    return Widget
+
+
+@pytest.mark.acceptance
+@pytest.mark.parametrize(
+    ("filename", "lane"),
+    [
+        ("appspec_corpus.canonical.json", "canonical"),
+        ("appspec_corpus.negative.json", "negative"),
+    ],
+)
+def test_appspec_corpus_fixture_schema_and_ids(filename: str, lane: str) -> None:
+    corpus = load_corpus(filename)
+    validate_corpus(corpus, lane=lane)
+
+
+@pytest.mark.acceptance
+def test_canonical_corpus_materializes_rpc_mounts() -> None:
+    corpus = load_corpus("appspec_corpus.canonical.json")
+    validate_corpus(corpus, lane="canonical")
+
+    for case in corpus["cases"]:
+        widget = _make_widget_model(
+            tablename=case["table"]["tablename"],
+            resource=case["table"]["resource"],
+            include_jsonrpc=True,
+        )
+        spec = AppSpec(
+            title=case["app"]["title"],
+            version=case["app"]["version"],
+            engine=mem(async_=False),
+            tables=(widget,),
+            jsonrpc_prefix=case["app"]["jsonrpc_prefix"],
+            system_prefix=case["app"]["system_prefix"],
+        )
+        app = TigrblApp.from_spec(spec)
+
+        paths = {getattr(route, "path", None) for route in getattr(app, "routes", ())}
+        rpc_prefix = case["app"]["jsonrpc_prefix"]
+
+        assert isinstance(app, TigrblApp)
+        assert getattr(app, "title", None) == case["app"]["title"]
+        assert getattr(app, "version", None) == case["app"]["version"]
+        assert rpc_prefix in paths or f"{rpc_prefix}/" in paths
+
+
+@pytest.mark.acceptance
+def test_negative_corpus_fail_closed_no_rpc_mount() -> None:
+    corpus = load_corpus("appspec_corpus.negative.json")
+    validate_corpus(corpus, lane="negative")
+
+    case = next(c for c in corpus["cases"] if c["mode"] == "no_rpc_binding_no_mount")
+    widget = _make_widget_model(
+        tablename=case["table"]["tablename"],
+        resource=case["table"]["resource"],
+        include_jsonrpc=False,
+    )
+    spec = AppSpec(
+        title=case["app"]["title"],
+        version=case["app"]["version"],
+        engine=mem(async_=False),
+        tables=(widget,),
+        jsonrpc_prefix=case["app"]["jsonrpc_prefix"],
+        system_prefix=case["app"]["system_prefix"],
+    )
+    app = TigrblApp.from_spec(spec)
+    paths = {getattr(route, "path", None) for route in getattr(app, "routes", ())}
+    rpc_prefix = case["app"]["jsonrpc_prefix"]
+
+    assert rpc_prefix not in paths
+    assert f"{rpc_prefix}/" not in paths

tigrbl_tests-0.3.22.dev1/tests/harness/test_05_appspec_metamorphic.py

@@ -0,0 +1,151 @@
+from __future__ import annotations
+
+from collections.abc import Iterable
+
+import pytest
+from sqlalchemy import Column, String
+
+from tigrbl import TableBase, TigrblApp
+from tigrbl._spec import AppSpec, HttpJsonRpcBindingSpec, HttpRestBindingSpec, OpSpec
+from tigrbl.factories.engine import mem
+from tigrbl.orm.mixins import GUIDPk
+from tigrbl_tests.tests.fixtures.appspec_corpus_loader import (
+    load_corpus,
+    validate_corpus,
+)
+
+
+def _make_widget_model(
+    *,
+    class_name: str,
+    tablename: str,
+    resource: str,
+    binding_order: Iterable[str] = ("rest", "jsonrpc"),
+) -> type:
+    bindings_by_kind = {
+        "rest": HttpRestBindingSpec(
+            proto="http.rest",
+            path=f"/{resource}",
+            methods=("POST",),
+        ),
+        "jsonrpc": HttpJsonRpcBindingSpec(
+            proto="http.jsonrpc",
+            rpc_method=f"{class_name}.create",
+        ),
+    }
+
+    attrs = {
+        "__tablename__": tablename,
+        "__resource__": resource,
+        "__allow_unmapped__": True,
+        "name": Column(String, nullable=False),
+    }
+    widget = type(class_name, (TableBase, GUIDPk), attrs)
+    widget.__tigrbl_ops__ = (
+        OpSpec(
+            alias="create",
+            target="create",
+            bindings=tuple(bindings_by_kind[kind] for kind in binding_order),
+        ),
+    )
+    return widget
+
+
+def _materialize_app(
+    *,
+    case: dict,
+    tables: tuple[type, ...],
+    title: str | None = None,
+    version: str | None = None,
+) -> TigrblApp:
+    spec = AppSpec(
+        title=title or case["app"]["title"],
+        version=version or case["app"]["version"],
+        engine=mem(async_=False),
+        tables=tables,
+        jsonrpc_prefix=case["app"]["jsonrpc_prefix"],
+        system_prefix=case["app"]["system_prefix"],
+    )
+    return TigrblApp.from_spec(spec)
+
+
+def _route_signature(app: TigrblApp) -> frozenset[tuple[str, tuple[str, ...]]]:
+    signature: set[tuple[str, tuple[str, ...]]] = set()
+    for route in getattr(app, "routes", ()):
+        path = getattr(route, "path", None)
+        if not isinstance(path, str):
+            continue
+        methods = tuple(sorted(getattr(route, "methods", ()) or ()))
+        signature.add((path, methods))
+    return frozenset(signature)
+
+
+@pytest.mark.acceptance
+def test_appspec_metadata_transform_preserves_route_surface() -> None:
+    corpus = load_corpus("appspec_corpus.canonical.json")
+    validate_corpus(corpus, lane="canonical")
+    case = corpus["cases"][0]
+
+    widget = _make_widget_model(
+        class_name="MetamorphicWidget",
+        tablename=f"{case['table']['tablename']}_metadata",
+        resource=case["table"]["resource"],
+    )
+    baseline = _materialize_app(case=case, tables=(widget,))
+    transformed = _materialize_app(
+        case=case,
+        tables=(widget,),
+        title=f"{case['app']['title']} Transformed",
+        version="9.9.9",
+    )
+
+    assert getattr(transformed, "title", None) != getattr(baseline, "title", None)
+    assert _route_signature(transformed) == _route_signature(baseline)
+
+
+@pytest.mark.acceptance
+def test_appspec_binding_order_transform_preserves_route_surface() -> None:
+    corpus = load_corpus("appspec_corpus.canonical.json")
+    validate_corpus(corpus, lane="canonical")
+    case = corpus["cases"][0]
+
+    rest_first = _make_widget_model(
+        class_name="MetamorphicBindingRestFirst",
+        tablename=f"{case['table']['tablename']}_rest_first",
+        resource=case["table"]["resource"],
+        binding_order=("rest", "jsonrpc"),
+    )
+    rpc_first = _make_widget_model(
+        class_name="MetamorphicBindingRpcFirst",
+        tablename=f"{case['table']['tablename']}_rpc_first",
+        resource=case["table"]["resource"],
+        binding_order=("jsonrpc", "rest"),
+    )
+
+    baseline = _materialize_app(case=case, tables=(rest_first,))
+    transformed = _materialize_app(case=case, tables=(rpc_first,))
+
+    assert _route_signature(transformed) == _route_signature(baseline)
+
+
+@pytest.mark.acceptance
+def test_appspec_table_order_transform_preserves_route_surface() -> None:
+    corpus = load_corpus("appspec_corpus.canonical.json")
+    validate_corpus(corpus, lane="canonical")
+    case = corpus["cases"][0]
+
+    alpha = _make_widget_model(
+        class_name="MetamorphicAlphaWidget",
+        tablename=f"{case['table']['tablename']}_alpha",
+        resource="alpha-widget",
+    )
+    beta = _make_widget_model(
+        class_name="MetamorphicBetaWidget",
+        tablename=f"{case['table']['tablename']}_beta",
+        resource="beta-widget",
+    )
+
+    baseline = _materialize_app(case=case, tables=(alpha, beta))
+    transformed = _materialize_app(case=case, tables=(beta, alpha))
+
+    assert _route_signature(transformed) == _route_signature(baseline)

{tigrbl_tests-0.3.12.dev16 → tigrbl_tests-0.3.22.dev1}/tests/harness_e2e/test_00_appspec_uvicorn_rest_rpc.py

@@ -7,9 +7,9 @@ import pytest
 from tigrbl_client import TigrblClient
 
 from tigrbl import TableBase
-from tigrbl.shortcuts.engine import mem
+from tigrbl.factories.engine import mem
 from tigrbl.orm.mixins import GUIDPk
-from tigrbl.shortcuts.app import deriveApp
+from tigrbl.factories.app import deriveApp
 from tigrbl.types import Column, String
 
 from tigrbl_tests.tests.harness_v3._support import (
@@ -154,3 +154,4 @@ async def test_appspec_to_uvicorn_rest_and_rpc_parity_e2e() -> None:
             await rpc.aclose()
     finally:
         await stop_uvicorn(server, task)
+