tigrbl 0.4.2.dev3__py3-none-any.whl → 0.4.3.dev4__py3-none-any.whl

tigrbl/__init__.py

@@ -61,6 +61,18 @@ def _install_alias(alias: str, target: str) -> None:
 for alias, target in _ALIAS_MODULES.items():
     _install_alias(alias, target)
 
+for alias, target in {
+    "runtime.events": "tigrbl_kernel.events",
+    "runtime.labels": "tigrbl_kernel.labels",
+    "runtime.status": "tigrbl_typing.status",
+}.items():
+    _install_alias(alias, target)
+    parent_alias, attr_name = alias.rsplit(".", 1)
+    parent_module = sys.modules.get(f"{__name__}.{parent_alias}")
+    target_module = sys.modules.get(target) or _optional_import(target)
+    if parent_module is not None and target_module is not None:
+        setattr(parent_module, attr_name, target_module)
+
 
 _spec = import_module("tigrbl_core._spec")
 _base = import_module("tigrbl_base._base")
@@ -84,8 +96,11 @@ from tigrbl_concrete._concrete import (  # noqa: E402
     BackgroundTask,
     Binding,
     BindingRegistry,
+    BulkCrudTable,
     Column,
     CORSMiddleware,
+    CrudTable,
+    EventStreamTable,
     EventStreamResponse,
     FileResponse,
     ForeignKey,
@@ -93,23 +108,44 @@ from tigrbl_concrete._concrete import (  # noqa: E402
     HTMLResponse,
     HTTPBasic,
     HTTPBearer,
+    JsonRpcOlapTable,
+    JsonRpcOltpTable,
+    JsonRpcTable,
     JSONResponse,
     MutualTLS,
     OAuth2,
+    OlapTable,
+    OltpTable,
     OpenIdConnect,
     Op,
     PlainTextResponse,
+    RealtimeTable,
+    RestJsonRpcOlapTable,
+    RestJsonRpcOltpTable,
+    RestJsonRpcTable,
+    RestOlapTable,
+    RestOltpTable,
     RedirectResponse,
     Request,
     TransportResponse,
     UploadedFile,
     WebSocket,
+    WebSocketJsonRpcTable,
+    WebSocketTable,
+    WebTransportBidiTable,
+    WebTransportClientStreamTable,
+    WebTransportDatagramTable,
+    WebTransportServerStreamTable,
+    WebTransportTable,
     Response,
     Route,
     Router,
     Schema,
     StorageTransform,
     Middleware,
+    RestTable,
+    SseTable,
+    StreamTable,
     StreamingResponse,
     Table,
     TableRegistry,
@@ -117,7 +153,7 @@ from tigrbl_concrete._concrete import (  # noqa: E402
     TigrblRouter,
 )
 from tigrbl_concrete._concrete.dependencies import Depends  # noqa: E402
-from tigrbl_runtime.runtime.status.exceptions import HTTPException  # noqa: E402
+from tigrbl_typing.status.exceptions import HTTPException  # noqa: E402
 from tigrbl.engine import resolver  # noqa: E402
 from tigrbl.system import mount_diagnostics  # noqa: E402
 from tigrbl_core.config.constants import DEFAULT_HTTP_METHODS, HOOK_DECLS_ATTR  # noqa: E402
@@ -143,16 +179,22 @@ from tigrbl.decorators import (  # noqa: E402
     websocket_ctx,
     webtransport_ctx,
 )
+from tigrbl_concrete._decorators.middlewares import (  # noqa: E402
+    middleware as middleware,
+    middlewares as middlewares,
+)
 from tigrbl.factories.op import op  # noqa: E402
 from tigrbl.schema import _build_list_params, _build_schema, get_schema  # noqa: E402
 from tigrbl.ddl import bootstrap_dbschema, ensure_schemas, register_sqlite_attach  # noqa: E402
 
 from tigrbl_base._base import (  # noqa: E402
     AppBase,
+    CrudTableBase,
     EngineBase,
     EngineProviderBase,
     ForeignKeyBase,
     HookBase,
+    RealtimeTableBase,
     RouterBase,
     TableBase,
     TableRegistryBase,
@@ -196,21 +238,18 @@ from tigrbl_core._spec import (  # noqa: E402
     SchemaRef,
     SchemaSpec,
     SessionSpec,
-    readonly,
-    session_spec,
     StorageSpec,
     StorageTransformSpec,
     StorageTypeRef,
+    TableProfileSpec,
     TableRegistrySpec,
     TableSpec,
     TargetOp,
     TemplateSpec,
-    tx_read_committed,
-    tx_repeatable_read,
-    tx_serializable,
     TxScope,
     WebSocketBindingSpec,
     WebTransportBindingSpec,
+    WellKnownResourceSpec,
     WsBindingSpec,
     canonical_binding_kind,
     normalize_binding_spec,
@@ -218,7 +257,7 @@ from tigrbl_core._spec import (  # noqa: E402
     validate_app_framing_for_binding,
     validate_binding_profile_exchange,
 )
-from tigrbl_runtime.runtime.executor import _invoke  # noqa: E402
+from tigrbl_runtime.executors.invoke import _invoke  # noqa: E402
 
 
 def bind(*args, **kwargs):
@@ -332,6 +371,8 @@ __all__ = [
     "Depends",
     "HTTPException",
     "TableBase",
+    "CrudTableBase",
+    "RealtimeTableBase",
     "RouterBase",
     "Op",
     "op",
@@ -357,6 +398,7 @@ __all__ = [
     "PathKind",
     "PathSpec",
     "path_for_binding",
+    "WellKnownResourceSpec",
     "DocsPayloadKind",
     "DocsPayloadSpec",
     "DocsProjectionSelection",
@@ -428,6 +470,7 @@ __all__ = [
     "BindingRegistrySpec",
     "RouterSpec",
     "TableSpec",
+    "TableProfileSpec",
     "TableRegistrySpec",
     "ColumnSpec",
     "FieldSpec",
@@ -457,6 +500,30 @@ __all__ = [
     "AppBase",
     "App",
     "Table",
+    "CrudTable",
+    "RealtimeTable",
+    "RestTable",
+    "RestJsonRpcTable",
+    "JsonRpcTable",
+    "BulkCrudTable",
+    "RestOltpTable",
+    "JsonRpcOltpTable",
+    "RestJsonRpcOltpTable",
+    "OltpTable",
+    "RestOlapTable",
+    "JsonRpcOlapTable",
+    "RestJsonRpcOlapTable",
+    "OlapTable",
+    "StreamTable",
+    "SseTable",
+    "EventStreamTable",
+    "WebSocketTable",
+    "WebSocketJsonRpcTable",
+    "WebTransportTable",
+    "WebTransportBidiTable",
+    "WebTransportClientStreamTable",
+    "WebTransportServerStreamTable",
+    "WebTransportDatagramTable",
     "Column",
     "CORSMiddleware",
     "Route",

tigrbl/cli.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import argparse
 import asyncio
+import hashlib
 import importlib
 import importlib.util
 import inspect
@@ -193,7 +194,9 @@ def _resolve_target(args: argparse.Namespace) -> str | None:
 
 
 def _load_module_from_path(path: Path) -> Any:
-    module_name = f"_tigrbl_cli_{path.stem}_{abs(hash(str(path.resolve())))}"
+    resolved = str(path.resolve())
+    digest = hashlib.sha256(resolved.encode("utf-8")).hexdigest()[:16]
+    module_name = f"_tigrbl_cli_{path.stem}_{digest}"
     spec = importlib.util.spec_from_file_location(module_name, path)
     if spec is None or spec.loader is None:
         raise CLIError(f"Could not load Python module from '{path}'")
@@ -208,7 +211,13 @@ def _load_target_object(target: str) -> Any:
     if not raw:
         raise CLIError("An app target is required. Use <module:attr> or <path.py:attr>.")
 
-    source, attr = (raw.rsplit(":", 1) + ["app"])[:2] if ":" in raw else (raw, "app")
+    raw_path = Path(raw)
+    if raw.endswith(".py") or raw_path.exists():
+        source, attr = raw, "app"
+    elif ":" in raw:
+        source, attr = raw.rsplit(":", 1)
+    else:
+        source, attr = raw, "app"
     source_path = Path(source)
     if source.endswith(".py") or source_path.exists():
         if not source_path.exists():

tigrbl/hook/exceptions.py

@@ -1,3 +1,3 @@
-"""Compatibility shim for runtime-owned exceptions."""
+"""Compatibility shim for hook declaration exceptions."""
 
-from ..runtime.exceptions import *  # noqa: F403, F401
+from tigrbl_core._spec.exceptions import *  # noqa: F403, F401

tigrbl/middlewares/__init__.py

@@ -1,11 +1,13 @@
-"""Hook type definitions exposed without importing runtime package internals."""
+"""Middleware declaration and composition helpers."""
 
 from __future__ import annotations
 
-from tigrbl_atoms import HookPhase, HookPhases, HookPredicate, StepFn
+from tigrbl_concrete._decorators.middlewares import (
+    MiddlewareConfig,
+    middleware,
+    middlewares,
+)
 
-PHASE = HookPhase
-PHASES = tuple(h.value for h in HookPhases)
-
-__all__ = ["HookPhase", "HookPhases", "PHASE", "PHASES", "StepFn", "HookPredicate"]
+from .compose import apply_middlewares
 
+__all__ = ["MiddlewareConfig", "apply_middlewares", "middleware", "middlewares"]

tigrbl/schema/jsonrpc.py

@@ -0,0 +1 @@
+from tigrbl_concrete.schema.jsonrpc import *  # noqa: F401,F403

tigrbl/system/diagnostics/__init__.py

@@ -1,19 +1,27 @@
-from ...runtime.kernel import _default_kernel, build_phase_chains
-from .router import mount_diagnostics
-from .healthz import build_healthz_endpoint, build_healthz_html, mount_healthz_uix
-from .methodz import build_methodz_endpoint
-from .hookz import build_hookz_endpoint
+from tigrbl_concrete.system.diagnostics import (
+    build_healthz_endpoint,
+    build_healthz_html,
+    build_hookz_endpoint,
+    build_methodz_endpoint,
+    mount_diagnostics,
+    mount_healthz_uix,
+)
 from .kernelz import build_kernelz_endpoint
-from .methodz import build_methodz_endpoint as _build_methodz_endpoint
-from .hookz import build_hookz_endpoint as _build_hookz_endpoint
+from tigrbl_concrete.system.diagnostics import (
+    build_hookz_endpoint as _build_hookz_endpoint,
+)
 from .kernelz import build_kernelz_endpoint as _build_kernelz_endpoint
-from .utils import (
-    table_iter as _table_iter,
-    model_iter as _model_iter,
-    opspecs as _opspecs,
+from tigrbl_concrete.system.diagnostics import (
+    build_methodz_endpoint as _build_methodz_endpoint,
+)
+from tigrbl_concrete.system.diagnostics.utils import (
     label_callable as _label_callable,
     label_hook as _label_hook,
+    model_iter as _model_iter,
+    opspecs as _opspecs,
+    table_iter as _table_iter,
 )
+from tigrbl_kernel import _default_kernel
 
 __all__ = [
     "mount_diagnostics",
@@ -31,6 +39,5 @@ __all__ = [
     "_opspecs",
     "_label_callable",
     "_label_hook",
-    "build_phase_chains",
     "_default_kernel",
 ]

tigrbl/system/diagnostics/kernelz.py

@@ -1,57 +1,15 @@
-"""Diagnostic endpoint exposing kernel phase plans."""
-
 from __future__ import annotations
 
 from typing import Any
 
-from ...runtime.kernel import _default_kernel as K
+from tigrbl_concrete.system.diagnostics.kernelz import (
+    build_kernelz_endpoint as _build_kernelz_endpoint,
+)
+from tigrbl_kernel import _default_kernel
 
 
 def build_kernelz_endpoint(router: Any):
-    """Return an async handler that serves the Kernel's cached plan."""
-
-    async def _kernelz():
-        K.ensure_primed(router)
-        payload = K.kernelz_payload(router)
-        models = getattr(router, "models", {}) or {}
-        if not models:
-            return payload
-
-        out = payload
-        for model_name, model in models.items():
-            specs = getattr(getattr(model, "opspecs", None), "all", ()) or ()
-            if specs:
-                continue
-
-            model_map = payload.get(model_name)
-            if not isinstance(model_map, dict):
-                continue
-
-            if out is payload:
-                out = {
-                    name: {alias: list(seq) for alias, seq in ops.items()}
-                    for name, ops in payload.items()
-                }
-
-            enriched = out.get(model_name)
-            if not isinstance(enriched, dict):
-                continue
-
-            for alias, seq in list(enriched.items()):
-                extras: list[str] = []
-                seen = set(seq)
-                for label in seq:
-                    if not isinstance(label, str) or ":" not in label:
-                        continue
-                    raw = label.split(":", 1)[1]
-                    if raw not in seen:
-                        extras.append(raw)
-                        seen.add(raw)
-                if extras:
-                    enriched[alias] = [*seq, *extras]
-        return out
-
-    return _kernelz
+    return _build_kernelz_endpoint(router, kernel=_default_kernel)
 
 
 __all__ = ["build_kernelz_endpoint"]

tigrbl/system/diagnostics/methodz.py

@@ -37,6 +37,8 @@ def build_methodz_endpoint(router: Any):
                 methods.append(entry)
                 per_model.setdefault(mname, []).append(entry)
         methods.sort(key=lambda x: (x["model"], x["alias"]))
+        for entries in per_model.values():
+            entries.sort(key=lambda x: x["alias"])
         cache = {"methods": methods, **per_model}
         return cache
 

tigrbl/system/diagnostics/utils.py

@@ -1,63 +1,17 @@
-from __future__ import annotations
-
-import inspect
-import warnings
-from types import SimpleNamespace
-from typing import Any, Iterable
-
-from sqlalchemy import text
-
-from ...runtime.labels import (
-    label_callable as _kernel_label_callable,
-    label_hook as _kernel_label_hook,
+from tigrbl_concrete.system.diagnostics.utils import (
+    label_callable,
+    label_hook,
+    maybe_execute,
+    model_iter,
+    opspecs,
+    table_iter,
 )
 
-
-def table_iter(router: Any) -> Iterable[type]:
-    tables = getattr(router, "tables", None)
-    if isinstance(tables, dict) and tables:
-        return tables.values()
-
-    return ()
-
-
-def model_iter(router: Any) -> Iterable[type]:
-    warnings.warn(
-        "model_iter is deprecated; use table_iter instead.",
-        DeprecationWarning,
-        stacklevel=2,
-    )
-    return table_iter(router)
-
-
-def opspecs(model: type):
-    ops = getattr(getattr(model, "opspecs", SimpleNamespace()), "all", ()) or ()
-    if ops:
-        return ops
-    try:
-        from tigrbl_core._spec.op_spec import _mro_collect_decorated_ops
-
-        return tuple(_mro_collect_decorated_ops(model))
-    except Exception:
-        return ()
-
-
-async def maybe_execute(db: Any, stmt: str):
-    try:
-        rv = db.execute(text(stmt))  # type: ignore[attr-defined]
-        if inspect.isawaitable(rv):
-            return await rv
-        return rv
-    except Exception:
-        rv = db.execute(text("select 1"))  # type: ignore[attr-defined]
-        if inspect.isawaitable(rv):
-            return await rv
-        return rv
-
-
-def label_callable(fn: Any) -> str:
-    return _kernel_label_callable(fn)
-
-
-def label_hook(fn: Any, phase: str) -> str:
-    return _kernel_label_hook(fn, phase)
+__all__ = [
+    "label_callable",
+    "label_hook",
+    "maybe_execute",
+    "model_iter",
+    "opspecs",
+    "table_iter",
+]

tigrbl/transport/jsonrpc/helpers.py

@@ -1 +1,7 @@
+from tigrbl_concrete.transport._deprecation import (
+    JSONRPC_HELPERS_WARNING,
+    warn_deprecated_transport_module,
+)
 from tigrbl_concrete.transport.jsonrpc.helpers import *  # noqa: F401,F403
+
+warn_deprecated_transport_module(JSONRPC_HELPERS_WARNING, __name__)

tigrbl/transport/jsonrpc/models.py

@@ -1 +1,7 @@
+from tigrbl_concrete.transport._deprecation import (
+    JSONRPC_MODELS_WARNING,
+    warn_deprecated_transport_module,
+)
 from tigrbl_concrete.transport.jsonrpc.models import *  # noqa: F401,F403
+
+warn_deprecated_transport_module(JSONRPC_MODELS_WARNING, __name__)

tigrbl/transport/rest/aggregator.py

@@ -1 +1,7 @@
+from tigrbl_concrete.transport._deprecation import (
+    REST_WARNING,
+    warn_deprecated_transport_module,
+)
 from tigrbl_concrete.transport.rest.aggregator import *  # noqa: F401,F403
+
+warn_deprecated_transport_module(REST_WARNING, __name__)