tigrbl 0.3.16.dev5__tar.gz → 0.3.17__tar.gz

{tigrbl-0.3.16.dev5 → tigrbl-0.3.17}/PKG-INFO

@@ -1,10 +1,9 @@
 Metadata-Version: 2.4
 Name: tigrbl
-Version: 0.3.16.dev5
+Version: 0.3.17
 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
-Keywords: tigrbl,sdk,standards,asgi,rest,rpc
 Author: Jacob Stewart
 Author-email: jacob@swarmauri.com
 Requires-Python: >=3.10,<3.13
@@ -27,6 +26,15 @@ Requires-Dist: jinja2 (>=3.1.4) ; extra == "templates"
 Requires-Dist: psycopg2-binary (>=2.9.9) ; extra == "postgres"
 Requires-Dist: pydantic (>=2.0.0)
 Requires-Dist: sqlalchemy (>=2.0)
+Requires-Dist: tigrbl-atoms
+Requires-Dist: tigrbl-base
+Requires-Dist: tigrbl-canon
+Requires-Dist: tigrbl-concrete
+Requires-Dist: tigrbl-core
+Requires-Dist: tigrbl-kernel
+Requires-Dist: tigrbl-ops-oltp
+Requires-Dist: tigrbl-orm
+Requires-Dist: tigrbl-runtime
 Requires-Dist: tigrbl-tests ; extra == "tests"
 Requires-Dist: uvicorn
 Description-Content-Type: text/markdown
@@ -59,6 +67,23 @@ 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
 
+## Split Package Module Locations 🗂️
+
+These surfaces are now maintained in the split Tigrbl packages (with `tigrbl.*`
+kept as compatibility imports):
+
+- `tigrbl.ddl` → `tigrbl_concrete.ddl`
+- `tigrbl.system` → `tigrbl_concrete.system`
+- `tigrbl.op` → `tigrbl_core.op`
+- `tigrbl.config` → `tigrbl_core.config`
+- `tigrbl.schema` → `tigrbl_core.schema`
+- `tigrbl.security` → `tigrbl_concrete.security`
+
+## 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.
@@ -223,7 +248,7 @@ Operation Handler
 v
 JSON-RPC Response
 
-````
+```
 
 ## Hooks 🪝
 
@@ -240,7 +265,7 @@ class Item(Base):
     async def validate(cls, ctx):
         if ctx["request"].payload.get("name") == "bad":
             raise ValueError("invalid name")
-````
+```
 
 The function runs during the `PRE_HANDLER` phase of `create`. The
 `ctx` mapping provides request and response objects, a database session,
@@ -457,7 +482,7 @@ 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")
 
@@ -606,7 +631,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 +654,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 +681,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 🥇
 
@@ -700,7 +725,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"))

{tigrbl-0.3.16.dev5 → tigrbl-0.3.17}/README.md

@@ -26,6 +26,23 @@ 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
 
+## Split Package Module Locations 🗂️
+
+These surfaces are now maintained in the split Tigrbl packages (with `tigrbl.*`
+kept as compatibility imports):
+
+- `tigrbl.ddl` → `tigrbl_concrete.ddl`
+- `tigrbl.system` → `tigrbl_concrete.system`
+- `tigrbl.op` → `tigrbl_core.op`
+- `tigrbl.config` → `tigrbl_core.config`
+- `tigrbl.schema` → `tigrbl_core.schema`
+- `tigrbl.security` → `tigrbl_concrete.security`
+
+## 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.
@@ -190,7 +207,7 @@ Operation Handler
 v
 JSON-RPC Response
 
-````
+```
 
 ## Hooks 🪝
 
@@ -207,7 +224,7 @@ class Item(Base):
     async def validate(cls, ctx):
         if ctx["request"].payload.get("name") == "bad":
             raise ValueError("invalid name")
-````
+```
 
 The function runs during the `PRE_HANDLER` phase of `create`. The
 `ctx` mapping provides request and response objects, a database session,
@@ -424,7 +441,7 @@ 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")
 
@@ -573,7 +590,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 +613,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 +640,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 🥇
 
@@ -667,7 +684,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"))

