sqlmodel-ext 0.3.3__tar.gz → 0.3.4__tar.gz

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlmodel-ext
-Version: 0.3.3
+Version: 0.3.4
 Summary: Extended SQLModel infrastructure: smart metaclass, async CRUD mixins, polymorphic inheritance, optimistic locking, relation preloading, and reusable field types.
 Project-URL: Homepage, https://github.com/Foxerine/sqlmodel-ext
 Project-URL: Repository, https://github.com/Foxerine/sqlmodel-ext

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/docs/en/index.md

@@ -34,3 +34,12 @@ features:
   - title: Safe & Reliable
     details: Optimistic locking for concurrency control, @requires_relations to prevent MissingGreenlet, and AST static analysis at startup
 ---
+
+## Design orientation
+
+sqlmodel-ext is not a new ORM. It is a set of **opt-in Mixins** layered on top of SQLModel / Pydantic v2 / SQLAlchemy 2.0. The library only introduces two kinds of machinery:
+
+- **Metaclass enhancements** — automatic SQLAlchemy column setup driven by `Annotated` type hints, `mapper_args` merging, on-demand `*UpdateRequest` DTO generation, attribute-docstring inheritance, and a Python 3.14 (PEP 649) compatibility patch.
+- **Composable Mixins** — `TableBaseMixin` (async CRUD), `PolymorphicBaseMixin` (JTI/STI), `OptimisticLockMixin` (version-column concurrency), `RelationPreloadMixin` (eager loading), `CachedTableBaseMixin` (Redis two-tier cache). Each Mixin stands alone and has no hard dependency on the others.
+
+The underlying `Session`, `select()`, query construction, and migration tooling remain native SQLAlchemy — there is no custom DSL, and the library does not take over `engine` / `session` lifecycle. In practice that means you can drop a single Mixin into an existing SQLModel/SQLAlchemy project without rewriting your data-access layer.

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/docs/en/reference/field-types.md

@@ -33,7 +33,7 @@ from sqlmodel_ext import Str16, Str24, Str32, Str36, Str48, Str64, Str100, Str12
 ## Text constraints
 
 ```python
-from sqlmodel_ext import Text1K, Text1024, Text2K, Text2500, Text3K, Text5K, Text10K, Text32K, Text60K, Text64K, Text100K, Text1M
+from sqlmodel_ext import Text1K, Text1024, Text2K, Text2500, Text3K, Text5K, Text10K, Text16K, Text32K, Text60K, Text64K, Text100K, Text128K, Text1M
 ```
 
 | Type | `max_length` |
@@ -45,10 +45,12 @@ from sqlmodel_ext import Text1K, Text1024, Text2K, Text2500, Text3K, Text5K, Tex
 | `Text3K` | 3000 |
 | `Text5K` | 5000 |
 | `Text10K` | 10000 |
+| `Text16K` | 16000 |
 | `Text32K` | 32000 |
 | `Text60K` | 60000 |
 | `Text64K` | 65536 |
 | `Text100K` | 100000 |
+| `Text128K` | 131072 (= 128 × 1024) |
 | `Text1M` | 1000000 |
 
 ## Numeric constraints

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/docs/en/tutorials/01-getting-started.md

@@ -8,7 +8,7 @@ This is your first conversation with sqlmodel-ext. In 15 minutes you'll have:
 - A clear mental model for "model + Mixin = table"
 
 ::: tip You don't need prior SQLAlchemy or SQLModel experience
-This tutorial introduces those concepts on demand. You only need Python 3.10+ and basic `async` / `await` knowledge. If you've never touched an ORM, skim [Prerequisites](/en/explanation/prerequisites) first.
+This tutorial introduces those concepts on demand. You only need Python 3.12+ and basic `async` / `await` knowledge. If you've never touched an ORM, skim [Prerequisites](/en/explanation/prerequisites) first.
 :::
 
 ## 0. Set up the environment

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/docs/en/tutorials/index.md

@@ -25,7 +25,7 @@ Tutorials don't **exhaustively cover the API**. If a feature you need is missing
 
 All tutorials assume you know:
 
-- Python 3.10+
+- Python 3.12+ (3.12 / 3.13 / 3.14 are all exercised in CI)
 - Basic `async` / `await` syntax
 - What SELECT / INSERT / UPDATE / DELETE do in SQL
 

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/docs/index.md

@@ -34,3 +34,12 @@ features:
   - title: 安全与可靠
     details: 乐观锁并发控制、@requires_relations 防止 MissingGreenlet、启动时 AST 静态分析
 ---
+
+## 设计取向
+
+sqlmodel-ext 不是新的 ORM，而是构建在 SQLModel / Pydantic v2 / SQLAlchemy 2.0 之上的一组**可单独取用的 Mixin**。库本身只引入两类东西：
+
+- **元类增强**——根据 `Annotated` 类型注解自动设置 SQLAlchemy 列、合并 `mapper_args`、按需生成 `*UpdateRequest` DTO、保留属性 docstring，并打上 Python 3.14 (PEP 649) 兼容补丁。
+- **可插拔 Mixin**——`TableBaseMixin`（异步 CRUD）、`PolymorphicBaseMixin`（JTI/STI）、`OptimisticLockMixin`（版本号并发）、`RelationPreloadMixin`（关系预加载）、`CachedTableBaseMixin`（Redis 双层缓存）。每个 Mixin 都可以独立使用，不互相依赖。
+
+底层 `Session`、`select()`、查询构造、迁移工具仍是原生 SQLAlchemy，没有自创 DSL，也不接管 `engine`/`session` 的生命周期。换句话说：在已有 SQLModel/SQLAlchemy 项目里，可以单独引入需要的 Mixin，而不必重写既有数据访问层。

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/docs/reference/field-types.md

@@ -33,7 +33,7 @@ from sqlmodel_ext import Str16, Str24, Str32, Str36, Str48, Str64, Str100, Str12
 ## 文本约束
 
 ```python
-from sqlmodel_ext import Text1K, Text1024, Text2K, Text2500, Text3K, Text5K, Text10K, Text32K, Text60K, Text64K, Text100K, Text1M
+from sqlmodel_ext import Text1K, Text1024, Text2K, Text2500, Text3K, Text5K, Text10K, Text16K, Text32K, Text60K, Text64K, Text100K, Text128K, Text1M
 ```
 
 | 类型 | `max_length` |
@@ -45,10 +45,12 @@ from sqlmodel_ext import Text1K, Text1024, Text2K, Text2500, Text3K, Text5K, Tex
 | `Text3K` | 3000 |
 | `Text5K` | 5000 |
 | `Text10K` | 10000 |
+| `Text16K` | 16000 |
 | `Text32K` | 32000 |
 | `Text60K` | 60000 |
 | `Text64K` | 65536 |
 | `Text100K` | 100000 |
+| `Text128K` | 131072（= 128 × 1024） |
 | `Text1M` | 1000000 |
 
 ## 数值约束

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/docs/tutorials/01-getting-started.md

@@ -8,7 +8,7 @@
 - 理解"模型 + Mixin = 表"这个核心范式
 
 ::: tip 不需要事先懂 SQLAlchemy 或 SQLModel
-本教程会按需引入这些概念。你只需要 Python 3.10+ 和基本的 `async` / `await` 知识。如果你完全没接触过 ORM，建议在开始之前先扫一眼 [前置知识](/explanation/prerequisites)。
+本教程会按需引入这些概念。你只需要 Python 3.12+ 和基本的 `async` / `await` 知识。如果你完全没接触过 ORM，建议在开始之前先扫一眼 [前置知识](/explanation/prerequisites)。
 :::
 
 ## 0. 准备环境

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/docs/tutorials/index.md

@@ -25,7 +25,7 @@
 
 所有教程假设你具备：
 
-- Python 3.10+
+- Python 3.12+（3.12 / 3.13 / 3.14 均在 CI 中受测）
 - 基本的 `async` / `await` 语法
 - 知道 SQL 的 SELECT / INSERT / UPDATE / DELETE 是什么
 

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sqlmodel-ext"
-version = "0.3.3"
+version = "0.3.4"
 description = "Extended SQLModel infrastructure: smart metaclass, async CRUD mixins, polymorphic inheritance, optimistic locking, relation preloading, and reusable field types."
 readme = "README.md"
 license = "MIT"

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/src/sqlmodel_ext/__init__.py

@@ -20,7 +20,7 @@ Quick start::
     user = await user.save(session)
     users = await User.get(session, fetch_mode="all")
 """
-__version__ = "0.3.3"
+__version__ = "0.3.4"
 
 # Base
 from sqlmodel_ext.base import SQLModelBase, ExtraIgnoreModelBase
@@ -94,10 +94,12 @@ from sqlmodel_ext.field_types import (
     Text3K,
     Text5K,
     Text10K,
+    Text16K,
     Text32K,
     Text60K,
     Text64K,
     Text100K,
+    Text128K,
     Text1M,
     # Numeric constraints
     INT32_MAX,

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/tests/test_smoke_imports.py

@@ -59,8 +59,35 @@ def test_toplevel_import() -> None:
         # Field types - path/string/numeric/custom
         "DirectoryPathType",
         "FilePathType",
+        # Str ladder (whole range — guards against export drift)
+        "Str16",
+        "Str24",
+        "Str32",
+        "Str36",
+        "Str48",
+        "Str64",
+        "Str100",
+        "Str128",
+        "Str255",
         "Str256",
+        "Str500",
+        "Str512",
+        "Str2048",
+        # Text ladder (whole range — guards against export drift)
         "Text1K",
+        "Text1024",
+        "Text2K",
+        "Text2500",
+        "Text3K",
+        "Text5K",
+        "Text10K",
+        "Text16K",
+        "Text32K",
+        "Text60K",
+        "Text64K",
+        "Text100K",
+        "Text128K",
+        "Text1M",
         "Port",
         "Percentage",
         "PositiveInt",

{sqlmodel_ext-0.3.3 → sqlmodel_ext-0.3.4}/uv.lock

@@ -500,7 +500,7 @@ wheels = [
 
 [[package]]
 name = "sqlmodel-ext"
-version = "0.3.2"
+version = "0.3.4"
 source = { editable = "." }
 dependencies = [
     { name = "pydantic" },