tigrbl-core 0.4.5.dev1__tar.gz → 0.4.5.dev6__tar.gz

{tigrbl_core-0.4.5.dev1 → tigrbl_core-0.4.5.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-core
-Version: 0.4.5.dev1
+Version: 0.4.5.dev6
 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.dev1 → tigrbl_core-0.4.5.dev6}/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.dev1 → tigrbl_core-0.4.5.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-core"
-version = "0.4.5.dev1"
+version = "0.4.5.dev6"
 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.dev6/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.dev1 → tigrbl_core-0.4.5.dev6}/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.dev1 → tigrbl_core-0.4.5.dev6}/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.dev1/tigrbl_core/_spec/session_spec.py → tigrbl_core-0.4.5.dev6/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.dev1 → tigrbl_core-0.4.5.dev6}/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.dev1 → tigrbl_core-0.4.5.dev6}/tigrbl_core/_spec/op_spec.py

@@ -1,7 +1,9 @@
 from __future__ import annotations
 
 from dataclasses import dataclass, field
+from importlib import metadata as importlib_metadata
 import inspect
+import warnings
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -59,6 +61,11 @@ TargetOp = Literal[
     "custom",
 ]
 
+_CANONICAL_OP_SPEC_ATTR = "__tigrbl_op_spec__"
+_LEGACY_OP_DECL_ATTR = "__tigrbl_op_decl__"
+_LEGACY_OP_DECL_FALLBACK_VERSION = "0.4.5.dev1"
+_LEGACY_OP_DECL_FAILS_IN = (0, 7)
+
 
 if TYPE_CHECKING:  # pragma: no cover
     from .._spec.engine_spec import EngineCfg
@@ -151,6 +158,46 @@ class OpSpec(SerdeMixin):
 
 
 _ALIAS_RE = __import__("re").compile(r"^[a-z][a-z0-9_]*$")
+_VERSION_RE = __import__("re").compile(r"^\s*(\d+)\.(\d+)")
+
+
+def _parse_major_minor(version: str) -> tuple[int, int]:
+    match = _VERSION_RE.match(version)
+    if match is None:
+        return (0, 0)
+    return (int(match.group(1)), int(match.group(2)))
+
+
+def _current_major_minor() -> tuple[int, int]:
+    try:
+        version = importlib_metadata.version("tigrbl-core")
+    except importlib_metadata.PackageNotFoundError:
+        version = _LEGACY_OP_DECL_FALLBACK_VERSION
+    return _parse_major_minor(version)
+
+
+def _warn_or_fail_legacy_op_decl() -> None:
+    if _current_major_minor() >= _LEGACY_OP_DECL_FAILS_IN:
+        raise RuntimeError(
+            "__tigrbl_op_decl__ is no longer supported; use "
+            "__tigrbl_op_spec__ for operation metadata."
+        )
+    warnings.warn(
+        "__tigrbl_op_decl__ is deprecated and will be removed in "
+        "tigrbl-core 0.7.0; use __tigrbl_op_spec__ instead.",
+        DeprecationWarning,
+        stacklevel=3,
+    )
+
+
+def _get_decorated_op_spec(func: Any) -> Optional["OpSpec"]:
+    op_spec: OpSpec | None = getattr(func, _CANONICAL_OP_SPEC_ATTR, None)
+    if op_spec is not None:
+        return op_spec
+    op_spec = getattr(func, _LEGACY_OP_DECL_ATTR, None)
+    if op_spec is not None:
+        _warn_or_fail_legacy_op_decl()
+    return op_spec
 
 
 def _ensure_spec_table(spec: Any, table: type) -> OpSpec:
@@ -484,9 +531,7 @@ def _mro_collect_decorated_ops(table: type) -> List["OpSpec"]:
             if name in seen:
                 continue
             func = _unwrap(attr)
-            op_spec: OpSpec | None = getattr(func, "__tigrbl_op_spec__", None)
-            if op_spec is None:
-                op_spec = getattr(func, "__tigrbl_op_decl__", None)
+            op_spec = _get_decorated_op_spec(func)
             if op_spec is None:
                 continue
 

{tigrbl_core-0.4.5.dev1 → tigrbl_core-0.4.5.dev6}/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.dev6/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.dev1 → tigrbl_core-0.4.5.dev6}/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 ()