aury-boot 0.0.2__py3-none-any.whl → 0.0.3__py3-none-any.whl

aury/boot/__init__.py

@@ -0,0 +1,66 @@
+"""Aury Boot - 核心基础架构工具包。
+
+提供数据库、缓存、认证等核心基础设施功能。
+
+模块结构：
+- common: 最基础层（异常基类、日志系统、国际化）
+- domain: 领域层（业务模型、仓储接口、服务基类、分页、事务管理）
+- infrastructure: 基础设施层（外部依赖的实现：数据库、缓存、存储、调度器等）
+- application: 应用层（配置管理、RPC通信、依赖注入、事务管理、事件系统、迁移管理、API接口）
+- toolkit: 工具包（通用工具函数）
+- testing: 测试框架（测试基类、测试客户端、数据工厂）
+
+使用方式：
+    from aury.boot import application
+    from aury.boot.domain.models import Model
+"""
+
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING
+
+# 版本号由 hatch-vcs 自动生成
+try:
+    from ._version import __version__
+except ImportError:
+    __version__ = "0.0.0.dev0"
+
+# 延迟导入：子模块仅在被访问时才加载
+_SUBMODULES = {
+    "application",
+    "common",
+    "domain",
+    "infrastructure",
+    "toolkit",
+    "testing",
+}
+
+
+def __getattr__(name: str):
+    """延迟导入子模块。"""
+    if name in _SUBMODULES:
+        try:
+            return importlib.import_module(f".{name}", __name__)
+        except ImportError:
+            if name == "testing":
+                # testing 模块可能在生产环境不可用
+                return None
+            raise
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__():
+    """返回可用属性列表。"""
+    return list(_SUBMODULES) + ["__version__"]
+
+
+__all__ = [
+    "__version__",
+    "application",
+    "common",
+    "domain",
+    "infrastructure",
+    "toolkit",
+    "testing",
+]

aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.2'
-__version_tuple__ = version_tuple = (0, 0, 2)
+__version__ = version = '0.0.3'
+__version_tuple__ = version_tuple = (0, 0, 3)
 
 __commit_id__ = commit_id = None

aury/boot/application/__init__.py

@@ -0,0 +1,120 @@
+"""应用层模块。
+
+提供用例编排、配置管理、RPC通信、依赖注入、事务管理和事件系统。
+"""
+
+# 事件系统（从 infrastructure 导入 - Event 定义在最底层）
+# 事务管理（从 domain 导入）
+from aury.boot.domain.transaction import (
+    TransactionManager,
+    TransactionRequiredError,
+    ensure_transaction,
+    transactional,
+    transactional_context,
+)
+
+# 依赖注入容器（从 infrastructure 导入）
+from aury.boot.infrastructure.di import Container, Lifetime, Scope, ServiceDescriptor
+from aury.boot.infrastructure.events import (
+    Event,
+    EventBus,
+    EventConsumer,
+    EventLoggingMiddleware,
+    EventMiddleware,
+)
+
+from . import interfaces, rpc
+
+# 应用框架、中间件和组件系统
+from .app import (
+    CacheComponent,
+    Component,
+    CORSMiddleware,
+    DatabaseComponent,
+    FoundationApp,
+    Middleware,
+    MigrationComponent,
+    RequestLoggingMiddleware,
+    SchedulerComponent,
+    TaskComponent,
+)
+from .config import (
+    BaseConfig,
+    CacheSettings,
+    CORSSettings,
+    LogSettings,
+    ServerSettings,
+)
+from .constants import ComponentName, MiddlewareName, SchedulerMode, ServiceType
+
+# HTTP 中间件装饰器
+from .middleware import (
+    log_request,
+)
+
+# 迁移管理
+from .migrations import MigrationManager
+
+# 调度器启动器
+from .scheduler import run_scheduler, run_scheduler_sync
+
+# 服务器集成
+from .server import ApplicationServer, run_app
+
+__all__ = [
+    # 配置
+    "BaseConfig",
+    "CORSSettings",
+    "CacheSettings",
+    "LogSettings",
+    "ServerSettings",
+    # 常量
+    "ComponentName",
+    "MiddlewareName",
+    "SchedulerMode",
+    "ServiceType",
+    # 应用框架
+    "FoundationApp",
+    # 基类
+    "Component",
+    "Middleware",
+    # 中间件
+    "CORSMiddleware",
+    "RequestLoggingMiddleware",
+    # 组件
+    "CacheComponent",
+    "DatabaseComponent",
+    "MigrationComponent",
+    "SchedulerComponent",
+    "TaskComponent",
+    # 依赖注入容器
+    "Container",
+    "Lifetime",
+    "Scope",
+    "ServiceDescriptor",
+    # 事件系统
+    "Event",
+    "EventBus",
+    "EventConsumer",
+    "EventLoggingMiddleware",
+    "EventMiddleware",
+    # 迁移
+    "MigrationManager",
+    # HTTP 中间件装饰器
+    "log_request",
+    # 事务管理
+    "TransactionManager",
+    "TransactionRequiredError",
+    "ensure_transaction",
+    "transactional",
+    "transactional_context",
+    # RPC通信
+    "rpc",
+    # 调度器启动器
+    "run_scheduler",
+    "run_scheduler_sync",
+    # 服务器集成
+    "ApplicationServer",
+    "run_app",
+]
+

aury/boot/application/app/__init__.py

@@ -0,0 +1,39 @@
+"""应用框架模块。
+
+提供 FoundationApp、Middleware 和 Component 系统。
+"""
+
+from .base import Component, FoundationApp, Middleware
+from .components import (
+    AdminConsoleComponent,
+    CacheComponent,
+    DatabaseComponent,
+    MigrationComponent,
+    SchedulerComponent,
+    TaskComponent,
+)
+from .middlewares import (
+    CORSMiddleware,
+    RequestLoggingMiddleware,
+)
+
+__all__ = [
+    # 应用框架
+    "FoundationApp",
+    # 基类
+    "Component",
+    "Middleware",
+    # 中间件
+    "CORSMiddleware",
+    "RequestLoggingMiddleware",
+    # 组件
+    "AdminConsoleComponent",
+    "CacheComponent",
+    "DatabaseComponent",
+    "MigrationComponent",
+    "SchedulerComponent",
+    "TaskComponent",
+]
+
+
+