springbootAI 2.2.1__tar.gz → 2.2.3__tar.gz

{springbootai-2.2.1 → springbootai-2.2.3}/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [2.2.3] - 2026-08-13
+
+### 新增
+
+- ORM 实体字段自动推断：类型注解无需显式 `= Column(...)` 赋值，对齐 Java JPA 字段自动映射。
+  - `name: str` → 自动创建 `Column(default=None)`
+  - `name: str = ""` → 自动创建 `Column(default="")`
+  - `name: int = 0` → 自动创建 `Column(default=0)`
+  - 已有 `Column()`/`Id()`/`CreateTime()` 等描述符的字段保留不覆盖
+  - 以 `_` 开头的私有字段自动跳过
+
+  ```python
+  @Entity
+  @Table(name="sys_user", comment="用户表")
+  class User:
+      id: int = Id()
+      username: str = ""               # 自动推断 Column(default="")
+      display_name: str = "系统管理员"  # 自动推断 Column(default="系统管理员")
+      enabled: bool = True             # 自动推断 Column(default=True)
+      _cache: dict = {}                # 私有字段，跳过
+  ```
+
+- `_parse_entity` 跳过以 `_` 开头的私有字段，不生成 DDL 列。
+
+## [2.2.2] - 2026-08-13
+
+### 新增
+
+- ORM `@Entity` / `@Table` 注解对齐 Java JPA 分离风格，支持三种写法（均向后兼容）：
+
+  | 写法 | 说明 | 对齐 Java |
+  |------|------|-----------|
+  | `@Entity` + `@Table(...)` | 分离风格（推荐） | `@Entity` + `@Table` |
+  | `@Entity` 无括号 | 表名自动推导为 snake_case | `@Entity`（无 `@Table`） |
+  | `@Entity("name", ...)` | 一体化风格（完全兼容） | 原有写法不变 |
+
+- `Table` 类新增 `__call__`，可直接作为类装饰器使用（`@Table(name=..., indexes=[...], comment=...)`）。
+- `@Entity` 支持无括号形式（`@Entity`），检测到已有 `@Table` 时不覆盖表元数据。
+- 提取 `_auto_generate_init` 辅助函数，消除 `Entity` 与 `Table.__call__` 间的重复代码。
+
 ## [2.2.1] - 2026-08-13
 
 ### 修复

