aury-boot 0.0.4__tar.gz → 0.0.5__tar.gz

{aury_boot-0.0.4 → aury_boot-0.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.4
+Version: 0.0.5
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2
@@ -72,7 +72,24 @@ Description-Content-Type: text/markdown
 
 # Aury Boot
 
-这是AUM项目的基于 FastAPI 生态的企业级 API 开发框架，提供所有微服务共用的基础设施组件。
+基于 FastAPI 生态的企业级 API 开发框架，提供所有微服务共用的基础设施组件。
+
+## 快速开始
+
+```bash
+# 1. 创建项目目录并初始化
+mkdir my-service && cd my-service
+uv init . --name my_service --no-package --python 3.13
+
+# 2. 添加依赖
+uv add "aury-boot[recommended,admin]"  # admin 可选，提供 SQLAdmin 管理后台
+
+# 3. 初始化项目结构
+aury init
+
+# 4. 启动开发服务器
+aury server dev
+```
 
 ## 功能模块
 

{aury_boot-0.0.4 → aury_boot-0.0.5}/README.md

@@ -1,6 +1,23 @@
 # Aury Boot
 
-这是AUM项目的基于 FastAPI 生态的企业级 API 开发框架，提供所有微服务共用的基础设施组件。
+基于 FastAPI 生态的企业级 API 开发框架，提供所有微服务共用的基础设施组件。
+
+## 快速开始
+
+```bash
+# 1. 创建项目目录并初始化
+mkdir my-service && cd my-service
+uv init . --name my_service --no-package --python 3.13
+
+# 2. 添加依赖
+uv add "aury-boot[recommended,admin]"  # admin 可选，提供 SQLAdmin 管理后台
+
+# 3. 初始化项目结构
+aury init
+
+# 4. 启动开发服务器
+aury server dev
+```
 
 ## 功能模块
 

{aury_boot-0.0.4 → aury_boot-0.0.5}/aury/boot/__init__.py

@@ -52,7 +52,7 @@ def __getattr__(name: str):
 
 def __dir__():
     """返回可用属性列表。"""
-    return list(_SUBMODULES) + ["__version__"]
+    return [*list(_SUBMODULES), "__version__"]
 
 
 __all__ = [
@@ -61,6 +61,6 @@ __all__ = [
     "common",
     "domain",
     "infrastructure",
-    "toolkit",
     "testing",
+    "toolkit",
 ]

{aury_boot-0.0.4 → aury_boot-0.0.5}/aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.4'
-__version_tuple__ = version_tuple = (0, 0, 4)
+__version__ = version = '0.0.5'
+__version_tuple__ = version_tuple = (0, 0, 5)
 
 __commit_id__ = commit_id = None

{aury_boot-0.0.4 → aury_boot-0.0.5}/aury/boot/application/__init__.py

@@ -17,10 +17,15 @@ from aury.boot.domain.transaction import (
 from aury.boot.infrastructure.di import Container, Lifetime, Scope, ServiceDescriptor
 from aury.boot.infrastructure.events import (
     Event,
-    EventBus,
-    EventConsumer,
-    EventLoggingMiddleware,
-    EventMiddleware,
+    EventBackend,
+    EventBusManager,
+    EventHandler,
+    EventType,
+    IEventBus,
+    # 后端实现
+    MemoryEventBus,
+    RabbitMQEventBus,
+    RedisEventBus,
 )
 
 from . import interfaces, rpc
@@ -62,59 +67,63 @@ from .scheduler import run_scheduler, run_scheduler_sync
 from .server import ApplicationServer, run_app
 
 __all__ = [
+    # 服务器集成
+    "ApplicationServer",
     # 配置
     "BaseConfig",
+    # 中间件
+    "CORSMiddleware",
     "CORSSettings",
+    # 组件
+    "CacheComponent",
     "CacheSettings",
-    "LogSettings",
-    "ServerSettings",
+    # 基类
+    "Component",
     # 常量
     "ComponentName",
-    "MiddlewareName",
-    "SchedulerMode",
-    "ServiceType",
+    # 依赖注入容器
+    "Container",
+    "DatabaseComponent",
+    # 事件系统
+    "Event",
+    "EventBackend",
+    "EventBusManager",
+    "EventHandler",
+    "EventType",
     # 应用框架
     "FoundationApp",
-    # 基类
-    "Component",
+    "IEventBus",
+    "Lifetime",
+    "LogSettings",
+    "MemoryEventBus",
     "Middleware",
-    # 中间件
-    "CORSMiddleware",
-    "RequestLoggingMiddleware",
-    # 组件
-    "CacheComponent",
-    "DatabaseComponent",
+    "MiddlewareName",
     "MigrationComponent",
+    # 迁移
+    "MigrationManager",
+    "RabbitMQEventBus",
+    "RedisEventBus",
+    "RequestLoggingMiddleware",
     "SchedulerComponent",
-    "TaskComponent",
-    # 依赖注入容器
-    "Container",
-    "Lifetime",
+    "SchedulerMode",
     "Scope",
+    "ServerSettings",
     "ServiceDescriptor",
-    # 事件系统
-    "Event",
-    "EventBus",
-    "EventConsumer",
-    "EventLoggingMiddleware",
-    "EventMiddleware",
-    # 迁移
-    "MigrationManager",
-    # HTTP 中间件装饰器
-    "log_request",
+    "ServiceType",
+    "TaskComponent",
     # 事务管理
     "TransactionManager",
     "TransactionRequiredError",
     "ensure_transaction",
-    "transactional",
-    "transactional_context",
+    # HTTP 中间件装饰器
+    "log_request",
     # RPC通信
     "rpc",
+    "run_app",
     # 调度器启动器
     "run_scheduler",
     "run_scheduler_sync",
-    # 服务器集成
-    "ApplicationServer",
-    "run_app",
+    "transactional",
+    "transactional_context",
 ]
 

{aury_boot-0.0.4 → aury_boot-0.0.5}/aury/boot/application/app/__init__.py

@@ -8,6 +8,8 @@ from .components import (
     AdminConsoleComponent,
     CacheComponent,
     DatabaseComponent,
+    EventBusComponent,
+    MessageQueueComponent,
     MigrationComponent,
     SchedulerComponent,
     TaskComponent,
@@ -18,19 +20,21 @@ from .middlewares import (
 )
 
 __all__ = [
-    # 应用框架
-    "FoundationApp",
-    # 基类
-    "Component",
-    "Middleware",
-    # 中间件
-    "CORSMiddleware",
-    "RequestLoggingMiddleware",
     # 组件
     "AdminConsoleComponent",
+    # 中间件
+    "CORSMiddleware",
     "CacheComponent",
+    # 基类
+    "Component",
     "DatabaseComponent",
+    "EventBusComponent",
+    # 应用框架
+    "FoundationApp",
+    "MessageQueueComponent",
+    "Middleware",
     "MigrationComponent",
+    "RequestLoggingMiddleware",
     "SchedulerComponent",
     "TaskComponent",
 ]

{aury_boot-0.0.4 → aury_boot-0.0.5}/aury/boot/application/app/base.py

@@ -349,6 +349,18 @@ class FoundationApp(FastAPI):
                     raise
 
             logger.info("应用启动完成")
+            
+            # 打印启动横幅和组件状态
+            from aury.boot.application.app.startup import (
+                collect_component_status,
+                print_startup_banner,
+            )
+            components = collect_component_status()
+            print_startup_banner(
+                app_name=self.title,
+                version=self.version,
+                components=components,
+            )
 
         except Exception as e:
             logger.error(f"应用启动异常: {e}")

{aury_boot-0.0.4 → aury_boot-0.0.5}/aury/boot/application/app/components.py

@@ -16,6 +16,8 @@ from aury.boot.application.migrations import MigrationManager
 from aury.boot.common.logging import logger
 from aury.boot.infrastructure.cache import CacheManager
 from aury.boot.infrastructure.database import DatabaseManager
+from aury.boot.infrastructure.events import EventBusManager
+from aury.boot.infrastructure.mq import MQManager
 from aury.boot.infrastructure.scheduler import SchedulerManager
 from aury.boot.infrastructure.storage import StorageManager
 from aury.boot.infrastructure.tasks import TaskManager
@@ -74,12 +76,12 @@ class CacheComponent(Component):
         """初始化缓存。"""
         try:
             cache_manager = CacheManager.get_instance()
-            if not cache_manager._backend:
-                await cache_manager.init_app({
-                    "CACHE_TYPE": config.cache.cache_type,
-                    "CACHE_URL": config.cache.url,
-                    "CACHE_MAX_SIZE": config.cache.max_size,
-                })
+            if not cache_manager.is_initialized:
+                await cache_manager.initialize(
+                    backend=config.cache.cache_type,
+                    url=config.cache.url,
+                    max_size=config.cache.max_size,
+                )
         except Exception as e:
             logger.warning(f"缓存初始化失败（非关键）: {e}")
 
@@ -87,7 +89,7 @@ class CacheComponent(Component):
         """关闭缓存。"""
         try:
             cache_manager = CacheManager.get_instance()
-            if cache_manager._backend:
+            if cache_manager.is_initialized:
                 await cache_manager.cleanup()
         except Exception as e:
             logger.warning(f"缓存关闭失败: {e}")
@@ -95,53 +97,53 @@ class CacheComponent(Component):
 
 class StorageComponent(Component):
     """对象存储组件。
-
-设计要点（解耦）：
-- 使用 aury-sdk-storage 的 StorageConfig/StorageBackend，Application 层仅做装配
-- 建议由应用的 `StorageSettings` 读取环境变量并构造 SDK 的 StorageConfig
-"""
+    
+    支持多实例配置，通过环境变量 STORAGE_{INSTANCE}_{FIELD} 配置。
+    """
 
     name = ComponentName.STORAGE
     enabled = True
     depends_on: ClassVar[list[str]] = []
 
     def can_enable(self, config: BaseConfig) -> bool:
-        st = getattr(config, "storage", None)
-        return self.enabled and bool(getattr(st, "enabled", True))
+        """当配置了 Storage 实例时启用。"""
+        return self.enabled and bool(config.get_storages())
 
     async def setup(self, app: FoundationApp, config: BaseConfig) -> None:
-        try:
-            from aury.boot.infrastructure.storage import StorageBackend, StorageConfig
-
-            storage_manager = StorageManager.get_instance()
-            st = config.storage
-            storage_config = StorageConfig(
-                backend=StorageBackend(st.type),
-                access_key_id=st.access_key_id,
-                access_key_secret=st.access_key_secret,
-                session_token=st.session_token,
-                endpoint=st.endpoint,
-                region=st.region,
-                bucket_name=st.bucket_name,
-                base_path=st.base_path,
-                addressing_style=st.addressing_style,
-                role_arn=st.role_arn,
-                role_session_name=st.role_session_name,
-                external_id=st.external_id,
-                sts_endpoint=st.sts_endpoint,
-                sts_region=st.sts_region,
-                sts_duration_seconds=st.sts_duration_seconds,
-            )
-            await storage_manager.init(storage_config)
-        except Exception as e:
-            logger.warning(f"存储初始化失败（非关键）: {e}")
+        """初始化存储。"""
+        from aury.boot.infrastructure.storage import StorageBackend, StorageConfig
+        
+        storage_configs = config.get_storages()
+        if not storage_configs:
+            logger.debug("未配置 Storage 实例，跳过存储初始化")
+            return
+        
+        for name, st_config in storage_configs.items():
+            try:
+                storage_manager = StorageManager.get_instance(name)
+                if not storage_manager.is_initialized:
+                    storage_config = StorageConfig(
+                        backend=StorageBackend(st_config.backend),
+                        access_key_id=st_config.access_key_id,
+                        access_key_secret=st_config.access_key_secret,
+                        endpoint=st_config.endpoint,
+                        region=st_config.region,
+                        bucket_name=st_config.bucket_name,
+                        base_path=st_config.base_path,
+                    )
+                    await storage_manager.initialize(storage_config)
+            except Exception as e:
+                logger.warning(f"存储 [{name}] 初始化失败（非关键）: {e}")
 
     async def teardown(self, app: FoundationApp) -> None:
-        try:
-            storage_manager = StorageManager.get_instance()
-            await storage_manager.cleanup()
-        except Exception as e:
-            logger.warning(f"存储关闭失败: {e}")
+        """关闭所有存储实例。"""
+        for name in list(StorageManager._instances.keys()):
+            try:
+                storage_manager = StorageManager.get_instance(name)
+                if storage_manager.is_initialized:
+                    await storage_manager.cleanup()
+            except Exception as e:
+                logger.warning(f"存储 [{name}] 关闭失败: {e}")
 
 
 class TaskComponent(Component):
@@ -410,6 +412,93 @@ class AdminConsoleComponent(Component):
         pass
 
 
+class MessageQueueComponent(Component):
+    """消息队列组件。
+    
+    提供统一的消息队列接口，支持多种后端（Redis、RabbitMQ）。
+    与 TaskComponent（基于 Dramatiq）的区别：
+    - Task: 异步任务处理（API 发送，Worker 执行）
+    - MQ: 通用消息队列（生产者/消费者模式，服务间通信）
+    """
+
+    name = ComponentName.MESSAGE_QUEUE
+    enabled = True
+    depends_on: ClassVar[list[str]] = []
+
+    def can_enable(self, config: BaseConfig) -> bool:
+        """当配置了 MQ 实例时启用。"""
+        return self.enabled and bool(config.get_mqs())
+
+    async def setup(self, app: FoundationApp, config: BaseConfig) -> None:
+        """初始化消息队列。"""
+        from aury.boot.application.config import MQInstanceConfig
+        
+        # 从多实例配置加载
+        mq_configs = config.get_mqs()
+        if not mq_configs:
+            logger.debug("未配置 MQ 实例，跳过消息队列初始化")
+            return
+        
+        for name, mq_config in mq_configs.items():
+            try:
+                mq_manager = MQManager.get_instance(name)
+                if not mq_manager.is_initialized:
+                    await mq_manager.initialize(config=mq_config)
+            except Exception as e:
+                logger.warning(f"消息队列 [{name}] 初始化失败（非关键）: {e}")
+
+    async def teardown(self, app: FoundationApp) -> None:
+        """关闭所有消息队列实例。"""
+        for name in list(MQManager._instances.keys()):
+            try:
+                mq_manager = MQManager.get_instance(name)
+                if mq_manager.is_initialized:
+                    await mq_manager.cleanup()
+            except Exception as e:
+                logger.warning(f"消息队列 [{name}] 关闭失败: {e}")
+
+
+class EventBusComponent(Component):
+    """事件总线组件。
+    
+    提供发布/订阅模式的事件总线功能，支持多种后端（memory、Redis、RabbitMQ）。
+    """
+
+    name = ComponentName.EVENT_BUS
+    enabled = True
+    depends_on: ClassVar[list[str]] = []
+
+    def can_enable(self, config: BaseConfig) -> bool:
+        """当配置了 Event 实例时启用。"""
+        return self.enabled and bool(config.get_events())
+
+    async def setup(self, app: FoundationApp, config: BaseConfig) -> None:
+        """初始化事件总线。"""
+        # 从多实例配置加载
+        event_configs = config.get_events()
+        if not event_configs:
+            logger.debug("未配置 Event 实例，跳过事件总线初始化")
+            return
+        
+        for name, event_config in event_configs.items():
+            try:
+                event_manager = EventBusManager.get_instance(name)
+                if not event_manager.is_initialized:
+                    await event_manager.initialize(config=event_config)
+            except Exception as e:
+                logger.warning(f"事件总线 [{name}] 初始化失败（非关键）: {e}")
+
+    async def teardown(self, app: FoundationApp) -> None:
+        """关闭所有事件总线实例。"""
+        for name in list(EventBusManager._instances.keys()):
+            try:
+                event_manager = EventBusManager.get_instance(name)
+                if event_manager.is_initialized:
+                    await event_manager.cleanup()
+            except Exception as e:
+                logger.warning(f"事件总线 [{name}] 关闭失败: {e}")
+
+
 # 设置默认组件
 FoundationApp.components = [
     DatabaseComponent,
@@ -418,6 +507,8 @@ FoundationApp.components = [
     CacheComponent,
     StorageComponent,
     TaskComponent,
+    MessageQueueComponent,
+    EventBusComponent,
     SchedulerComponent,
 ]
 
@@ -426,6 +517,8 @@ __all__ = [
     "AdminConsoleComponent",
     "CacheComponent",
     "DatabaseComponent",
+    "EventBusComponent",
+    "MessageQueueComponent",
     "MigrationComponent",
     "SchedulerComponent",
     "StorageComponent",

{aury_boot-0.0.4 → aury_boot-0.0.5}/aury/boot/application/app/middlewares.py

@@ -13,6 +13,8 @@ from aury.boot.application.config import BaseConfig
 from aury.boot.application.constants import MiddlewareName
 from aury.boot.application.middleware.logging import (
     RequestLoggingMiddleware as StarletteRequestLoggingMiddleware,
+)
+from aury.boot.application.middleware.logging import (
     WebSocketLoggingMiddleware as StarletteWebSocketLoggingMiddleware,
 )