tigrbl 0.3.16.dev4__tar.gz → 0.3.17.dev2__tar.gz

{tigrbl-0.3.16.dev4 → tigrbl-0.3.17.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl
-Version: 0.3.16.dev4
+Version: 0.3.17.dev2
 Summary: A modern pure ASGI/WSGI Python framework for building schema-first REST and JSON-RPC APIs with SQLAlchemy models, typed validation, lifecycle hooks, and engine extension support.
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -59,11 +59,16 @@ A high-leverage ASGI meta-framework that turns plain SQLAlchemy models into a fu
 - 🧩 Pluggable engine and provider abstractions
 - 🚀 Built as an ASGI-native framework with Pydantic-powered schema generation
 
+## Runtime-owned Routing Contract
+
+For the kernel-first flow that avoids pre-runtime REST/RPC dispatching, see
+[`RUNTIME_OWNED_ROUTING.md`](./RUNTIME_OWNED_ROUTING.md).
+
 ## Terminology 📚
 
 - **Tenant** 🏢 – a namespace used to group related resources.
 - **Principal** 👤 – an owner of resources, such as an individual user or an organization.
-- **Resource** 📦 – a logical collection of data or functionality exposed by the API.
+- **Resource** 📦 – a logical collection of data or functionality exposed by the router.
 - **Engine** ⚙️ – the database connection and transaction manager backing a resource.
 - **Model / Table** 🧱 – the ORM or database representation of a resource's records.
 - **Column** 📏 – a field on a model that maps to a table column.
@@ -310,7 +315,7 @@ increasing order of precedence:
 
 1. defaults
 2. app config
-3. API config
+3. router config
 4. table config
 5. column config
 6. operation spec
@@ -318,7 +323,7 @@ increasing order of precedence:
 
 Later entries override earlier ones, so request overrides win over all other
 sources. This can be summarized as
-`overrides > opspec > colspecs > tabspec > apispec > appspec > defaults`.
+`overrides > opspec > colspecs > tabspec > routerspec > appspec > defaults`.
 
 ### Schema Config Precedence 🧬
 
@@ -327,7 +332,7 @@ Later layers override earlier ones, with the precedence order:
 
 1. defaults (lowest)
 2. app configuration
-3. API configuration
+3. router configuration
 4. table configuration
 5. column-level `cfg` values
 6. op-specific `cfg`
@@ -367,7 +372,7 @@ This hierarchy ensures that the most specific settings always win. 🥇
 When assembling values for persistence, defaults are resolved in this order:
 
 1. Client-supplied value
-2. API `default_factory`
+2. router `default_factory`
 3. ORM default
 4. Database `server_default`
 5. HTTP 422 if the field is required and still missing
@@ -408,15 +413,15 @@ approved usage. These are not optional—adhering to them keeps the runtime
 predictable, preserves hook lifecycle guarantees, and ensures schema
 consistency across REST and RPC surfaces.
 
-### 1) Never import SQLAlchemy directly or bypass Tigrbl APIs
+### 1) Never import SQLAlchemy directly or bypass Tigrbl routers
 
 **Why:** Direct imports bypass Tigrbl's compatibility layer and make it
 harder to evolve internal dependencies. Use the Tigrbl exports so your
-code stays aligned with the framework’s versioned ASGI API.
+code stays aligned with the framework’s versioned ASGI router.
 
 ✅ **Preferred:**
 ```python
-from tigrbl import Base, TigrblApp, TigrblApi
+from tigrbl import Base, TigrblApp, TigrblRouter
 from tigrbl.types import Integer, String, Mapped
 from tigrbl.types import Depends, HTTPException, Request
 ```
@@ -452,12 +457,12 @@ item_id = UUID(str(payload["id"]))
 ### 3) Use engine specs for persistence, not ad-hoc engines
 
 **Why:** Engine specs make persistence declarative, testable, and
-compatible with engine resolution across app, API, table, and op scopes.
+compatible with engine resolution across app, router, table, and op scopes.
 
 ✅ **Preferred:**
 ```python
 from tigrbl.engine.shortcuts import engine_spec
-from tigrbl.engine.decorators import engine_ctx
+from tigrbl.decorators.engine import engine_ctx
 
 spec = engine_spec(kind="postgres", async_=True, host="db", name="app_db")
 
@@ -588,9 +593,9 @@ async def rotate_keys(payload, *, ctx):
 
 🚫 **Avoid:**
 ```python
-from some_framework import APIRouter
+from some_framework import routerRouter
 
-router = APIRouter()
+router = routerRouter()
 
 @router.post("/keys/rotate")
 async def rotate_keys(payload):
@@ -606,7 +611,7 @@ resolved deterministically by the runtime.
 ✅ **Preferred:**
 ```python
 from tigrbl import hook_ctx, op_ctx, schema_ctx
-from tigrbl.engine.decorators import engine_ctx
+from tigrbl.decorators.engine import engine_ctx
 
 @engine_ctx(kind="sqlite", mode="memory")
 class Item(Table):
@@ -629,7 +634,7 @@ async def validate(ctx):
 
 ```python
 from tigrbl.engine.shortcuts import engine_spec, prov
-from tigrbl.engine._engine import Engine, Provider
+from tigrbl._concrete._engine import Engine, Provider
 
 # Build an EngineSpec from a DSN string
 spec = engine_spec("sqlite://:memory:")
@@ -656,7 +661,7 @@ provider_pg = Provider(spec_pg)
 `engine_ctx` binds database configuration to different layers. It accepts a
 DSN string, a mapping, an `EngineSpec`, a `Provider`, or an `Engine`. The
 resolver chooses the most specific binding in the order
-`op > table > api > app`.
+`op > table > router > app`.
 
 #### Engine precedence 🥇
 
@@ -664,8 +669,8 @@ When engine contexts are declared at multiple scopes, Tigrbl resolves them
 with strict precedence:
 
 1. **Op level** – bindings attached directly to an operation take highest priority.
-2. **Table/Model level** – definitions on a model or table override API and app defaults.
-3. **API level** – bindings on the API class apply when no model-specific context exists.
+2. **Table/Model level** – definitions on a model or table override router and app defaults.
+3. **router level** – bindings on the router class apply when no model-specific context exists.
 4. **App level** – the default engine supplied to the application is used last.
 
 This ordering ensures that the most specific engine context always wins.
@@ -679,7 +684,7 @@ from tigrbl.engine.shortcuts import prov, engine
 app = SimpleNamespace(db=prov(kind="sqlite", mode="memory"))
 alt = SimpleNamespace(db=engine(kind="sqlite", mode="memory"))
 
-class API:
+class router:
     db = {"kind": "sqlite", "memory": True}
 
 class Item:
@@ -700,7 +705,7 @@ create.__tigrbl_engine_ctx__ = {
 #### Decorative bindings 🎛️
 
 ```python
-from tigrbl.engine.decorators import engine_ctx
+from tigrbl.decorators.engine import engine_ctx
 from tigrbl.engine.shortcuts import prov, engine
 
 @engine_ctx(prov(kind="sqlite", mode="memory"))
@@ -708,7 +713,7 @@ class App:
     pass
 
 @engine_ctx(engine(kind="sqlite", mode="memory"))
-class DecoratedAPI:
+class Decoratedrouter:
     pass
 
 @engine_ctx(kind="sqlite", mode="memory")
@@ -735,7 +740,7 @@ The bridge examples cover two integration styles:
   * A Swarmauri `Factory` invocation during `PRE_HANDLER` via `hook_ctx`.
   * Tigrbl default verbs (`create`, `get`, `list`, `update`, `delete`) plus a custom op.
   * `engine_ctx` at model and operation scope.
-  * Generated OpenAPI and OpenRPC documents mounted from the same model bindings.
+  * Generated Openrouter and OpenRPC documents mounted from the same model bindings.
 
 * **Smoother direct-model flow** (`swarmauri_tigrbl_bridge_smooth.py`)
   * Uses hooks + default `create` persistence to normalize Swarmauri payloads.

{tigrbl-0.3.16.dev4 → tigrbl-0.3.17.dev2}/README.md

@@ -26,11 +26,16 @@ A high-leverage ASGI meta-framework that turns plain SQLAlchemy models into a fu
 - 🧩 Pluggable engine and provider abstractions
 - 🚀 Built as an ASGI-native framework with Pydantic-powered schema generation
 
+## Runtime-owned Routing Contract
+
+For the kernel-first flow that avoids pre-runtime REST/RPC dispatching, see
+[`RUNTIME_OWNED_ROUTING.md`](./RUNTIME_OWNED_ROUTING.md).
+
 ## Terminology 📚
 
 - **Tenant** 🏢 – a namespace used to group related resources.
 - **Principal** 👤 – an owner of resources, such as an individual user or an organization.
-- **Resource** 📦 – a logical collection of data or functionality exposed by the API.
+- **Resource** 📦 – a logical collection of data or functionality exposed by the router.
 - **Engine** ⚙️ – the database connection and transaction manager backing a resource.
 - **Model / Table** 🧱 – the ORM or database representation of a resource's records.
 - **Column** 📏 – a field on a model that maps to a table column.
@@ -277,7 +282,7 @@ increasing order of precedence:
 
 1. defaults
 2. app config
-3. API config
+3. router config
 4. table config
 5. column config
 6. operation spec
@@ -285,7 +290,7 @@ increasing order of precedence:
 
 Later entries override earlier ones, so request overrides win over all other
 sources. This can be summarized as
-`overrides > opspec > colspecs > tabspec > apispec > appspec > defaults`.
+`overrides > opspec > colspecs > tabspec > routerspec > appspec > defaults`.
 
 ### Schema Config Precedence 🧬
 
@@ -294,7 +299,7 @@ Later layers override earlier ones, with the precedence order:
 
 1. defaults (lowest)
 2. app configuration
-3. API configuration
+3. router configuration
 4. table configuration
 5. column-level `cfg` values
 6. op-specific `cfg`
@@ -334,7 +339,7 @@ This hierarchy ensures that the most specific settings always win. 🥇
 When assembling values for persistence, defaults are resolved in this order:
 
 1. Client-supplied value
-2. API `default_factory`
+2. router `default_factory`
 3. ORM default
 4. Database `server_default`
 5. HTTP 422 if the field is required and still missing
@@ -375,15 +380,15 @@ approved usage. These are not optional—adhering to them keeps the runtime
 predictable, preserves hook lifecycle guarantees, and ensures schema
 consistency across REST and RPC surfaces.
 
-### 1) Never import SQLAlchemy directly or bypass Tigrbl APIs
+### 1) Never import SQLAlchemy directly or bypass Tigrbl routers
 
 **Why:** Direct imports bypass Tigrbl's compatibility layer and make it
 harder to evolve internal dependencies. Use the Tigrbl exports so your
-code stays aligned with the framework’s versioned ASGI API.
+code stays aligned with the framework’s versioned ASGI router.
 
 ✅ **Preferred:**
 ```python
-from tigrbl import Base, TigrblApp, TigrblApi
+from tigrbl import Base, TigrblApp, TigrblRouter
 from tigrbl.types import Integer, String, Mapped
 from tigrbl.types import Depends, HTTPException, Request
 ```
@@ -419,12 +424,12 @@ item_id = UUID(str(payload["id"]))
 ### 3) Use engine specs for persistence, not ad-hoc engines
 
 **Why:** Engine specs make persistence declarative, testable, and
-compatible with engine resolution across app, API, table, and op scopes.
+compatible with engine resolution across app, router, table, and op scopes.
 
 ✅ **Preferred:**
 ```python
 from tigrbl.engine.shortcuts import engine_spec
-from tigrbl.engine.decorators import engine_ctx
+from tigrbl.decorators.engine import engine_ctx
 
 spec = engine_spec(kind="postgres", async_=True, host="db", name="app_db")
 
@@ -555,9 +560,9 @@ async def rotate_keys(payload, *, ctx):
 
 🚫 **Avoid:**
 ```python
-from some_framework import APIRouter
+from some_framework import routerRouter
 
-router = APIRouter()
+router = routerRouter()
 
 @router.post("/keys/rotate")
 async def rotate_keys(payload):
@@ -573,7 +578,7 @@ resolved deterministically by the runtime.
 ✅ **Preferred:**
 ```python
 from tigrbl import hook_ctx, op_ctx, schema_ctx
-from tigrbl.engine.decorators import engine_ctx
+from tigrbl.decorators.engine import engine_ctx
 
 @engine_ctx(kind="sqlite", mode="memory")
 class Item(Table):
@@ -596,7 +601,7 @@ async def validate(ctx):
 
 ```python
 from tigrbl.engine.shortcuts import engine_spec, prov
-from tigrbl.engine._engine import Engine, Provider
+from tigrbl._concrete._engine import Engine, Provider
 
 # Build an EngineSpec from a DSN string
 spec = engine_spec("sqlite://:memory:")
@@ -623,7 +628,7 @@ provider_pg = Provider(spec_pg)
 `engine_ctx` binds database configuration to different layers. It accepts a
 DSN string, a mapping, an `EngineSpec`, a `Provider`, or an `Engine`. The
 resolver chooses the most specific binding in the order
-`op > table > api > app`.
+`op > table > router > app`.
 
 #### Engine precedence 🥇
 
@@ -631,8 +636,8 @@ When engine contexts are declared at multiple scopes, Tigrbl resolves them
 with strict precedence:
 
 1. **Op level** – bindings attached directly to an operation take highest priority.
-2. **Table/Model level** – definitions on a model or table override API and app defaults.
-3. **API level** – bindings on the API class apply when no model-specific context exists.
+2. **Table/Model level** – definitions on a model or table override router and app defaults.
+3. **router level** – bindings on the router class apply when no model-specific context exists.
 4. **App level** – the default engine supplied to the application is used last.
 
 This ordering ensures that the most specific engine context always wins.
@@ -646,7 +651,7 @@ from tigrbl.engine.shortcuts import prov, engine
 app = SimpleNamespace(db=prov(kind="sqlite", mode="memory"))
 alt = SimpleNamespace(db=engine(kind="sqlite", mode="memory"))
 
-class API:
+class router:
     db = {"kind": "sqlite", "memory": True}
 
 class Item:
@@ -667,7 +672,7 @@ create.__tigrbl_engine_ctx__ = {
 #### Decorative bindings 🎛️
 
 ```python
-from tigrbl.engine.decorators import engine_ctx
+from tigrbl.decorators.engine import engine_ctx
 from tigrbl.engine.shortcuts import prov, engine
 
 @engine_ctx(prov(kind="sqlite", mode="memory"))
@@ -675,7 +680,7 @@ class App:
     pass
 
 @engine_ctx(engine(kind="sqlite", mode="memory"))
-class DecoratedAPI:
+class Decoratedrouter:
     pass
 
 @engine_ctx(kind="sqlite", mode="memory")
@@ -702,7 +707,7 @@ The bridge examples cover two integration styles:
   * A Swarmauri `Factory` invocation during `PRE_HANDLER` via `hook_ctx`.
   * Tigrbl default verbs (`create`, `get`, `list`, `update`, `delete`) plus a custom op.
   * `engine_ctx` at model and operation scope.
-  * Generated OpenAPI and OpenRPC documents mounted from the same model bindings.
+  * Generated Openrouter and OpenRPC documents mounted from the same model bindings.
 
 * **Smoother direct-model flow** (`swarmauri_tigrbl_bridge_smooth.py`)
   * Uses hooks + default `create` persistence to normalize Swarmauri payloads.

{tigrbl-0.3.16.dev4 → tigrbl-0.3.17.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl"
-version = "0.3.16.dev4"
+version = "0.3.17.dev2"
 description = "A modern pure ASGI/WSGI Python framework for building schema-first REST and JSON-RPC APIs with SQLAlchemy models, typed validation, lifecycle hooks, and engine extension support."
 license = "Apache-2.0"
 readme = "README.md"
@@ -48,6 +48,7 @@ tests = [
 
 [tool.uv.sources]
 tigrbl-tests = { workspace = true }
+tigrbl_client = { workspace = true }
 
 [tool.pytest.ini_options]
 norecursedirs = ["combined", "scripts"]
@@ -81,6 +82,7 @@ packages = [
 
 [dependency-groups]
 dev = [
+    "tigrbl_client",
     "pytest>=8.0",
     "pytest-asyncio>=0.24.0",
     "pytest-xdist>=3.6.1",

{tigrbl-0.3.16.dev4 → tigrbl-0.3.17.dev2}/tigrbl/README.md

@@ -86,7 +86,7 @@ Some objects also expose optional helpers:
 | Column | `column_spec.py` | `_column.py` | — | `shortcuts.py` | `collect.py` | — | — |
 | Engine | `engine_spec.py` | `_engine.py` | `decorators.py` | `shortcuts.py` | `collect.py` | `resolver.py` | `builders.py` |
 | Op | `types.py` | `_op.py` | `decorators.py` | — | `collect.py` | — | — |
-| API | `api_spec.py` | `_api.py` | — | `shortcuts.py` | — | — | — |
+| API | `router_spec.py` | `_api.py` | — | `shortcuts.py` | — | — | — |
 | App | `app_spec.py` | `_app.py` | — | `shortcuts.py` | — | — | — |
 | Table | `table_spec.py` | `_table.py` | — | `shortcuts.py` | — | — | — |
 

{tigrbl-0.3.16.dev4 → tigrbl-0.3.17.dev2}/tigrbl/__init__.py

@@ -5,24 +5,12 @@ Tigrbl – public API
 OpSpec-centric building blocks to bind models, wire schemas/handlers/hooks,
 register RPC & REST, and (optionally) mount JSON-RPC and diagnostics.
 
-Quick start:
-    from tigrbl import include_model, build_jsonrpc_router, mount_diagnostics
-    from tigrbl import OpSpec, hook_ctx, op_ctx, alias_ctx, schema_ctx, SchemaRef
-
-    include_model(api, User, app=asgi_app)
-    app.include_router(build_jsonrpc_router(api), prefix="/rpc")
-    app.include_router(mount_diagnostics(api), prefix="/system")
-
-    # Example: custom op using an existing schema
-    @op_ctx(alias="search", target="custom", arity="collection",
-            request_schema=SchemaRef("Search", "in"),
-            response_schema=SchemaRef("Search", "out"))
-    def search(cls, ctx):
-        ...
 """
 
 from __future__ import annotations
 
+from ._concrete import Router
+
 # ── OpSpec (source of truth) ───────────────────────────────────────────────────
 from .op import (
     OpSpec,
@@ -40,14 +28,13 @@ from .schema.types import SchemaRef, SchemaArg
 # ── Ctx-only decorators (new surface; replaces legacy ops.decorators) ─────────
 
 from .op import alias_ctx, op_ctx, alias, op_alias
-from .hook import hook_ctx
-from .engine.decorators import engine_ctx
-from .schema.decorators import schema_ctx
-from .responses.decorators import response_ctx
-from .responses.types import ResponseSpec
-
-# ── Bindings (model + API orchestration) ───────────────────────────────────────
-from .bindings import (
+from .decorators.hook import hook_ctx
+from .decorators.engine import engine_ctx
+from .decorators.schema import schema_ctx
+from .decorators.response import response_ctx
+
+# ── Bindings (model + Router orchestration) ───────────────────────────────────────
+from .mapping import (
     bind,
     rebind,
     build_schemas,
@@ -55,8 +42,8 @@ from .bindings import (
     build_handlers,
     register_rpc,
     build_rest,
-    include_model,
-    include_models,
+    include_table,
+    include_tables,
     rpc_call,
 )
 
@@ -67,7 +54,10 @@ from .runtime.executor import _invoke
 from .schema import _build_schema, _build_list_params, get_schema
 
 # ── Transport & Diagnostics (optional) ─────────────────────────────────────────
-from .transport.jsonrpc import build_jsonrpc_router
+from ._concrete._request import Request
+from .security import Depends
+from ._concrete._json_response import JSONResponse
+from ._concrete._response import Response
 from .system import mount_diagnostics
 
 # ── DB/bootstrap helpers (infra; optional) ─────────────────────────────────────
@@ -75,22 +65,62 @@ from .ddl import ensure_schemas, register_sqlite_attach, bootstrap_dbschema
 
 # ── Config constants (defaults used by REST) ───────────────────────────────────
 from .config.constants import DEFAULT_HTTP_METHODS
-from .app.tigrbl_app import TigrblApp
-from .api import Api, TigrblApi
-
-from .table import Base
+from ._concrete.tigrbl_app import TigrblApp
+from ._concrete.tigrbl_router import TigrblRouter
+from .decorators.router import route_ctx
+from .orm.tables import TableBase
 from .op import Op
-from .security import APIKey, HTTPBearer, MutualTLS, OAuth2, OpenIdConnect
+from .shortcuts.op import op
+from .engine import resolver
+from ._concrete._security.api_key import APIKey
+from ._concrete._security.http_bearer import HTTPBearer
+from ._concrete._security.mutual_tls import MutualTLS
+from ._concrete._security.oauth2 import OAuth2
+from ._concrete._security.openid_connect import OpenIdConnect
+from .runtime.status.exceptions import HTTPException
+from ._spec import (
+    AppSpec,
+    ColumnSpec,
+    EngineSpec,
+    FieldSpec,
+    ForeignKeySpec,
+    IOSpec,
+    RequestSpec,
+    ResponseSpec,
+    RouterSpec,
+    SchemaSpec,
+    SessionSpec,
+    StorageSpec,
+    StorageTransform,
+    TableRegistrySpec,
+    TableSpec,
+    TemplateSpec,
+)
+from ._base import ForeignKeyBase, HookBase, TableRegistryBase
+from ._concrete import (
+    App,
+    Column,
+    ForeignKey,
+    Hook,
+    Route,
+    Schema,
+    Table,
+    TableRegistry,
+)
+from .decorators import HOOK_DECLS_ATTR, middleware, middlewares
 
 
 __all__: list[str] = []
 
 __all__ += [
     "TigrblApp",
-    "TigrblApi",
-    "Api",
-    "Base",
+    "TigrblRouter",
+    "Router",
+    "Depends",
+    "HTTPException",
+    "TableBase",
     "Op",
+    "op",
     "HTTPBearer",
     "APIKey",
     "OAuth2",
@@ -114,6 +144,7 @@ __all__ += [
     # Ctx-only decorators
     "alias_ctx",
     "op_ctx",
+    "route_ctx",
     "hook_ctx",
     "schema_ctx",
     "response_ctx",
@@ -129,8 +160,8 @@ __all__ += [
     "build_handlers",
     "register_rpc",
     "build_rest",
-    "include_model",
-    "include_models",
+    "include_table",
+    "include_tables",
     "rpc_call",
     # Runtime
     "_invoke",
@@ -139,7 +170,6 @@ __all__ += [
     "_build_list_params",
     "get_schema",
     # Transport / Diagnostics
-    "build_jsonrpc_router",
     "mount_diagnostics",
     # DB/infra
     "ensure_schemas",
@@ -147,4 +177,40 @@ __all__ += [
     "bootstrap_dbschema",
     # Config
     "DEFAULT_HTTP_METHODS",
+    "Request",
+    "Depends",
+    "Response",
+    "JSONResponse",
+    "resolver",
+]
+__all__ += [
+    "AppSpec",
+    "RouterSpec",
+    "TableSpec",
+    "TableRegistrySpec",
+    "ColumnSpec",
+    "FieldSpec",
+    "IOSpec",
+    "StorageSpec",
+    "StorageTransform",
+    "ForeignKeySpec",
+    "RequestSpec",
+    "SchemaSpec",
+    "SessionSpec",
+    "EngineSpec",
+    "TemplateSpec",
+    "ForeignKeyBase",
+    "HookBase",
+    "TableRegistryBase",
+    "App",
+    "Table",
+    "Column",
+    "Route",
+    "Schema",
+    "Hook",
+    "ForeignKey",
+    "TableRegistry",
+    "HOOK_DECLS_ATTR",
+    "middleware",
+    "middlewares",
 ]

tigrbl-0.3.17.dev2/tigrbl/_base/__init__.py

@@ -0,0 +1,24 @@
+"""Base class implementations for tigrbl internals."""
+
+from ._hook_base import HookBase
+from ._storage import ForeignKeyBase
+from ._op_base import OpBase
+from ._request_base import RequestBase
+from ._schema_base import SchemaBase
+from ._session_abc import SessionABC
+from ._session_base import TigrblSessionBase
+from ._table_base import TableBase
+from ._table_registry_base import TableRegistryBase
+
+
+__all__ = [
+    "HookBase",
+    "ForeignKeyBase",
+    "OpBase",
+    "RequestBase",
+    "SchemaBase",
+    "SessionABC",
+    "TigrblSessionBase",
+    "TableBase",
+    "TableRegistryBase",
+]

tigrbl-0.3.17.dev2/tigrbl/_base/_hook_base.py

@@ -0,0 +1,25 @@
+"""Base runtime hook wrapper for Tigrbl v3."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Iterable, Optional, Union
+
+from ..hook.types import HookPhase, StepFn
+from .._spec.hook_spec import HookSpec
+
+
+@dataclass(frozen=True, slots=True)
+class HookBase(HookSpec):
+    """Base hook bound to a phase and one or more ops."""
+
+    phase: HookPhase
+    fn: StepFn
+    ops: Union[str, Iterable[str]] = "*"
+    order: int = 0
+    when: Optional[object] = None
+    name: Optional[str] = None
+    description: Optional[str] = None
+
+
+__all__ = ["HookBase"]

tigrbl-0.3.16.dev4/tigrbl/middlewares/base.py → tigrbl-0.3.17.dev2/tigrbl/_base/_middleware_base.py

@@ -5,16 +5,15 @@ from __future__ import annotations
 from typing import Any
 from urllib.parse import urlencode
 
-from tigrbl.requests import Request
-from tigrbl.requests.adapters import request_from_asgi
-from tigrbl.responses import Response
-from tigrbl.responses._transport import finalize_transport_response
+from tigrbl._concrete._request import Request
+from tigrbl._concrete._request_adapters import request_from_asgi
+from tigrbl._concrete._response import Response
+from tigrbl.runtime.atoms.egress.asgi_send import finalize_transport_response
 
-from .middleware import Middleware
-from .spec import ASGIReceive, ASGISend, Message
+from .._spec.middleware_spec import MiddlewareSpec, ASGIReceive, ASGISend, Message
 
 
-class BaseHTTPMiddleware(Middleware):
+class MiddlewareBase(MiddlewareSpec):
     """Base middleware for intercepting HTTP requests in ASGI mode."""
 
     async def dispatch(
@@ -139,4 +138,4 @@ class BaseHTTPMiddleware(Middleware):
         )
 
 
-__all__ = ["BaseHTTPMiddleware"]
+__all__ = ["MiddlewareBase"]

tigrbl-0.3.17.dev2/tigrbl/_base/_op_base.py

@@ -0,0 +1,12 @@
+"""Base operation descriptor implementation for Tigrbl."""
+
+from __future__ import annotations
+
+from .._spec.op_spec import OpSpec
+
+
+class OpBase(OpSpec):
+    """Base operation descriptor type."""
+
+
+__all__ = ["OpBase"]