{springbootai-2.2.1/springbootAI.egg-info → springbootai-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 2.2.1
+Version: 2.2.3
 Summary: Spring-style Python framework with Web, ORM, Cloud and AI integrations
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT

{springbootai-2.2.1 → springbootai-2.2.3}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
 [project]
 # 发行名 springbootAI（PyPI 包名，pip install springbootAI）；导入包名仍为 spring
 name = "springbootAI"
-version = "2.2.1"
+version = "2.2.3"
 description = "Spring-style Python framework with Web, ORM, Cloud and AI integrations"
 readme = "README.md"
 license = "MIT"

{springbootai-2.2.1 → springbootai-2.2.3}/spring/orm/ddl_auto.py

@@ -244,12 +244,47 @@ class Transient:
 
 
 class Table:
-    """表注解"""
+    """``@Table`` 表注解（对齐 JPA ``javax.persistence.Table``）。
+
+    既可作为元数据类使用（内部 ``EntityTable`` 解析），也可直接作为类装饰器使用。
+    作为装饰器时等价于 JPA 的 ``@Table``，与 ``@Entity`` 组合使用::
+
+        @Entity
+        @Table(name="sys_user", indexes=[Index("idx_name", ["name"])], comment="用户表")
+        class User:
+            id: int = Id()
+            name: str = Column(length=50)
+
+    也可单独使用（隐含 ``@Entity`` 语义，与 ``@Entity("sys_user")`` 等价）::
+
+        @Table(name="sys_user", comment="用户表")
+        class User:
+            id: int = Id()
+    """
     def __init__(self, name: str = "", indexes: List['Index'] = None, comment: str = ""):
         self.name = name
         self.indexes = indexes or []
         self.comment = comment
 
+    def __call__(self, cls):
+        """装饰器形式：将表元数据挂载到类上并标记为实体，返回类本身。
+
+        装饰器应用顺序（Python 底向上）::
+
+            @Entity          # 外层，后执行
+            @Table(...)      # 内层，先执行
+            class User: ...
+
+        ``@Table`` 先设置 ``__table__`` 与 ``__entity__``，随后 ``@Entity``
+        检测到已有 ``__table__`` 则不覆盖。
+        """
+        if not self.name:
+            self.name = _camel_to_snake(cls.__name__)
+        setattr(cls, '__table__', self)
+        setattr(cls, '__entity__', True)
+        _auto_generate_init(cls)
+        return cls
+
 
 class Index:
     """索引定义"""
@@ -509,6 +544,9 @@ class DdlAutoManager:
                 # @Transient 字段不持久化，跳过
                 if _is_transient_field(cls, attr_name):
                     continue
+                # 私有字段（以 _ 开头）不持久化，跳过
+                if attr_name.startswith('_'):
+                    continue
                 py_type = init_hints.get(attr_name) or cls_annotations.get(attr_name)
                 # 解包 Optional[X]：Python 3.10 的 get_type_hints 会把带 None 默认值的
                 # 参数注解自动包装为 Optional[X]，3.11+ 不再包装。此处统一解包为承载类型，
@@ -1046,43 +1084,146 @@ class DdlAutoManager:
 
 # ==================== 装饰器API（便捷使用） ====================
 
-def Entity(table_name: str = "", indexes: List[Index] = None, comment: str = ""):
+def _auto_infer_columns(cls):
+    """扫描类型注解，为未显式赋 ``Column`` 描述符的字段自动创建 ``Column`` 实例。
+
+    对齐 Java JPA：实体类中所有非 ``@Transient`` 字段自动映射为数据库列，
+    无需显式 ``= Column(...)`` 赋值。
+
+    推断规则：
+      - ``name: str``               → ``Column(default=None)``
+      - ``name: str = ""``          → ``Column(default="")``
+      - ``name: int = 0``           → ``Column(default=0)``
+      - ``name: str = Column(...)`` → 保留原 Column，不覆盖
+      - ``name: int = Id()``        → 保留原 Id，不覆盖
+      - 以 ``_`` 开头的字段         → 跳过（私有/内部字段）
+      - ``@Transient`` 标记字段      → 跳过
     """
-    @Entity 装饰器，标注一个类为JPA风格的实体类
-    
-    Usage:
-        @Entity("sys_user")
+    # 收集 MRO 中所有类型注解
+    all_annotations = {}
+    for cls_base in reversed(cls.__mro__):
+        base_anns = getattr(cls_base, '__annotations__', {})
+        all_annotations.update(base_anns)
+
+    for attr_name in all_annotations:
+        # 跳过私有字段
+        if attr_name.startswith('_'):
+            continue
+        # 跳过 @Transient 字段
+        if _is_transient_field(cls, attr_name):
+            continue
+
+        # 查找 MRO 中最近的类属性值
+        existing = None
+        for cls_base in cls.__mro__:
+            if attr_name in cls_base.__dict__:
+                existing = cls_base.__dict__[attr_name]
+                break
+
+        # 已有 Column/Id/Version/CreateTime/UpdateTime 描述符，不覆盖
+        if isinstance(existing, Column):
+            continue
+        # 已有 @column 装饰器标记
+        if hasattr(existing, '__column__'):
+            continue
+        # 已有 Transient 标记
+        if isinstance(existing, Transient):
+            continue
+
+        # 推断默认值：非 None 的类属性值作为 Column default
+        default_val = None
+        if existing is not None and not callable(existing) \
+                and not isinstance(existing, (classmethod, staticmethod)):
+            default_val = existing
+
+        # 创建 Column 描述符并挂到类上
+        setattr(cls, attr_name, Column(default=default_val))
+
+
+def _auto_generate_init(cls):
+    """为描述符风格实体类自动生成 ``__init__``（若类未显式声明）。
+
+    先调用 ``_auto_infer_columns`` 补全类型注解对应的 ``Column`` 描述符，
+    再扫描 MRO 中所有 ``Column`` 实例属性，生成关键字构造器。
+    若类已显式声明 ``__init__`` 则跳过，保持兼容。
+    """
+    # 无论是否有自定义 __init__，都先补全 Column 描述符（DDL 解析依赖）
+    _auto_infer_columns(cls)
+
+    if '__init__' in cls.__dict__:
+        return
+    fields = {}
+    for cls_base in reversed(cls.__mro__):
+        for name, value in cls_base.__dict__.items():
+            if isinstance(value, Column):
+                fields[name] = value
+
+    def __init__(self, **values):
+        unknown = set(values) - set(fields)
+        if unknown:
+            names = ', '.join(sorted(unknown))
+            raise TypeError(f"Unexpected entity field(s): {names}")
+        for name, column in fields.items():
+            setattr(self, name, values.get(name, column.default))
+
+    cls.__init__ = __init__
+
+
+def Entity(table_name: str = "", indexes: List[Index] = None, comment: str = ""):
+    """``@Entity`` 装饰器，标注一个类为 JPA 风格的实体类。
+
+    三种用法（均向后兼容）：
+
+    1. **Java JPA 风格**（``@Entity`` + ``@Table`` 分离，推荐）::
+
+        @Entity
+        @Table(name="sys_user", indexes=[Index("idx_name", ["name"])], comment="用户表")
         class User:
-            def __init__(self, id: int = None, username: str = "", email: str = ""):
-                self.id = id
-                self.username = username
-                self.email = email
+            id: int = Id()
+            name: str = Column(length=50)
+
+    2. **简化风格**（仅 ``@Entity``，表名自动推导为类名 snake_case）::
+
+        @Entity
+        class User:
+            id: int = Id()
+            name: str = Column(length=50)
+        # 表名自动推导为 "user"
+
+    3. **一体化风格**（当前写法，完全兼容）::
+
+        @Entity("sys_user", indexes=[...], comment="用户表")
+        class User:
+            id: int = Id()
+            name: str = Column(length=50)
     """
-    t = Table(name=table_name, indexes=indexes, comment=comment)
-    def decorator(cls):
+    # 支持 @Entity 无括号形式：直接接收类
+    if inspect.isclass(table_name):
+        cls = table_name
         setattr(cls, '__entity__', True)
-        setattr(cls, '__table__', t)
-        if not table_name:
-            t.name = _camel_to_snake(cls.__name__)
+        # 未显式指定表信息时，不覆盖已有 @Table 设置的 __table__
+        existing = getattr(cls, '__table__', None)
+        if not isinstance(existing, Table):
+            setattr(cls, '__table__', Table(name=_camel_to_snake(cls.__name__)))
+        _auto_generate_init(cls)
+        return cls
 
-        # Descriptor-style entities do not need repetitive constructors.
-        # Keep an explicitly declared __init__ unchanged for compatibility.
-        if '__init__' not in cls.__dict__:
-            fields = {}
-            for cls_base in reversed(cls.__mro__):
-                for name, value in cls_base.__dict__.items():
-                    if isinstance(value, Column):
-                        fields[name] = value
-
-            def __init__(self, **values):
-                unknown = set(values) - set(fields)
-                if unknown:
-                    names = ', '.join(sorted(unknown))
-                    raise TypeError(f"Unexpected entity field(s): {names}")
-                for name, column in fields.items():
-                    setattr(self, name, values.get(name, column.default))
-
-            cls.__init__ = __init__
+    # @Entity("table_name", ...) 或 @Entity() 形式
+    has_explicit_meta = bool(table_name or indexes or comment)
+    t = Table(name=table_name, indexes=indexes, comment=comment) if has_explicit_meta else None
+
+    def decorator(cls):
+        setattr(cls, '__entity__', True)
+        if t is not None:
+            if not t.name:
+                t.name = _camel_to_snake(cls.__name__)
+            setattr(cls, '__table__', t)
+        else:
+            # 无显式表信息：不覆盖已有 @Table 设置
+            existing = getattr(cls, '__table__', None)
+            if not isinstance(existing, Table):
+                setattr(cls, '__table__', Table(name=_camel_to_snake(cls.__name__)))
+        _auto_generate_init(cls)
         return cls
     return decorator
 

{springbootai-2.2.1 → springbootai-2.2.3}/spring/orm/pymybatis/version.py

@@ -2,7 +2,7 @@
 PyMyBatis版本信息
 """
 
-__version__ = '2.2.1'
+__version__ = '2.2.3'
 __author__ = 'PyMyBatis Team'
 __email__ = 'dev@pymybatis.org'
 __license__ = 'MIT'

{springbootai-2.2.1 → springbootai-2.2.3/springbootAI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 2.2.1
+Version: 2.2.3
 Summary: Spring-style Python framework with Web, ORM, Cloud and AI integrations
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT