aury-boot 0.0.4__py3-none-any.whl → 0.0.7__py3-none-any.whl

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/_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.7'
+__version_tuple__ = version_tuple = (0, 0, 7)
 
 __commit_id__ = commit_id = None

aury/boot/application/__init__.py

@@ -5,6 +5,14 @@
 
 # 事件系统（从 infrastructure 导入 - Event 定义在最底层）
 # 事务管理（从 domain 导入）
+# 第三方适配器
+from aury.boot.application.adapter import (
+    AdapterError,
+    AdapterSettings,
+    BaseAdapter,
+    HttpAdapter,
+    adapter_method,
+)
 from aury.boot.domain.transaction import (
     TransactionManager,
     TransactionRequiredError,
@@ -17,10 +25,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 +75,70 @@ from .scheduler import run_scheduler, run_scheduler_sync
 from .server import ApplicationServer, run_app
 
 __all__ = [
+    # 第三方适配器
+    "AdapterError",
+    "AdapterSettings",
+    # 服务器集成
+    "ApplicationServer",
+    "BaseAdapter",
     # 配置
     "BaseConfig",
+    # 中间件
+    "CORSMiddleware",
     "CORSSettings",
+    # 组件
+    "CacheComponent",
     "CacheSettings",
-    "LogSettings",
-    "ServerSettings",
+    # 基类
+    "Component",
     # 常量
     "ComponentName",
-    "MiddlewareName",
-    "SchedulerMode",
-    "ServiceType",
+    # 依赖注入容器
+    "Container",
+    "DatabaseComponent",
+    # 事件系统
+    "Event",
+    "EventBackend",
+    "EventBusManager",
+    "EventHandler",
+    "EventType",
     # 应用框架
     "FoundationApp",
-    # 基类
-    "Component",
+    "HttpAdapter",
+    "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",
+    # 第三方适配器装饰器
+    "adapter_method",
     "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/application/adapter/__init__.py

@@ -0,0 +1,112 @@
+"""第三方接口适配器模块。
+
+本模块用于封装第三方接口（如支付、短信、微信、云存储等外部服务）的调用，
+解决测试环境中第三方接口不可用的问题，通过配置切换真实调用与挡板（Mock）实现。
+
+核心特性:
+- 多模式切换：real(真实)/sandbox(沙箱)/mock(挡板)/disabled(禁用)
+- 按方法级别的模式覆盖：同一 Adapter 不同方法可用不同模式
+- 装饰器声明式定义：@adapter_method + .mock 链式定义挡板逻辑
+- HTTP 类第三方的便捷基类：HttpAdapter 封装请求/认证/错误处理
+- 调用历史记录：便于测试断言，验证调用参数和结果
+
+模式说明:
+- real: 调用真实第三方接口（生产环境）
+- sandbox: 调用第三方提供的沙箱环境（如果有）
+- mock: 使用本地挡板实现，不发出真实请求（测试/开发环境）
+- disabled: 禁用该接口，调用时抛出 AdapterDisabledError
+
+设计原则:
+- 最小约束：只约束"模式怎么切换"，不限制具体调用方式
+- 最大自由：HTTP/SDK/gRPC/任意协议都能用
+- 可组合：Adapter 可以组合其他 Adapter
+
+典型使用场景:
+1. 测试环境：第三方接口不可用，使用 mock 模式运行测试
+2. 开发环境：避免消耗真实资源（如短信费用），使用 mock
+3. 部分挡板：查询接口走真实，写入接口走 mock
+4. 功能开关：禁用某些危险操作（如退款）在测试环境
+
+使用示例:
+    from aury.boot.application.adapter import (
+        HttpAdapter, adapter_method, AdapterSettings
+    )
+    
+    class PaymentAdapter(HttpAdapter):
+        '''支付第三方接口适配器。'''
+        
+        @adapter_method("create")
+        async def create_order(self, amount: int, order_id: str) -> dict:
+            '''创建支付订单（真实实现）。'''
+            return await self._request("POST", "/charge", json={"amount": amount, "order_id": order_id})
+        
+        @create_order.mock
+        async def create_order_mock(self, amount: int, order_id: str) -> dict:
+            '''创建支付订单（挡板实现）。
+            
+            挡板可以包含业务逻辑，模拟各种场景（成功、失败、边界情况）。
+            '''
+            if amount > 10000:
+                return {"success": False, "error": "金额超限"}
+            return {"success": True, "mock": True, "order_id": order_id}
+    
+    # 配置：测试环境使用挡板，但 query 走真实接口
+    settings = AdapterSettings(
+        mode="mock",                      # 默认走挡板
+        method_modes={"query": "real"},   # query 走真实
+        base_url="https://api.payment.com",
+    )
+    
+    adapter = PaymentAdapter("payment", settings)
+    result = await adapter.create_order(100, "order-1")  # 走挡板
+
+环境变量配置:
+    # 全局模式
+    THIRD_PARTY_PAYMENT_MODE=mock
+    
+    # 连接配置
+    THIRD_PARTY_PAYMENT_BASE_URL=https://api.payment.com
+    THIRD_PARTY_PAYMENT_SANDBOX_URL=https://sandbox.payment.com
+    THIRD_PARTY_PAYMENT_API_KEY=sk_test_xxx
+    THIRD_PARTY_PAYMENT_TIMEOUT=30
+    
+    # 方法级模式覆盖（JSON 格式）
+    THIRD_PARTY_PAYMENT_METHOD_MODES={"query": "real", "refund": "disabled"}
+    
+    # 挡板配置
+    THIRD_PARTY_PAYMENT_MOCK_DELAY=0.1  # 模拟网络延迟
+"""
+
+from .base import BaseAdapter, CallRecord
+from .config import (
+    AdapterMode,
+    AdapterSettings,
+    MockStrategy,
+    ThirdPartySettings,
+)
+from .decorators import adapter_method
+from .exceptions import (
+    AdapterDisabledError,
+    AdapterError,
+    AdapterTimeoutError,
+)
+from .http import HttpAdapter
+
+__all__ = [
+    # 基类
+    "BaseAdapter",
+    "HttpAdapter",
+    # 配置
+    "AdapterSettings",
+    "AdapterMode",
+    "MockStrategy",
+    "ThirdPartySettings",
+    # 装饰器
+    "adapter_method",
+    # 异常
+    "AdapterError",
+    "AdapterDisabledError",
+    "AdapterTimeoutError",
+    # 数据类
+    "CallRecord",
+]