tigrbl 0.4.5.dev4__tar.gz → 0.4.5.dev6__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl
-Version: 0.4.5.dev4
+Version: 0.4.5.dev6
 Summary: Schema-first ASGI framework for REST, JSON-RPC, streaming, SSE, WebSocket, runtime plans, hooks, diagnostics, and engine plugins.
 License: Apache License
                                     Version 2.0, January 2004
@@ -230,15 +230,21 @@ Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
+Provides-Extra: gunicorn
+Provides-Extra: hypercorn
 Provides-Extra: postgres
 Provides-Extra: servers
 Provides-Extra: templates
 Provides-Extra: tests
+Provides-Extra: tigrcorn
+Provides-Extra: uvicorn
 Requires-Dist: aiosqlite (>=0.19.0)
 Requires-Dist: asyncpg (>=0.30.0) ; extra == "postgres"
 Requires-Dist: greenlet (>=3.2.3)
+Requires-Dist: gunicorn (>=21.2.0) ; extra == "gunicorn"
 Requires-Dist: gunicorn (>=21.2.0) ; extra == "servers"
 Requires-Dist: httpx (>=0.27.0)
+Requires-Dist: hypercorn (>=0.16.0) ; extra == "hypercorn"
 Requires-Dist: hypercorn (>=0.16.0) ; extra == "servers"
 Requires-Dist: jinja2 (>=3.1.4) ; extra == "templates"
 Requires-Dist: psycopg2-binary (>=2.9.9) ; extra == "postgres"
@@ -254,7 +260,10 @@ Requires-Dist: tigrbl-ops-oltp
 Requires-Dist: tigrbl-orm
 Requires-Dist: tigrbl-runtime
 Requires-Dist: tigrbl-tests ; extra == "tests"
-Requires-Dist: uvicorn
+Requires-Dist: tigrcorn ; extra == "servers"
+Requires-Dist: tigrcorn ; extra == "tigrcorn"
+Requires-Dist: uvicorn ; extra == "servers"
+Requires-Dist: uvicorn ; extra == "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
@@ -269,7 +278,7 @@ Description-Content-Type: text/markdown
 <a href="https://pypi.org/project/tigrbl/"><img src="https://img.shields.io/pypi/v/tigrbl?label=PyPI" alt="PyPI version for tigrbl"/></a>
 <a href="https://pypi.org/project/tigrbl/"><img src="https://static.pepy.tech/badge/tigrbl" alt="Downloads for tigrbl"/></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"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl/README.md.svg?label=hits" alt="Repository hits for tigrbl README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/80_facade/tigrbl/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/80_facade/tigrbl/README.md.svg?label=hits" alt="Repository hits for tigrbl 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"/></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"/></a>
@@ -293,7 +302,7 @@ Application developers, platform teams, and service owners building schema-first
 
 ## Where does tigrbl fit?
 
-`tigrbl` lives at `pkgs/core/tigrbl` and serves schema-first service authoring, REST, JSON-RPC, streaming, SSE, WebSocket, WebTransport-aware runtime planning, docs, engines, and CLI workflows.
+`tigrbl` lives at `pkgs/80_facade/tigrbl` and serves schema-first service authoring, REST, JSON-RPC, streaming, SSE, WebSocket, WebTransport-aware runtime planning, docs, engines, and CLI workflows.
 
 ## How does tigrbl work?
 
