litedbmodel-runtime 2.0.2__tar.gz → 2.2.0__tar.gz

{litedbmodel_runtime-2.0.2 → litedbmodel_runtime-2.2.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: litedbmodel-runtime
-Version: 2.0.2
+Version: 2.2.0
 Summary: Thin multi-language runtime for litedbmodel v2 SCP makeSQL bundles (Python port). Executes the published static-makeSQL artifacts (a read ReadGraph = a bc surrogate ComponentGraphIR + per-node static statement templates, or a gate-first TransactionPlan) against a SQL driver — semantics-identical to the TS reference. Delegates the Expression-IR evaluation + map/Φ/wiring orchestration to behavior-contracts.
 Author: foo-ogawa
 License: MIT
 Keywords: orm,sql,ir,runtime,conformance,litedbmodel
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Requires-Dist: behavior-contracts==0.5.0
+Requires-Dist: behavior-contracts==0.11.17
 Provides-Extra: test
 Requires-Dist: pytest>=7.0; extra == "test"
 Provides-Extra: livedb

litedbmodel_runtime-2.2.0/litedbmodel_runtime/__init__.py

@@ -0,0 +1,253 @@
+"""litedbmodel v2 SCP — Python runtime (WS7b, #31).
+
+The Python leg of the multi-language SCP runtime. It interprets the language-neutral §8 published
+bundle (``SqlBundle``: sql text + fragment tree + closed-set Expression-IR param slots +
+transaction plan, dialect-tagged) and executes it against a SQL driver, semantics-identical to
+the TS reference (``src/scp``). The generic Expression-IR evaluation (SKIP guards, param slots)
+and the plan/map/wire/output orchestration are delegated to the shared common core
+``behavior-contracts`` (PyPI) — this package re-implements NO generic evaluator, only the
+SQL-backend concerns (render → bind → execute → assembly + gate-first transaction), exactly like
+the TS runtime.
+"""
+
+from __future__ import annotations
+
+from .dialect import SQLITE, POSTGRES, MYSQL, Dialect, dialect_for, to_dollar_placeholders
+from .driver import Driver, MysqlDriver, PostgresDriver, PreparedStatement, RunInfo, SqliteDriver, TxConnection
+from .errors import LimitExceededError, SqlFailure, check_find_hard_limit, map_sqlite_error
+from .exec_context import (
+    Connection,
+    ExecutionContext,
+    MiddlewareChain,
+    StatementIntent,
+    READ_INTENT,
+    WRITE_INTENT,
+    TxDecision,
+    ambient_in_transaction,
+    ambient_read_only,
+    as_context,
+    check_write_allowed_ambient,
+    commit,
+    context_for_driver,
+    current_context,
+    execute,
+    rollback,
+    run,
+    run_guarded,
+    run_with_pinned_context,
+    transaction,
+    with_transaction,
+    with_transaction_decided,
+)
+from .tx_options import (
+    IsolationLevel,
+    TransactionOptions,
+    WriteInReadOnlyContextError,
+    WriteOutsideTransactionError,
+    begin_statements,
+    check_write_allowed,
+    is_connection_error,
+    is_retryable_tx_error,
+    isolation_prelude,
+)
+from .middleware import (
+    LogEntry,
+    Logger,
+    METHOD_KINDS,
+    MethodKind,
+    MiddlewareConfig,
+    MiddlewareDescriptor,
+    MiddlewareHandle,
+    RawResult,
+    Registry,
+    SqlHook,
+    active_sql_middlewares,
+    clear_middlewares,
+    create_middleware,
+    current_registry,
+    raw_execute,
+    raw_query,
+    register,
+    register_middleware,
+    run_method,
+    use,
+    with_middleware_scope,
+)
+from .connection_routing import (
+    DEFAULT_CONNECTION,
+    ConfiguredPool,
+    ConnectionConfig,
+    ConnectionPool,
+    ConnectionRegistry,
+    ConnectionRegistryBuilder,
+    ConnectionSetup,
+    PoolConnection,
+    RawConnectionPool,
+    ReaderWriterPools,
+    ResolvedConnectionConfig,
+    RoutingConfig,
+    WriterStickyClock,
+    build_routing_config,
+    close_all_pools,
+    configured_pool,
+    in_writer_scope,
+    mysql_pool_factory,
+    pg_pool_factory,
+    reader_writer_pair,
+    resolve_connection_config,
+    resolve_pool,
+    routed_begin_tx,
+    session_reset_statements,
+    session_statements,
+    single_pool_pair,
+    with_writer,
+)
+from .static_bundle import (
+    assemble_make_sql,
+    compose_make_sql,
+    execute_read_graph,
+    render_placeholders,
+    render_read_primary,
+    render_statements,
+)
+from .runtime import (
+    ENTITY_ROOT,
+    execute_bundle,
+    execute_transaction_bundle,
+    order_by_nulls,
+)
+from .relation import (
+    dedupe_keys,
+    distribute_to_parent,
+    read_bundle,
+    run_relation_op,
+)
+from .leaves import make_handlers
+
+__version__ = "2.2.0"
+
+__all__ = [
+    "__version__",
+    # dialect
+    "SQLITE",
+    "POSTGRES",
+    "MYSQL",
+    "Dialect",
+    "dialect_for",
+    "to_dollar_placeholders",
+    # driver seam
+    "Driver",
+    "PreparedStatement",
+    "RunInfo",
+    "SqliteDriver",
+    "PostgresDriver",
+    "MysqlDriver",
+    "TxConnection",
+    # errors
+    "SqlFailure",
+    "LimitExceededError",
+    "check_find_hard_limit",
+    "map_sqlite_error",
+    # ExecutionContext + central execute/run seam (Phase A / #78)
+    "Connection",
+    "ExecutionContext",
+    "MiddlewareChain",
+    "StatementIntent",
+    "READ_INTENT",
+    "WRITE_INTENT",
+    "TxDecision",
+    "ambient_in_transaction",
+    "ambient_read_only",
+    "as_context",
+    "check_write_allowed_ambient",
+    "commit",
+    "context_for_driver",
+    "current_context",
+    "execute",
+    "rollback",
+    "run",
+    "run_guarded",
+    "run_with_pinned_context",
+    "transaction",
+    "with_transaction",
+    "with_transaction_decided",
+    # middleware layer (Phase D / #95)
+    "LogEntry",
+    "Logger",
+    "METHOD_KINDS",
+    "MethodKind",
+    "MiddlewareConfig",
+    "MiddlewareDescriptor",
+    "MiddlewareHandle",
+    "RawResult",
+    "Registry",
+    "SqlHook",
+    "active_sql_middlewares",
+    "clear_middlewares",
+    "create_middleware",
+    "current_registry",
+    "raw_execute",
+    "raw_query",
+    "register",
+    "register_middleware",
+    "run_method",
+    "use",
+    "with_middleware_scope",
+    # tx-completeness primitives (Phase B / #84)
+    "IsolationLevel",
+    "TransactionOptions",
+    "WriteOutsideTransactionError",
+    "WriteInReadOnlyContextError",
+    "begin_statements",
+    "check_write_allowed",
+    "is_connection_error",
+    "is_retryable_tx_error",
+    "isolation_prelude",
+    # connection routing + config (Phase C / #90)
+    "DEFAULT_CONNECTION",
+    "ConfiguredPool",
+    "ConnectionConfig",
+    "ConnectionPool",
+    "ConnectionRegistry",
+    "ConnectionRegistryBuilder",
+    "ConnectionSetup",
+    "PoolConnection",
+    "RawConnectionPool",
+    "ReaderWriterPools",
+    "ResolvedConnectionConfig",
+    "RoutingConfig",
+    "WriterStickyClock",
+    "build_routing_config",
+    "close_all_pools",
+    "configured_pool",
+    "in_writer_scope",
+    "mysql_pool_factory",
+    "pg_pool_factory",
+    "reader_writer_pair",
+    "resolve_connection_config",
+    "resolve_pool",
+    "routed_begin_tx",
+    "session_reset_statements",
+    "session_statements",
+    "single_pool_pair",
+    "with_writer",
+    # static makeSQL bundle runtime (the sole read/render path)
+    "assemble_make_sql",
+    "compose_make_sql",
+    "execute_read_graph",
+    "render_placeholders",
+    "render_read_primary",
+    "render_statements",
+    # runtime
+    "ENTITY_ROOT",
+    "execute_bundle",
+    "execute_transaction_bundle",
+    "order_by_nulls",
+    # read-relation batch execution + hydration (#43)
+    "dedupe_keys",
+    "distribute_to_parent",
+    "read_bundle",
+    "run_relation_op",
+    # op-agnostic leaf transport for the bc-generated native (ir-exec) modules (#141 / epic #123)
+    "make_handlers",
+]