tigrbl-base 0.4.3.dev4__py3-none-any.whl → 0.4.4.dev7__py3-none-any.whl

tigrbl_base/_base/__init__.py

@@ -13,6 +13,8 @@ _EXPORTS = {
     "AliasBase": "_alias_base",
     "EngineBase": "_engine_base",
     "EngineProviderBase": "_engine_provider_base",
+    "HeaderCookiesBase": "_headers_base",
+    "HeadersBase": "_headers_base",
     "HookBase": "_hook_base",
     "RouterBase": "_router_base",
     "ForeignKeyBase": "_storage",

tigrbl_base/_base/_headers_base.py

@@ -1,9 +1,82 @@
 from __future__ import annotations
 
+from collections.abc import Iterable, Mapping
+from typing import Any
+
+from tigrbl_core._spec.headers_spec import HeadersSpec
+
+
+HeaderInput = Iterable[tuple[str, str]] | Mapping[str, str] | HeadersSpec | None
+
+
+def _normalize_header_name(name: Any) -> str:
+    if isinstance(name, (bytes, bytearray)):
+        return name.decode("latin-1").lower()
+    return str(name).lower()
+
+
+def _normalize_header_value(value: Any) -> str:
+    if isinstance(value, (bytes, bytearray)):
+        return value.decode("latin-1")
+    return str(value)
+
+
+def _iter_header_items(values: HeaderInput):
+    if values is None:
+        return ()
+    if isinstance(values, HeadersSpec):
+        return values.values.items()
+    if hasattr(values, "items"):
+        return values.items()  # type: ignore[union-attr]
+    return values
+
 
 class HeadersBase(dict[str, str]):
     """Base header mapping type for response implementations."""
 
+    required: tuple[str, ...]
+    expose: tuple[str, ...]
+
+    def __init__(
+        self,
+        values: HeaderInput = None,
+        *,
+        required: tuple[str, ...] = (),
+        expose: tuple[str, ...] = (),
+    ) -> None:
+        if isinstance(values, HeadersSpec):
+            required = values.required
+            expose = values.expose
+        super().__init__(
+            {
+                _normalize_header_name(key): _normalize_header_value(value)
+                for key, value in _iter_header_items(values)
+            }
+        )
+        self.required = tuple(_normalize_header_name(name) for name in required)
+        self.expose = tuple(_normalize_header_name(name) for name in expose)
+
+    def __getitem__(self, key: str) -> str:
+        return super().__getitem__(_normalize_header_name(key))
+
+    def __contains__(self, key: object) -> bool:
+        if isinstance(key, (str, bytes, bytearray)):
+            return super().__contains__(_normalize_header_name(key))
+        return super().__contains__(key)
+
+    def get(self, key: str, default: Any = None) -> str | Any:
+        return super().get(_normalize_header_name(key), default)
+
+    @property
+    def raw_headers(self) -> list[tuple[bytes, bytes]]:
+        return [
+            (key.encode("latin-1"), value.encode("latin-1"))
+            for key, value in self.items()
+        ]
+
+    def as_spec(self) -> HeadersSpec:
+        return HeadersSpec(values=dict(self), required=self.required, expose=self.expose)
+
 
 class HeaderCookiesBase(dict[str, str]):
     """Base cookie mapping type for response implementations."""

tigrbl_base/_base/_response_base.py

@@ -38,18 +38,13 @@ class ResponseBase(ResponseSpec):
         payload = (
             body if body is not None else (content if content is not None else b"")
         )
-        normalized_headers = {
-            str(key).lower(): str(value)
-            for key, value in (
-                headers.items() if hasattr(headers, "items") else (headers or [])
-            )
-        }
+        headers_base = HeadersBase(headers)
 
         super().__init__(
             kind=kind,
             media_type=media_type,
             status_code=status_code,
-            headers=dict(normalized_headers),
+            headers=dict(headers_base),
             envelope=envelope,
             template=template,
             filename=filename,
@@ -59,15 +54,13 @@ class ResponseBase(ResponseSpec):
             redirect_to=redirect_to,
         )
         self.status_code = status_code
-        self.headers: HeadersBase = HeadersBase(normalized_headers)
+        self.headers: HeadersBase = headers_base
         self.body = payload
         self.media_type = media_type
 
     @property
     def raw_headers(self) -> list[tuple[bytes, bytes]]:
-        return [
-            (k.encode("latin-1"), v.encode("latin-1")) for k, v in self.headers.items()
-        ]
+        return self.headers.raw_headers
 
     @property
     def headers_map(self) -> HeadersBase:

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/_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__"):

{tigrbl_base-0.4.3.dev4.dist-info → tigrbl_base-0.4.4.dev7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-base
-Version: 0.4.3.dev4
+Version: 0.4.4.dev7
 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.dev4.dist-info → tigrbl_base-0.4.4.dev7.dist-info}/RECORD

@@ -1,4 +1,4 @@
-tigrbl_base/_base/__init__.py,sha256=8-d-nNB1jEfqGR8m7KLU7H5jwin7vMhiEnpz_1hQxB4,1284
+tigrbl_base/_base/__init__.py,sha256=WCgpQb4SDuYas2jXWtU5BvyhFz71iVru-RGjHXwkDB0,1362
 tigrbl_base/_base/_alias_base.py,sha256=DeBwVYrkOYbQliZriBfnopsLIEZwn6SQMbkS8hGOrO8,1265
 tigrbl_base/_base/_app_base.py,sha256=osoATbXZhRjEzR8k0S6ACfIFqXPVM1HyOg6-xcPbIrU,5366
 tigrbl_base/_base/_assembly.py,sha256=k3KRKijcB6XTzm-pSnqOvkAb_htVHlrm5n-tV_dnC1U,1809
@@ -7,22 +7,22 @@ tigrbl_base/_base/_column_base.py,sha256=tA08qOVe7OTaO-xSQvybE00VJPj2kFZ8Z_UkeJB
 tigrbl_base/_base/_datatype_lowering.py,sha256=XVVSaOqdAwPViBVuhXpNmrDSawwbBzxoqu0_x1f0IZE,1653
 tigrbl_base/_base/_engine_base.py,sha256=G5ODOOF413ViX7Pkm6FRl7dcqPdzK-PLJiL2Qv9DQ28,764
 tigrbl_base/_base/_engine_provider_base.py,sha256=WEj4pISQ7z34SOZMNN2ZNci3f5kcPWx85k131db06uM,321
-tigrbl_base/_base/_headers_base.py,sha256=7DMJIn1LsVlZIjuuBHYrtwW1nLAGum_RIIIPnD8Nvl0,294
+tigrbl_base/_base/_headers_base.py,sha256=btikCRtQw7K0btJpHQtHcv6R4gI2F5wi2sO1eLXQA2E,2593
 tigrbl_base/_base/_hook_base.py,sha256=ycRlUXZkzpmE4-sF9UaTHKJ7KqIECd-69dAiSQc8xio,579
 tigrbl_base/_base/_mapping_access.py,sha256=uPhHw7pZJecg8rldwtwXdO355ofm0B29MhXWklWoGn0,683
 tigrbl_base/_base/_middleware_base.py,sha256=O2QKBimBgaBuzlC3cZKif-Aq-0HebNV0-uqispwOSXg,4579
 tigrbl_base/_base/_op_base.py,sha256=4kejZkpj6tTcIfF2JAFNxh49z3lgIhvxn9NBw-pUyhc,230
 tigrbl_base/_base/_request_base.py,sha256=9SKnJfQ9XQgUbUHxx4PXdPUh_53gQkGTCvpANzD30rc,1554
-tigrbl_base/_base/_response_base.py,sha256=-q__euq7-5SRKhn3VUWQ4BYzVZVwdkRuF6_YU1SGKsY,3094
+tigrbl_base/_base/_response_base.py,sha256=HkYtkN6UMiamJk5t-xghbbdWM_H4MfjTVkK8yDi8PAc,2828
 tigrbl_base/_base/_rest_map.py,sha256=CG9UGz2F4o6cmgu58gdZiAqdCwxrCnJwdaPE3dy_1D8,3345
 tigrbl_base/_base/_router_base.py,sha256=PXaVlNc0TWE3gQbGO9CvrOSJIbb3z_VvBsxtp11IOJ8,1556
 tigrbl_base/_base/_rpc_map.py,sha256=67_TvblvR0IQzONThBj8AeByGPE3M492OnNh-XHW_x8,18468
-tigrbl_base/_base/_schema_base.py,sha256=v17Ev7J46exof-8i_1aAUjprwXFb0lnW1X58U-2ADhw,1819
+tigrbl_base/_base/_schema_base.py,sha256=XWTlcm8FuxPVMmDCiy_fX56HI9O_NWBXEYeTpd0lWM0,3060
 tigrbl_base/_base/_security_base.py,sha256=LTv3TYeW6WX60KixLsEtIPta5ap4lmqDiSfBB1MP2YE,2284
 tigrbl_base/_base/_session_abc.py,sha256=oHEvhJyhHrcp4TJrU9znUMA9AlYZCm8i8b6nm6xZL2I,1207
 tigrbl_base/_base/_session_base.py,sha256=KDdz-tK-0aDhYSv-CQDlnRT17gNT9PaephJmkRtMzU8,4343
 tigrbl_base/_base/_storage.py,sha256=yCpmR_B9_JV7w-DGJIpKb-VDGtA4yf3F_GJyG4V4JxI,508
-tigrbl_base/_base/_table_base.py,sha256=9EMvqqs6MvQh_ykjmIdCyauXfpeNQftW1l56G3PjHFE,23284
+tigrbl_base/_base/_table_base.py,sha256=ETFE7AYTcnkBTmlHvHauQlgvGqWnxofIpJmTt2yeXtU,23511
 tigrbl_base/_base/_table_registry_base.py,sha256=0bkl0g6JFonzaaDiP5dVPxJ8g2LVqq25vyu9JniY1zM,1801
 tigrbl_base/column/__init__.py,sha256=DfJkmiDkpThisBttbzSACAaKc8XtdHH2HMiDBwsuDlc,3306
 tigrbl_base/column/infer/__init__.py,sha256=JMfMGGiGtc9jMql6po7mu4r7GVZqnyi_YzNNjLrL53I,367
@@ -31,8 +31,8 @@ tigrbl_base/column/infer/jsonhints.py,sha256=pCTXhFUvPvzd9KLxZob_m2SYNaZI0nVIKc7
 tigrbl_base/column/infer/planning.py,sha256=PebtJaYEIkBVepazmIajbFkvfAEEwFEt9M1p97vjSs0,4264
 tigrbl_base/column/infer/types.py,sha256=NGdnddAugowHDl8Lhw0b83wxCCLAROjtPtWiyMagoEs,1720
 tigrbl_base/column/infer/utils.py,sha256=J8VcLGA-KXjy3IJ2ROQ1alyfYP9qj8ukb5Z3IMvasi4,1532
-tigrbl_base-0.4.3.dev4.dist-info/METADATA,sha256=h8WC_GJW3rjXfwarEcx4iGpWIfoEtZ8fKgeUTGTy4d4,27445
-tigrbl_base-0.4.3.dev4.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
-tigrbl_base-0.4.3.dev4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-tigrbl_base-0.4.3.dev4.dist-info/licenses/NOTICE,sha256=EvJMTshzsWz43LiK-DeN2ZuLtrP49cxvlrFlJ8F_buc,221
-tigrbl_base-0.4.3.dev4.dist-info/RECORD,,
+tigrbl_base-0.4.4.dev7.dist-info/METADATA,sha256=npJfC8fHH2702cpxmlU59M4L7Mfw1RU3OJxnXd8kaLQ,27445
+tigrbl_base-0.4.4.dev7.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
+tigrbl_base-0.4.4.dev7.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+tigrbl_base-0.4.4.dev7.dist-info/licenses/NOTICE,sha256=EvJMTshzsWz43LiK-DeN2ZuLtrP49cxvlrFlJ8F_buc,221
+tigrbl_base-0.4.4.dev7.dist-info/RECORD,,