tigrbl-core 0.4.5.dev4__tar.gz → 0.4.5.dev8__tar.gz

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-core
-Version: 0.4.5.dev4
+Version: 0.4.5.dev8
 Summary: Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
 License: Apache License
                                     Version 2.0, January 2004
@@ -235,7 +235,7 @@ Project-URL: Discord, https://discord.gg/K4YTAPapjR
 Project-URL: Homepage, https://github.com/tigrbl/tigrbl
 Project-URL: Issues, https://github.com/tigrbl/tigrbl/issues
 Project-URL: Organization, https://github.com/tigrbl
-Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_core
+Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/10_core/tigrbl_core
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -245,7 +245,7 @@ Description-Content-Type: text/markdown
 <a href="https://pypi.org/project/tigrbl-core/"><img src="https://img.shields.io/pypi/v/tigrbl-core?label=PyPI" alt="PyPI version for tigrbl-core"/></a>
 <a href="https://pypi.org/project/tigrbl-core/"><img src="https://static.pepy.tech/badge/tigrbl-core" alt="Downloads for tigrbl-core"/></a>
 <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-core"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_core/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_core/README.md.svg?label=hits" alt="Repository hits for tigrbl-core README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/10_core/tigrbl_core/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/10_core/tigrbl_core/README.md.svg?label=hits" alt="Repository hits for tigrbl-core README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
 <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%2C%203.11%2C%203.12%2C%203.13%2C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-core"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-core"/></a>
@@ -269,7 +269,7 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-core fit?
 
-`tigrbl-core` lives at `pkgs/core/tigrbl_core` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-core` lives at `pkgs/10_core/tigrbl_core` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-core work?
 
@@ -291,7 +291,7 @@ pip install tigrbl-core
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) |
-| Repository path | [`pkgs/core/tigrbl_core`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_core) |
+| Repository path | [`pkgs/10_core/tigrbl_core`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/10_core/tigrbl_core) |
 | Python import root | `tigrbl_core` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -460,7 +460,7 @@ Choose `tigrbl-core` when the quick-answer table matches your use case. Choose [
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_core](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_core).
+- Repository: [pkgs/10_core/tigrbl_core](https://github.com/tigrbl/tigrbl/tree/master/pkgs/10_core/tigrbl_core).
 
 ## Package-local Boundary
 
@@ -471,7 +471,7 @@ This file is a package-local distribution entry point. This README is the packag
 - Package status: governed package in the `tigrbl/tigrbl` workspace.
 - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
 - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
-- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Local certification guard: `pkgs/97_tests/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
 - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## License

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/README.md

@@ -5,7 +5,7 @@
 <a href="https://pypi.org/project/tigrbl-core/"><img src="https://img.shields.io/pypi/v/tigrbl-core?label=PyPI" alt="PyPI version for tigrbl-core"/></a>
 <a href="https://pypi.org/project/tigrbl-core/"><img src="https://static.pepy.tech/badge/tigrbl-core" alt="Downloads for tigrbl-core"/></a>
 <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-core"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_core/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_core/README.md.svg?label=hits" alt="Repository hits for tigrbl-core README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/10_core/tigrbl_core/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/10_core/tigrbl_core/README.md.svg?label=hits" alt="Repository hits for tigrbl-core README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
 <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%2C%203.11%2C%203.12%2C%203.13%2C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-core"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-core"/></a>
@@ -29,7 +29,7 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-core fit?
 
-`tigrbl-core` lives at `pkgs/core/tigrbl_core` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-core` lives at `pkgs/10_core/tigrbl_core` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-core work?
 
@@ -51,7 +51,7 @@ pip install tigrbl-core
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) |
-| Repository path | [`pkgs/core/tigrbl_core`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_core) |
+| Repository path | [`pkgs/10_core/tigrbl_core`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/10_core/tigrbl_core) |
 | Python import root | `tigrbl_core` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -220,7 +220,7 @@ Choose `tigrbl-core` when the quick-answer table matches your use case. Choose [
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_core](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_core).
+- Repository: [pkgs/10_core/tigrbl_core](https://github.com/tigrbl/tigrbl/tree/master/pkgs/10_core/tigrbl_core).
 
 ## Package-local Boundary
 
@@ -231,7 +231,7 @@ This file is a package-local distribution entry point. This README is the packag
 - Package status: governed package in the `tigrbl/tigrbl` workspace.
 - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
 - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
-- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Local certification guard: `pkgs/97_tests/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
 - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## License

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-core"
-version = "0.4.5.dev4"
+version = "0.4.5.dev8"
 description = "Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -55,7 +55,7 @@ dependencies = [
 Organization = "https://github.com/tigrbl"
 Discord = "https://discord.gg/K4YTAPapjR"
 Homepage = "https://github.com/tigrbl/tigrbl"
-Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_core"
+Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/10_core/tigrbl_core"
 Issues = "https://github.com/tigrbl/tigrbl/issues"
 
 [tool.uv.sources]
@@ -75,5 +75,6 @@ packages = [
 [dependency-groups]
 dev = [
     "pytest>=8.0",
+    "sqlalchemy>=2.0",
     "ruff>=0.9",
 ]

tigrbl_core-0.4.5.dev8/tigrbl_core/_compat.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+import re
+import warnings
+
+_REMOVAL_VERSION = (0, 13, 0)
+
+
+def _dist_version_tuple() -> tuple[int, int, int] | None:
+    try:
+        raw = version("tigrbl")
+    except PackageNotFoundError:
+        return None
+    parts = re.split(r"[.+-]", raw, maxsplit=1)[0].split(".")
+    numbers = []
+    for item in parts[:3]:
+        try:
+            numbers.append(int(item))
+        except ValueError:
+            numbers.append(0)
+    while len(numbers) < 3:
+        numbers.append(0)
+    return tuple(numbers)  # type: ignore[return-value]
+
+
+def warn_legacy_engine_session_name(old: str, new: str) -> None:
+    installed = _dist_version_tuple()
+    if installed is not None and installed > _REMOVAL_VERSION:
+        raise RuntimeError(
+            f"{old} was removed after tigrbl 0.13.0; use {new} instead."
+        )
+    warnings.warn(
+        f"{old} is deprecated and will fail after tigrbl 0.13.0; use {new} instead.",
+        DeprecationWarning,
+        stacklevel=3,
+    )
+
+
+__all__ = ["warn_legacy_engine_session_name"]

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/tigrbl_core/_spec/__init__.py

@@ -122,12 +122,16 @@ _EXPORTS = {
     "SchemaSpec": "schema_spec",
     "SchemaRef": "schema_spec",
     "SchemaArg": "schema_spec",
+    "EngineSessionCfg": "engine_session_spec",
+    "EngineSessionSpec": "engine_session_spec",
+    "engine_session_spec": "engine_session_spec",
+    "SessionCfg": "session_spec",
     "SessionSpec": "session_spec",
     "session_spec": "session_spec",
-    "tx_read_committed": "session_spec",
-    "tx_repeatable_read": "session_spec",
-    "tx_serializable": "session_spec",
-    "readonly": "session_spec",
+    "tx_read_committed": "engine_session_spec",
+    "tx_repeatable_read": "engine_session_spec",
+    "tx_serializable": "engine_session_spec",
+    "readonly": "engine_session_spec",
     "StorageTypeRef": "datatypes",
     "StorageSpec": "storage_spec",
     "S": "storage_spec",
@@ -156,7 +160,6 @@ _EXPORTS = {
     "get_builtin_table_profile_definition": "table_profile_spec",
     "get_table_profile": "table_profile_spec",
     "iter_builtin_table_profile_definitions": "table_profile_spec",
-    "make_builtin_table_profile": "table_profile_spec",
     "register_table_profile": "table_profile_spec",
     "TableRegistrySpec": "table_registry_spec",
     "BINDING_STACK_PROJECTIONS": "transport_stack",

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/tigrbl_core/_spec/binding_spec.py

@@ -775,6 +775,7 @@ class WebTransportBindingSpec(SerdeMixin):
     exchange: Exchange = "bidirectional_stream"
     framing: None = None
     inner_framing: FramingSpec | None = None
+    rpc_method: str | None = None
 
     def __post_init__(self) -> None:
         if self.framing is not None:
@@ -801,10 +802,20 @@ class WebTransportBindingSpec(SerdeMixin):
             lane=lane,
             inner_framing=self.inner_framing,
         )
+        rpc_method = self.rpc_method
+        if rpc_method is not None:
+            rpc_method = str(rpc_method).strip()
+            if not rpc_method:
+                raise ValueError("WebTransport rpc_method must not be empty")
+            if lane != "bidi_stream" or framing_kind(inner_framing) != "jsonrpc":
+                raise ValueError(
+                    "WebTransport rpc_method requires a bidi_stream lane with JSON-RPC framing"
+                )
         object.__setattr__(self, "framing", None)
         object.__setattr__(self, "lane", lane)
         object.__setattr__(self, "exchange", exchange)
         object.__setattr__(self, "inner_framing", inner_framing)
+        object.__setattr__(self, "rpc_method", rpc_method)
 
 
 @dataclass(frozen=True, slots=True)

tigrbl_core-0.4.5.dev4/tigrbl_core/_spec/session_spec.py → tigrbl_core-0.4.5.dev8/tigrbl_core/_spec/engine_session_spec.py

@@ -5,13 +5,13 @@ from typing import Any, Mapping, MutableMapping, Optional, Union
 
 from .serde import SerdeMixin
 
-SessionCfg = Union["SessionSpec", Mapping[str, Any], None]
+EngineSessionCfg = Union["EngineSessionSpec", Mapping[str, Any], None]
 
 
 @dataclass(frozen=True)
-class SessionSpec(SerdeMixin):
+class EngineSessionSpec(SerdeMixin):
     """
-    Per-session policy for Tigrbl sessions.
+    Per-session policy for Tigrbl engine database sessions.
 
     These fields are backend-agnostic hints and constraints. Adapters should
     validate and apply them where supported; critical ones (like isolation and
@@ -69,21 +69,27 @@ class SessionSpec(SerdeMixin):
     idempotency_key: Optional[str] = None
     page_snapshot: Optional[str] = None
 
-    def merge(self, higher: "SessionSpec | Mapping[str, Any] | None") -> "SessionSpec":
+    def merge(
+        self, higher: "EngineSessionSpec | Mapping[str, Any] | None"
+    ) -> "EngineSessionSpec":
         """
         Overlay another spec on top of this one (explicit fields take precedence).
         Use to implement op > model > router > app precedence.
         """
         if higher is None:
             return self
-        h = higher if isinstance(higher, SessionSpec) else SessionSpec.from_any(higher)
+        h = (
+            higher
+            if isinstance(higher, EngineSessionSpec)
+            else EngineSessionSpec.from_any(higher)
+        )
         if h is None:
             return self
-        defaults = SessionSpec()
+        defaults = EngineSessionSpec()
         vals: MutableMapping[str, Any] = {
-            f.name: getattr(self, f.name) for f in fields(SessionSpec)
+            f.name: getattr(self, f.name) for f in fields(EngineSessionSpec)
         }
-        for f in fields(SessionSpec):
+        for f in fields(EngineSessionSpec):
             hv = getattr(h, f.name)
             if hv is None:
                 continue
@@ -91,61 +97,62 @@ class SessionSpec(SerdeMixin):
             if hv == default and vals[f.name] != default:
                 continue
             vals[f.name] = hv
-        return SessionSpec(**vals)  # type: ignore[arg-type]
+        return EngineSessionSpec(**vals)  # type: ignore[arg-type]
 
     def to_kwargs(self) -> dict[str, Any]:
         """Return only non-None items as a plain dict (adapters can **kwargs this)."""
         return {
             f.name: getattr(self, f.name)
-            for f in fields(SessionSpec)
+            for f in fields(EngineSessionSpec)
             if getattr(self, f.name) is not None
         }
 
     @staticmethod
-    def from_any(x: SessionCfg) -> Optional["SessionSpec"]:
+    def from_any(x: EngineSessionCfg) -> Optional["EngineSessionSpec"]:
         if x is None:
             return None
-        if isinstance(x, SessionSpec):
+        if isinstance(x, EngineSessionSpec):
             return x
         if isinstance(x, Mapping):
             m = dict(x)
-            # aliases
             if "readonly" in m and "read_only" not in m:
                 m["read_only"] = bool(m.pop("readonly"))
             if "iso" in m and "isolation" not in m:
                 m["isolation"] = str(m.pop("iso"))
-            allowed = {f.name for f in fields(SessionSpec)}
-            return SessionSpec(**{k: v for k, v in m.items() if k in allowed})
-        raise TypeError(f"Unsupported SessionSpec input: {type(x)}")
+            allowed = {f.name for f in fields(EngineSessionSpec)}
+            return EngineSessionSpec(**{k: v for k, v in m.items() if k in allowed})
+        raise TypeError(f"Unsupported EngineSessionSpec input: {type(x)}")
 
 
-def session_spec(cfg: SessionCfg = None, /, **kw: Any) -> SessionSpec:
-    """Build a SessionSpec from either a mapping/spec or kwargs."""
+def engine_session_spec(
+    cfg: EngineSessionCfg = None, /, **kw: Any
+) -> EngineSessionSpec:
+    """Build an EngineSessionSpec from either a mapping/spec or kwargs."""
     if cfg is not None and kw:
         raise ValueError("Provide either a mapping/spec or kwargs, not both")
-    return SessionSpec.from_any(cfg or kw) or SessionSpec()
+    return EngineSessionSpec.from_any(cfg or kw) or EngineSessionSpec()
 
 
-def tx_read_committed(*, read_only: Optional[bool] = None) -> SessionSpec:
-    return SessionSpec(isolation="read_committed", read_only=read_only)
+def tx_read_committed(*, read_only: Optional[bool] = None) -> EngineSessionSpec:
+    return EngineSessionSpec(isolation="read_committed", read_only=read_only)
 
 
-def tx_repeatable_read(*, read_only: Optional[bool] = None) -> SessionSpec:
-    return SessionSpec(isolation="repeatable_read", read_only=read_only)
+def tx_repeatable_read(*, read_only: Optional[bool] = None) -> EngineSessionSpec:
+    return EngineSessionSpec(isolation="repeatable_read", read_only=read_only)
 
 
-def tx_serializable(*, read_only: Optional[bool] = None) -> SessionSpec:
-    return SessionSpec(isolation="serializable", read_only=read_only)
+def tx_serializable(*, read_only: Optional[bool] = None) -> EngineSessionSpec:
+    return EngineSessionSpec(isolation="serializable", read_only=read_only)
 
 
-def readonly() -> SessionSpec:
-    return SessionSpec(read_only=True)
+def readonly() -> EngineSessionSpec:
+    return EngineSessionSpec(read_only=True)
 
 
 __all__ = [
-    "SessionCfg",
-    "SessionSpec",
-    "session_spec",
+    "EngineSessionCfg",
+    "EngineSessionSpec",
+    "engine_session_spec",
     "tx_read_committed",
     "tx_repeatable_read",
     "tx_serializable",

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/tigrbl_core/_spec/engine_spec.py

@@ -53,6 +53,8 @@ class EngineSpec(SerdeMixin):
           "sqlite+aiosqlite:///./file.db" ,
           "postgresql://user:pwd@host:5432/db" ,
           "postgresql+asyncpg://user:pwd@host:5432/db"
+          "analytics.duckdb" ,
+          "quack://analytics.internal:9494"
       • Mapping (recommended for clarity/portability):
           {"kind":"sqlite","async":True,"path":"./file.db"}
           {"kind":"postgres","async":True,"host":"db","db":"app_db",...}
@@ -163,6 +165,10 @@ class EngineSpec(SerdeMixin):
             if s.startswith("postgresql://") or s.startswith("postgres://"):
                 return EngineSpec(kind="postgres", async_=False, dsn=s)
 
+            # DuckDB accepts its quack URI as well as a direct database file.
+            if s.lower().startswith("quack:") or s.lower().endswith(".duckdb"):
+                return EngineSpec(kind="duckdb", async_=False, dsn=s)
+
             raise ValueError(f"Unsupported DSN: {s}")
 
         # Mapping
@@ -360,7 +366,13 @@ class EngineSpec(SerdeMixin):
                 return None
             redacted: dict[str, object] = {}
             for key, value in mapping.items():
-                if str(key).lower() in {"pwd", "password", "pass", "secret"}:
+                if str(key).lower() in {
+                    "pwd",
+                    "password",
+                    "pass",
+                    "secret",
+                    "token",
+                }:
                     redacted[key] = "***"
                 else:
                     redacted[key] = value

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/tigrbl_core/_spec/plugins.py

@@ -29,14 +29,21 @@ def load_engine_plugins() -> None:
     if _LOADED:
         return
 
-    try:
-        discovered = entry_points(group="tigrbl.engine_plugins")
-    except TypeError:
-        discovered = entry_points().get("tigrbl.engine_plugins", [])  # pragma: no cover
+    discovered = []
+    for group in ("tigrbl.engine_plugins", "tigrbl.engine"):
+        try:
+            discovered.extend(entry_points(group=group))
+        except TypeError:  # pragma: no cover
+            discovered.extend(entry_points().get(group, []))
 
+    loaded_names: set[str] = set()
     for ep in discovered:
+        name = str(getattr(ep, "name", ""))
+        if name in loaded_names:
+            continue
         try:
             _invoke_plugin(ep.load())
+            loaded_names.add(name)
         except Exception:
             # EngineSpec handles missing registrations with explicit error text.
             continue

tigrbl_core-0.4.5.dev8/tigrbl_core/_spec/session_spec.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from typing import Any
+
+from tigrbl_core._compat import warn_legacy_engine_session_name
+
+from .engine_session_spec import (
+    EngineSessionCfg,
+    EngineSessionSpec,
+    engine_session_spec,
+    readonly,
+    tx_read_committed,
+    tx_repeatable_read,
+    tx_serializable,
+)
+
+
+def __getattr__(name: str) -> Any:
+    if name == "SessionSpec":
+        warn_legacy_engine_session_name("SessionSpec", "EngineSessionSpec")
+        return EngineSessionSpec
+    if name == "SessionCfg":
+        warn_legacy_engine_session_name("SessionCfg", "EngineSessionCfg")
+        return EngineSessionCfg
+    if name == "session_spec":
+        warn_legacy_engine_session_name("session_spec", "engine_session_spec")
+        return engine_session_spec
+    raise AttributeError(name)
+
+
+__all__ = [
+    "EngineSessionCfg",
+    "EngineSessionSpec",
+    "engine_session_spec",
+    "readonly",
+    "tx_read_committed",
+    "tx_repeatable_read",
+    "tx_serializable",
+    "SessionCfg",
+    "SessionSpec",
+    "session_spec",
+]

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/tigrbl_core/_spec/table_profile_bindings.py

@@ -4,6 +4,7 @@ from dataclasses import dataclass, replace
 from typing import Any, Iterable, Literal, Sequence
 
 from .binding_spec import (
+    BindingSpec,
     BytesFramingSpec,
     HttpJsonRpcBindingSpec,
     HttpRestBindingSpec,
@@ -234,6 +235,24 @@ def lower_default_bindings_for_op(
     profile: TableProfileSpec,
     op: OpSpec,
 ) -> tuple[LoweredBinding, ...]:
+    profile_bindings = tuple(
+        binding.spec if isinstance(binding, BindingSpec) else binding
+        for binding in profile.default_bindings
+    )
+    if profile_bindings:
+        return tuple(
+            LoweredBinding(
+                token=_token_from_binding(
+                    source="table_profile",
+                    profile=profile.kind,
+                    op=op,
+                    binding=binding,
+                    precedence=1,
+                ),
+                binding=binding,
+            )
+            for binding in profile_bindings
+        )
     if _is_custom_or_unknown(op):
         return ()
 

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/tigrbl_core/_spec/table_profile_spec.py

@@ -414,69 +414,6 @@ class TableProfileSpec(SerdeMixin):
         )
 
 
-def make_profile_op(
-    target: TargetOp,
-    *,
-    alias: str | None = None,
-    bindings: Sequence[Any] = (),
-    exchange: Any = "request_response",
-) -> OpSpec:
-    selected_alias = alias or str(target)
-    return OpSpec(
-        alias=selected_alias,
-        target=target,
-        arity="collection" if target in _COLLECTION_TARGETS else "member",
-        bindings=tuple(bindings or ()),
-        exchange=exchange,
-        persist="default",
-        handler=None,
-        request_model=None,
-        response_model=None,
-        hooks=(),
-        status_code=None,
-        extra={},
-    )
-
-
-def make_table_profile(
-    kind: str,
-    targets: Sequence[TargetOp],
-    *,
-    role: TableProfileRole = "concrete",
-    default_bindings: Sequence[BindingSpec | TransportBindingSpec] = (),
-    docs_exposure: DocsExposure = "none",
-    runtime_exposure: RuntimeExposure = "none",
-    custom: bool = False,
-    namespace: str | None = None,
-) -> TableProfileSpec:
-    return TableProfileSpec(
-        kind=kind,
-        role=role,
-        ops=tuple(make_profile_op(target) for target in targets),
-        default_bindings=tuple(default_bindings or ()),
-        docs_exposure=docs_exposure,
-        runtime_exposure=runtime_exposure,
-        custom=custom,
-        namespace=namespace,
-    )
-
-
-def make_builtin_table_profile(kind: str) -> TableProfileSpec:
-    try:
-        row = BUILTIN_TABLE_PROFILE_DEFINITIONS[kind]
-    except KeyError as exc:
-        raise TableProfileError(
-            f"unknown built-in table profile kind {kind!r}"
-        ) from exc
-    return make_table_profile(
-        row.kind,
-        row.targets,
-        role=row.role,
-        docs_exposure=row.docs_exposure,
-        runtime_exposure=row.runtime_exposure,
-    )
-
-
 def get_builtin_table_profile_definition(kind: str) -> BuiltinTableProfile:
     try:
         return BUILTIN_TABLE_PROFILE_DEFINITIONS[kind]
@@ -491,7 +428,21 @@ def iter_builtin_table_profile_definitions() -> tuple[BuiltinTableProfile, ...]:
 
 
 _BUILTIN_TABLE_PROFILES: dict[str, TableProfileSpec] = {
-    kind: make_builtin_table_profile(kind) for kind in BUILTIN_TABLE_PROFILE_DEFINITIONS
+    kind: TableProfileSpec(
+        kind=row.kind,
+        role=row.role,
+        ops=tuple(
+            OpSpec(
+                alias=str(target),
+                target=target,
+                arity=("collection" if target in _COLLECTION_TARGETS else "member"),
+            )
+            for target in row.targets
+        ),
+        docs_exposure=row.docs_exposure,
+        runtime_exposure=row.runtime_exposure,
+    )
+    for kind, row in BUILTIN_TABLE_PROFILE_DEFINITIONS.items()
 }
 
 PLAIN_TABLE_PROFILE = _BUILTIN_TABLE_PROFILES["plain"]
@@ -553,8 +504,5 @@ __all__ = [
     "get_builtin_table_profile_definition",
     "get_table_profile",
     "iter_builtin_table_profile_definitions",
-    "make_profile_op",
-    "make_builtin_table_profile",
-    "make_table_profile",
     "register_table_profile",
 ]

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/tigrbl_core/schema/__init__.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from tigrbl_core._spec.schema_spec import SchemaArg, SchemaRef
 from .get_schema import get_schema
+from .result import build_operation_result_json_schema
 from .builder.build_schema import _build_schema
 from .builder.list_params import _build_list_params
 from .spec_json import (
@@ -39,6 +40,7 @@ from .utils import (
 
 __all__ = [
     "get_schema",
+    "build_operation_result_json_schema",
     "SchemaRef",
     "SchemaArg",
     "_build_schema",

{tigrbl_core-0.4.5.dev4 → tigrbl_core-0.4.5.dev8}/tigrbl_core/schema/builder/build_schema.py

@@ -215,12 +215,14 @@ def _build_schema(
         logger.debug("schema: processing column %s (verb=%s)", attr_name, verb)
 
         # Determine type and requiredness
-        py_t = _python_type(col)
+        fs = getattr(spec, "field", None)
+        py_t = getattr(fs, "py_type", Any) if fs is not None else Any
         py_t = _normalize_py_type(py_t)
+        if py_t is Any:
+            py_t = _normalize_py_type(_python_type(col))
         required = _is_required(col, verb)
 
         # Field construction (collect kwargs then create Field once)
-        fs = getattr(spec, "field", None)
         field_kwargs: Dict[str, Any] = dict(getattr(fs, "constraints", {}) or {})
         description = getattr(fs, "description", None)
         if description and "description" not in field_kwargs: