aury-boot 0.0.10__py3-none-any.whl → 0.0.12__py3-none-any.whl

aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.10'
-__version_tuple__ = version_tuple = (0, 0, 10)
+__version__ = version = '0.0.12'
+__version_tuple__ = version_tuple = (0, 0, 12)
 
 __commit_id__ = commit_id = None

aury/boot/application/migrations/setup.py

@@ -117,6 +117,8 @@ def run_migrations_offline() -> None:
         dialect_opts={{"paramstyle": "named"}},
         compare_type=True,
         compare_server_default=True,
+        # 启用 batch 模式以更好地支持 SQLite 等不完整 DDL 的后端
+        render_as_batch=True,
     )
     with context.begin_transaction():
         context.run_migrations()
@@ -129,6 +131,8 @@ def _do_run_migrations(connection) -> None:
         target_metadata=target_metadata,
         compare_type=True,
         compare_server_default=True,
+        # 启用 batch 模式以更好地支持 SQLite 等不完整 DDL 的后端
+        render_as_batch=True,
     )
     with context.begin_transaction():
         context.run_migrations()

aury/boot/commands/app.py

@@ -86,12 +86,14 @@ def _get_app() -> typer.Typer:
         from .generate import app as generate_app
         from .init import init
         from .migrate import app as migrate_app
+        from .pkg import app as pkg_app
         from .scheduler import app as scheduler_app
         from .server import app as server_app
         from .worker import app as worker_app
 
         app.command(name="init", help="🎯 初始化项目脚手架")(init)
         app.add_typer(add_app, name="add", help="➕ 添加可选模块")
+        app.add_typer(pkg_app, name="pkg", help="📦 包管理")
         app.add_typer(generate_app, name="generate", help="⚡ 代码生成器")
         app.add_typer(server_app, name="server", help="🖥️  服务器管理")
         app.add_typer(scheduler_app, name="scheduler", help="🕐 独立运行调度器")
