tigrbl-base 0.4.3__tar.gz → 0.4.4.dev1__tar.gz

{tigrbl_base-0.4.3 → tigrbl_base-0.4.4.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-base
-Version: 0.4.3
+Version: 0.4.4.dev1
 Summary: Base contract package for Tigrbl apps, routers, tables, sessions, middleware, requests, responses, bindings, and engine interfaces.
 License: Apache License
                                     Version 2.0, January 2004

{tigrbl_base-0.4.3 → tigrbl_base-0.4.4.dev1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-base"
-version = "0.4.3"
+version = "0.4.4.dev1"
 description = "Base contract package for Tigrbl apps, routers, tables, sessions, middleware, requests, responses, bindings, and engine interfaces."
 readme = "README.md"
 license = { file = "LICENSE" }

{tigrbl_base-0.4.3 → tigrbl_base-0.4.4.dev1}/tigrbl_base/_base/_schema_base.py

@@ -9,6 +9,39 @@ from tigrbl_core.config.constants import TIGRBL_SCHEMA_DECLS_ATTR
 class SchemaBase:
     """Shared schema helpers used by concrete schema wrappers."""
 
+    @staticmethod
+    def bind_declared_schema(
+        model: type, alias: str, kind: str, schema_cls: type
+    ) -> None:
+        """Expose a declared schema on ``model.schemas.<alias>`` immediately."""
+
+        if kind not in ("in", "out"):
+            raise ValueError("schema_ctx(kind=...) must be 'in' or 'out'")
+
+        schemas = getattr(model, "schemas", None)
+        if not isinstance(schemas, SimpleNamespace):
+            schemas = SimpleNamespace()
+            setattr(model, "schemas", schemas)
+
+        alias_ns = getattr(schemas, alias, None)
+        if not isinstance(alias_ns, SimpleNamespace):
+            alias_ns = SimpleNamespace()
+            setattr(schemas, alias, alias_ns)
+
+        setattr(alias_ns, "in_" if kind == "in" else "out", schema_cls)
+
+    @classmethod
+    def bind_nested_declarations(cls, model: type) -> None:
+        """Bind nested ``schema_ctx`` declarations onto a table/model class."""
+
+        for obj in tuple(model.__dict__.values()):
+            if not inspect.isclass(obj):
+                continue
+            decl = getattr(obj, "__tigrbl_schema_decl__", None)
+            if decl is None:
+                continue
+            cls.bind_declared_schema(model, decl.alias, decl.kind, obj)
+
     @classmethod
     def collect(cls, model: type) -> dict[str, dict[str, type]]:
         """Collect schema declarations from explicit mappings and decorator metadata."""

{tigrbl_base-0.4.3 → tigrbl_base-0.4.4.dev1}/tigrbl_base/_base/_table_base.py

@@ -18,6 +18,7 @@ from tigrbl_core._spec.table_profile_spec import (
     TableProfileError,
     coerce_table_profile,
 )
+from ._schema_base import SchemaBase
 
 # ──────────────────────────────────────────────────────────────────────────────
 # Helpers – type inference & SA type instantiation
@@ -521,6 +522,10 @@ class TableBase(DeclarativeBase):
         # 2) Let SQLAlchemy map the class (PK now exists)
         super().__init_subclass__(**kw)
 
+        # 2.3) Surface table-local schema_ctx declarations immediately without
+        # invoking full schema synthesis or runtime binding.
+        SchemaBase.bind_nested_declarations(cls)
+
         # 2.5) Surface ctx-only op declarations for lightweight introspection.
         has_decorated_ops = False
         if not hasattr(cls, "__tigrbl_ops__"):