tigrbl-concrete 0.4.5.dev4__tar.gz → 0.4.5.dev6__tar.gz

{tigrbl_concrete-0.4.5.dev4 → tigrbl_concrete-0.4.5.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-concrete
-Version: 0.4.5.dev4
+Version: 0.4.5.dev6
 Summary: Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
 License: Apache License
                                     Version 2.0, January 2004
@@ -235,14 +235,14 @@ Requires-Dist: tigrbl-ops-olap
 Requires-Dist: tigrbl-ops-oltp
 Requires-Dist: tigrbl-ops-realtime
 Requires-Dist: tigrbl-ops-webtransport
-Requires-Dist: tigrbl-runtime
+Requires-Dist: tigrbl-runtime (>=0.4.5.dev5)
 Requires-Dist: tigrbl-typing
 Requires-Dist: uvicorn
 Project-URL: Discord, https://discord.gg/K4YTAPapjR
 Project-URL: Homepage, https://github.com/tigrbl/tigrbl
 Project-URL: Issues, https://github.com/tigrbl/tigrbl/issues
 Project-URL: Organization, https://github.com/tigrbl
-Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete
+Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/70_concrete/tigrbl_concrete
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -252,7 +252,7 @@ Description-Content-Type: text/markdown
 <a href="https://pypi.org/project/tigrbl-concrete/"><img src="https://img.shields.io/pypi/v/tigrbl-concrete?label=PyPI" alt="PyPI version for tigrbl-concrete"/></a>
 <a href="https://pypi.org/project/tigrbl-concrete/"><img src="https://static.pepy.tech/badge/tigrbl-concrete" alt="Downloads for tigrbl-concrete"/></a>
 <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-concrete"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_concrete/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_concrete/README.md.svg?label=hits" alt="Repository hits for tigrbl-concrete README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/70_concrete/tigrbl_concrete/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/70_concrete/tigrbl_concrete/README.md.svg?label=hits" alt="Repository hits for tigrbl-concrete README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
 <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%2C%203.11%2C%203.12%2C%203.13%2C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-concrete"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-concrete"/></a>
@@ -276,7 +276,7 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-concrete fit?
 
-`tigrbl-concrete` lives at `pkgs/core/tigrbl_concrete` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-concrete` lives at `pkgs/70_concrete/tigrbl_concrete` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-concrete work?
 
@@ -298,7 +298,7 @@ pip install tigrbl-concrete
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) |
-| Repository path | [`pkgs/core/tigrbl_concrete`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete) |
+| Repository path | [`pkgs/70_concrete/tigrbl_concrete`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/70_concrete/tigrbl_concrete) |
 | Python import root | `tigrbl_concrete` |
 | Console scripts | none declared |
 | Entry points | `tigrbl.engine_plugins` |
@@ -482,7 +482,7 @@ Choose `tigrbl-concrete` when the quick-answer table matches your use case. Choo
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_concrete](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete).
+- Repository: [pkgs/70_concrete/tigrbl_concrete](https://github.com/tigrbl/tigrbl/tree/master/pkgs/70_concrete/tigrbl_concrete).
 
 ## Package-local Boundary
 
@@ -493,7 +493,7 @@ This file is a package-local distribution entry point. This README is the packag
 - Package status: governed package in the `tigrbl/tigrbl` workspace.
 - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
 - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
-- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Local certification guard: `pkgs/97_tests/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
 - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## License

{tigrbl_concrete-0.4.5.dev4 → tigrbl_concrete-0.4.5.dev6}/README.md

@@ -5,7 +5,7 @@
 <a href="https://pypi.org/project/tigrbl-concrete/"><img src="https://img.shields.io/pypi/v/tigrbl-concrete?label=PyPI" alt="PyPI version for tigrbl-concrete"/></a>
 <a href="https://pypi.org/project/tigrbl-concrete/"><img src="https://static.pepy.tech/badge/tigrbl-concrete" alt="Downloads for tigrbl-concrete"/></a>
 <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-concrete"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_concrete/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_concrete/README.md.svg?label=hits" alt="Repository hits for tigrbl-concrete README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/70_concrete/tigrbl_concrete/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/70_concrete/tigrbl_concrete/README.md.svg?label=hits" alt="Repository hits for tigrbl-concrete README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
 <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%2C%203.11%2C%203.12%2C%203.13%2C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-concrete"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-concrete"/></a>
@@ -29,7 +29,7 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-concrete fit?
 
-`tigrbl-concrete` lives at `pkgs/core/tigrbl_concrete` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-concrete` lives at `pkgs/70_concrete/tigrbl_concrete` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-concrete work?
 
@@ -51,7 +51,7 @@ pip install tigrbl-concrete
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) |
-| Repository path | [`pkgs/core/tigrbl_concrete`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete) |
+| Repository path | [`pkgs/70_concrete/tigrbl_concrete`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/70_concrete/tigrbl_concrete) |
 | Python import root | `tigrbl_concrete` |
 | Console scripts | none declared |
 | Entry points | `tigrbl.engine_plugins` |
@@ -235,7 +235,7 @@ Choose `tigrbl-concrete` when the quick-answer table matches your use case. Choo
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_concrete](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete).
+- Repository: [pkgs/70_concrete/tigrbl_concrete](https://github.com/tigrbl/tigrbl/tree/master/pkgs/70_concrete/tigrbl_concrete).
 
 ## Package-local Boundary
 
@@ -246,7 +246,7 @@ This file is a package-local distribution entry point. This README is the packag
 - Package status: governed package in the `tigrbl/tigrbl` workspace.
 - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
 - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
-- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Local certification guard: `pkgs/97_tests/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
 - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## License

{tigrbl_concrete-0.4.5.dev4 → tigrbl_concrete-0.4.5.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-concrete"
-version = "0.4.5.dev4"
+version = "0.4.5.dev6"
 description = "Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -51,7 +51,7 @@ dependencies = [
     "tigrbl-ops-oltp",
     "tigrbl-ops-realtime",
     "tigrbl-ops-webtransport",
-    "tigrbl-runtime",
+    "tigrbl-runtime>=0.4.5.dev5",
     "tigrbl-typing",
     "uvicorn",
 ]
@@ -61,7 +61,7 @@ dependencies = [
 Organization = "https://github.com/tigrbl"
 Discord = "https://discord.gg/K4YTAPapjR"
 Homepage = "https://github.com/tigrbl/tigrbl"
-Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete"
+Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/70_concrete/tigrbl_concrete"
 Issues = "https://github.com/tigrbl/tigrbl/issues"
 
 [tool.uv.sources]
@@ -88,6 +88,7 @@ packages = [
 [dependency-groups]
 dev = [
     "pytest>=8.0",
+    "pytest-asyncio>=0.24.0",
     "ruff>=0.9",
 ]
 

{tigrbl_concrete-0.4.5.dev4 → tigrbl_concrete-0.4.5.dev6}/tigrbl_concrete/__init__.py

@@ -14,16 +14,30 @@ _COMPAT_ALIASES = {
     'security': 'tigrbl.security',
 }
 
+_COLUMN_EXPORTS = {
+    'Column': 'tigrbl_concrete._concrete',
+    'acol': 'tigrbl_concrete.factories.column',
+    'makeColumn': 'tigrbl_concrete.factories.column',
+    'makeVirtualColumn': 'tigrbl_concrete.factories.column',
+    'vcol': 'tigrbl_concrete.factories.column',
+}
+
 __all__ = [
     'build_handlers',
     'build_hooks',
     'build_schemas',
     'build_rest_router',
+    *_COLUMN_EXPORTS,
     *_COMPAT_ALIASES,
 ]
 
 
 def __getattr__(name: str) -> Any:
+    if name in _COLUMN_EXPORTS:
+        module = import_module(_COLUMN_EXPORTS[name])
+        value = getattr(module, name)
+        globals()[name] = value
+        return value
     if name in _COMPAT_ALIASES:
         module = import_module(_COMPAT_ALIASES[name])
         globals()[name] = module

{tigrbl_concrete-0.4.5.dev4 → tigrbl_concrete-0.4.5.dev6}/tigrbl_concrete/_concrete/__init__.py

@@ -55,7 +55,8 @@ _EXPORTS = {
     "PlainTextResponse": "_plain_text_response",
     "StreamingResponse": "_streaming_response",
     "EventStreamResponse": "_event_stream_response",
-    "DefaultSession": "_session",
+    "EngineSession": "_engine_session",
+    "EngineSession": "_session",
     "FileResponse": "_file_response",
     "RedirectResponse": "_redirect_response",
     "Request": "_request",
@@ -73,7 +74,7 @@ _EXPORTS = {
     "TigrblApp": "tigrbl_app",
     "TigrblRouter": "tigrbl_router",
     "BackgroundTask": "_background",
-    "wrap_sessionmaker": "_session",
+    "wrap_sessionmaker": "_engine_session",
     "allow_anon": "_allow_anon",
     "Middleware": "_middleware",
     "CORSMiddleware": "_cors_middleware",

{tigrbl_concrete-0.4.5.dev4 → tigrbl_concrete-0.4.5.dev6}/tigrbl_concrete/_concrete/_app.py

@@ -1,17 +1,19 @@
 from __future__ import annotations
 
 from dataclasses import replace
-from typing import Any
+from pathlib import Path
+from typing import Any, Sequence
 
 from ._table_registry import TableRegistry
-from ._websocket import WebSocket
 from ._request import Request
 from tigrbl_base._base import AppBase
 from tigrbl_concrete.ddl import initialize as _ddl_initialize
 from ._engine import Engine
 from tigrbl_concrete._concrete import engine_resolver as _resolver
 from tigrbl_core._spec.app_spec import AppSpec
+from tigrbl_core._spec.binding_spec import Exchange, TransportBindingSpec
 from tigrbl_core._spec.engine_spec import EngineCfg
+from tigrbl_core._spec.op_spec import TxScope
 from ._route import (
     ROUTE_OPS_MODEL_NAME,
     add_route as _add_route_impl,
@@ -175,8 +177,67 @@ class App(AppBase):
             if callable(invalidate):
                 invalidate(self)
 
-    def add_route(self, path: str, endpoint: Any, *, methods: list[str] | tuple[str, ...], **kwargs: Any) -> None:
-        _add_route_impl(self, path, endpoint, methods=methods, **kwargs)
+    def add_route(
+        self,
+        path: str,
+        endpoint: Any,
+        *,
+        methods: Sequence[str],
+        name: str | None = None,
+        summary: str | None = None,
+        description: str | None = None,
+        tags: Sequence[str] | None = None,
+        deprecated: bool = False,
+        request_schema: dict[str, Any] | None = None,
+        response_schema: dict[str, Any] | None = None,
+        path_param_schemas: dict[str, dict[str, Any]] | None = None,
+        query_param_schemas: dict[str, dict[str, Any]] | None = None,
+        include_in_schema: bool = True,
+        operation_id: str | None = None,
+        response_model: Any | None = None,
+        request_model: Any | None = None,
+        responses: dict[int, dict[str, Any]] | None = None,
+        status_code: int | None = None,
+        dependencies: list[Any] | None = None,
+        security_dependencies: list[Any] | None = None,
+        inherit_owner_dependencies: bool = True,
+        tigrbl_model: Any | None = None,
+        tigrbl_alias: str | None = None,
+        tigrbl_binding: TransportBindingSpec | None = None,
+        tigrbl_exchange: Exchange | None = None,
+        tigrbl_tx_scope: TxScope | None = None,
+        tigrbl_default_root: bool = False,
+    ) -> None:
+        _add_route_impl(
+            self,
+            path,
+            endpoint,
+            methods=methods,
+            name=name,
+            summary=summary,
+            description=description,
+            tags=tags,
+            deprecated=deprecated,
+            request_schema=request_schema,
+            response_schema=response_schema,
+            path_param_schemas=path_param_schemas,
+            query_param_schemas=query_param_schemas,
+            include_in_schema=include_in_schema,
+            operation_id=operation_id,
+            response_model=response_model,
+            request_model=request_model,
+            responses=responses,
+            status_code=status_code,
+            dependencies=dependencies,
+            security_dependencies=security_dependencies,
+            inherit_owner_dependencies=inherit_owner_dependencies,
+            tigrbl_model=tigrbl_model,
+            tigrbl_alias=tigrbl_alias,
+            tigrbl_binding=tigrbl_binding,
+            tigrbl_exchange=tigrbl_exchange,
+            tigrbl_tx_scope=tigrbl_tx_scope,
+            tigrbl_default_root=tigrbl_default_root,
+        )
         self._bump_runtime_plan_revision()
 
     def route(self, path: str, *, methods: Any, **kwargs: Any):
@@ -197,28 +258,52 @@ class App(AppBase):
     def delete(self, path: str, **kwargs: Any):
         return self.route(path, methods=["DELETE"], **kwargs)
 
-    def mount_openapi(self, *, path: str = "/openapi.json", name: str = "__openapi__") -> Any:
-        from tigrbl_concrete.system.docs.openapi.mount import mount_openapi as _mount_openapi
+    def mount_openapi(
+        self, *, path: str = "/openapi.json", name: str = "__openapi__"
+    ) -> Any:
+        from tigrbl_concrete.system.docs.openapi.mount import (
+            mount_openapi as _mount_openapi,
+        )
+
         return _mount_openapi(self, path=path, name=name)
 
-    def mount_swagger(self, *, path: str = "/docs", openapi_url: str | None = None, title: str | None = None) -> Any:
+    def mount_swagger(
+        self,
+        *,
+        path: str = "/docs",
+        openapi_url: str | None = None,
+        title: str | None = None,
+    ) -> Any:
         from tigrbl_concrete.system.docs.swagger import mount_swagger as _mount_swagger
+
         return _mount_swagger(self, path=path, openapi_url=openapi_url, title=title)
 
-    def mount_openrpc(self, *, path: str = "/openrpc.json", name: str = "openrpc_json") -> Any:
+    def mount_openrpc(
+        self, *, path: str = "/openrpc.json", name: str = "openrpc_json"
+    ) -> Any:
         from tigrbl_concrete.system.docs.openrpc import mount_openrpc as _mount_openrpc
+
         return _mount_openrpc(self, path=path, name=name)
 
-    def mount_lens(self, *, path: str = "/lens", openrpc_url: str | None = None, title: str | None = None) -> Any:
+    def mount_lens(
+        self,
+        *,
+        path: str = "/lens",
+        openrpc_url: str | None = None,
+        title: str | None = None,
+    ) -> Any:
         from tigrbl_concrete.system.docs.lens import mount_lens as _mount_lens
+
         return _mount_lens(self, path=path, openrpc_url=openrpc_url, title=title)
 
     def mount_json_schema(self, *, path: str = "/schemas.json") -> Any:
         from tigrbl_concrete.system.docs.json_schema import _mount_json_schema
+
         return _mount_json_schema(self, path=path)
 
     def mount_static(self, *, directory: str | Path, path: str = "/static") -> Any:
         from tigrbl_concrete.system.static import _mount_static
+
         return _mount_static(self, directory=directory, path=path)
 
     def mount_app(self, *, app: Any, path: str) -> Any:
@@ -249,9 +334,7 @@ class App(AppBase):
                     handler=handler,
                     name=route_name,
                     protocol=str(kwargs.get("protocol", kwargs.get("proto", "ws"))),
-                    exchange=str(
-                        kwargs.get("exchange", "bidirectional_stream")
-                    ),
+                    exchange=str(kwargs.get("exchange", "bidirectional_stream")),
                     framing=str(framing),
                     summary=kwargs.get("summary"),
                     description=kwargs.get("description"),
@@ -272,6 +355,7 @@ class App(AppBase):
             if callable(bump):
                 bump()
             return handler
+
         return _decorator
 
     @property
@@ -279,6 +363,7 @@ class App(AppBase):
         runtime = getattr(self, "_runtime_instance", None)
         if runtime is None:
             from tigrbl_runtime.runtime import Runtime
+
             runtime = Runtime(default_executor=self._runtime_default_executor)
             self._runtime_instance = runtime
         return runtime
@@ -422,19 +507,42 @@ class App(AppBase):
             wt_state = {}
             scope_state["tigrbl_webtransport"] = wt_state
 
-        while wt_state.get("closed") is not True:
-            env = GwRawEnvelope(kind="asgi3", scope=scope, receive=receive, send=send)
-            await self.invoke(env)
-            trace = wt_state.get("trace")
-            if isinstance(trace, list):
-                self._webtransport_trace_latest = list(trace)
-                snapshots = getattr(self, "_webtransport_trace_snapshots", None)
-                if not isinstance(snapshots, list):
-                    snapshots = []
-                    self._webtransport_trace_snapshots = snapshots
-                snapshots.append(list(trace))
-            if wt_state.get("closed") is True or wt_state.get("disconnected") is True:
-                break
+        try:
+            while wt_state.get("closed") is not True:
+                env = GwRawEnvelope(kind="asgi3", scope=scope, receive=receive, send=send)
+                await self.invoke(env)
+                trace = wt_state.get("trace")
+                if isinstance(trace, list):
+                    self._webtransport_trace_latest = list(trace)
+                    snapshots = getattr(self, "_webtransport_trace_snapshots", None)
+                    if not isinstance(snapshots, list):
+                        snapshots = []
+                        self._webtransport_trace_snapshots = snapshots
+                    snapshots.append(list(trace))
+                if wt_state.get("closed") is True or wt_state.get("disconnected") is True:
+                    break
+        finally:
+            session_id = scope.get("session_id")
+            extensions = scope.get("extensions")
+            if session_id is None and isinstance(extensions, dict):
+                extension = extensions.get("webtransport")
+                if isinstance(extension, dict):
+                    session_id = extension.get("session_id")
+            callbacks = []
+            broker = getattr(self, "__realtime_broker__", None)
+            if session_id is not None and callable(
+                getattr(broker, "unsubscribe_session", None)
+            ):
+                callbacks.append(
+                    lambda: broker.unsubscribe_session(str(session_id))
+                )
+            hub = getattr(self, "__presentation_hub__", None)
+            if session_id is not None and callable(getattr(hub, "disconnect", None)):
+                callbacks.append(lambda: hub.disconnect(str(session_id)))
+            session_plan = wt_state.get("session_plan")
+            cleanup = getattr(session_plan, "cleanup", None)
+            if callable(cleanup):
+                await cleanup(*callbacks)
 
     async def _handle_lifespan(
         self, _scope: dict[str, Any], receive: Any, send: Any
@@ -516,7 +624,9 @@ class App(AppBase):
             _prefix_model_bindings(model, normalized_prefix)
             if name == ROUTE_OPS_MODEL_NAME and name in self.tables:
                 hooks = getattr(model, "hooks", None)
-                for spec in tuple(getattr(getattr(model, "ops", None), "all", ()) or ()):
+                for spec in tuple(
+                    getattr(getattr(model, "ops", None), "all", ()) or ()
+                ):
                     handler_step = None
                     alias_hooks = getattr(hooks, str(getattr(spec, "alias", "")), None)
                     if alias_hooks is not None:
@@ -529,16 +639,31 @@ class App(AppBase):
         for ws_route in list(getattr(routed, "websocket_routes", ()) or []):
             path_template = ws_route.path_template
             if normalized_prefix:
-                path_template = f"{normalized_prefix}{path_template}" if path_template != "/" else normalized_prefix
+                path_template = (
+                    f"{normalized_prefix}{path_template}"
+                    if path_template != "/"
+                    else normalized_prefix
+                )
             pattern, param_names = compile_path(path_template)
             self.websocket_routes.append(
-                replace(ws_route, path_template=path_template, pattern=pattern, param_names=param_names)
+                replace(
+                    ws_route,
+                    path_template=path_template,
+                    pattern=pattern,
+                    param_names=param_names,
+                )
             )
         for mount in list(getattr(routed, "_static_mounts", ()) or []):
             static_path = mount.get("path", "/static")
             if normalized_prefix:
-                static_path = f"{normalized_prefix}{static_path}" if static_path != "/" else normalized_prefix
-            self._static_mounts.append({"path": static_path, "directory": mount["directory"]})
+                static_path = (
+                    f"{normalized_prefix}{static_path}"
+                    if static_path != "/"
+                    else normalized_prefix
+                )
+            self._static_mounts.append(
+                {"path": static_path, "directory": mount["directory"]}
+            )
         routed_mounted_apps = list(getattr(routed, "_mounted_apps", ()) or ())
         if routed_mounted_apps:
             owner_mounted_apps = list(getattr(self, "_mounted_apps", []) or [])
@@ -550,9 +675,7 @@ class App(AppBase):
                         if mount_path != "/"
                         else normalized_prefix
                     )
-                owner_mounted_apps.append(
-                    {"path": mount_path, "app": mount.get("app")}
-                )
+                owner_mounted_apps.append({"path": mount_path, "app": mount.get("app")})
             self._mounted_apps = owner_mounted_apps
         routed_jsonrpc_mounts = getattr(routed, "_jsonrpc_endpoint_mounts", None)
         if isinstance(routed_jsonrpc_mounts, dict):
@@ -563,8 +686,14 @@ class App(AppBase):
             for mount_path, endpoint in routed_jsonrpc_mounts.items():
                 path = mount_path
                 if normalized_prefix:
-                    path = f"{normalized_prefix}{path}" if path != "/" else normalized_prefix
-                normalized_path = (path if path.startswith("/") else f"/{path}").rstrip("/") or "/"
+                    path = (
+                        f"{normalized_prefix}{path}"
+                        if path != "/"
+                        else normalized_prefix
+                    )
+                normalized_path = (path if path.startswith("/") else f"/{path}").rstrip(
+                    "/"
+                ) or "/"
                 owner_mounts[normalized_path] = endpoint
                 if normalized_path != "/":
                     owner_mounts[f"{normalized_path}/"] = endpoint
@@ -585,13 +714,17 @@ def _serve_mounted_app(host: Any, scope: dict[str, Any], receive: Any, send: Any
         mounted_app = mount.get("app")
         if mounted_app is None:
             continue
-        remainder = request_path[len(mount_path) :] if mount_path != "/" else request_path
-        nested_path = (remainder or "/")
+        remainder = (
+            request_path[len(mount_path) :] if mount_path != "/" else request_path
+        )
+        nested_path = remainder or "/"
         if not str(nested_path).startswith("/"):
             nested_path = f"/{nested_path}"
         nested_scope = dict(scope)
         nested_scope["path"] = nested_path
-        nested_scope["root_path"] = f"{str(scope.get('root_path', '') or '').rstrip('/')}{mount_path}"
+        nested_scope["root_path"] = (
+            f"{str(scope.get('root_path', '') or '').rstrip('/')}{mount_path}"
+        )
         raw_path = scope.get("raw_path")
         if isinstance(raw_path, (bytes, bytearray)):
             nested_scope["raw_path"] = nested_path.encode("utf-8")

tigrbl_concrete-0.4.5.dev6/tigrbl_concrete/_concrete/_column.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from tigrbl_base._base import ColumnBase
+from tigrbl_core._spec.field_spec import FieldSpec
+from tigrbl_core._spec.io_spec import IOSpec
+from tigrbl_core._spec.storage_spec import StorageSpec
+
+
+class Column(ColumnBase):
+    """Concrete SQLAlchemy column implementing a :class:`ColumnSpec`."""
+
+    S = StorageSpec
+    F = FieldSpec
+    IO = IOSpec
+
+    @classmethod
+    def make(cls, **kwargs):
+        """Construct a concrete column through the canonical factory."""
+        from tigrbl_concrete.factories.column import makeColumn
+
+        return makeColumn(**kwargs)
+
+    @classmethod
+    def make_virtual(cls, **kwargs):
+        """Construct a virtual column through the canonical factory."""
+        from tigrbl_concrete.factories.column import makeVirtualColumn
+
+        return makeVirtualColumn(**kwargs)
+
+
+__all__ = ["Column"]