lush-sqlalchemyx 0.3.0__tar.gz → 0.3.1__tar.gz

{lush_sqlalchemyx-0.3.0 → lush_sqlalchemyx-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: lush-sqlalchemyx
-Version: 0.3.0
+Version: 0.3.1
 Summary: SQLAlchemy helpers (DAL) and async MySQL managers, with some web frameworks integrations
 Author: straydragon
 Author-email: straydragon <straydragonl@foxmail.com>

{lush_sqlalchemyx-0.3.0 → lush_sqlalchemyx-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lush-sqlalchemyx"
-version = "0.3.0"
+version = "0.3.1"
 description = "SQLAlchemy helpers (DAL) and async MySQL managers, with some web frameworks integrations"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -304,3 +304,8 @@ reportUnknownArgumentType = false
 
 [[tool.basedpyright.executionEnvironments]]
 root = "src"
+
+[[tool.basedpyright.executionEnvironments]]
+root = "examples"
+# examples 作为下游类型检查 SSOT, 仅继承全局设置, 不做额外放宽.
+# 如果此处报错, 说明库的类型变更破坏了合法下游用法.

{lush_sqlalchemyx-0.3.0 → lush_sqlalchemyx-0.3.1}/src/lush_sqlalchemyx/base/dal/_async.py

@@ -121,7 +121,8 @@ async def async_temp_set_lock_wait_timeout(
 # Async Table bases
 # ---------------------------------------------------------------------------
 
-AsyncSQLATableT = TypeVar("AsyncSQLATableT", bound="AsyncSqlATableBase")
+# 隐含约束: AsyncSQLATableT 应为 AsyncSqlATableBase (AsyncAttrs + DeclarativeBase) 子类.
+AsyncSQLATableT = TypeVar("AsyncSQLATableT")
 
 
 class AsyncSqlATableBase(AsyncAttrs, DeclarativeBase):

{lush_sqlalchemyx-0.3.0 → lush_sqlalchemyx-0.3.1}/src/lush_sqlalchemyx/base/dal/_common.py

@@ -21,7 +21,7 @@ from lush_dal_protocol.dto import DTOModelT as DTOModelT  # noqa: PLC0414
 from pydantic import BaseModel, ConfigDict, Field
 from sqlalchemy import event as sa_event
 from sqlalchemy.exc import OperationalError as SQLAlchemyOperationalError
-from sqlalchemy.orm import DeclarativeBase, Mapped, ORMExecuteState, mapped_column, with_loader_criteria
+from sqlalchemy.orm import Mapped, ORMExecuteState, mapped_column, with_loader_criteria
 from sqlalchemy.orm import Session as SyncSession
 
 READONLY_SESSION_FLAG: Final[str] = "__lush_sqlalchemyx__readonly_session__"
@@ -139,7 +139,10 @@ DEFAULT_RETRY_CONFIG = RetryConfig(max_attempts=3, initial_delay=0.1, max_delay=
 # Pydantic CU / DTO models
 # ---------------------------------------------------------------------------
 
-SQLATableT = TypeVar("SQLATableT", bound=DeclarativeBase)
+# 隐含约束: SQLATableT 应为 SQLAlchemy DeclarativeBase 子类 (含 Flask-SQLAlchemy db.Model).
+# 不设 bound 是因为 Flask-SQLAlchemy 的 db.Model 运行时继承 DeclarativeBase,
+# 但静态类型系统看不到该链路, bound 会误拦合法下游.
+SQLATableT = TypeVar("SQLATableT")
 
 
 class BaseCU(_ProtocolBaseCU[SQLATableT]):

{lush_sqlalchemyx-0.3.0 → lush_sqlalchemyx-0.3.1}/src/lush_sqlalchemyx/base/dal/_sync.py

@@ -115,7 +115,8 @@ def sync_temp_set_lock_wait_timeout(
 # Sync Table bases
 # ---------------------------------------------------------------------------
 
-SyncSQLATableT = TypeVar("SyncSQLATableT", bound=DeclarativeBase)
+# 隐含约束: SyncSQLATableT 应为 DeclarativeBase 子类 (含 Flask-SQLAlchemy db.Model).
+SyncSQLATableT = TypeVar("SyncSQLATableT")
 
 
 class SyncSqlATableBase(DeclarativeBase):