tigrbl-concrete 0.4.1.dev6__tar.gz → 0.4.2.dev3__tar.gz

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-concrete
-Version: 0.4.1.dev6
+Version: 0.4.2.dev3
 Summary: Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
 License: Apache License
                                     Version 2.0, January 2004
@@ -243,113 +243,66 @@ Project-URL: Organization, https://github.com/tigrbl
 Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete
 Description-Content-Type: text/markdown
 
-![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
+<div align="center">
+<h1>tigrbl-concrete</h1>
+<img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
+<p><strong>Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.</strong></p>
+<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://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="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%20to%203.15-3776ab" alt="Python requirement 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>
+</div>
 
-<p align="center">
-    <a href="https://pepy.tech/project/tigrbl-concrete">
-        <img src="https://static.pepy.tech/badge/tigrbl-concrete" alt="Pepy downloads for tigrbl-concrete"/></a>
-    <a href="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete/">
-        <img src="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete.svg" alt="Repository views for tigrbl-concrete"/></a>
-    <a href="https://pypi.org/project/tigrbl-concrete/">
-        <img src="https://img.shields.io/badge/python-3.10--3.14-blue" alt="Python 3.10 through 3.14"/></a>
-    <a href="https://pypi.org/project/tigrbl-concrete/">
-        <img src="https://img.shields.io/pypi/l/tigrbl-concrete" alt="PyPI license metadata for tigrbl-concrete"/></a>
-    <a href="https://pypi.org/project/tigrbl-concrete/">
-        <img src="https://img.shields.io/pypi/v/tigrbl-concrete?label=tigrbl-concrete&color=green" alt="PyPI version for tigrbl-concrete"/></a>
-</p>
-
----
-
-<h1 align="center">Tigrbl concrete</h1>
-
-**Build concrete ASGI objects: [inspect `TigrblApp`, routers, transports, docs, and security objects](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete/tigrbl_concrete).**
-
-tigrbl-concrete is a concrete implementation package for concrete implementations of Tigrbl base abstractions for reusable framework behavior.
-
-`tigrbl-concrete` is part of the Tigrbl package graph. It documents package-resident classes, concepts, extension points, and execution responsibilities while cross-linking to the facade, core specs, canonical mapping, runtime phases, concrete objects, operation packages, engine plugins, OpenAPI/OpenRPC documentation surfaces, and PyPI distributions that complete the system.
-
-## Resident concepts
-
-- `tigrbl_concrete` owns first-class native objects: concrete apps, routers, routes, tables, columns, requests, responses, middleware, security schemes, dependency wrappers, engine providers, REST transport aggregation, JSON-RPC helpers, docs builders, diagnostics, and shortcut factories.
-- Hooks, deps, and secdeps are documented here when they cross into concrete routing: model/router hook binding, REST dependencies, operation-level security requirements, allow-anonymous operation exceptions, authorization dependency injection, and docs metadata emission.
-- Use this package when you need the concrete objects that turn specs and canonical maps into ASGI routes, JSON-RPC methods, docs endpoints, security schemes, and execution-ready router state.
+## Install
 
-## Package ecosystem cross-links
+```bash
+uv add tigrbl-concrete
+```
 
-Every Tigrbl Python package links to its sibling distributions on PyPI so package indexes, search engines, answer engines, dependency scanners, and human readers can move through the installable package graph without falling back to source-tree paths.
+```bash
+pip install tigrbl-concrete
+```
 
-Core packages:
-- [`tigrbl`](https://pypi.org/project/tigrbl/) - Schema-first ASGI API framework for REST, JSON-RPC, OpenAPI, OpenRPC, SQLAlchemy models, typed validation, lifecycle hooks, and engine plugins.
-- [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) - Runtime atom utilities for Tigrbl planning, dispatch, transport ingress, egress, and high-throughput ASGI execution pipelines.
-- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/) - Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
-- [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) - Canonical mapping, routing, symbol resolution, and naming utilities for Tigrbl framework packages and generated API surfaces.
-- [`tigrbl_client`](https://pypi.org/project/tigrbl_client/) - Typed Python client helpers for calling Tigrbl REST, JSON-RPC, OpenAPI, and generated schema-first API surfaces.
-- [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) (this package) - Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
-- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) - Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
-- [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) - Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
-- [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/) - Analytical OLAP operation boundaries for Tigrbl workloads, query-oriented APIs, and engine integrations.
-- [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/) - Transactional OLTP operation handlers for Tigrbl CRUD, bulk, REST, JSON-RPC, and database-backed workloads.
-- [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/) - Realtime, streaming, datagram, websocket, and event operation handlers for Tigrbl ASGI runtimes.
-- [`tigrbl-orm`](https://pypi.org/project/tigrbl-orm/) - SQLAlchemy ORM tables, mixins, columns, model helpers, and persistence primitives for Tigrbl applications.
-- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) - Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
-- [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) - Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
-- [`tigrbl_tests`](https://pypi.org/project/tigrbl_tests/) - Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
-- [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) - Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions.
+## What It Owns
 
-Engine packages:
-- [`tigrbl_engine_bigquery`](https://pypi.org/project/tigrbl_engine_bigquery/) - BigQuery engine plugin for Google BigQuery warehouse sessions, analytics workloads, and Tigrbl engine registration.
-- [`tigrbl_engine_clickhouse`](https://pypi.org/project/tigrbl_engine_clickhouse/) - ClickHouse engine plugin for analytical database sessions, warehouse workloads, and Tigrbl engine registration.
-- [`tigrbl_engine_csv`](https://pypi.org/project/tigrbl_engine_csv/) - CSV engine plugin for file-backed tables, pandas DataFrames, and lightweight Tigrbl data workflows.
-- [`tigrbl_engine_dataframe`](https://pypi.org/project/tigrbl_engine_dataframe/) - DataFrame engine plugin for transactional pandas sessions and in-process Tigrbl analytics workloads.
-- [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/) - DuckDB engine plugin for embedded analytical database sessions, OLAP workloads, and Tigrbl engine registration.
-- [`tigrbl_engine_inmemcache`](https://pypi.org/project/tigrbl_engine_inmemcache/) - In-memory cache engine plugin for process-local TTL, LRU, and fast Tigrbl cache workflows.
-- [`tigrbl_engine_inmemory`](https://pypi.org/project/tigrbl_engine_inmemory/) - In-memory database engine plugin for process-local transactional storage, copy-on-write snapshots, and Tigrbl testing.
-- [`tigrbl_engine_membloom`](https://pypi.org/project/tigrbl_engine_membloom/) - In-memory Bloom filter engine plugin for membership checks, rotating TTL windows, and Tigrbl API workflows.
-- [`tigrbl_engine_memdedupe`](https://pypi.org/project/tigrbl_engine_memdedupe/) - In-memory dedupe engine plugin for idempotency tracking, duplicate suppression, and Tigrbl workflow coordination.
-- [`tigrbl_engine_memkv`](https://pypi.org/project/tigrbl_engine_memkv/) - In-memory key-value engine plugin for process-local KV storage, cache workflows, and lightweight Tigrbl services.
-- [`tigrbl_engine_memlru`](https://pypi.org/project/tigrbl_engine_memlru/) - In-memory LRU engine plugin for least-recently-used cache behavior and process-local Tigrbl data workflows.
-- [`tigrbl_engine_mempubsub`](https://pypi.org/project/tigrbl_engine_mempubsub/) - In-memory pub/sub engine plugin for process-local publish-subscribe channels, events, and Tigrbl realtime workflows.
-- [`tigrbl_engine_memqueue`](https://pypi.org/project/tigrbl_engine_memqueue/) - In-memory queue engine plugin for process-local tasks, message workflows, and Tigrbl runtime coordination.
-- [`tigrbl_engine_memrate`](https://pypi.org/project/tigrbl_engine_memrate/) - In-memory rate-limit engine plugin for API quotas, counters, windows, and Tigrbl governance workflows.
-- [`tigrbl_engine_numpy`](https://pypi.org/project/tigrbl_engine_numpy/) - NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
-- [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/) - Pandas engine plugin for transactional DataFrame sessions, tabular workflows, and Tigrbl data integration.
-- [`tigrbl_engine_pgsqli_wal`](https://pypi.org/project/tigrbl_engine_pgsqli_wal/) - PostgreSQL and SQLite WAL engine plugin for transactional Tigrbl workflows and database-backed engine registration.
-- [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) - PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
-- [`tigrbl_engine_pyspark`](https://pypi.org/project/tigrbl_engine_pyspark/) - PySpark engine plugin for distributed DataFrame integration, analytics workloads, and Tigrbl data workflows.
-- [`tigrbl_engine_redis`](https://pypi.org/project/tigrbl_engine_redis/) - Redis engine plugin for cache, data structures, and Tigrbl engine workflows backed by Redis.
-- [`tigrbl_engine_rediscachethrough`](https://pypi.org/project/tigrbl_engine_rediscachethrough/) - Redis cache-through engine plugin for Redis, PostgreSQL, and Tigrbl data-access acceleration workflows.
-- [`tigrbl_engine_snowflake`](https://pypi.org/project/tigrbl_engine_snowflake/) - Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
-- [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/) - SQLite engine plugin for SQLAlchemy sessions, local transactional storage, and Tigrbl application persistence.
-- [`tigrbl_engine_xlsx`](https://pypi.org/project/tigrbl_engine_xlsx/) - XLSX engine plugin for Excel workbook-backed tables, worksheet data access, and Tigrbl tabular workflows.
+`tigrbl-concrete` owns the concrete boundary inside the split Python workspace. Key implementation roots include `tigrbl_concrete` with `_concrete/, _decorators/, _mapping/, ddl/, decorators, engine/`.
 
-Application packages:
-- [`tigrbl_acme_ca`](https://pypi.org/project/tigrbl_acme_ca/) - ACME v2 certificate authority app for Tigrbl tables, certificate automation, TLS workflows, and API surfaces.
-- [`tigrbl_spiffe`](https://pypi.org/project/tigrbl_spiffe/) - SPIFFE and SPIRE identity app for Tigrbl with workload identity tables, UDS transport, and HTTP API surfaces.
+## Use It When
 
-Source-tree links remain available from each package identity section; this ecosystem section is intentionally PyPI-first for package discovery and installation routing.
+Use `tigrbl-concrete` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
 
-## Install
+## Public Surface
 
-```bash
-pip install tigrbl-concrete
-```
+- `tigrbl_concrete` exposes `import_module, Any, build_handlers, build_hooks, build_schemas, build_rest_router`.
 
-## Package discovery
+## Internal Layout
 
-`tigrbl-concrete` is described for package indexes, search engines, answer engines, and AI coding tools as: Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
+- Workspace path: `pkgs/core/tigrbl_concrete`.
+- Package class: `core framework package`.
+- Python requirement: `>=3.10,<3.15`.
+- `tigrbl_concrete` modules: `_concrete/, _decorators/, _mapping/, ddl/, decorators, engine/, factories/, resolve/, security/, shortcuts/`.
 
-Use `tigrbl-concrete` when you need Tigrbl's schema-first ASGI package graph for REST APIs, JSON-RPC APIs, OpenAPI documentation, OpenRPC documentation, SQLAlchemy-backed models, Pydantic validation, typed operation specs, runtime dispatch, and installable engine or application extensions.
+## Dependency Surface
 
-Discovery terms: tigrbl, ASGI, schema-first API framework, REST API, JSON-RPC API, OpenAPI documentation, OpenRPC documentation, SQLAlchemy models, Pydantic validation, typed validation, operation dispatch, engine plugins, api, json-rpc, rest, sqlalchemy, pydantic, concrete, implementation, framework, openapi, openrpc, schema-first.
+- Workspace package dependencies: [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/), [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/), [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/), [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/), [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/).
+- External runtime dependencies: `orjson`, `pydantic>=2.0`, `sqlalchemy`, `uvicorn`.
+- Optional extras: none declared.
 
-## Package-local entry point
+## Related Packages
 
-This file is a package-local distribution entry point.
-It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
+- [`tigrbl`](https://pypi.org/project/tigrbl/)
+- [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
+- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
+- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
+- [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/)
+- [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/)
+- [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/)
+- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
 
-## Canonical repository docs
+## Canonical Repository Docs
 
-- `README.md`
 - `docs/README.md`
 - `docs/conformance/CURRENT_TARGET.md`
 - `docs/conformance/CURRENT_STATE.md`
@@ -358,15 +311,12 @@ It is not the authoritative location for repository governance, current target s
 - `docs/developer/PACKAGE_CATALOG.md`
 - `docs/developer/PACKAGE_LAYOUT.md`
 
-## Package identity
+## Package-local Boundary
+
+This file is a package-local distribution entry point.
+Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
 
-- canonical repository: `https://github.com/tigrbl/tigrbl`
-- organization: `https://github.com/tigrbl`
-- social: `https://discord.gg/K4YTAPapjR`
-- package path: `https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_concrete`
-- workspace path: `pkgs/core/tigrbl_concrete`
-- workspace class: core Python package
-- implementation layout: `tigrbl_concrete/`
+## License
 
-Long-form repository documentation is governed from `docs/`.
+Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
 

tigrbl_concrete-0.4.2.dev3/README.md

@@ -0,0 +1,76 @@
+<div align="center">
+<h1>tigrbl-concrete</h1>
+<img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
+<p><strong>Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.</strong></p>
+<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://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="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%20to%203.15-3776ab" alt="Python requirement 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>
+</div>
+
+## Install
+
+```bash
+uv add tigrbl-concrete
+```
+
+```bash
+pip install tigrbl-concrete
+```
+
+## What It Owns
+
+`tigrbl-concrete` owns the concrete boundary inside the split Python workspace. Key implementation roots include `tigrbl_concrete` with `_concrete/, _decorators/, _mapping/, ddl/, decorators, engine/`.
+
+## Use It When
+
+Use `tigrbl-concrete` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
+
+## Public Surface
+
+- `tigrbl_concrete` exposes `import_module, Any, build_handlers, build_hooks, build_schemas, build_rest_router`.
+
+## Internal Layout
+
+- Workspace path: `pkgs/core/tigrbl_concrete`.
+- Package class: `core framework package`.
+- Python requirement: `>=3.10,<3.15`.
+- `tigrbl_concrete` modules: `_concrete/, _decorators/, _mapping/, ddl/, decorators, engine/, factories/, resolve/, security/, shortcuts/`.
+
+## Dependency Surface
+
+- Workspace package dependencies: [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/), [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/), [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/), [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/), [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/).
+- External runtime dependencies: `orjson`, `pydantic>=2.0`, `sqlalchemy`, `uvicorn`.
+- Optional extras: none declared.
+
+## Related Packages
+
+- [`tigrbl`](https://pypi.org/project/tigrbl/)
+- [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
+- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
+- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
+- [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/)
+- [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/)
+- [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/)
+- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
+
+## Canonical Repository Docs
+
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+
+## Package-local Boundary
+
+This file is a package-local distribution entry point.
+Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
+
+## License
+
+Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-concrete"
-version = "0.4.1.dev6"
+version = "0.4.2.dev3"
 description = "Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters."
 readme = "README.md"
 license = { file = "LICENSE" }

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/tigrbl_concrete/_concrete/_app.py

@@ -164,6 +164,7 @@ class App(AppBase):
             self._runtime_plan_revision = int(current) + 1
         except Exception:
             self._runtime_plan_revision = 1
+        self.openapi_schema = None
         kernels = []
         runtime = getattr(self, "_runtime_instance", None)
         kernel = getattr(runtime, "kernel", None)
@@ -216,10 +217,6 @@ class App(AppBase):
         from tigrbl_concrete.system.docs.json_schema import _mount_json_schema
         return _mount_json_schema(self, path=path)
 
-    def mount_asyncapi(self, *, path: str = "/asyncapi.json") -> Any:
-        from tigrbl_concrete.system.docs.asyncapi import _mount_asyncapi
-        return _mount_asyncapi(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)
@@ -336,6 +333,9 @@ class App(AppBase):
         if scope_type == "lifespan":
             await self._handle_lifespan(scope, receive, send)
             return
+        if scope_type == "webtransport":
+            await self._handle_webtransport(scope, receive, send)
+            return
         if scope_type == "websocket":
             if not scope.get("scheme"):
                 scope = dict(scope)
@@ -406,6 +406,35 @@ class App(AppBase):
         env = GwRawEnvelope(kind="asgi3", scope=scope, receive=receive, send=send)
         await self.invoke(env)
 
+    async def _handle_webtransport(
+        self, scope: dict[str, Any], receive: Any, send: Any
+    ) -> None:
+        if not scope.get("scheme"):
+            scope = dict(scope)
+            scope["scheme"] = "webtransport"
+        scope_state = scope.setdefault("state", {})
+        if not isinstance(scope_state, dict):
+            scope_state = {}
+            scope["state"] = scope_state
+        wt_state = scope_state.setdefault("tigrbl_webtransport", {})
+        if not isinstance(wt_state, dict):
+            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
+
     async def _handle_lifespan(
         self, _scope: dict[str, Any], receive: Any, send: Any
     ) -> None:

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/tigrbl_concrete/_concrete/_router.py

@@ -98,6 +98,7 @@ class Router(RouterBase):
         self.docs_url = docs_url
         self.debug = debug
         self.swagger_ui_version = swagger_ui_version
+        self.openapi_schema = None
         class_prefix = getattr(self, "PREFIX", "")
         self.prefix = normalize_prefix(prefix or class_prefix)
         self.tags = list(_seqify(tags))
@@ -201,6 +202,7 @@ class Router(RouterBase):
             self._runtime_plan_revision = int(current) + 1
         except Exception:
             self._runtime_plan_revision = 1
+        self.openapi_schema = None
         kernels = []
         runtime = getattr(self, "_runtime_instance", None)
         kernel = getattr(runtime, "kernel", None)
@@ -255,10 +257,6 @@ class Router(RouterBase):
         from tigrbl_concrete.system.docs.json_schema import _mount_json_schema
         return _mount_json_schema(self, path=path)
 
-    def mount_asyncapi(self, *, path: str = "/asyncapi.json") -> Any:
-        from tigrbl_concrete.system.docs.asyncapi import _mount_asyncapi
-        return _mount_asyncapi(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)
@@ -275,10 +273,6 @@ class Router(RouterBase):
         from tigrbl_concrete.system.docs.json_schema import _build_json_schema_bundle
         return _build_json_schema_bundle(self)
 
-    def build_asyncapi_spec(self) -> dict[str, Any]:
-        from tigrbl_concrete.system.docs.asyncapi import _build_asyncapi_spec
-        return _build_asyncapi_spec(self)
-
     def websocket(self, path: str, **kwargs: Any) -> Callable[[Any], Any]:
         def _decorator(handler: Any) -> Any:
             from tigrbl_concrete.system.docs.runtime_ops import (

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/tigrbl_concrete/_concrete/tigrbl_app.py

@@ -36,10 +36,8 @@ from tigrbl_concrete.system import mount_lens as _mount_lens
 from tigrbl_concrete.system import mount_openapi as _mount_openapi
 from tigrbl_concrete.system import mount_openrpc as _mount_openrpc
 from tigrbl_concrete.system import mount_swagger as _mount_swagger
-from tigrbl_concrete.system import mount_asyncapi as _mount_asyncapi
 from tigrbl_concrete.system import mount_json_schema as _mount_json_schema
 from tigrbl_concrete.system import mount_static as _mount_static
-from tigrbl_concrete.system import build_asyncapi_spec as _build_asyncapi_spec
 from tigrbl_concrete.system import build_json_schema_bundle as _build_json_schema_bundle
 from tigrbl_concrete.system import build_openrpc_spec as _build_openrpc_spec
 from tigrbl_concrete.system.docs import build_openapi as _build_openapi
@@ -278,7 +276,6 @@ class TigrblApp(_App):
             self.mount_openrpc(path="/openrpc.json")
             self.mount_lens(path="/lens", spec_path="/openrpc.json")
             self.mount_json_schema(path="/schemas.json")
-            self.mount_asyncapi(path="/asyncapi.json")
         if routers:
             initial_routers.extend(list(routers))
         if initial_routers:
@@ -812,18 +809,12 @@ class TigrblApp(_App):
     def mount_json_schema(self, *, path: str = "/schemas.json") -> Any:
         return _mount_json_schema(self, path=path)
 
-    def mount_asyncapi(self, *, path: str = "/asyncapi.json") -> Any:
-        return _mount_asyncapi(self, path=path)
-
     def mount_static(self, *, directory: str | Path, path: str = "/static") -> Any:
         return _mount_static(self, directory=directory, path=path)
 
     def build_json_schema_bundle(self) -> Dict[str, Any]:
         return _build_json_schema_bundle(self)
 
-    def build_asyncapi_spec(self) -> Dict[str, Any]:
-        return _build_asyncapi_spec(self)
-
     def websocket(self, path: str, **kwargs: Any) -> Callable[[Any], Any]:
         def _decorator(handler: Any) -> Any:
             from tigrbl_concrete.system.docs.runtime_ops import (
@@ -893,7 +884,12 @@ class TigrblApp(_App):
 
     def openapi(self) -> Dict[str, Any]:
         """Build and return the OpenAPI document for this app."""
-        return _build_openapi(self)
+        cached = getattr(self, "openapi_schema", None)
+        if isinstance(cached, dict):
+            return cached
+        document = _build_openapi(self)
+        self.openapi_schema = document
+        return document
 
     def mount_lens(
         self,

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/tigrbl_concrete/_concrete/tigrbl_router.py

@@ -359,11 +359,6 @@ class TigrblRouter(_Router):
 
         return _mount_json_schema(self, path=path)
 
-    def mount_asyncapi(self, *, path: str = "/asyncapi.json") -> Any:
-        from tigrbl_concrete.system import mount_asyncapi as _mount_asyncapi
-
-        return _mount_asyncapi(self, path=path)
-
     def mount_static(self, *, directory: str, path: str = "/static") -> Any:
         from tigrbl_concrete.system import mount_static as _mount_static
 
@@ -374,11 +369,6 @@ class TigrblRouter(_Router):
 
         return _build_json_schema_bundle(self)
 
-    def build_asyncapi_spec(self) -> Dict[str, Any]:
-        from tigrbl_concrete.system import build_asyncapi_spec as _build_asyncapi_spec
-
-        return _build_asyncapi_spec(self)
-
     def websocket(self, path: str, **kwargs: Any) -> Callable[[Any], Any]:
         def _decorator(handler: Any) -> Any:
             from tigrbl_concrete.system.docs.runtime_ops import (
@@ -447,7 +437,12 @@ class TigrblRouter(_Router):
 
     def openapi(self) -> Dict[str, Any]:
         """Build and return the OpenAPI document for this router."""
-        return _build_openapi(self)
+        cached = getattr(self, "openapi_schema", None)
+        if isinstance(cached, dict):
+            return cached
+        document = _build_openapi(self)
+        self.openapi_schema = document
+        return document
 
     # ------------------------- registry passthroughs -------------------------
 

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/tigrbl_concrete/_mapping/appspec/path_lowering.py

@@ -124,8 +124,8 @@ def _mount_docs_payload(router: Any, path_spec: PathSpec) -> None:
         router.mount_openrpc(path=path_spec.path)
     elif payload.kind == "jsonschema":
         router.mount_json_schema(path=path_spec.path)
-    elif payload.kind == "asyncapi":
-        router.mount_asyncapi(path=path_spec.path)
+    elif str(payload.kind) == "asyncapi":
+        raise NotImplementedError("AsyncAPI docs payloads are not supported.")
 
 
 def _mount_docs_uix(router: Any, path_spec: PathSpec) -> None:

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/tigrbl_concrete/system/__init__.py

@@ -63,12 +63,6 @@ def mount_json_schema(*args: Any, **kwargs: Any) -> Any:
     return _mount_json_schema(*args, **kwargs)
 
 
-def mount_asyncapi(*args: Any, **kwargs: Any) -> Any:
-    from .docs import mount_asyncapi as _mount_asyncapi
-
-    return _mount_asyncapi(*args, **kwargs)
-
-
 def mount_static(*args: Any, **kwargs: Any) -> Any:
     from .static import _mount_static as _mount_static
 
@@ -111,12 +105,6 @@ def build_json_schema_bundle(*args: Any, **kwargs: Any) -> Any:
     return _build_json_schema_bundle(*args, **kwargs)
 
 
-def build_asyncapi_spec(*args: Any, **kwargs: Any) -> Any:
-    from .docs import build_asyncapi_spec as _build_asyncapi_spec
-
-    return _build_asyncapi_spec(*args, **kwargs)
-
-
 def stop_uvicorn_server(*args: Any, **kwargs: Any) -> Any:
     from .uvicorn import stop_uvicorn_server as _stop_uvicorn_server
 
@@ -133,7 +121,6 @@ __all__ = [
     'mount_openrpc',
     'mount_swagger',
     'mount_json_schema',
-    'mount_asyncapi',
     'mount_static',
     'build_favicon',
     'build_healthz_uix',
@@ -142,6 +129,5 @@ __all__ = [
     'build_openrpc_spec',
     'build_swagger',
     'build_json_schema_bundle',
-    'build_asyncapi_spec',
     'stop_uvicorn_server',
 ]

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/tigrbl_concrete/system/docs/__init__.py

@@ -63,29 +63,15 @@ def mount_json_schema(*args: Any, **kwargs: Any) -> Any:
     return _mount_json_schema(*args, **kwargs)
 
 
-def build_asyncapi_spec(*args: Any, **kwargs: Any) -> Any:
-    from .asyncapi import _build_asyncapi_spec as _build_asyncapi_spec
-
-    return _build_asyncapi_spec(*args, **kwargs)
-
-
-def mount_asyncapi(*args: Any, **kwargs: Any) -> Any:
-    from .asyncapi import _mount_asyncapi as _mount_asyncapi
-
-    return _mount_asyncapi(*args, **kwargs)
-
-
 __all__ = [
     'build_lens',
     'build_openapi',
     'build_openrpc_spec',
     'build_swagger',
     'build_json_schema_bundle',
-    'build_asyncapi_spec',
     'mount_lens',
     'mount_openapi',
     'mount_openrpc',
     'mount_swagger',
     'mount_json_schema',
-    'mount_asyncapi',
 ]

{tigrbl_concrete-0.4.1.dev6 → tigrbl_concrete-0.4.2.dev3}/tigrbl_concrete/system/docs/lens.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import json
 from typing import Any
 from urllib.parse import quote
 
@@ -14,11 +15,21 @@ def _with_leading_slash(path: str) -> str:
     return path if path.startswith("/") else f"/{path}"
 
 
+def _build_docs_config(router: Any, *, spec_path: str) -> list[dict[str, Any]]:
+    openapi_path = _with_leading_slash(str(getattr(router, "openapi_url", "/openapi.json") or "/openapi.json"))
+    openrpc_path = _with_leading_slash(str(spec_path or getattr(router, "openrpc_path", "/openrpc.json") or "/openrpc.json"))
+    return [
+        {"id": "rest", "label": "REST", "kind": "openapi", "url": openapi_path, "rawSpecHref": openapi_path, "protocols": ["rest"]},
+        {"id": "jsonrpc", "label": "JSON-RPC", "kind": "openrpc", "url": openrpc_path, "rawSpecHref": openrpc_path, "protocols": ["jsonrpc"]},
+    ]
+
+
 def build_lens_html(router: Any, request: Any, *, spec_path: str) -> str:
     base = (getattr(request, "script_name", "") or "").rstrip("/")
     route_prefix = str(getattr(router, "_tigrbl_route_prefix", "") or "").rstrip("/")
     spec_url = f"{base}{route_prefix}{_with_leading_slash(spec_path)}"
     quoted_spec_url = quote(spec_url, safe="/:?=&%")
+    docs_config = json.dumps(_build_docs_config(router, spec_path=spec_path), separators=(",", ":"))
     return f"""<!doctype html>
 <html>
   <head>
@@ -62,7 +73,7 @@ def build_lens_html(router: Any, request: Any, *, spec_path: str) -> str:
           React.createElement(
             React.StrictMode,
             null,
-            React.createElement(EmbeddedLens, {{ url: "{quoted_spec_url}" }}),
+            React.createElement(EmbeddedLens, {{ url: "{quoted_spec_url}", docs: {docs_config} }}),
           ),
         );
       }}