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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/PKG-INFO +51 -101
  2. tigrbl_base-0.4.2.dev3/README.md +70 -0
  3. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/pyproject.toml +17 -5
  4. tigrbl_base-0.4.1.dev6/README.md +0 -125
  5. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/LICENSE +0 -0
  6. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/__init__.py +0 -0
  7. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_alias_base.py +0 -0
  8. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_app_base.py +0 -0
  9. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_assembly.py +0 -0
  10. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_binding_base.py +0 -0
  11. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_column_base.py +0 -0
  12. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_datatype_lowering.py +0 -0
  13. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_engine_base.py +0 -0
  14. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_engine_provider_base.py +0 -0
  15. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_headers_base.py +0 -0
  16. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_hook_base.py +0 -0
  17. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_mapping_access.py +0 -0
  18. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_middleware_base.py +0 -0
  19. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_op_base.py +0 -0
  20. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_request_base.py +0 -0
  21. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_response_base.py +0 -0
  22. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_rest_map.py +0 -0
  23. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_router_base.py +0 -0
  24. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_rpc_map.py +0 -0
  25. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_schema_base.py +0 -0
  26. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_security_base.py +0 -0
  27. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_session_abc.py +0 -0
  28. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_session_base.py +0 -0
  29. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_storage.py +0 -0
  30. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_table_base.py +0 -0
  31. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/_base/_table_registry_base.py +0 -0
  32. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/column/__init__.py +0 -0
  33. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/column/infer/__init__.py +0 -0
  34. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/column/infer/core.py +0 -0
  35. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/column/infer/jsonhints.py +0 -0
  36. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/column/infer/planning.py +0 -0
  37. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/column/infer/types.py +0 -0
  38. {tigrbl_base-0.4.1.dev6 → tigrbl_base-0.4.2.dev3}/tigrbl_base/column/infer/utils.py +0 -0
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tigrbl-base
3
- Version: 0.4.1.dev6
4
- Summary: Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
3
+ Version: 0.4.2.dev3
4
+ Summary: Base contract package for Tigrbl apps, routers, tables, sessions, middleware, requests, responses, bindings, and engine interfaces.
5
5
  License: Apache License
6
6
  Version 2.0, January 2004
7
7
  http://www.apache.org/licenses/
@@ -204,14 +204,16 @@ License: Apache License
204
204
  See the License for the specific language governing permissions and
205
205
  limitations under the License.
206
206
  License-File: LICENSE
207
- Keywords: tigrbl,asgi,api,json-rpc,rest,sqlalchemy,pydantic,base,base-classes,interfaces,abstractions,openapi,openrpc,schema-first
207
+ Keywords: tigrbl,asgi,api,abstract base classes,api contracts,base contracts,engine interfaces,framework internals,json-rpc,base,base-classes,interfaces,abstractions,openapi,openrpc,request response,rest,schema-first,session interfaces,sqlalchemy,table base
208
208
  Author: Jacob Stewart
209
209
  Author-email: jacob@swarmauri.com
210
210
  Requires-Python: >=3.10,<3.15
211
211
  Classifier: Development Status :: 3 - Alpha
212
+ Classifier: Environment :: Web Environment
212
213
  Classifier: Intended Audience :: Developers
213
214
  Classifier: Intended Audience :: Information Technology
214
215
  Classifier: Framework :: AsyncIO
216
+ Classifier: License :: OSI Approved :: Apache Software License
215
217
  Classifier: Operating System :: OS Independent
216
218
  Classifier: Programming Language :: Python
217
219
  Classifier: Programming Language :: Python :: 3
@@ -222,8 +224,11 @@ Classifier: Programming Language :: Python :: 3.12
222
224
  Classifier: Programming Language :: Python :: 3.13
223
225
  Classifier: Programming Language :: Python :: 3.14
224
226
  Classifier: Topic :: Internet :: WWW/HTTP
227
+ Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
228
+ Classifier: Topic :: Software Development :: Code Generators
225
229
  Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
226
230
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
231
+ Classifier: Typing :: Typed
227
232
  Requires-Dist: pydantic (>=2.0)
228
233
  Requires-Dist: sqlalchemy (>=2.0)
229
234
  Requires-Dist: tigrbl-atoms
@@ -235,112 +240,60 @@ Project-URL: Organization, https://github.com/tigrbl
235
240
  Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base
236
241
  Description-Content-Type: text/markdown
237
242
 