@@ -162,6 +164,10 @@ def register_commands(
         from .add import app as add_app
         target_app.add_typer(add_app, name="add", help="➕ 添加可选模块")
     
+    # pkg 命令始终注册（包管理是通用功能）
+    from .pkg import app as pkg_app
+    target_app.add_typer(pkg_app, name="pkg", help="📦 包管理")
+    
     if include_generate:
         from .generate import app as generate_app
         target_app.add_typer(generate_app, name="generate", help="⚡ 代码生成器")
@@ -205,11 +211,12 @@ def get_command_modules() -> dict[str, type]:
         # {'init': <module>, 'add': <module>, 'server': <module>, ...}
         ```
     """
-    from . import add, docker, docs, generate, init, migrate, scheduler, server, worker
+    from . import add, docker, docs, generate, init, migrate, pkg, scheduler, server, worker
     
     return {
         "init": init,
         "add": add,
+        "pkg": pkg,
         "generate": generate,
         "server": server,
         "scheduler": scheduler,

aury/boot/commands/init.py

@@ -928,6 +928,12 @@ def init(
     console.print("  4. 访问 API 文档：")
     console.print("     [cyan]http://127.0.0.1:8000/docs[/cyan]")
     console.print()
+    console.print("[bold]包管理（按需安装可选模块）：[/bold]")
+    console.print("  [cyan]aury pkg list[/cyan]               # 查看所有可用模块")
+    console.print("  [cyan]aury pkg preset[/cyan]             # 查看预设配置")
+    console.print("  [cyan]aury pkg install postgres redis[/cyan]  # 安装指定模块")
+    console.print("  [cyan]aury pkg install --preset api[/cyan]    # 按预设安装")
+    console.print()
     console.print("[bold]常用命令：[/bold]")
     console.print("  [cyan]aury generate crud user -i[/cyan]  # 生成 CRUD（交互式）")
     console.print("  [cyan]aury generate model user -i[/cyan] # 生成模型（交互式）")

aury/boot/commands/pkg.py

@@ -0,0 +1,471 @@
+"""包管理命令。
+
+用法：
+    aury pkg list                    # 列出所有可安装模块
+    aury pkg list --installed        # 已安装的模块
+    aury pkg preset                  # 列出预设
+    aury pkg preset api              # 查看预设详情
+    aury pkg install postgres redis  # 安装模块
+    aury pkg install --preset api    # 按预设安装
+    aury pkg remove redis            # 卸载模块
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import Enum
+import subprocess
+import sys
+from typing import Annotated
+
+from rich.console import Console
+from rich.table import Table
+import typer
+
+console = Console()
+
+app = typer.Typer(
+    name="pkg",
+    help="包管理 - 安装/卸载 aury 生态模块",
+    no_args_is_help=True,
+)
+
+
+# ============================================================================
+# 数据定义
+# ============================================================================
+
+
+class Category(str, Enum):
+    """模块分类。"""
+
+    DATABASE = "database"
+    CACHE = "cache"
+    TASK = "task"
+    SCHEDULER = "scheduler"
+    ADMIN = "admin"
+    STORAGE = "storage"
+    ECOSYSTEM = "ecosystem"
+
+
+@dataclass
+class ModuleInfo:
+    """模块信息。"""
+
+    name: str
+    desc: str
+    usage: str
+    category: Category
+    deps: list[str]  # extras 的依赖包名
+    is_extra: bool = True  # True=extras, False=生态包
+    pkg: str | None = None  # 生态包的完整包名
+
+
+# Extras（aury-boot 的可选依赖）
+MODULES: dict[str, ModuleInfo] = {
+    # 数据库驱动
+    "postgres": ModuleInfo(
+        name="postgres",
+        desc="PostgreSQL 异步驱动",
+        usage="DatabaseManager 使用 PostgreSQL 时需要",
+        category=Category.DATABASE,
+        deps=["asyncpg"],
+    ),
+    "mysql": ModuleInfo(
+        name="mysql",
+        desc="MySQL 异步驱动",
+        usage="DatabaseManager 使用 MySQL 时需要",
+        category=Category.DATABASE,
+        deps=["aiomysql"],
+    ),
+    "sqlite": ModuleInfo(
+        name="sqlite",
+        desc="SQLite 异步驱动",
+        usage="DatabaseManager 使用 SQLite 时需要（本地开发推荐）",
+        category=Category.DATABASE,
+        deps=["aiosqlite"],
+    ),
+    # 缓存
+    "redis": ModuleInfo(
+        name="redis",
+        desc="Redis 客户端",
+        usage="CacheManager 使用 Redis 后端时需要",
+        category=Category.CACHE,
+        deps=["redis"],
+    ),
+    # 任务队列
+    "tasks": ModuleInfo(
+        name="tasks",
+        desc="Dramatiq 任务队列",
+        usage="TaskManager 异步任务时需要",
+        category=Category.TASK,
+        deps=["dramatiq", "kombu", "dramatiq-kombu-broker"],
+    ),
+    "rabbitmq": ModuleInfo(
+        name="rabbitmq",
+        desc="RabbitMQ 消息队列后端",
+        usage="TaskManager/EventBus 使用 RabbitMQ 时需要（需配合 tasks）",
+        category=Category.TASK,
+        deps=["amqp"],
+    ),
+    # 调度器
+    "scheduler": ModuleInfo(
+        name="scheduler",
+        desc="APScheduler 定时调度",
+        usage="SchedulerManager 定时任务时需要",
+        category=Category.SCHEDULER,
+        deps=["apscheduler"],
+    ),
+    # 管理后台
+    "admin": ModuleInfo(
+        name="admin",
+        desc="SQLAdmin 管理后台",
+        usage="启用 /admin 管理界面时需要",
+        category=Category.ADMIN,
+        deps=["sqladmin", "itsdangerous"],
+    ),
+    # 存储（extras）
+    "s3": ModuleInfo(
+        name="s3",
+        desc="S3 兼容存储（AWS/MinIO/OSS）",
+        usage="StorageManager 使用 S3 兼容存储时需要",
+        category=Category.STORAGE,
+        deps=["aury-sdk-storage[aws]"],
+    ),
+    # 生态包
+    "storage-aws": ModuleInfo(
+        name="storage-aws",
+        desc="AWS S3 兼容存储",
+        usage="StorageManager 使用 AWS S3/MinIO/OSS 时需要",
+        category=Category.ECOSYSTEM,
+        deps=[],
+        is_extra=False,
+        pkg="aury-sdk-storage[aws]",
+    ),
+    "storage-cos": ModuleInfo(
+        name="storage-cos",
+        desc="腾讯云 COS 原生存储",
+        usage="StorageManager 使用腾讯云 COS 时推荐（性能更好）",
+        category=Category.ECOSYSTEM,
+        deps=[],
+        is_extra=False,
+        pkg="aury-sdk-storage[cos]",
+    ),
+}
+
+
+@dataclass
+class PresetInfo:
+    """预设信息。"""
+
+    name: str
+    desc: str
+    modules: list[str]
+
+
+PRESETS: dict[str, PresetInfo] = {
+    "minimal": PresetInfo(
+        name="minimal",
+        desc="最小化（本地开发/测试）",
+        modules=["sqlite"],
+    ),
+    "api": PresetInfo(
+        name="api",
+        desc="API 服务（Web 接口 + 管理后台）",
+        modules=["postgres", "redis", "admin"],
+    ),
+    "worker": PresetInfo(
+        name="worker",
+        desc="后台 Worker（任务队列 + 调度器）",
+        modules=["postgres", "redis", "tasks", "rabbitmq", "scheduler"],
+    ),
+    "full": PresetInfo(
+        name="full",
+        desc="完整功能（所有模块）",
+        modules=["postgres", "redis", "tasks", "rabbitmq", "scheduler", "admin", "storage-cos"],
+    ),
+}
+
+
+# 分类显示名称
+CATEGORY_NAMES: dict[Category, str] = {
+    Category.DATABASE: "📦 数据库驱动",
+    Category.CACHE: "📦 缓存",
+    Category.TASK: "📦 任务队列",
+    Category.SCHEDULER: "📦 定时调度",
+    Category.ADMIN: "📦 管理后台",
+    Category.STORAGE: "📦 对象存储",
+    Category.ECOSYSTEM: "🌐 生态包",
+}
+
+
+# ============================================================================
+# 工具函数
+# ============================================================================
+
+
+def _get_installed_packages() -> set[str]:
+    """获取已安装的包名。"""
+    try:
+        result = subprocess.run(
+            [sys.executable, "-m", "pip", "list", "--format=freeze"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        installed = set()
+        for line in result.stdout.strip().split("\n"):
+            if "==" in line:
+                pkg_name = line.split("==")[0].lower().replace("-", "_")
+                installed.add(pkg_name)
+        return installed
+    except subprocess.CalledProcessError:
+        return set()
+
+
+def _is_module_installed(module: ModuleInfo) -> bool:
+    """检查模块是否已安装。"""
+    installed = _get_installed_packages()
+
+    if module.is_extra:
+        # 检查 deps 中的包是否已安装
+        for dep in module.deps:
+            # 处理 extras 语法，如 aury-sdk-storage[aws]
+            pkg_name = dep.split("[")[0].lower().replace("-", "_")
+            if pkg_name not in installed:
+                return False
+        return bool(module.deps)
+    else:
+        # 生态包：检查包名
+        if module.pkg:
+            pkg_name = module.pkg.split("[")[0].lower().replace("-", "_")
+            return pkg_name in installed
+    return False
+
+
+def _run_uv_command(args: list[str]) -> bool:
+    """运行 uv 命令。"""
+    cmd = ["uv", *args]
+    console.print(f"[dim]$ {' '.join(cmd)}[/dim]")
+    try:
+        subprocess.run(cmd, check=True)
+        return True
+    except subprocess.CalledProcessError as e:
+        console.print(f"[red]命令失败: {e}[/red]")
+        return False
+    except FileNotFoundError:
+        console.print("[red]错误: 未找到 uv，请先安装: pip install uv[/red]")
+        return False
+
+
+# ============================================================================
+# 命令实现
+# ============================================================================
+
+
+@app.command(name="list")
+def list_modules(
+    installed: Annotated[
+        bool,
+        typer.Option("--installed", "-i", help="仅显示已安装的模块"),
+    ] = False,
+) -> None:
+    """列出所有可安装的模块。"""
+    installed_pkgs = _get_installed_packages() if installed else None
+
+    # 按分类组织
+    by_category: dict[Category, list[ModuleInfo]] = {}
+    for module in MODULES.values():
+        if module.category not in by_category:
+            by_category[module.category] = []
+        by_category[module.category].append(module)
+
+    # 输出
+    for category in Category:
+        modules = by_category.get(category, [])
+        if not modules:
+            continue
+
+        # 过滤已安装
+        if installed:
+            modules = [m for m in modules if _is_module_installed(m)]
+            if not modules:
+                continue
+
+        console.print()
+        console.print(f"[bold]{CATEGORY_NAMES[category]}[/bold]")
+
+        table = Table(show_header=False, box=None, padding=(0, 2))
+        table.add_column("名称", style="cyan", width=15)
+        table.add_column("描述", width=30)
+        table.add_column("用途", style="dim")
+
+        for module in modules:
+            status = ""
+            if installed_pkgs is not None:
+                is_installed = _is_module_installed(module)
+                status = " [green]✓[/green]" if is_installed else ""
+            table.add_row(
+                f"{module.name}{status}",
+                module.desc,
+                f"→ {module.usage}",
+            )
+
+        console.print(table)
+
+    console.print()
+    console.print("[dim]提示: 使用 aury pkg install <模块名> 安装模块[/dim]")
+
+
+@app.command(name="preset")
+def list_presets(
+    name: Annotated[
+        str | None,
+        typer.Argument(help="预设名称（留空列出所有预设）"),
+    ] = None,
+) -> None:
+    """查看预设配置。"""
+    if name is None:
+        # 列出所有预设
+        console.print()
+        console.print("[bold]📋 可用预设[/bold]")
+        console.print()
+
+        table = Table(show_header=True, box=None, padding=(0, 2))
+        table.add_column("预设", style="cyan", width=12)
+        table.add_column("描述", width=35)
+        table.add_column("包含模块", style="dim")
+
+        for preset in PRESETS.values():
+            table.add_row(
+                preset.name,
+                preset.desc,
+                ", ".join(preset.modules),
+            )
+
+        console.print(table)
+        console.print()
+        console.print("[dim]提示: 使用 aury pkg preset <预设名> 查看详情[/dim]")
+        console.print("[dim]      使用 aury pkg install --preset <预设名> 安装[/dim]")
+    else:
+        # 查看指定预设
+        if name not in PRESETS:
+            console.print(f"[red]错误: 预设 '{name}' 不存在[/red]")
+            console.print(f"[dim]可用预设: {', '.join(PRESETS.keys())}[/dim]")
+            raise typer.Exit(1)
+
+        preset = PRESETS[name]
+        console.print()
+        console.print(f"[bold]📋 预设: {preset.name}[/bold]")
+        console.print(f"[dim]{preset.desc}[/dim]")
+        console.print()
+
+        console.print("[bold]包含模块:[/bold]")
+        for module_name in preset.modules:
+            module = MODULES.get(module_name)
+            if module:
+                installed = _is_module_installed(module)
+                status = "[green]✓ 已安装[/green]" if installed else "[dim]未安装[/dim]"
+                console.print(f"  • {module.name}: {module.desc} {status}")
+            else:
+                console.print(f"  • {module_name} [red](未知模块)[/red]")
+
+        console.print()
+        console.print(f"[dim]安装命令: aury pkg install --preset {name}[/dim]")
+
+
+@app.command(name="install")
+def install_modules(
+    modules: Annotated[
+        list[str] | None,
+        typer.Argument(help="要安装的模块名称"),
+    ] = None,
+    preset: Annotated[
+        str | None,
+        typer.Option("--preset", "-p", help="使用预设安装"),
+    ] = None,
+) -> None:
+    """安装模块。"""
+    if preset:
+        # 使用预设
+        if preset not in PRESETS:
+            console.print(f"[red]错误: 预设 '{preset}' 不存在[/red]")
+            console.print(f"[dim]可用预设: {', '.join(PRESETS.keys())}[/dim]")
+            raise typer.Exit(1)
+
+        preset_info = PRESETS[preset]
+        modules = preset_info.modules
+        console.print(f"[bold]📦 安装预设: {preset_info.name}[/bold]")
+        console.print(f"[dim]{preset_info.desc}[/dim]")
+        console.print()
+
+    if not modules:
+        console.print("[red]错误: 请指定要安装的模块，或使用 --preset[/red]")
+        raise typer.Exit(1)
+
+    # 收集要安装的包
+    extras_to_install: list[str] = []
+    pkgs_to_install: list[str] = []
+
+    for module_name in modules:
+        if module_name not in MODULES:
+            console.print(f"[yellow]警告: 模块 '{module_name}' 不存在，跳过[/yellow]")
+            continue
+
+        module = MODULES[module_name]
+        if module.is_extra:
+            extras_to_install.append(module.name)
+        else:
+            if module.pkg:
+                pkgs_to_install.append(module.pkg)
+
+    # 安装 extras
+    if extras_to_install:
+        extras_str = ",".join(extras_to_install)
+        console.print(f"[bold]安装 extras: {extras_str}[/bold]")
+        if not _run_uv_command(["add", f"aury-boot[{extras_str}]"]):
+            raise typer.Exit(1)
+
+    # 安装生态包
+    for pkg in pkgs_to_install:
+        console.print(f"[bold]安装生态包: {pkg}[/bold]")
+        if not _run_uv_command(["add", pkg]):
+            raise typer.Exit(1)
+
+    console.print()
+    console.print("[green]✅ 安装完成[/green]")
+
+
+@app.command(name="remove")
+def remove_modules(
+    modules: Annotated[
+        list[str],
+        typer.Argument(help="要卸载的模块名称"),
+    ],
+) -> None:
+    """卸载模块。"""
+    for module_name in modules:
+        if module_name not in MODULES:
+            console.print(f"[yellow]警告: 模块 '{module_name}' 不存在，跳过[/yellow]")
+            continue
+
+        module = MODULES[module_name]
+
+        if module.is_extra:
+            # extras 需要移除具体的依赖包
+            console.print(f"[bold]移除 {module.name} 的依赖...[/bold]")
+            for dep in module.deps:
+                pkg_name = dep.split("[")[0]  # 去掉 extras 语法
+                _run_uv_command(["remove", pkg_name])
+        else:
+            # 生态包直接移除
+            if module.pkg:
+                pkg_name = module.pkg.split("[")[0]
+                console.print(f"[bold]移除生态包: {pkg_name}[/bold]")
+                _run_uv_command(["remove", pkg_name])
+
+    console.print()
+    console.print("[green]✅ 卸载完成[/green]")
+
+
+__all__ = ["app"]

aury/boot/commands/templates/project/aury_docs/10-storage.md.tpl

@@ -11,17 +11,20 @@ pip install "aury-sdk-storage[aws]"
 
 ## 10.2 基本用法（StorageManager）
 
-`StorageManager` 支持**命名多实例**，可以同时管理多个存储后端。
+`StorageManager` 支持**命名多实例**，内部使用 `aury-sdk-storage` 提供的 `StorageFactory.from_config()` 智能选择后端（COS 原生 / S3 兼容等），对上层暴露统一接口。
 
 ```python
 from aury.boot.infrastructure.storage import (
-    StorageManager, StorageConfig, StorageBackend, StorageFile,
+    StorageManager,
+    StorageConfig,
+    StorageBackend,
+    StorageFile,
 )
 
 # 默认实例
 storage = StorageManager.get_instance()
 await storage.initialize(StorageConfig(
-    backend=StorageBackend.COS,
+    backend=StorageBackend.COS,  # 自动选择 COS 原生 SDK 或 S3 兼容模式
     bucket_name="my-bucket-1250000000",
     region="ap-guangzhou",
     endpoint="https://cos.ap-guangzhou.myqcloud.com",
@@ -45,6 +48,12 @@ url = await storage.upload_file(
     )
 )
 
+# 批量上传
+urls = await storage.upload_files([
+    StorageFile(object_name="img/1.jpg", data=b"..."),
+    StorageFile(object_name="img/2.jpg", data=b"..."),
+])
+
 # 下载文件
 content = await storage.download_file("user/123/avatar.png")
 
@@ -58,7 +67,38 @@ exists = await storage.file_exists("user/123/avatar.png")
 await storage.delete_file("user/123/avatar.png")
 ```
 
-## 10.3 STS 临时凭证（前端直传）
+## 10.3 高级用法：直接使用 SDKStorageFactory / StorageType
+
+对于需要更精细控制后端类型（如在脚手架或基础设施层扩展存储实现）的场景，可以直接使用 SDK 导出的类型：
+
+```python
+from aury.boot.infrastructure.storage import (
+    COSStorage,
+    LocalStorage,
+    S3Storage,
+    SDKStorageFactory,  # SDK 工厂（基于 StorageType 枚举）
+    StorageConfig,
+    StorageFile,
+    StorageType,
+)
+
+# 使用 StorageType 创建后端
+config = StorageConfig(
+    backend=StorageType.COS,
+    bucket_name="my-bucket-1250000000",
+    region="ap-guangzhou",
+)
+
+backend = SDKStorageFactory.from_config(config)
+result = await backend.upload_file(
+    StorageFile(object_name="dev/test.txt", data=b"hello"),
+)
+print(result.url)
+```
+
+> 一般业务代码直接通过 `StorageManager` 即可，只有在需要自定义装配流程或编写基础设施扩展时才需要直接使用 `SDKStorageFactory` / `StorageType` / `COSStorage` 等类型。
+
+## 10.4 STS 临时凭证（前端直传）
 
 ```python
 from aury.sdk.storage.sts import (
@@ -95,11 +135,14 @@ return {{
 }}
 ```
 
-## 10.4 本地存储（开发测试）
+## 10.5 本地存储（开发测试）
 
 ```python
 from aury.boot.infrastructure.storage import (
-    StorageManager, StorageConfig, StorageBackend, StorageFile,
+    StorageManager,
+    StorageConfig,
+    StorageBackend,
+    StorageFile,
 )
 
 storage = StorageManager.get_instance()

aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl

@@ -33,7 +33,7 @@ class PaymentAdapter(BaseAdapter):
         # 真实调用第三方 API
         response = await self.http_client.post(
             "https://api.payment.com/orders",
-            json={"amount": amount, "order_id": order_id},
+            json={{"amount": amount, "order_id": order_id}},
         )
         return response.json()
 
@@ -41,12 +41,12 @@ class PaymentAdapter(BaseAdapter):
     async def create_order_mock(self, amount: int, order_id: str) -> dict:
         """创建支付订单（Mock 实现）。"""
         if amount > 100000:
-            return {"success": False, "error": "金额超限"}
-        return {
+            return {{"success": False, "error": "金额超限"}}
+        return {{
             "success": True,
-            "transaction_id": f"mock_tx_{order_id}",
+            "transaction_id": f"mock_tx_{{order_id}}",
             "amount": amount,
-        }
+        }}
 
     @adapter_method("query_order")
     async def query_order(self, transaction_id: str) -> dict:
@@ -59,11 +59,11 @@ class PaymentAdapter(BaseAdapter):
     @query_order.mock
     async def query_order_mock(self, transaction_id: str) -> dict:
         """查询支付订单（Mock）。"""
-        return {
+        return {{
             "transaction_id": transaction_id,
             "status": "paid",
             "mock": True,
-        }
+        }}
 ```
 
 ## 16.3 Adapter 配置
@@ -78,7 +78,7 @@ THIRD_PARTY__GATEWAY_MODE=mock
 
 # 方法级模式覆盖（JSON 格式）
 # 例如：query 方法使用 real，其他方法使用全局配置
-THIRD_PARTY__METHOD_MODES={"query_order": "real"}
+THIRD_PARTY__METHOD_MODES={{"query_order": "real"}}
 
 # Mock 策略：decorator（装饰器）/ auto（自动生成）
 THIRD_PARTY__MOCK_STRATEGY=decorator
@@ -140,7 +140,7 @@ class WechatAdapter(HttpAdapter):
         return await self._request(
             "POST",
             "/cgi-bin/message/send",
-            json={"touser": openid, "content": content},
+            json={{"touser": openid, "content": content}},
         )
 
     @send_message.mock
@@ -156,13 +156,13 @@ class WechatAdapter(HttpAdapter):
 ```python
 settings = AdapterSettings(
     mode="mock",  # 默认 Mock
-    method_modes={
+    method_modes={{
         "query_order": "real",      # 查询走真实接口
         "create_order": "mock",     # 创建走 Mock
         "refund": "disabled",       # 退款禁用
-    },
+    }},
+    debug=True,
 )
-
 adapter = PaymentAdapter("payment", settings)
 
 # query_order 会调用真实 API
@@ -237,19 +237,19 @@ class PaymentAdapter(HttpAdapter):
         self, method: str, args: tuple, kwargs: dict
     ) -> None:
         """调用前钩子。"""
-        logger.info(f"调用 {method}，参数: {args}")
+        logger.info(f"调用 {{method}}，参数: {{args}}")
 
     async def _on_after_call(
         self, method: str, args: tuple, kwargs: dict, result: Any
     ) -> None:
         """调用后钩子。"""
-        logger.info(f"{method} 返回: {result}")
+        logger.info(f"{{method}} 返回: {{result}}")
 
     async def _on_call_error(
         self, method: str, args: tuple, kwargs: dict, error: Exception
     ) -> None:
         """调用异常钩子。"""
-        logger.error(f"{method} 异常: {error}")
+        logger.error(f"{{method}} 异常: {{error}}")
         # 可以在这里发送告警
 ```
 
@@ -277,11 +277,11 @@ class CompositePaymentAdapter(BaseAdapter):
     @pay.mock
     async def pay_mock(self, channel: str, amount: int, order_id: str) -> dict:
         """统一 Mock 实现。"""
-        return {
+        return {{
             "success": True,
             "channel": channel,
-            "transaction_id": f"mock_{channel}_{order_id}",
-        }
+            "transaction_id": f"mock_{{channel}}_{{order_id}}",
+        }}
 ```
 
 ## 16.8 异常处理
@@ -303,9 +303,9 @@ except AdapterTimeoutError:
     logger.error("支付适配器超时")
     # 重试或告警
 except AdapterValidationError as e:
-    logger.error(f"参数校验失败: {e}")
+    logger.error(f"参数校验失败: {{e}}")
 except AdapterError as e:
-    logger.error(f"适配器错误: {e}")
+    logger.error(f"适配器错误: {{e}}")
 ```
 
 ## 16.9 最佳实践
@@ -329,16 +329,16 @@ async def create_order_mock(self, amount: int, order_id: str) -> dict:
     """Mock 应模拟各种场景。"""
     # 模拟金额校验
     if amount <= 0:
-        return {"success": False, "error": "金额必须大于0"}
+        return {{"success": False, "error": "金额必须大于0"}}
     if amount > 100000:
-        return {"success": False, "error": "金额超限"}
+        return {{"success": False, "error": "金额超限"}}
 
     # 模拟偶发失败（可选）
     import random
     if random.random() < 0.01:
-        return {"success": False, "error": "系统繁忙"}
+        return {{"success": False, "error": "系统繁忙"}}
 
-    return {"success": True, "transaction_id": f"mock_{order_id}"}
+    return {{"success": True, "transaction_id": f"mock_{{order_id}}"}}
 ```
 
 ### 3. 环境配置建议
@@ -381,11 +381,11 @@ class OrderService(BaseService):
     async def create_order(self, user_id: str, amount: int) -> Order:
         """创建订单并发起支付。"""
         # 1. 创建订单记录
-        order = await self.order_repo.create({
+        order = await self.order_repo.create({{
             "user_id": user_id,
             "amount": amount,
             "status": "pending",
-        })
+        }})
 
         # 2. 调用支付适配器
         pay_result = await self.payment.create_order(amount, str(order.id))
@@ -394,10 +394,10 @@ class OrderService(BaseService):
             raise PaymentError(pay_result["error"])
 
         # 3. 更新订单状态
-        await self.order_repo.update(order, {
+        await self.order_repo.update(order, {{
             "transaction_id": pay_result["transaction_id"],
             "status": "paid",
-        })
+        }})
 
         return order
 ```

aury/boot/commands/templates/project/aury_docs/99-cli.md.tpl

@@ -59,6 +59,31 @@ aury scheduler    # 独立运行调度器
 aury worker       # 运行 Dramatiq Worker
 ```
 
+## 包管理
+
+```bash
+# 查看所有可用模块
+aury pkg list
+
+# 查看预设配置
+aury pkg preset
+aury pkg preset api              # 查看某个预设详情
+
+# 安装模块
+aury pkg install postgres redis  # 安装指定模块
+aury pkg install --preset api    # 按预设安装（postgres + redis + admin）
+aury pkg install --preset worker # 按预设安装（任务队列 + 调度器）
+
+# 卸载模块
+aury pkg remove redis
+```
+
+可用预设：
+- `minimal` - 本地开发（sqlite）
+- `api` - API 服务（postgres + redis + admin）
+- `worker` - 后台 Worker（postgres + redis + tasks + rabbitmq + scheduler）
+- `full` - 完整功能
+
 ## 环境变量配置
 
 所有配置项都可通过环境变量设置，优先级：命令行参数 > 环境变量 > .env 文件 > 默认值

aury/boot/commands/templates/project/config.py.tpl

@@ -9,6 +9,8 @@
     LOG__LEVEL=INFO
 """
 
+from functools import lru_cache
+
 from aury.boot.application.config import BaseConfig
 
 
@@ -28,3 +30,9 @@ class AppConfig(BaseConfig):
     # 添加自定义配置项
     # my_setting: str = Field(default="value", description="自定义配置")
     pass
+
+
+@lru_cache
+def get_settings() -> AppConfig:
+    """获取应用配置单例。"""
+    return AppConfig()

aury/boot/infrastructure/storage/__init__.py

@@ -5,34 +5,45 @@
 
 # 从 SDK 直接导出核心类型
 from aury.sdk.storage.storage import (
+    COSStorage,  # 可选依赖，未安装 cos extras 时为 None
     IStorage,
     LocalStorage,
     S3Storage,  # 可选依赖，未安装 aws extras 时为 None
     StorageBackend,
     StorageConfig,
     StorageFile,
+    StorageType,
     UploadResult,
 )
 
+# SDK 工厂（基于 StorageType 枚举）
+from aury.sdk.storage.storage import StorageFactory as SDKStorageFactory
+
 from .base import StorageManager
 from .exceptions import StorageBackendError, StorageError, StorageNotFoundError
+
+# Boot 工厂（注册机制）
 from .factory import StorageFactory
 
 __all__ = [
     # SDK 类型
+    "COSStorage",
     "IStorage",
     "LocalStorage",
     "S3Storage",
     "StorageBackend",
-    "StorageBackendError",
     "StorageConfig",
+    "StorageFile",
+    "StorageType",
+    "UploadResult",
+    # 工厂
+    "SDKStorageFactory",  # SDK 工厂（基于枚举类型）
+    "StorageFactory",  # Boot 工厂（注册机制）
     # 异常
+    "StorageBackendError",
     "StorageError",
-    "StorageFactory",
-    "StorageFile",
-    # 管理器与工厂
-    "StorageManager",
     "StorageNotFoundError",
-    "UploadResult",
+    # 管理器
+    "StorageManager",
 ]
 

aury/boot/infrastructure/storage/base.py

@@ -9,11 +9,12 @@ from aury.boot.common.logging import logger
 from aury.sdk.storage.storage import (
     IStorage,
     LocalStorage,
-    S3Storage,
-    StorageBackend,
     StorageConfig,
     StorageFile,
 )
+from aury.sdk.storage.storage import (
+    StorageFactory as SDKStorageFactory,
+)
 
 
 class StorageManager:
@@ -78,11 +79,8 @@ class StorageManager:
             self: 支持链式调用
         """
         self._config = config
-        if config.backend == StorageBackend.LOCAL:
-            self._backend = LocalStorage(base_path=config.base_path or "./storage")
-        else:
-            # S3/COS/OSS/MinIO 统一走 S3Storage
-            self._backend = S3Storage(config)
+        # 使用 SDK 的 StorageFactory 创建后端实例
+        self._backend = SDKStorageFactory.from_config(config)
         logger.info(f"存储管理器初始化完成: {config.backend.value}")
         return self
 
@@ -168,8 +166,7 @@ class StorageManager:
 __all__ = [
     "IStorage",
     "LocalStorage",
-    "S3Storage",
-    "StorageBackend",
+    "SDKStorageFactory",
     "StorageConfig",
     "StorageFile",
     "StorageManager",

{aury_boot-0.0.10.dist-info → aury_boot-0.0.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.10
+Version: 0.0.12
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2

{aury_boot-0.0.10.dist-info → aury_boot-0.0.12.dist-info}/RECORD

@@ -1,5 +1,5 @@
 aury/boot/__init__.py,sha256=pCno-EInnpIBa1OtxNYF-JWf9j95Cd2h6vmu0xqa_-4,1791
-aury/boot/_version.py,sha256=qWM7tuFjLDSZffhqImvB3QeSymOYGxPQLtsW7Q2jQD0,706
+aury/boot/_version.py,sha256=AZGfWDETy7COMkzrSothvXJ8vYrPI7kp7_Tcfcp9hUQ,706
 aury/boot/application/__init__.py,sha256=0o_XmiwFCeAu06VHggS8I1e7_nSMoRq0Hcm0fYfCywU,3071
 aury/boot/application/adapter/__init__.py,sha256=e1bcSb1bxUMfofTwiCuHBZJk5-STkMCWPF2EJXHQ7UU,3976
 aury/boot/application/adapter/base.py,sha256=Ar_66fiHPDEmV-1DKnqXKwc53p3pozG31bgTJTEUriY,15763
@@ -32,7 +32,7 @@ aury/boot/application/middleware/__init__.py,sha256=T01fmbcdO0Sm6JE74g23uuDyebBG
 aury/boot/application/middleware/logging.py,sha256=VXd472GJpOQ_n54896tQHauoPSdXyklGD_ZgMoIKsHQ,12633
 aury/boot/application/migrations/__init__.py,sha256=Z5Gizx7f3AImRcl3cooiIDAZcNi5W-6GvB7mK5w1TNA,204
 aury/boot/application/migrations/manager.py,sha256=G7mzkNA3MFjyQmM2UwY0ZFNgGGVS4W5GoG2Sbj5AUXk,23685
-aury/boot/application/migrations/setup.py,sha256=P89QSMV2JQQb1FuyA9KHhgqSzKWZneCmOtOrLvEmKYQ,6261
+aury/boot/application/migrations/setup.py,sha256=cxzBIHGzRXhlIYs4_ZW6P85Z9A7uVnTq_dmQFKp3ha4,6485
 aury/boot/application/rpc/__init__.py,sha256=0mVyksLbTOLYMN4OtYrdf9naBNVQnAU9pt2kS2w_9ZY,2064
 aury/boot/application/rpc/base.py,sha256=KqdWupF2PTizr--jE0KgJUDCfBap72ZWk9FtU5FM9_8,2618
 aury/boot/application/rpc/client.py,sha256=ApW4h_DrwnnkAh921TVUd4fvdWP-rVIse3VW1_1TLPk,9113
@@ -42,12 +42,13 @@ aury/boot/application/scheduler/runner.py,sha256=g8CM5bDtjiiaMV3662fAOAzh4_bzlQl
 aury/boot/application/server/__init__.py,sha256=WgSeWItN6oXUzYr1rflGreFiASkLXVt0Z3qkGGtLTI0,8964
 aury/boot/commands/__init__.py,sha256=8HqWCNefFDk1I-NyViUfCYjynzV7YsdnIsbgoj_sJjo,1486
 aury/boot/commands/add.py,sha256=JRJir92oFHwIBtIKKEjQ7trUhfb9-kCH84x_7saV2gI,2647
-aury/boot/commands/app.py,sha256=-kHcWdZ_D4xDwjOiUkcNSCTYKIUYz39HJV87eaZpeY8,7557
+aury/boot/commands/app.py,sha256=k0zHzR3ckt17laAYk6WwwS-lqzS-N8811XjKC-7lerg,7857
 aury/boot/commands/config.py,sha256=gPkG_jSWrXidjpyVdzABH7uRhoCgX5yrOcdKabtX5wY,4928
 aury/boot/commands/docker.py,sha256=7mKorZCPZgxH1XFslzo6W-uzpe61hGXz86JKOhOeBlo,9006
 aury/boot/commands/docs.py,sha256=-uCvrKj0_shdeBY08W6zx5vNpsBM3yc_IIOOQzoFbqE,11647
 aury/boot/commands/generate.py,sha256=WZieSXuofxJOC7NBiVGpBigB9NZ4GMcF2F1ReTNun1I,44420
-aury/boot/commands/init.py,sha256=HcfBLaU3MwF0tSRTVUEUEA__INwB_cbF7DKRPQ_1Lf0,32358
+aury/boot/commands/init.py,sha256=4JsQ6U48ZfH_Vzu83k3439gc77Zcmn9arKHgH_kq7HM,32808
+aury/boot/commands/pkg.py,sha256=SyHpeSh0vuGVHNmv97-0ZX7AjuSttfZkOs7T86Pq-NQ,14489
 aury/boot/commands/scheduler.py,sha256=BCIGQcGryXpsYNF-mncP6v5kNoz6DZ10DMzMKVDiXxA,3516
 aury/boot/commands/worker.py,sha256=qAcPdoKpMBLYoi45X_y2-nobuYKxscJpooEB_0HhM4o,4163
 aury/boot/commands/migrate/__init__.py,sha256=W9OhkX8ILdolySofgdP2oYoJGG9loQd5FeSwkniU3qM,455
@@ -63,7 +64,7 @@ aury/boot/commands/templates/generate/service.py.tpl,sha256=2hwQ8e4a5d_bIMx_jGDo
 aury/boot/commands/templates/project/AGENTS.md.tpl,sha256=lzRh23-8Buw5JgZ_BRuMH15gh6WmxJRU4dbZ57fyntA,7309
 aury/boot/commands/templates/project/README.md.tpl,sha256=oCeBiukk6Pa3hrCKybkfM2sIRHsPZ15nlwuFTUSFDwY,2459
 aury/boot/commands/templates/project/admin_console_init.py.tpl,sha256=K81L14thyEhRA8lFCQJVZL_NU22-sBz0xS68MJPeoCo,1541
-aury/boot/commands/templates/project/config.py.tpl,sha256=ZCZHHvTOv3dm0VcJqmqkvoIEzKoBBcfne_UYnqimc7s,869
+aury/boot/commands/templates/project/config.py.tpl,sha256=H_B05FypBJxTjb7qIL91zC1C9e37Pk7C9gO0-b3CqNs,1009
 aury/boot/commands/templates/project/conftest.py.tpl,sha256=chbETK81Hy26cWz6YZ2cFgy7HbnABzYCqeyMzgpa3eI,726
 aury/boot/commands/templates/project/gitignore.tpl,sha256=OI0nt9u2E9EC-jAMoh3gpqamsWo18uDgyPybgee_snQ,3053
 aury/boot/commands/templates/project/main.py.tpl,sha256=Q61ve3o1VkNPv8wcQK7lUosne18JWYeItxoXVNNoYJM,1070
@@ -77,14 +78,14 @@ aury/boot/commands/templates/project/aury_docs/06-exception.md.tpl,sha256=Tv_Q5l
 aury/boot/commands/templates/project/aury_docs/07-cache.md.tpl,sha256=EQMI7vJIwJT-VdG4p1GMCDEo58DCO1n6V-MvUzGSaS0,3411
 aury/boot/commands/templates/project/aury_docs/08-scheduler.md.tpl,sha256=zk7RHjtx_QGjmeLy04Nk_qSc8sofTrubS2Tg7DxfEl4,858
 aury/boot/commands/templates/project/aury_docs/09-tasks.md.tpl,sha256=swHOQ_pWPtW8Bsy1arPu2OeIgs1FoKsJ2AsVSYUWPHY,931
-aury/boot/commands/templates/project/aury_docs/10-storage.md.tpl,sha256=5zamjmVxp3q16De1w_il2vdzEho1O_FoZBN8PIVp2aI,2976
+aury/boot/commands/templates/project/aury_docs/10-storage.md.tpl,sha256=mhe0j0S51ndPJLjaQ6yD8OPYBEO02NHumJVbBvz2qkw,4320
 aury/boot/commands/templates/project/aury_docs/11-logging.md.tpl,sha256=jdczsKrQuvS3KbR2KdfCu0fUbFNbvP8DHzfYASV-4N0,3397
 aury/boot/commands/templates/project/aury_docs/12-admin.md.tpl,sha256=6z3mN54qP2jtpTFOJBLVexvEv0ZHXYKjncvpZG4yOdw,1883
 aury/boot/commands/templates/project/aury_docs/13-channel.md.tpl,sha256=rdtlog3ajcSsT0fq9a_US3MPcZhTvDo72eT6hetg4aI,3376
 aury/boot/commands/templates/project/aury_docs/14-mq.md.tpl,sha256=4bxLQBbCi0Fue0VQWOPt6acZ5P00BoLkCoLPQe_8k4U,2396
 aury/boot/commands/templates/project/aury_docs/15-events.md.tpl,sha256=a4wQRgVPuYUGTGmw_lX1HJH_yFTbD30mBz7Arc4zgfs,3361
-aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl,sha256=wPbDKoIMw-d-wwvSWHGm0OF4r9PtoAsQWwTK0BJESCA,11377
-aury/boot/commands/templates/project/aury_docs/99-cli.md.tpl,sha256=s0tIhVEi7N9AOABGsFx0hD1g6YutG5ehAG0XMQQva0E,3020
+aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl,sha256=mKLbvIJxHNQOIeDLJH_v5EYaZYEu54K4jGSk8kEianA,11444
+aury/boot/commands/templates/project/aury_docs/99-cli.md.tpl,sha256=_dXMK8V7HJAsA_6R1SboD8Rv63s7sDPolvQoSQvKXgA,3667
 aury/boot/commands/templates/project/env_templates/_header.tpl,sha256=Pt0X_I25o1th3CLR228L2-nlcC-lIkN8cPailohBEkU,513
 aury/boot/commands/templates/project/env_templates/admin.tpl,sha256=wWt3iybOpBHtuw6CkoUJ1bzEL0aNgOzKDEkMKhI2oag,2032
 aury/boot/commands/templates/project/env_templates/cache.tpl,sha256=_sK-p_FECj4mVvggNvgb4Wu0yGii0Ocz560syG7DU2c,498
@@ -176,8 +177,8 @@ aury/boot/infrastructure/mq/backends/redis.py,sha256=i8KECToIFEZ6CnHyNCk34_xdff5
 aury/boot/infrastructure/scheduler/__init__.py,sha256=eTRJ5dSPcKvyFvLVtraoQteXTTDDGwIrmw06J2hoNdA,323
 aury/boot/infrastructure/scheduler/exceptions.py,sha256=ROltrhSctVWA-6ulnjuYeHAk3ZF-sykDoesuierYzew,634
 aury/boot/infrastructure/scheduler/manager.py,sha256=vvVditIJC4WaeqWWpUXSmMdkqnlUHREPd0BRPSNpnyY,15554
-aury/boot/infrastructure/storage/__init__.py,sha256=sUfZqHFLYeutssN5t_LcnOApnxwOreXy-1YtDPmtEdo,866
-aury/boot/infrastructure/storage/base.py,sha256=aWBCmPHF5Hkj8VWH2BGkpdeLfqf9uWECOVTFHNj7knw,5131
+aury/boot/infrastructure/storage/__init__.py,sha256=bA-n3v2S1FX6XsQbLqt0hkgx512MjUn_b8kJo53G6gA,1238
+aury/boot/infrastructure/storage/base.py,sha256=X9aswSMWtKZ6TdG5Rrh6qJpqIVLt1QcFkQAKdyUWPi0,5039
 aury/boot/infrastructure/storage/exceptions.py,sha256=Av1r94bRkeeeDo6vgAD9e_9YA9Ge6D7F2U1qzUs-8FE,622
 aury/boot/infrastructure/storage/factory.py,sha256=-ua2N5Uw5K14F1FzkGjlqv9VQCtywuZEB9o_kL465IU,2479
 aury/boot/infrastructure/tasks/__init__.py,sha256=Ne3VRVj4Y7x51UUkJH8nVrbxucCbalsQB7PmthqSfxY,513
@@ -191,7 +192,7 @@ aury/boot/testing/client.py,sha256=KOg1EemuIVsBG68G5y0DjSxZGcIQVdWQ4ASaHE3o1R0,4
 aury/boot/testing/factory.py,sha256=8GvwX9qIDu0L65gzJMlrWB0xbmJ-7zPHuwk3eECULcg,5185
 aury/boot/toolkit/__init__.py,sha256=AcyVb9fDf3CaEmJPNkWC4iGv32qCPyk4BuFKSuNiJRQ,334
 aury/boot/toolkit/http/__init__.py,sha256=zIPmpIZ9Qbqe25VmEr7jixoY2fkRbLm7NkCB9vKpg6I,11039
-aury_boot-0.0.10.dist-info/METADATA,sha256=i5glHELenzosPJRyoJBQcn9ujPccCjMvo9BmnNAqX6E,7981
-aury_boot-0.0.10.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-aury_boot-0.0.10.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
-aury_boot-0.0.10.dist-info/RECORD,,
+aury_boot-0.0.12.dist-info/METADATA,sha256=YB6RyOOKJdDaZbfk-RhHL041oPN8DZ0kZFRxlrR8mys,7981
+aury_boot-0.0.12.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+aury_boot-0.0.12.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
+aury_boot-0.0.12.dist-info/RECORD,,