tigrbl 0.3.0.dev4__tar.gz → 0.3.2__tar.gz

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/PKG-INFO

@@ -1,8 +1,10 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: tigrbl
-Version: 0.3.0.dev4
+Version: 0.3.2
 Summary: Automatic API generation tools by Swarmauri.
-License: Apache-2.0
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: tigrbl,sdk,standards
 Author: Swarmauri Team
 Author-email: team@swarmauri.com
 Requires-Python: >=3.10,<3.13
@@ -11,8 +13,12 @@ Classifier: Development Status :: 3 - Alpha
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
 Provides-Extra: postgres
 Provides-Extra: templates
+Provides-Extra: tests
 Requires-Dist: aiosqlite (>=0.19.0)
 Requires-Dist: asyncpg (>=0.30.0) ; extra == "postgres"
 Requires-Dist: fastapi (>=0.100.0)
@@ -25,10 +31,11 @@ Requires-Dist: sqlalchemy (>=2.0)
 Requires-Dist: swarmauri_base
 Requires-Dist: swarmauri_core
 Requires-Dist: swarmauri_standard
+Requires-Dist: tigrbl-tests ; extra == "tests"
 Requires-Dist: uvicorn
 Description-Content-Type: text/markdown
 
-![Tigrbl Logo](../../../assets/tigrbl_full_logo.png)
+![Tigrbl Logo](https://github.com/swarmauri/swarmauri-sdk/blob/a170683ecda8ca1c4f912c966d4499649ffb8224/assets/tigrbl.brand.theme.svg)
 
 <p align="center">
     <a href="https://pypi.org/project/tigrbl/">
@@ -48,6 +55,14 @@ Description-Content-Type: text/markdown
 # Tigrbl 🐅🐂
 A high-leverage meta-framework that turns plain SQLAlchemy models into a fully-featured REST+RPC surface with near-zero boilerplate. 🚀
 
+## Features ✨
+
+- ⚡ Zero-boilerplate CRUD for SQLAlchemy models
+- 🔌 Unified REST and RPC endpoints from a single definition
+- 🪝 Hookable phase system for deep customization
+- 🧩 Pluggable engine and provider abstractions
+- 🚀 Built on FastAPI and Pydantic for modern Python web apps
+
 ## Terminology 📚
 
 - **Tenant** 🏢 – a namespace used to group related resources.

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/README.md

@@ -1,4 +1,4 @@
-![Tigrbl Logo](../../../assets/tigrbl_full_logo.png)
+![Tigrbl Logo](https://github.com/swarmauri/swarmauri-sdk/blob/a170683ecda8ca1c4f912c966d4499649ffb8224/assets/tigrbl.brand.theme.svg)
 
 <p align="center">
     <a href="https://pypi.org/project/tigrbl/">
@@ -18,6 +18,14 @@
 # Tigrbl 🐅🐂
 A high-leverage meta-framework that turns plain SQLAlchemy models into a fully-featured REST+RPC surface with near-zero boilerplate. 🚀
 
+## Features ✨
+
+- ⚡ Zero-boilerplate CRUD for SQLAlchemy models
+- 🔌 Unified REST and RPC endpoints from a single definition
+- 🪝 Hookable phase system for deep customization
+- 🧩 Pluggable engine and provider abstractions
+- 🚀 Built on FastAPI and Pydantic for modern Python web apps
+
 ## Terminology 📚
 
 - **Tenant** 🏢 – a namespace used to group related resources.

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl"
-version = "0.3.0.dev4"
+version = "0.3.2"
 description = "Automatic API generation tools by Swarmauri."
 license = "Apache-2.0"
 readme = "README.md"
@@ -12,6 +12,9 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
 ]
 authors = [{ name = "Swarmauri Team", email = "team@swarmauri.com" }]
 dependencies = [
@@ -26,6 +29,11 @@ dependencies = [
     "greenlet>=3.2.3",
     "uvicorn", 
 ]
+keywords = [
+    'tigrbl',
+    'sdk',
+    'standards',
+]
 
 [project.optional-dependencies]
 postgres = [
@@ -35,14 +43,19 @@ postgres = [
 templates = [
     "jinja2>=3.1.4",
 ]
+tests = [
+    "tigrbl-tests",
+]
 
 [tool.uv.sources]
 swarmauri_core = { workspace = true }
 swarmauri_base = { workspace = true }
 swarmauri_standard = { workspace = true }
+tigrbl-tests = { workspace = true }
 
 [tool.pytest.ini_options]
 norecursedirs = ["combined", "scripts"]
+testpaths = ["../tigrbl_tests/tests"]
 markers = [
     "test: standard test",
     "unit: Unit tests",
@@ -65,6 +78,11 @@ asyncio_default_fixture_loop_scope = "function"
 requires = ["poetry-core>=1.0.0"]
 build-backend = "poetry.core.masonry.api"
 
+[tool.poetry]
+packages = [
+    { include = "tigrbl" },
+]
+
 [dependency-groups]
 dev = [
     "pytest>=8.0",
@@ -79,4 +97,4 @@ dev = [
     "pytest-benchmark>=4.0.0",
     "asyncpg>=0.30.0",
     "psycopg2-binary>=2.9.9",
-]
+]

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/api/_api.py

@@ -6,7 +6,9 @@ from types import SimpleNamespace
 from ..deps.fastapi import APIRouter as ApiRouter
 from ..engine.engine_spec import EngineCfg
 from ..engine import install_from_objects
+from ..ddl import initialize as _ddl_initialize
 from ..engine import resolver as _resolver
+from ..app._model_registry import initialize_model_registry
 from .api_spec import APISpec
 
 
@@ -41,7 +43,7 @@ class Api(APISpec, ApiRouter):
         self.deps = tuple(getattr(self, "DEPS", ()))
         self.response = getattr(self, "RESPONSE", None)
         # ``models`` is expected to be a dict at runtime for registry lookups.
-        self.models: dict[str, type] = {}
+        self.models = initialize_model_registry(getattr(self, "MODELS", ()))
 
         ApiRouter.__init__(
             self,
@@ -70,3 +72,26 @@ class Api(APISpec, ApiRouter):
                 install_from_objects(app=self, api=a, models=models)
         else:
             install_from_objects(app=self, api=None, models=models)
+
+    def _collect_tables(self) -> list[Any]:
+        seen = set()
+        tables = []
+        for model in self.models.values():
+            if not hasattr(model, "__table__"):
+                try:  # pragma: no cover - defensive remap
+                    from ..table import Base
+                    from ..table._base import _materialize_colspecs_to_sqla
+
+                    _materialize_colspecs_to_sqla(model)
+                    Base.registry.map_declaratively(model)
+                except Exception:
+                    pass
+            table = getattr(model, "__table__", None)
+            if table is not None and not table.columns:
+                continue
+            if table is not None and table not in seen:
+                seen.add(table)
+                tables.append(table)
+        return tables
+
+    initialize = _ddl_initialize

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/api/tigrbl_api.py

@@ -32,6 +32,7 @@ from ..bindings.rest import build_router_and_attach as _build_router_and_attach
 from ..transport import mount_jsonrpc as _mount_jsonrpc
 from ..system import mount_diagnostics as _mount_diagnostics
 from ..op import get_registry, OpSpec
+from ..app._model_registry import initialize_model_registry
 
 
 class TigrblApi(_Api):
@@ -73,7 +74,7 @@ class TigrblApi(_Api):
         self.system_prefix = system_prefix
 
         # public containers (mirrors used by bindings.api)
-        self.models: Dict[str, type] = {}
+        self.models = initialize_model_registry(getattr(self, "MODELS", ()))
         self.schemas = SimpleNamespace()
         self.handlers = SimpleNamespace()
         self.hooks = SimpleNamespace()
@@ -231,6 +232,8 @@ class TigrblApi(_Api):
     ) -> None:
         if authn is not None:
             self._authn = authn
+            if allow_anon is None:
+                allow_anon = False
         if allow_anon is not None:
             self._allow_anon = bool(allow_anon)
         if authorize is not None:
@@ -270,6 +273,8 @@ class TigrblApi(_Api):
         tables = []
         for m in self.models.values():
             t = getattr(m, "__table__", None)
+            if t is not None and not t.columns:
+                continue
             if t is not None and t not in seen:
                 seen.add(t)
                 tables.append(t)

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/app/_app.py

@@ -6,6 +6,8 @@ from ..deps.fastapi import FastAPI
 from ..engine.engine_spec import EngineCfg
 from ..engine import resolver as _resolver
 from ..engine import install_from_objects
+from ..ddl import initialize as _ddl_initialize
+from ._model_registry import initialize_model_registry
 from .app_spec import AppSpec
 
 
@@ -23,7 +25,7 @@ class App(AppSpec, FastAPI):
         self.ops = tuple(getattr(self, "OPS", ()))
         # Runtime registries use mutable containers (dict/namespace), but the
         # dataclass fields expect sequences. Storing a dict here satisfies both.
-        self.models = {}
+        self.models = initialize_model_registry(getattr(self, "MODELS", ()))
         self.schemas = tuple(getattr(self, "SCHEMAS", ()))
         self.hooks = tuple(getattr(self, "HOOKS", ()))
         self.security_deps = tuple(getattr(self, "SECURITY_DEPS", ()))
@@ -59,3 +61,26 @@ class App(AppSpec, FastAPI):
                 install_from_objects(app=self, api=a, models=models)
         else:
             install_from_objects(app=self, api=None, models=models)
+
+    def _collect_tables(self) -> list[Any]:
+        seen = set()
+        tables = []
+        for model in self.models.values():
+            if not hasattr(model, "__table__"):
+                try:  # pragma: no cover - defensive remap
+                    from ..table import Base
+                    from ..table._base import _materialize_colspecs_to_sqla
+
+                    _materialize_colspecs_to_sqla(model)
+                    Base.registry.map_declaratively(model)
+                except Exception:
+                    pass
+            table = getattr(model, "__table__", None)
+            if table is not None and not table.columns:
+                continue
+            if table is not None and table not in seen:
+                seen.add(table)
+                tables.append(table)
+        return tables
+
+    initialize = _ddl_initialize

tigrbl-0.3.2/tigrbl/app/_model_registry.py

@@ -0,0 +1,41 @@
+"""Utilities for initializing model registries on App and API facades."""
+
+from __future__ import annotations
+
+from typing import Any, Iterable
+
+
+def initialize_model_registry(models: Iterable[Any]) -> dict[str, Any]:
+    """Build the default ``models`` mapping for an App or Api instance.
+
+    ``defineAppSpec``/``defineApiSpec`` allow authors to declare default models
+    using bare model classes or ``("alias", Model)`` tuples.  Runtime facades,
+    however, expect ``self.models`` to be a dictionary keyed by model name so
+    that lookups like ``app.models["Widget"]`` Just Work.
+
+    This helper normalizes the declared sequence into that dictionary shape and
+    preserves declaration order.  When an alias is provided we register both the
+    alias and the model's ``__name__`` so either lookup style succeeds.
+    """
+
+    registry: dict[str, Any] = {}
+
+    for entry in models or ():
+        # Support ``("Alias", Model)`` declarations in addition to bare models.
+        if isinstance(entry, tuple) and len(entry) == 2 and isinstance(entry[0], str):
+            alias, model = entry
+            registry[alias] = model
+            model_name = getattr(model, "__name__", alias)
+            registry.setdefault(model_name, model)
+            continue
+
+        model = entry
+        model_name = getattr(model, "__name__", None)
+        if model_name is None:
+            model_name = str(model)
+        registry[model_name] = model
+
+    return registry
+
+
+__all__ = ["initialize_model_registry"]

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/app/tigrbl_app.py

@@ -32,6 +32,7 @@ from ..bindings.rest import build_router_and_attach as _build_router_and_attach
 from ..transport import mount_jsonrpc as _mount_jsonrpc
 from ..system import mount_diagnostics as _mount_diagnostics
 from ..op import get_registry, OpSpec
+from ._model_registry import initialize_model_registry
 
 
 # optional compat: legacy transactional decorator
@@ -93,7 +94,7 @@ class TigrblApp(_App):
         self.system_prefix = system_prefix
 
         # public containers (mirrors used by bindings.api)
-        self.models: Dict[str, type] = {}
+        self.models = initialize_model_registry(getattr(self, "MODELS", ()))
         self.schemas = SimpleNamespace()
         self.handlers = SimpleNamespace()
         self.hooks = SimpleNamespace()
@@ -262,6 +263,8 @@ class TigrblApp(_App):
     ) -> None:
         if authn is not None:
             self._authn = authn
+            if allow_anon is None:
+                allow_anon = False
         if allow_anon is not None:
             self._allow_anon = bool(allow_anon)
         if authorize is not None:
@@ -301,6 +304,8 @@ class TigrblApp(_App):
         tables = []
         for m in self.models.values():
             t = getattr(m, "__table__", None)
+            if t is not None and not t.columns:
+                continue
             if t is not None and t not in seen:
                 seen.add(t)
                 tables.append(t)

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/api/__init__.py

@@ -5,7 +5,6 @@ from .common import AttrDict, _default_prefix, _mount_router  # noqa: F401
 from .include import include_model, include_models, _seed_security_and_deps  # noqa: F401
 from .rpc import rpc_call
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/api/__init__")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/api/common.py

@@ -4,7 +4,6 @@ import logging
 from types import SimpleNamespace
 from typing import Any
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/api/common")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/api/include.py

@@ -24,11 +24,23 @@ from ...config.constants import (
 )
 from ...engine import resolver as _resolver
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/api/include")
 
 
+def _coerce_model_columns(columns: Any) -> Tuple[str, ...]:
+    if isinstance(columns, SimpleNamespace):
+        return tuple(columns.__dict__.keys())
+    if isinstance(columns, dict):
+        return tuple(columns.keys())
+    if isinstance(columns, str):
+        return (columns,)
+    try:
+        return tuple(columns)
+    except TypeError:
+        return ()
+
+
 # --- keep as helper, no behavior change to transports/kernel ---
 def _seed_security_and_deps(api: Any, model: type) -> None:
     """
@@ -132,7 +144,7 @@ def _attach_to_api(api: ApiLike, model: type) -> None:
     )
 
     # Table metadata (introspection only)
-    api.columns[mname] = tuple(getattr(model, "columns", ()))
+    api.columns[mname] = _coerce_model_columns(getattr(model, "columns", ()))
     api.table_config[mname] = dict(getattr(model, "table_config", {}) or {})
 
     # Core helper proxies (now aware of API for DB resolution precedence)

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/api/resource_proxy.py

@@ -8,7 +8,6 @@ from ..rpc import _coerce_payload, _get_phase_chains, _validate_input, _serializ
 from ...runtime import executor as _executor
 from ...engine import resolver as _resolver
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/api/resource_proxy")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/api/rpc.py

@@ -8,7 +8,6 @@ from .common import ApiLike, _ensure_api_ns
 from ...engine import resolver as _resolver
 from ...core.crud.helpers.model import _single_pk_name
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/api/rpc")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/handlers/__init__.py

@@ -4,7 +4,6 @@ import logging
 
 from .builder import build_and_attach
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/handlers/__init__")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/handlers/builder.py

@@ -9,7 +9,6 @@ from ...op.types import StepFn
 from .namespaces import _ensure_alias_handlers_ns, _ensure_alias_hooks_ns
 from .steps import _wrap_core, _wrap_custom
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/handlers/builder")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/handlers/ctx.py

@@ -4,7 +4,6 @@ import logging
 
 from typing import Any, Mapping, Sequence
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/handlers/ctx")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/handlers/identifiers.py

@@ -7,7 +7,6 @@ from typing import Any, Mapping, Optional
 
 from .ctx import _ctx_payload, _ctx_path_params
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/handlers/identifiers")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/handlers/namespaces.py

@@ -4,7 +4,6 @@ import logging
 
 from types import SimpleNamespace
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/handlers/namespaces")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/handlers/steps.py

@@ -13,7 +13,6 @@ from ...runtime.executor import _Ctx
 from .ctx import _ctx_db, _ctx_payload, _ctx_request
 from .identifiers import _resolve_ident
 
-logging.getLogger("uvicorn").setLevel(logging.DEBUG)
 logger = logging.getLogger("uvicorn")
 logger.debug("Loaded module v3/bindings/handlers/steps")
 

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/rest/collection.py

@@ -35,6 +35,8 @@ from .common import (
     _status_for,
 )
 
+from .io_headers import _make_header_dep
+
 from ...runtime.executor.types import _Ctx
 
 
@@ -103,6 +105,7 @@ def _make_collection_endpoint(
 ) -> Callable[..., Awaitable[Any]]:
     alias, target, nested_vars = sp.alias, sp.target, list(nested_vars or [])
     status_code = _status_for(sp)
+    hdr_dep = _make_header_dep(model, alias)
 
     if target in {"list", "clear"}:
         list_dep = _make_list_query_dep(model, alias) if target == "list" else None
@@ -110,6 +113,7 @@ def _make_collection_endpoint(
         async def _endpoint(
             request: Request,
             db: Any = Depends(db_dep),
+            h: Mapping[str, Any] = Depends(hdr_dep),
             q: Mapping[str, Any] | None = None,
             **kw: Any,
         ):
@@ -120,6 +124,8 @@ def _make_collection_endpoint(
                 payload = _validate_query(model, alias, target, query)
             else:
                 payload = dict(parent_kw)
+            if isinstance(h, Mapping):
+                payload = {**payload, **dict(h)}
             ctx = _ctx(model, alias, target, request, db, payload, parent_kw, api)
             ctx["response_serializer"] = lambda r: _serialize_output(
                 model, alias, target, sp, r
@@ -154,16 +160,20 @@ def _make_collection_endpoint(
                     inspect.Parameter.POSITIONAL_OR_KEYWORD,
                     annotation=Annotated[Any, Depends(db_dep)],
                 ),
+                inspect.Parameter(
+                    "h",
+                    inspect.Parameter.POSITIONAL_OR_KEYWORD,
+                    annotation=Annotated[Mapping[str, Any], Depends(hdr_dep)],
+                ),
             ]
         )
         if target == "list":
-            params.insert(
-                len(nested_vars) + 1,
+            params.append(
                 inspect.Parameter(
                     "q",
                     inspect.Parameter.POSITIONAL_OR_KEYWORD,
                     annotation=Annotated[Mapping[str, Any], Depends(list_dep)],
-                ),
+                )
             )
         _endpoint.__signature__ = inspect.Signature(params)
     else:
@@ -192,12 +202,18 @@ def _make_collection_endpoint(
         async def _endpoint(
             request: Request,
             db: Any = Depends(db_dep),
+            h: Mapping[str, Any] = Depends(hdr_dep),
             body=Body(...),
             **kw: Any,
         ):
             parent_kw = {k: kw[k] for k in nested_vars if k in kw}
             _coerce_parent_kw(model, parent_kw)
             payload = _validate_body(model, alias, target, body)
+            if isinstance(h, Mapping):
+                if isinstance(payload, Mapping):
+                    payload = {**payload, **dict(h)}
+                else:
+                    payload = [{**dict(item), **dict(h)} for item in payload]
             is_seq = (
                 target in {"create", "update", "replace", "merge"}
                 and isinstance(payload, Sequence)
@@ -248,6 +264,11 @@ def _make_collection_endpoint(
                     inspect.Parameter.POSITIONAL_OR_KEYWORD,
                     annotation=Annotated[Any, Depends(db_dep)],
                 ),
+                inspect.Parameter(
+                    "h",
+                    inspect.Parameter.POSITIONAL_OR_KEYWORD,
+                    annotation=Annotated[Mapping[str, Any], Depends(hdr_dep)],
+                ),
                 inspect.Parameter(
                     "body",
                     inspect.Parameter.POSITIONAL_OR_KEYWORD,

{tigrbl-0.3.0.dev4 → tigrbl-0.3.2}/tigrbl/bindings/rest/common.py

@@ -45,6 +45,8 @@ from .routing import (
     _default_path_suffix,
     _normalize_deps,
     _normalize_secdeps,
+    _require_auth_header,
+    _requires_auth_header,
     _path_for_spec,
     _request_model_for,
     _response_model_for,
@@ -106,6 +108,8 @@ __all__ = [
     "_optionalize_list_in_model",
     "_normalize_deps",
     "_normalize_secdeps",
+    "_require_auth_header",
+    "_requires_auth_header",
     "_status_for",
     "_RESPONSES_META",
     "_DEFAULT_METHODS",

tigrbl-0.3.2/tigrbl/bindings/rest/io_headers.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+import inspect
+from typing import Mapping, Any
+
+from fastapi import Header
+
+
+def _build_signature_with_header_params(
+    hdr_fields: list[tuple[str, str, bool]],
+) -> inspect.Signature:
+    params: list[inspect.Parameter] = []
+    for _field, header, required in hdr_fields:
+        param = header.lower().replace("-", "_")
+        default = Header(... if required else None, alias=header)
+        params.append(
+            inspect.Parameter(
+                name=param,
+                kind=inspect.Parameter.KEYWORD_ONLY,
+                default=default,
+                annotation=str | None,
+            )
+        )
+    return inspect.Signature(parameters=params, return_annotation=Mapping[str, object])
+
+
+def _make_header_dep(model: type, alias: str):
+    hdr_fields: list[tuple[str, str, bool]] = []
+    for name, spec in getattr(model, "__tigrbl_cols__", {}).items():
+        io = getattr(spec, "io", None)
+        if not io or not getattr(io, "header_in", None):
+            continue
+        if alias not in set(getattr(io, "in_verbs", ()) or ()):  # honor IO.in_verbs
+            continue
+        hdr_fields.append(
+            (name, io.header_in, bool(getattr(io, "header_required_in", False)))
+        )
+
+    async def _dep(**kw: Any) -> Mapping[str, object]:
+        out: dict[str, object] = {}
+        for field, header, _req in hdr_fields:
+            param = header.lower().replace("-", "_")
+            v = kw.get(param)
+            if v is not None:
+                out[field] = v
+        return out
+
+    _dep.__signature__ = _build_signature_with_header_params(hdr_fields)
+    return _dep