@@ -321,7 +330,7 @@ pip install "tigrbl[postgres,servers,templates,tests]"
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl`](https://pypi.org/project/tigrbl/) |
-| Repository path | [`pkgs/core/tigrbl`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl) |
+| Repository path | [`pkgs/80_facade/tigrbl`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/80_facade/tigrbl) |
 | Python import root | `tigrbl` |
 | Console scripts | `tigrbl` |
 | Entry points | none declared |
@@ -779,7 +788,7 @@ Choose `tigrbl` when you want the full public facade: app composition, schema-fi
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl).
+- Repository: [pkgs/80_facade/tigrbl](https://github.com/tigrbl/tigrbl/tree/master/pkgs/80_facade/tigrbl).
 
 ## Package-local Boundary
 
@@ -790,7 +799,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-0.4.5.dev4 → tigrbl-0.4.5.dev6}/README.md

@@ -5,7 +5,7 @@
 <a href="https://pypi.org/project/tigrbl/"><img src="https://img.shields.io/pypi/v/tigrbl?label=PyPI" alt="PyPI version for tigrbl"/></a>
 <a href="https://pypi.org/project/tigrbl/"><img src="https://static.pepy.tech/badge/tigrbl" alt="Downloads for tigrbl"/></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"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl/README.md.svg?label=hits" alt="Repository hits for tigrbl README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/80_facade/tigrbl/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/80_facade/tigrbl/README.md.svg?label=hits" alt="Repository hits for tigrbl 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"/></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"/></a>
@@ -29,7 +29,7 @@ Application developers, platform teams, and service owners building schema-first
 
 ## Where does tigrbl fit?
 
-`tigrbl` lives at `pkgs/core/tigrbl` and serves schema-first service authoring, REST, JSON-RPC, streaming, SSE, WebSocket, WebTransport-aware runtime planning, docs, engines, and CLI workflows.
+`tigrbl` lives at `pkgs/80_facade/tigrbl` and serves schema-first service authoring, REST, JSON-RPC, streaming, SSE, WebSocket, WebTransport-aware runtime planning, docs, engines, and CLI workflows.
 
 ## How does tigrbl work?
 
@@ -57,7 +57,7 @@ pip install "tigrbl[postgres,servers,templates,tests]"
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl`](https://pypi.org/project/tigrbl/) |
-| Repository path | [`pkgs/core/tigrbl`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl) |
+| Repository path | [`pkgs/80_facade/tigrbl`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/80_facade/tigrbl) |
 | Python import root | `tigrbl` |
 | Console scripts | `tigrbl` |
 | Entry points | none declared |
@@ -515,7 +515,7 @@ Choose `tigrbl` when you want the full public facade: app composition, schema-fi
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl).
+- Repository: [pkgs/80_facade/tigrbl](https://github.com/tigrbl/tigrbl/tree/master/pkgs/80_facade/tigrbl).
 
 ## Package-local Boundary
 
@@ -526,7 +526,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-0.4.5.dev4 → tigrbl-0.4.5.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl"
-version = "0.4.5.dev4"
+version = "0.4.5.dev6"
 description = "Schema-first ASGI framework for REST, JSON-RPC, streaming, SSE, WebSocket, runtime plans, hooks, diagnostics, and engine plugins."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -68,7 +68,6 @@ dependencies = [
     "aiosqlite>=0.19.0",
     "httpx>=0.27.0",
     "greenlet>=3.2.3",
-    "uvicorn",
 ]
 
 
@@ -92,9 +91,23 @@ templates = [
     "jinja2>=3.1.4",
 ]
 servers = [
+    "uvicorn",
+    "tigrcorn",
     "hypercorn>=0.16.0",
     "gunicorn>=21.2.0",
 ]
+uvicorn = [
+    "uvicorn",
+]
+tigrcorn = [
+    "tigrcorn",
+]
+hypercorn = [
+    "hypercorn>=0.16.0",
+]
+gunicorn = [
+    "gunicorn>=21.2.0",
+]
 tests = [
     "tigrbl-tests",
 ]

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

@@ -100,6 +100,7 @@ from tigrbl_concrete._concrete import (  # noqa: E402
     Column,
     CORSMiddleware,
     CrudTable,
+    EngineSession,
     EventStreamTable,
     EventStreamResponse,
     FileResponse,
@@ -185,7 +186,39 @@ from tigrbl_concrete._decorators.middlewares import (  # noqa: E402
     middleware as middleware,
     middlewares as middlewares,
 )
-from tigrbl.factories.op import op  # noqa: E402
+from tigrbl.factories.op import makeOp, op  # noqa: E402
+from tigrbl.factories.table import (  # noqa: E402
+    activateTableSpec,
+    activateTableSpecs,
+    defineTableSpec,
+    deriveTableSpec,
+    provideTableSpec,
+)
+from tigrbl_concrete.records import (  # noqa: E402
+    clear_table_records,
+    clear_records,
+    create_table_record,
+    create_record,
+    database_from_context,
+    delete_table_record,
+    delete_record,
+    field,
+    field_value,
+    first_table_record,
+    first_record,
+    invoke_table_operation,
+    list_table_records,
+    list_records,
+    maybe_await,
+    normalize_items,
+    payload_from_context,
+    provideTableHandler,
+    read_table_record,
+    read_record,
+    record_identifier,
+    update_table_record,
+    update_record,
+)
 from tigrbl.schema import _build_list_params, _build_schema, get_schema  # noqa: E402
 from tigrbl.ddl import bootstrap_dbschema, ensure_schemas, register_sqlite_attach  # noqa: E402
 
@@ -194,6 +227,7 @@ from tigrbl_base._base import (  # noqa: E402
     CrudTableBase,
     EngineBase,
     EngineProviderBase,
+    EngineSessionBase,
     ForeignKeyBase,
     HookBase,
     RealtimeTableBase,
@@ -229,6 +263,7 @@ from tigrbl_core._spec import (  # noqa: E402
     HttpRestProtocolBindingSpec,
     HttpStreamBindingSpec,
     IOSpec,
+    JsonRpcFramingSpec,
     OpSpec,
     PathKind,
     PathSpec,
@@ -242,7 +277,8 @@ from tigrbl_core._spec import (  # noqa: E402
     SchemaArg,
     SchemaRef,
     SchemaSpec,
-    SessionSpec,
+    EngineSessionCfg,
+    EngineSessionSpec,
     StorageSpec,
     StorageTransformSpec,
     StorageTypeRef,
@@ -346,21 +382,41 @@ async def rpc_call(*args, **kwargs):
     )
 
 
-from tigrbl_core._spec.session_spec import (  # noqa: E402
+from tigrbl_core._compat import warn_legacy_engine_session_name  # noqa: E402
+from tigrbl_core._spec.engine_session_spec import (  # noqa: E402
     readonly as _readonly_fn,
-    session_spec as _session_spec_fn,
+    engine_session_spec as _engine_session_spec_fn,
     tx_read_committed as _tx_read_committed_fn,
     tx_repeatable_read as _tx_repeatable_read_fn,
     tx_serializable as _tx_serializable_fn,
 )
 
 readonly = _readonly_fn
-session_spec = _session_spec_fn
+engine_session_spec = _engine_session_spec_fn
 tx_read_committed = _tx_read_committed_fn
 tx_repeatable_read = _tx_repeatable_read_fn
 tx_serializable = _tx_serializable_fn
 
 
+def __getattr__(name: str):
+    if name == "SessionSpec":
+        warn_legacy_engine_session_name("tigrbl.SessionSpec", "EngineSessionSpec")
+        return EngineSessionSpec
+    if name == "SessionCfg":
+        warn_legacy_engine_session_name("tigrbl.SessionCfg", "EngineSessionCfg")
+        return EngineSessionCfg
+    if name == "session_spec":
+        warn_legacy_engine_session_name("tigrbl.session_spec", "engine_session_spec")
+        return engine_session_spec
+    if name == "TigrblSessionBase":
+        warn_legacy_engine_session_name("tigrbl.TigrblSessionBase", "EngineSessionBase")
+        return EngineSessionBase
+    if name == "DefaultSession":
+        warn_legacy_engine_session_name("tigrbl.DefaultSession", "EngineSession")
+        return EngineSession
+    raise AttributeError(name)
+
+
 __all__ = [
     "specs",
     "base",
@@ -383,8 +439,38 @@ __all__ = [
     "CrudTableBase",
     "RealtimeTableBase",
     "RouterBase",
+    "EngineSessionBase",
     "Op",
     "op",
+    "makeOp",
+    "defineTableSpec",
+    "deriveTableSpec",
+    "provideTableSpec",
+    "activateTableSpec",
+    "activateTableSpecs",
+    "clear_table_records",
+    "clear_records",
+    "create_table_record",
+    "create_record",
+    "database_from_context",
+    "delete_table_record",
+    "delete_record",
+    "field",
+    "field_value",
+    "first_table_record",
+    "first_record",
+    "invoke_table_operation",
+    "list_table_records",
+    "list_records",
+    "maybe_await",
+    "normalize_items",
+    "payload_from_context",
+    "provideTableHandler",
+    "read_table_record",
+    "read_record",
+    "record_identifier",
+    "update_table_record",
+    "update_record",
     "HTTPBasic",
     "HTTPBearer",
     "APIKey",
@@ -401,6 +487,7 @@ __all__ = [
     "HookPhase",
     "Exchange",
     "Framing",
+    "JsonRpcFramingSpec",
     "HTTPBindingSpec",
     "HttpJsonRpcBindingSpec",
     "HttpJsonRpcProtocolBindingSpec",
@@ -475,6 +562,7 @@ __all__ = [
     "Request",
     "UploadedFile",
     "WebSocket",
+    "EngineSession",
     "Response",
     "TransportResponse",
     "JSONResponse",
@@ -499,8 +587,9 @@ __all__ = [
     "HeadersSpec",
     "RequestSpec",
     "SchemaSpec",
-    "SessionSpec",
-    "session_spec",
+    "EngineSessionCfg",
+    "EngineSessionSpec",
+    "engine_session_spec",
     "tx_read_committed",
     "tx_repeatable_read",
     "tx_serializable",

tigrbl-0.4.5.dev6/tigrbl/engine_session/__init__.py

@@ -0,0 +1,28 @@
+"""Canonical engine database session exports."""
+
+from __future__ import annotations
+
+from tigrbl_base._base import EngineSessionBase
+from tigrbl_concrete._concrete import EngineSession, wrap_sessionmaker
+from tigrbl_core._spec.engine_session_spec import (
+    EngineSessionCfg,
+    EngineSessionSpec,
+    engine_session_spec,
+    readonly,
+    tx_read_committed,
+    tx_repeatable_read,
+    tx_serializable,
+)
+
+__all__ = [
+    "EngineSession",
+    "EngineSessionBase",
+    "EngineSessionCfg",
+    "EngineSessionSpec",
+    "engine_session_spec",
+    "wrap_sessionmaker",
+    "readonly",
+    "tx_read_committed",
+    "tx_repeatable_read",
+    "tx_serializable",
+]

tigrbl-0.4.5.dev6/tigrbl/engine_session/base.py

@@ -0,0 +1,7 @@
+"""Canonical engine session base export."""
+
+from __future__ import annotations
+
+from tigrbl_base._base import EngineSessionBase
+
+__all__ = ["EngineSessionBase"]

tigrbl-0.4.5.dev6/tigrbl/engine_session/spec.py

@@ -0,0 +1,23 @@
+"""Canonical engine session spec exports."""
+
+from __future__ import annotations
+
+from tigrbl_core._spec.engine_session_spec import (
+    EngineSessionCfg,
+    EngineSessionSpec,
+    engine_session_spec,
+    readonly,
+    tx_read_committed,
+    tx_repeatable_read,
+    tx_serializable,
+)
+
+__all__ = [
+    "EngineSessionCfg",
+    "EngineSessionSpec",
+    "engine_session_spec",
+    "readonly",
+    "tx_read_committed",
+    "tx_repeatable_read",
+    "tx_serializable",
+]

tigrbl-0.4.5.dev6/tigrbl/factories/__init__.py

@@ -0,0 +1,85 @@
+from __future__ import annotations
+
+from importlib import import_module
+
+_MODULES = (
+    "app",
+    "column",
+    "engine",
+    "hook",
+    "op",
+    "responses",
+    "router",
+    "schema",
+    "table",
+)
+
+_EXPORT_MODULE = {
+    "Column": "column",
+    "ColumnSpec": "column",
+    "F": "column",
+    "IO": "column",
+    "S": "column",
+    "acol": "column",
+    "activateTableSpec": "table",
+    "activateTableSpecs": "table",
+    "as_event_stream": "responses",
+    "as_file": "responses",
+    "as_html": "responses",
+    "as_json": "responses",
+    "as_redirect": "responses",
+    "as_stream": "responses",
+    "as_text": "responses",
+    "defineAppSpec": "app",
+    "defineRouterSpec": "router",
+    "defineTableSpec": "table",
+    "deriveApp": "app",
+    "deriveRouter": "router",
+    "deriveTable": "table",
+    "deriveTableSpec": "table",
+    "engine": "engine",
+    "engine_spec": "engine",
+    "hook": "hook",
+    "hook_spec": "hook",
+    "makeColumn": "column",
+    "makeOp": "op",
+    "makeVirtualColumn": "column",
+    "mariadb": "engine",
+    "mariadb_cfg": "engine",
+    "mem": "engine",
+    "mysql": "engine",
+    "mysql_cfg": "engine",
+    "op": "op",
+    "pg": "engine",
+    "pg_cfg": "engine",
+    "pga": "engine",
+    "pgs": "engine",
+    "prov": "engine",
+    "provider_mariadb": "engine",
+    "provider_mysql": "engine",
+    "provider_postgres": "engine",
+    "provider_sqlite_file": "engine",
+    "provider_sqlite_memory": "engine",
+    "provideTableSpec": "table",
+    "schema": "schema",
+    "schema_spec": "schema",
+    "sqlite_cfg": "engine",
+    "sqlitef": "engine",
+    "vcol": "column",
+}
+
+__all__ = sorted((*_MODULES, *_EXPORT_MODULE))
+
+
+def __getattr__(name: str):
+    module_name = name if name in _MODULES else _EXPORT_MODULE.get(name)
+    if module_name is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    module = import_module(f"{__name__}.{module_name}")
+    value = module if name in _MODULES else getattr(module, name)
+    globals()[name] = value
+    return value
+
+
+def __dir__() -> list[str]:
+    return sorted(set(__all__) | {key for key in globals() if not key.startswith("_")})

tigrbl-0.4.5.dev6/tigrbl/factories/column.py

@@ -0,0 +1,23 @@
+from tigrbl_concrete.factories.column import (
+    Column,
+    ColumnSpec,
+    F,
+    IO,
+    S,
+    acol,
+    makeColumn,
+    makeVirtualColumn,
+    vcol,
+)
+
+__all__ = [
+    "Column",
+    "ColumnSpec",
+    "F",
+    "IO",
+    "S",
+    "acol",
+    "makeColumn",
+    "makeVirtualColumn",
+    "vcol",
+]

{tigrbl-0.4.5.dev4 → tigrbl-0.4.5.dev6}/tigrbl/factories/engine.py

@@ -28,7 +28,7 @@ def engine_spec(
             kind = kw.get("kind")
             if not kind:
                 raise ValueError(
-                    "Provide spec=<DSN|mapping> or kind=('sqlite'|'postgres') with appropriate fields"
+                    "Provide spec=<DSN|mapping> or kind=('sqlite'|'postgres'|'mysql') with appropriate fields"
                 )
 
             async_kw = kw.get("async_")
@@ -69,8 +69,17 @@ def engine_spec(
                     "pool_size": kw.get("pool_size", 10),
                     "max": kw.get("max", 20),
                 }
+            elif kind in ("mariadb", "mysql"):
+                async_ = bool(async_kw) if async_kw is not None else False
+                spec = {
+                    "kind": kind, "async": async_,
+                    "user": kw.get("user", "app"), "pwd": kw.get("pwd", "secret"),
+                    "host": kw.get("host", "localhost"), "port": kw.get("port", 3306),
+                    "db": kw.get("name", kw.get("db", "app_db")),
+                    "pool_size": kw.get("pool_size", 10), "max": kw.get("max", 20),
+                }
             else:
-                raise ValueError("kind must be 'sqlite' or 'postgres'")
+                raise ValueError("kind must be 'sqlite', 'postgres', or 'mysql'")
 
     return EngineSpec.from_any(spec)
 
@@ -142,6 +151,26 @@ def pg_cfg(
     }
 
 
+def mysql_cfg(*, async_: bool = False, user: str = "app", pwd: str = "secret",
+              host: str = "localhost", port: int = 3306, name: str = "app_db",
+              pool_size: int = 10, max: int = 20) -> EngineCfg:
+    return {"kind": "mysql", "async": async_, "user": user, "pwd": pwd,
+            "host": host, "port": port, "db": name, "pool_size": pool_size, "max": max}
+
+
+def mariadb_cfg(*, async_: bool = False, user: str = "app", pwd: str = "secret",
+                 host: str = "localhost", port: int = 3306, name: str = "app_db",
+                 pool_size: int = 10, max: int = 20) -> EngineCfg:
+    return {"kind": "mariadb", "async": async_, "user": user, "pwd": pwd,
+            "host": host, "port": port, "db": name, "pool_size": pool_size, "max": max}
+
+
+def mariadb(**kw: Any) -> EngineCfg:
+    """Sync MariaDB EngineCfg (PyMySQL)."""
+    kw.setdefault("async_", False)
+    return mariadb_cfg(**kw)
+
+
 def mem(async_: bool = True) -> EngineCfg:
     """SQLite in-memory (StaticPool) EngineCfg mapping."""
     return {"kind": "sqlite", "async": async_, "mode": "memory"}
@@ -174,6 +203,12 @@ def pgs(**kw: Any) -> EngineCfg:
     return pg_cfg(**kw)
 
 
+def mysql(**kw: Any) -> EngineCfg:
+    """Sync MySQL EngineCfg (PyMySQL)."""
+    kw.setdefault("async_", False)
+    return mysql_cfg(**kw)
+
+
 # ---------------------------------------------------------------------------
 # Provider one-liners
 # ---------------------------------------------------------------------------
@@ -213,6 +248,14 @@ def provider_postgres(
     )
 
 
+def provider_mariadb(**kw: Any) -> Provider:
+    return provider_from_spec(engine_spec(mariadb_cfg(**kw)))
+
+
+def provider_mysql(**kw: Any) -> Provider:
+    return provider_from_spec(engine_spec(mysql_cfg(**kw)))
+
+
 __all__ = [
     # EngineSpec / Provider / Engine helpers
     "engine_spec",
@@ -221,13 +264,19 @@ __all__ = [
     # convenience EngineCfg helpers
     "sqlite_cfg",
     "pg_cfg",
+    "mysql_cfg",
+    "mariadb_cfg",
     "mem",
     "sqlitef",
     "pg",
     "pga",
     "pgs",
+    "mysql",
+    "mariadb",
     # direct providers
     "provider_sqlite_memory",
     "provider_sqlite_file",
     "provider_postgres",
+    "provider_mysql",
+    "provider_mariadb",
 ]

tigrbl-0.4.5.dev6/tigrbl/factories/op.py

@@ -0,0 +1,3 @@
+from tigrbl_concrete.factories.op import makeOp, op
+
+__all__ = ["makeOp", "op"]

tigrbl-0.4.5.dev6/tigrbl/factories/router.py

@@ -0,0 +1,3 @@
+from tigrbl_concrete.factories.router import defineRouterSpec, deriveRouter
+
+__all__ = ["defineRouterSpec", "deriveRouter"]

tigrbl-0.4.5.dev6/tigrbl/factories/table.py

@@ -0,0 +1,17 @@
+from tigrbl_concrete.factories.table import (
+    defineTableSpec,
+    deriveTable,
+    deriveTableSpec,
+    provideTableSpec,
+)
+from tigrbl_concrete.factories.activation import activateTableSpec, activateTableSpecs
+
+
+__all__ = [
+    "activateTableSpec",
+    "activateTableSpecs",
+    "defineTableSpec",
+    "deriveTable",
+    "deriveTableSpec",
+    "provideTableSpec",
+]