{tigrbl-0.3.16.dev5 → tigrbl-0.3.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl"
-version = "0.3.16.dev5"
+version = "0.3.17"
 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"
@@ -18,22 +18,24 @@ classifiers = [
 ]
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
 dependencies = [
+    "tigrbl-core",
+    "tigrbl-base",
+    "tigrbl-concrete",
+    "tigrbl-canon",
+    "tigrbl-orm",
+    "tigrbl-runtime",
+    "tigrbl-atoms",
+    "tigrbl-kernel",
+    "tigrbl-ops-oltp",
     "pydantic>=2.0.0",
     "sqlalchemy>=2.0",
     "aiosqlite>=0.19.0",
     "httpx>=0.27.0",
     "greenlet>=3.2.3",
-    "uvicorn", 
-]
-keywords = [
-    'tigrbl',
-    'sdk',
-    'standards',
-    'asgi',
-    'rest',
-    'rpc',
+    "uvicorn",
 ]
 
+
 [project.optional-dependencies]
 postgres = [
     "asyncpg>=0.30.0",
@@ -47,7 +49,18 @@ tests = [
 ]
 
 [tool.uv.sources]
+"tigrbl-core" = { workspace = true }
+"tigrbl-base" = { workspace = true }
+"tigrbl-concrete" = { workspace = true }
+"tigrbl-canon" = { workspace = true }
+"tigrbl-orm" = { workspace = true }
+"tigrbl-runtime" = { workspace = true }
+"tigrbl-atoms" = { workspace = true }
+"tigrbl-kernel" = { workspace = true }
+"tigrbl-ops-oltp" = { workspace = true }
 tigrbl-tests = { workspace = true }
+tigrbl_client = { workspace = true }
+
 
 [tool.pytest.ini_options]
 norecursedirs = ["combined", "scripts"]
@@ -81,6 +94,7 @@ packages = [
 
 [dependency-groups]
 dev = [
+    "tigrbl_client",
     "pytest>=8.0",
     "pytest-asyncio>=0.24.0",
     "pytest-xdist>=3.6.1",

{tigrbl-0.3.16.dev5 → tigrbl-0.3.17}/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` | — | — |
-| Router | `router_spec.py` | `_router.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.17/tigrbl/__init__.py

@@ -0,0 +1,332 @@
+"""Tigrbl public API facade over split core packages."""
+
+from __future__ import annotations
+
+from importlib import import_module
+from pkgutil import extend_path
+import sys
+
+__path__ = extend_path(__path__, __name__)
+
+
+# Compatibility aliases so legacy ``tigrbl.<segment>`` imports resolve to
+# the new split packages.
+_ALIAS_MODULES = {
+    "_spec": "tigrbl_core._spec",
+    "_base": "tigrbl_base._base",
+    "_concrete": "tigrbl_concrete._concrete",
+    "core": "tigrbl_ops_oltp",
+    "runtime": "tigrbl_runtime.runtime",
+    "executors": "tigrbl_runtime.executors",
+    "atoms": "tigrbl_atoms.atoms",
+}
+
+
+def _optional_import(path: str):
+    try:
+        return import_module(path)
+    except ImportError:
+        return None
+
+
+def _install_alias(alias: str, target: str) -> None:
+    module = _optional_import(target)
+    if module is None:
+        return
+
+    alias_name = f"{__name__}.{alias}"
+    sys.modules.setdefault(alias_name, module)
+
+    target_prefix = f"{target}."
+    alias_prefix = f"{alias_name}."
+    for name, loaded in tuple(sys.modules.items()):
+        if name.startswith(target_prefix):
+            suffix = name[len(target_prefix) :]
+            sys.modules.setdefault(f"{alias_prefix}{suffix}", loaded)
+
+    module_path = getattr(module, "__path__", None)
+    if not module_path:
+        return
+
+    from pkgutil import walk_packages
+
+    for info in walk_packages(module_path, target_prefix):
+        submodule = _optional_import(info.name)
+        if submodule is None:
+            continue
+        suffix = info.name[len(target_prefix) :]
+        sys.modules.setdefault(f"{alias_prefix}{suffix}", submodule)
+
+
+for alias, target in _ALIAS_MODULES.items():
+    _install_alias(alias, target)
+
+
+_spec = import_module("tigrbl_core._spec")
+_base = import_module("tigrbl_base._base")
+_concrete = import_module("tigrbl_concrete._concrete")
+canon = None
+orm = import_module("tigrbl_orm.orm")
+runtime = _optional_import("tigrbl_runtime.runtime")
+atoms = _optional_import("tigrbl_atoms.atoms")
+kernel = None
+core = _optional_import("tigrbl_ops_oltp")
+
+# Backward-compatible names requested for top-level facade access.
+specs = _spec
+base = _base
+concrete = _concrete
+
+from tigrbl_concrete._concrete import (  # noqa: E402
+    APIKey,
+    Alias,
+    App,
+    BackgroundTask,
+    Column,
+    FileResponse,
+    ForeignKey,
+    Hook,
+    HTMLResponse,
+    HTTPBearer,
+    JSONResponse,
+    MutualTLS,
+    OAuth2,
+    OpenIdConnect,
+    Op,
+    PlainTextResponse,
+    RedirectResponse,
+    Request,
+    Response,
+    Route,
+    Router,
+    Schema,
+    StorageTransform,
+    StreamingResponse,
+    Table,
+    TableRegistry,
+    TigrblApp,
+    TigrblRouter,
+)
+from tigrbl_concrete._concrete.dependencies import Depends  # noqa: E402
+from tigrbl_runtime.runtime.status.exceptions import HTTPException  # noqa: E402
+from tigrbl.engine import resolver  # noqa: E402
+from tigrbl.system import mount_diagnostics  # noqa: E402
+from tigrbl_core.config.constants import DEFAULT_HTTP_METHODS, HOOK_DECLS_ATTR  # noqa: E402
+from tigrbl.decorators import (  # noqa: E402
+    alias,
+    allow_anon,
+    alias_ctx,
+    engine_ctx,
+    hook_ctx,
+    middleware,
+    middlewares,
+    op_alias,
+    op_ctx,
+    response_ctx,
+    route_ctx,
+    schema_ctx,
+)
+from tigrbl.shortcuts.op import op  # noqa: E402
+from tigrbl.schema import _build_list_params, _build_schema, get_schema  # noqa: E402
+from tigrbl.ddl import bootstrap_dbschema, ensure_schemas, register_sqlite_attach  # noqa: E402
+
+from tigrbl_base._base import (  # noqa: E402
+    AppBase,
+    ForeignKeyBase,
+    HookBase,
+    RouterBase,
+    TableBase,
+    TableRegistryBase,
+)
+from tigrbl_core._spec import (  # noqa: E402
+    AppSpec,
+    Arity,
+    ColumnSpec,
+    EngineSpec,
+    FieldSpec,
+    ForeignKeySpec,
+    HookPhase,
+    IOSpec,
+    OpSpec,
+    PersistPolicy,
+    PHASE,
+    PHASES,
+    RequestSpec,
+    ResponseSpec,
+    RouterSpec,
+    SchemaArg,
+    SchemaRef,
+    SchemaSpec,
+    SessionSpec,
+    StorageSpec,
+    StorageTransformSpec,
+    TableRegistrySpec,
+    TableSpec,
+    TargetOp,
+    TemplateSpec,
+)
+from tigrbl_runtime.runtime.executor import _invoke  # noqa: E402
+
+
+def bind(*args, **kwargs):
+    return import_module("tigrbl_concrete._mapping.model").bind(*args, **kwargs)
+
+
+def rebind(*args, **kwargs):
+    return import_module("tigrbl_concrete._mapping.model").rebind(*args, **kwargs)
+
+
+def build_schemas(*args, **kwargs):
+    return import_module("tigrbl_concrete._mapping.model")._materialize_schemas(
+        *args, **kwargs
+    )
+
+
+def build_hooks(*args, **kwargs):
+    return import_module("tigrbl_concrete._mapping.model")._bind_model_hooks(
+        *args, **kwargs
+    )
+
+
+def build_handlers(*args, **kwargs):
+    mod = import_module("tigrbl_concrete._mapping.model")
+    specs = mod._materialize_handlers(*args, **kwargs)
+    model = args[0] if args else kwargs.get("model")
+    spec_arg = args[1] if len(args) > 1 else kwargs.get("specs", ())
+    spec_tuple = tuple(spec_arg or ())
+    if model is not None:
+        mod._bind_model_hooks(model, spec_tuple)
+    return specs
+
+
+def register_rpc(*args, **kwargs):
+    return import_module("tigrbl_base._base._rpc_map").register_and_attach(
+        *args, **kwargs
+    )
+
+
+def build_rest(*args, **kwargs):
+    if "router" not in kwargs:
+        kwargs["router"] = None
+    return import_module("tigrbl_concrete._mapping.model")._materialize_rest_router(
+        *args, **kwargs
+    )
+
+
+def include_tables(*args, **kwargs):
+    return import_module("tigrbl_concrete._mapping.router.include").include_tables(
+        *args, **kwargs
+    )
+
+
+async def rpc_call(*args, **kwargs):
+    return await import_module("tigrbl_concrete._mapping.router.rpc").rpc_call(
+        *args, **kwargs
+    )
+
+
+__all__ = [
+    "specs",
+    "base",
+    "concrete",
+    "canon",
+    "orm",
+    "runtime",
+    "atoms",
+    "kernel",
+    "core",
+    "TigrblApp",
+    "TigrblRouter",
+    "Router",
+    "Depends",
+    "HTTPException",
+    "TableBase",
+    "RouterBase",
+    "Op",
+    "op",
+    "HTTPBearer",
+    "APIKey",
+    "OAuth2",
+    "OpenIdConnect",
+    "MutualTLS",
+    "OpSpec",
+    "TargetOp",
+    "Arity",
+    "PersistPolicy",
+    "PHASE",
+    "PHASES",
+    "HookPhase",
+    "SchemaRef",
+    "SchemaArg",
+    "alias_ctx",
+    "op_ctx",
+    "route_ctx",
+    "hook_ctx",
+    "schema_ctx",
+    "response_ctx",
+    "alias",
+    "allow_anon",
+    "Alias",
+    "op_alias",
+    "engine_ctx",
+    "ResponseSpec",
+    "bind",
+    "rebind",
+    "build_schemas",
+    "build_hooks",
+    "build_handlers",
+    "register_rpc",
+    "build_rest",
+    "include_tables",
+    "rpc_call",
+    "_invoke",
+    "_build_schema",
+    "_build_list_params",
+    "get_schema",
+    "mount_diagnostics",
+    "ensure_schemas",
+    "register_sqlite_attach",
+    "bootstrap_dbschema",
+    "DEFAULT_HTTP_METHODS",
+    "Request",
+    "Response",
+    "JSONResponse",
+    "BackgroundTask",
+    "resolver",
+    "AppSpec",
+    "RouterSpec",
+    "TableSpec",
+    "TableRegistrySpec",
+    "ColumnSpec",
+    "FieldSpec",
+    "IOSpec",
+    "StorageSpec",
+    "StorageTransform",
+    "StorageTransformSpec",
+    "ForeignKeySpec",
+    "RequestSpec",
+    "SchemaSpec",
+    "SessionSpec",
+    "EngineSpec",
+    "TemplateSpec",
+    "ForeignKeyBase",
+    "HookBase",
+    "TableRegistryBase",
+    "AppBase",
+    "App",
+    "Table",
+    "Column",
+    "Route",
+    "Schema",
+    "Hook",
+    "ForeignKey",
+    "TableRegistry",
+    "HOOK_DECLS_ATTR",
+    "middleware",
+    "middlewares",
+    "FileResponse",
+    "HTMLResponse",
+    "PlainTextResponse",
+    "StreamingResponse",
+    "RedirectResponse",
+]

tigrbl-0.3.17/tigrbl/config/__init__.py

@@ -0,0 +1,3 @@
+"""Compatibility shim for relocated config module."""
+
+from tigrbl_core.config import *  # noqa: F403

tigrbl-0.3.17/tigrbl/config/constants.py

@@ -0,0 +1,3 @@
+"""Compatibility shim for constants moved to ``tigrbl_core``."""
+
+from tigrbl_core.config.constants import *  # noqa: F403

tigrbl-0.3.17/tigrbl/config/defaults.py

@@ -0,0 +1,3 @@
+"""Compatibility shim for relocated config defaults."""
+
+from tigrbl_core.config.defaults import *  # noqa: F403

tigrbl-0.3.17/tigrbl/ddl/__init__.py

@@ -0,0 +1,3 @@
+"""Compatibility shim for relocated DDL module."""
+
+from tigrbl_concrete.ddl import *  # noqa: F403

tigrbl-0.3.17/tigrbl/decorators/__init__.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/allow_anon.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.allow_anon import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/engine.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.engine import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/hook.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.hook import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/middlewares.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.middlewares import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/op.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.op import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/response.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.response import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/rest.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.rest import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/router.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.router import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/schema.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.schema import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/decorators/session.py

@@ -0,0 +1 @@
+from tigrbl_concrete._decorators.session import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/docs/session.md

@@ -0,0 +1,11 @@
+# Session Architecture
+
+Tigrbl session support is organized across core layers:
+
+- `_spec/session_spec.py`: `SessionSpec` policy model plus helpers (`session_spec`, `tx_*`, `readonly`, `wrap_sessionmaker`).
+- `_base/_session_abc.py`: `SessionABC` contract expected by runtime and adapters.
+- `_base/_session_base.py`: `TigrblSessionBase` guardrails and transaction behavior.
+- `_concrete/_session.py`: `DefaultSession` delegating wrapper for provider-native sessions.
+- `decorators/session.py`: `session_ctx` and `read_only_session` decorators for app/router/model/op policy scopes.
+
+This design is backend-agnostic and does not depend on specific database drivers.

tigrbl-0.3.17/tigrbl/engine/__init__.py

@@ -0,0 +1 @@
+from tigrbl_concrete.engine import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/engine/bind.py

@@ -0,0 +1 @@
+from tigrbl_concrete.engine.bind import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/engine/builders.py

@@ -0,0 +1 @@
+from tigrbl_concrete.engine.builders import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/engine/capabilities.py

@@ -0,0 +1 @@
+from tigrbl_concrete.engine.capabilities import *  # noqa: F401,F403

tigrbl-0.3.17/tigrbl/engine/collect.py

@@ -0,0 +1 @@
+from tigrbl_concrete.engine.collect import *  # noqa: F401,F403