238
- ![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
243
+ <div align="center">
244
+ <h1>tigrbl-base</h1>
245
+ <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
246
+ <p><strong>Base contract package for Tigrbl apps, routers, tables, sessions, middleware, requests, responses, bindings, and engine interfaces.</strong></p>
247
+ <a href="https://pypi.org/project/tigrbl-base/"><img src="https://img.shields.io/pypi/v/tigrbl-base?label=PyPI" alt="PyPI version for tigrbl-base"/></a>
248
+ <a href="https://pypi.org/project/tigrbl-base/"><img src="https://static.pepy.tech/badge/tigrbl-base" alt="Downloads for tigrbl-base"/></a>
249
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_base/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_base/README.md.svg?label=hits" alt="Repository hits for tigrbl-base README"/></a>
250
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
251
+ <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl-base"/></a>
252
+ <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-base"/></a>
253
+ </div>
239
254
 
240
- <p align="center">
241
- <a href="https://pepy.tech/project/tigrbl-base">
242
- <img src="https://static.pepy.tech/badge/tigrbl-base" alt="Pepy downloads for tigrbl-base"/></a>
243
- <a href="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base/">
244
- <img src="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base.svg" alt="Repository views for tigrbl-base"/></a>
245
- <a href="https://pypi.org/project/tigrbl-base/">
246
- <img src="https://img.shields.io/badge/python-3.10--3.14-blue" alt="Python 3.10 through 3.14"/></a>
247
- <a href="https://pypi.org/project/tigrbl-base/">
248
- <img src="https://img.shields.io/pypi/l/tigrbl-base" alt="PyPI license metadata for tigrbl-base"/></a>
249
- <a href="https://pypi.org/project/tigrbl-base/">
250
- <img src="https://img.shields.io/pypi/v/tigrbl-base?label=tigrbl-base&color=green" alt="PyPI version for tigrbl-base"/></a>
251
- </p>
252
-
253
- ---
254
-
255
- <h1 align="center">Tigrbl base</h1>
256
-
257
- **Install and inspect `tigrbl-base`: [download `tigrbl-base` from PyPI](https://pypi.org/project/tigrbl-base/) or [open the package source](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base).**
258
-
259
- tigrbl-base is a base interface package for abstract base interfaces for Tigrbl APIs, engines, providers, and runtime components.
260
-
261
- `tigrbl-base` 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.
262
-
263
- ## Package ownership
264
-
265
- - `tigrbl-base` documents the concepts implemented in `pkgs/core/tigrbl_base` and links to the Tigrbl packages that provide neighboring authoring, canon, runtime, operation, and engine behavior.
266
- - Use this README as the package-local explanation for the objects that live here; use governed docs for release state, certification, and evidence.
255
+ ## Install
267
256
 
268
- ## Package ecosystem cross-links
257
+ ```bash
258
+ uv add tigrbl-base
259
+ ```
269
260
 
270
- 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.
261
+ ```bash
262
+ pip install tigrbl-base
263
+ ```
271
264
 
272
- Core packages:
273
- - [`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.
274
- - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) - Runtime atom utilities for Tigrbl planning, dispatch, transport ingress, egress, and high-throughput ASGI execution pipelines.
275
- - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/) (this package) - Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
276
- - [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) - Canonical mapping, routing, symbol resolution, and naming utilities for Tigrbl framework packages and generated API surfaces.
277
- - [`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.
278
- - [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) - Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
279
- - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) - Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
280
- - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) - Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
281
- - [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/) - Analytical OLAP operation boundaries for Tigrbl workloads, query-oriented APIs, and engine integrations.
282
- - [`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.
283
- - [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/) - Realtime, streaming, datagram, websocket, and event operation handlers for Tigrbl ASGI runtimes.
284
- - [`tigrbl-orm`](https://pypi.org/project/tigrbl-orm/) - SQLAlchemy ORM tables, mixins, columns, model helpers, and persistence primitives for Tigrbl applications.
285
- - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) - Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
286
- - [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) - Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
287
- - [`tigrbl_tests`](https://pypi.org/project/tigrbl_tests/) - Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
288
- - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) - Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions.
265
+ ## What It Owns
289
266
 
290
- Engine packages:
291
- - [`tigrbl_engine_bigquery`](https://pypi.org/project/tigrbl_engine_bigquery/) - BigQuery engine plugin for Google BigQuery warehouse sessions, analytics workloads, and Tigrbl engine registration.
292
- - [`tigrbl_engine_clickhouse`](https://pypi.org/project/tigrbl_engine_clickhouse/) - ClickHouse engine plugin for analytical database sessions, warehouse workloads, and Tigrbl engine registration.
293
- - [`tigrbl_engine_csv`](https://pypi.org/project/tigrbl_engine_csv/) - CSV engine plugin for file-backed tables, pandas DataFrames, and lightweight Tigrbl data workflows.
294
- - [`tigrbl_engine_dataframe`](https://pypi.org/project/tigrbl_engine_dataframe/) - DataFrame engine plugin for transactional pandas sessions and in-process Tigrbl analytics workloads.
295
- - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/) - DuckDB engine plugin for embedded analytical database sessions, OLAP workloads, and Tigrbl engine registration.
296
- - [`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.
297
- - [`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.
298
- - [`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.
299
- - [`tigrbl_engine_memdedupe`](https://pypi.org/project/tigrbl_engine_memdedupe/) - In-memory dedupe engine plugin for idempotency tracking, duplicate suppression, and Tigrbl workflow coordination.
300
- - [`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.
301
- - [`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.
302
- - [`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.
303
- - [`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.
304
- - [`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.
305
- - [`tigrbl_engine_numpy`](https://pypi.org/project/tigrbl_engine_numpy/) - NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
306
- - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/) - Pandas engine plugin for transactional DataFrame sessions, tabular workflows, and Tigrbl data integration.
307
- - [`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.
308
- - [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) - PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
309
- - [`tigrbl_engine_pyspark`](https://pypi.org/project/tigrbl_engine_pyspark/) - PySpark engine plugin for distributed DataFrame integration, analytics workloads, and Tigrbl data workflows.
310
- - [`tigrbl_engine_redis`](https://pypi.org/project/tigrbl_engine_redis/) - Redis engine plugin for cache, data structures, and Tigrbl engine workflows backed by Redis.
311
- - [`tigrbl_engine_rediscachethrough`](https://pypi.org/project/tigrbl_engine_rediscachethrough/) - Redis cache-through engine plugin for Redis, PostgreSQL, and Tigrbl data-access acceleration workflows.
312
- - [`tigrbl_engine_snowflake`](https://pypi.org/project/tigrbl_engine_snowflake/) - Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
313
- - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/) - SQLite engine plugin for SQLAlchemy sessions, local transactional storage, and Tigrbl application persistence.
314
- - [`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.
267
+ `tigrbl-base` owns the base boundary inside the split Python workspace.
315
268
 
316
- Application packages:
317
- - [`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.
318
- - [`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.
269
+ ## Use It When
319
270
 
320
- Source-tree links remain available from each package identity section; this ecosystem section is intentionally PyPI-first for package discovery and installation routing.
271
+ Use `tigrbl-base` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
321
272
 
322
- ## Install
273
+ ## Public Surface
323
274
 
324
- ```bash
325
- pip install tigrbl-base
326
- ```
275
+ - Package-local implementation lives under `pkgs/core/tigrbl_base` and is consumed as a distribution boundary rather than a single broad root re-export.
327
276
 
328
- ## Package discovery
277
+ ## Internal Layout
329
278
 
330
- `tigrbl-base` is described for package indexes, search engines, answer engines, and AI coding tools as: Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
279
+ - Workspace path: `pkgs/core/tigrbl_base`.
280
+ - Package class: `core framework package`.
281
+ - Python requirement: `>=3.10,<3.15`.
331
282
 
332
- Use `tigrbl-base` 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.
283
+ ## Dependency Surface
333
284
 
334
- 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, base, base-classes, interfaces, abstractions, openapi, openrpc, schema-first.
285
+ - Workspace package dependencies: [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/).
286
+ - External runtime dependencies: `sqlalchemy>=2.0`, `pydantic>=2.0`.
287
+ - Optional extras: none declared.
335
288
 
336
- ## Package-local entry point
289
+ ## Related Packages
337
290
 
338
- This file is a package-local distribution entry point.
339
- It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
291
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
292
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
293
+ - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
340
294
 
341
- ## Canonical repository docs
295
+ ## Canonical Repository Docs
342
296
 
343
- - `README.md`
344
297
  - `docs/README.md`
345
298
  - `docs/conformance/CURRENT_TARGET.md`
346
299
  - `docs/conformance/CURRENT_STATE.md`
@@ -349,15 +302,12 @@ It is not the authoritative location for repository governance, current target s
349
302
  - `docs/developer/PACKAGE_CATALOG.md`
350
303
  - `docs/developer/PACKAGE_LAYOUT.md`
351
304
 
352
- ## Package identity
305
+ ## Package-local Boundary
306
+
307
+ This file is a package-local distribution entry point.
308
+ Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
353
309
 
354
- - canonical repository: `https://github.com/tigrbl/tigrbl`
355
- - organization: `https://github.com/tigrbl`
356
- - social: `https://discord.gg/K4YTAPapjR`
357
- - package path: `https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base`
358
- - workspace path: `pkgs/core/tigrbl_base`
359
- - workspace class: core Python package
360
- - implementation layout: `tigrbl_base/`
310
+ ## License
361
311
 
362
- Long-form repository documentation is governed from `docs/`.
312
+ 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).
363
313
 
@@ -0,0 +1,70 @@
1
+ <div align="center">
2
+ <h1>tigrbl-base</h1>
3
+ <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
4
+ <p><strong>Base contract package for Tigrbl apps, routers, tables, sessions, middleware, requests, responses, bindings, and engine interfaces.</strong></p>
5
+ <a href="https://pypi.org/project/tigrbl-base/"><img src="https://img.shields.io/pypi/v/tigrbl-base?label=PyPI" alt="PyPI version for tigrbl-base"/></a>
6
+ <a href="https://pypi.org/project/tigrbl-base/"><img src="https://static.pepy.tech/badge/tigrbl-base" alt="Downloads for tigrbl-base"/></a>
7
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_base/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_base/README.md.svg?label=hits" alt="Repository hits for tigrbl-base README"/></a>
8
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
9
+ <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl-base"/></a>
10
+ <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-base"/></a>
11
+ </div>
12
+
13
+ ## Install
14
+
15
+ ```bash
16
+ uv add tigrbl-base
17
+ ```
18
+
19
+ ```bash
20
+ pip install tigrbl-base
21
+ ```
22
+
23
+ ## What It Owns
24
+
25
+ `tigrbl-base` owns the base boundary inside the split Python workspace.
26
+
27
+ ## Use It When
28
+
29
+ Use `tigrbl-base` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
30
+
31
+ ## Public Surface
32
+
33
+ - Package-local implementation lives under `pkgs/core/tigrbl_base` and is consumed as a distribution boundary rather than a single broad root re-export.
34
+
35
+ ## Internal Layout
36
+
37
+ - Workspace path: `pkgs/core/tigrbl_base`.
38
+ - Package class: `core framework package`.
39
+ - Python requirement: `>=3.10,<3.15`.
40
+
41
+ ## Dependency Surface
42
+
43
+ - Workspace package dependencies: [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/).
44
+ - External runtime dependencies: `sqlalchemy>=2.0`, `pydantic>=2.0`.
45
+ - Optional extras: none declared.
46
+
47
+ ## Related Packages
48
+
49
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
50
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
51
+ - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
52
+
53
+ ## Canonical Repository Docs
54
+
55
+ - `docs/README.md`
56
+ - `docs/conformance/CURRENT_TARGET.md`
57
+ - `docs/conformance/CURRENT_STATE.md`
58
+ - `docs/conformance/NEXT_STEPS.md`
59
+ - `docs/governance/DOC_POINTERS.md`
60
+ - `docs/developer/PACKAGE_CATALOG.md`
61
+ - `docs/developer/PACKAGE_LAYOUT.md`
62
+
63
+ ## Package-local Boundary
64
+
65
+ This file is a package-local distribution entry point.
66
+ Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
67
+
68
+ ## License
69
+
70
+ 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).
@@ -1,30 +1,39 @@
1
1
  [project]
2
2
  name = "tigrbl-base"
3
- version = "0.4.1.dev6"
4
- description = "Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components."
3
+ version = "0.4.2.dev3"
4
+ description = "Base contract package for Tigrbl apps, routers, tables, sessions, middleware, requests, responses, bindings, and engine interfaces."
5
5
  readme = "README.md"
6
6
  license = { file = "LICENSE" }
7
7
  keywords = [
8
8
  "tigrbl",
9
9
  "asgi",
10
10
  "api",
11
+ "abstract base classes",
12
+ "api contracts",
13
+ "base contracts",
14
+ "engine interfaces",
15
+ "framework internals",
11
16
  "json-rpc",
12
- "rest",
13
- "sqlalchemy",
14
- "pydantic",
15
17
  "base",
16
18
  "base-classes",
17
19
  "interfaces",
18
20
  "abstractions",
19
21
  "openapi",
20
22
  "openrpc",
23
+ "request response",
24
+ "rest",
21
25
  "schema-first",
26
+ "session interfaces",
27
+ "sqlalchemy",
28
+ "table base",
22
29
  ]
23
30
  classifiers = [
24
31
  "Development Status :: 3 - Alpha",
32
+ "Environment :: Web Environment",
25
33
  "Intended Audience :: Developers",
26
34
  "Intended Audience :: Information Technology",
27
35
  "Framework :: AsyncIO",
36
+ "License :: OSI Approved :: Apache Software License",
28
37
  "Operating System :: OS Independent",
29
38
  "Programming Language :: Python",
30
39
  "Programming Language :: Python :: 3",
@@ -35,8 +44,11 @@ classifiers = [
35
44
  "Programming Language :: Python :: 3.13",
36
45
  "Programming Language :: Python :: 3.14",
37
46
  "Topic :: Internet :: WWW/HTTP",
47
+ "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
48
+ "Topic :: Software Development :: Code Generators",
38
49
  "Topic :: Software Development :: Libraries :: Application Frameworks",
39
50
  "Topic :: Software Development :: Libraries :: Python Modules",
51
+ "Typing :: Typed",
40
52
  ]
41
53
  requires-python = ">=3.10,<3.15"
42
54
  authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
@@ -1,125 +0,0 @@
1
- ![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
2
-
3
- <p align="center">
4
- <a href="https://pepy.tech/project/tigrbl-base">
5
- <img src="https://static.pepy.tech/badge/tigrbl-base" alt="Pepy downloads for tigrbl-base"/></a>
6
- <a href="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base/">
7
- <img src="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base.svg" alt="Repository views for tigrbl-base"/></a>
8
- <a href="https://pypi.org/project/tigrbl-base/">
9
- <img src="https://img.shields.io/badge/python-3.10--3.14-blue" alt="Python 3.10 through 3.14"/></a>
10
- <a href="https://pypi.org/project/tigrbl-base/">
11
- <img src="https://img.shields.io/pypi/l/tigrbl-base" alt="PyPI license metadata for tigrbl-base"/></a>
12
- <a href="https://pypi.org/project/tigrbl-base/">
13
- <img src="https://img.shields.io/pypi/v/tigrbl-base?label=tigrbl-base&color=green" alt="PyPI version for tigrbl-base"/></a>
14
- </p>
15
-
16
- ---
17
-
18
- <h1 align="center">Tigrbl base</h1>
19
-
20
- **Install and inspect `tigrbl-base`: [download `tigrbl-base` from PyPI](https://pypi.org/project/tigrbl-base/) or [open the package source](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base).**
21
-
22
- tigrbl-base is a base interface package for abstract base interfaces for Tigrbl APIs, engines, providers, and runtime components.
23
-
24
- `tigrbl-base` 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.
25
-
26
- ## Package ownership
27
-
28
- - `tigrbl-base` documents the concepts implemented in `pkgs/core/tigrbl_base` and links to the Tigrbl packages that provide neighboring authoring, canon, runtime, operation, and engine behavior.
29
- - Use this README as the package-local explanation for the objects that live here; use governed docs for release state, certification, and evidence.
30
-
31
- ## Package ecosystem cross-links
32
-
33
- 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.
34
-
35
- Core packages:
36
- - [`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.
37
- - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) - Runtime atom utilities for Tigrbl planning, dispatch, transport ingress, egress, and high-throughput ASGI execution pipelines.
38
- - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/) (this package) - Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
39
- - [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) - Canonical mapping, routing, symbol resolution, and naming utilities for Tigrbl framework packages and generated API surfaces.
40
- - [`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.
41
- - [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) - Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
42
- - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) - Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
43
- - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) - Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
44
- - [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/) - Analytical OLAP operation boundaries for Tigrbl workloads, query-oriented APIs, and engine integrations.
45
- - [`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.
46
- - [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/) - Realtime, streaming, datagram, websocket, and event operation handlers for Tigrbl ASGI runtimes.
47
- - [`tigrbl-orm`](https://pypi.org/project/tigrbl-orm/) - SQLAlchemy ORM tables, mixins, columns, model helpers, and persistence primitives for Tigrbl applications.
48
- - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) - Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
49
- - [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) - Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
50
- - [`tigrbl_tests`](https://pypi.org/project/tigrbl_tests/) - Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
51
- - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) - Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions.
52
-
53
- Engine packages:
54
- - [`tigrbl_engine_bigquery`](https://pypi.org/project/tigrbl_engine_bigquery/) - BigQuery engine plugin for Google BigQuery warehouse sessions, analytics workloads, and Tigrbl engine registration.
55
- - [`tigrbl_engine_clickhouse`](https://pypi.org/project/tigrbl_engine_clickhouse/) - ClickHouse engine plugin for analytical database sessions, warehouse workloads, and Tigrbl engine registration.
56
- - [`tigrbl_engine_csv`](https://pypi.org/project/tigrbl_engine_csv/) - CSV engine plugin for file-backed tables, pandas DataFrames, and lightweight Tigrbl data workflows.
57
- - [`tigrbl_engine_dataframe`](https://pypi.org/project/tigrbl_engine_dataframe/) - DataFrame engine plugin for transactional pandas sessions and in-process Tigrbl analytics workloads.
58
- - [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/) - DuckDB engine plugin for embedded analytical database sessions, OLAP workloads, and Tigrbl engine registration.
59
- - [`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.
60
- - [`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.
61
- - [`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.
62
- - [`tigrbl_engine_memdedupe`](https://pypi.org/project/tigrbl_engine_memdedupe/) - In-memory dedupe engine plugin for idempotency tracking, duplicate suppression, and Tigrbl workflow coordination.
63
- - [`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.
64
- - [`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.
65
- - [`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.
66
- - [`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.
67
- - [`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.
68
- - [`tigrbl_engine_numpy`](https://pypi.org/project/tigrbl_engine_numpy/) - NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
69
- - [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/) - Pandas engine plugin for transactional DataFrame sessions, tabular workflows, and Tigrbl data integration.
70
- - [`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.
71
- - [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) - PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
72
- - [`tigrbl_engine_pyspark`](https://pypi.org/project/tigrbl_engine_pyspark/) - PySpark engine plugin for distributed DataFrame integration, analytics workloads, and Tigrbl data workflows.
73
- - [`tigrbl_engine_redis`](https://pypi.org/project/tigrbl_engine_redis/) - Redis engine plugin for cache, data structures, and Tigrbl engine workflows backed by Redis.
74
- - [`tigrbl_engine_rediscachethrough`](https://pypi.org/project/tigrbl_engine_rediscachethrough/) - Redis cache-through engine plugin for Redis, PostgreSQL, and Tigrbl data-access acceleration workflows.
75
- - [`tigrbl_engine_snowflake`](https://pypi.org/project/tigrbl_engine_snowflake/) - Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
76
- - [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/) - SQLite engine plugin for SQLAlchemy sessions, local transactional storage, and Tigrbl application persistence.
77
- - [`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.
78
-
79
- Application packages:
80
- - [`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.
81
- - [`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.
82
-
83
- Source-tree links remain available from each package identity section; this ecosystem section is intentionally PyPI-first for package discovery and installation routing.
84
-
85
- ## Install
86
-
87
- ```bash
88
- pip install tigrbl-base
89
- ```
90
-
91
- ## Package discovery
92
-
93
- `tigrbl-base` is described for package indexes, search engines, answer engines, and AI coding tools as: Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
94
-
95
- Use `tigrbl-base` 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.
96
-
97
- 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, base, base-classes, interfaces, abstractions, openapi, openrpc, schema-first.
98
-
99
- ## Package-local entry point
100
-
101
- This file is a package-local distribution entry point.
102
- It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
103
-
104
- ## Canonical repository docs
105
-
106
- - `README.md`
107
- - `docs/README.md`
108
- - `docs/conformance/CURRENT_TARGET.md`
109
- - `docs/conformance/CURRENT_STATE.md`
110
- - `docs/conformance/NEXT_STEPS.md`
111
- - `docs/governance/DOC_POINTERS.md`
112
- - `docs/developer/PACKAGE_CATALOG.md`
113
- - `docs/developer/PACKAGE_LAYOUT.md`
114
-
115
- ## Package identity
116
-
117
- - canonical repository: `https://github.com/tigrbl/tigrbl`
118
- - organization: `https://github.com/tigrbl`
119
- - social: `https://discord.gg/K4YTAPapjR`
120
- - package path: `https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_base`
121
- - workspace path: `pkgs/core/tigrbl_base`
122
- - workspace class: core Python package
123
- - implementation layout: `tigrbl_base/`
124
-
125
- Long-form repository documentation is governed from `docs/`.