ErisPulse 2.3.3.dev0__py3-none-any.whl → 2.3.4.dev2__py3-none-any.whl

ErisPulse/Core/__init__.py

@@ -1,12 +1,11 @@
-from .lifecycle import lifecycle
-from .adapter import adapter
+from .lifecycle import lifecycle, LifecycleManager
+from .adapter import adapter, AdapterManager
 from .Bases import BaseAdapter, BaseModule, SendDSL
-from .storage import storage
-from .logger import logger
-from .module import module
-from .router import router
-from .config import config
-from .ux import ux, UXManager
+from .storage import storage, StorageManager
+from .logger import logger, Logger, LoggerChild
+from .module import module, ModuleManager
+from .router import router, RouterManager
+from .config import config, ConfigManager
 from . import exceptions
 from . import Event
 
@@ -21,29 +20,33 @@ __all__ = [
 
     # 适配器相关
     'adapter',          # 适配器管理器
+    'AdapterManager',   # 适配器管理器类
     'AdapterFather',    # 适配器基类
     'BaseAdapter',      # 适配器基类别名
     'SendDSL',          # DSL发送接口基类
 
     # 模块相关
     'module',           # 模块管理器
+    'ModuleManager',    # 模块管理器类
     'BaseModule',       # 模块基类
     
     # 存储和配置相关
     'storage',          # 存储管理器
+    'StorageManager',   # 存储管理器类
     'config',           # 配置管理器
+    'ConfigManager',    # 配置管理器类
     'env',              # 配置管理器别名
 
     # 路由相关
     'router',           # 路由管理器
+    'RouterManager',    # 路由管理器类
     'adapter_server',   # 路由管理器别名
 
-    # UX
-    'ux',               # UX管理器实例
-    'UXManager',        # UX管理器类
-
     # 基础设施
     'logger',           # 日志管理器
+    'Logger',           # 日志管理器类
+    'LoggerChild',      # 日志子管理器类
     'exceptions',       # 异常处理模块
-    'lifecycle'         # 生命周期管理器
+    'lifecycle',        # 生命周期管理器
+    'LifecycleManager', # 生命周期管理器类
 ]

ErisPulse/Core/__init__.pyi

@@ -0,0 +1,16 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+from .lifecycle import lifecycle, LifecycleManager
+from .adapter import adapter, AdapterManager
+from .Bases import BaseAdapter, BaseModule, SendDSL
+from .storage import storage, StorageManager
+from .logger import logger, Logger, LoggerChild
+from .module import module, ModuleManager
+from .router import router, RouterManager
+from .config import config, ConfigManager
+from . import exceptions
+from . import Event

ErisPulse/Core/_self_config.py

@@ -21,7 +21,7 @@ DEFAULT_ERISPULSE_CONFIG = {
         "memory_limit": 1000
     },
     "storage":  {
-        "max_snapshot": 20
+        "use_global_db": False,
     },
     "modules": {},
     "adapters": {},

ErisPulse/Core/_self_config.pyi

@@ -0,0 +1,72 @@
+# type: ignore
+#
+# Auto-generated type stub for _self_config.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 框架配置管理
+
+专门管理 ErisPulse 框架自身的配置项。
+"""
+
+from typing import Dict, Any
+from .config import config
+
+def _ensure_erispulse_config_structure(config_dict: Dict[(str, Any)]) -> Dict[(str, Any)]:
+    """
+    确保 ErisPulse 配置结构完整，补全缺失的配置项
+    
+    :param config_dict: 当前配置
+    :return: 补全后的完整配置
+    """
+    ...
+
+def get_erispulse_config() -> Dict[(str, Any)]:
+    """
+    获取 ErisPulse 框架配置，自动补全缺失的配置项并保存
+    
+    :return: 完整的 ErisPulse 配置字典
+    """
+    ...
+
+def update_erispulse_config(new_config: Dict[(str, Any)]) -> bool:
+    """
+    更新 ErisPulse 配置，自动补全缺失的配置项
+    
+    :param new_config: 新的配置字典
+    :return: 是否更新成功
+    """
+    ...
+
+def get_server_config() -> Dict[(str, Any)]:
+    """
+    获取服务器配置，确保结构完整
+    
+    :return: 服务器配置字典
+    """
+    ...
+
+def get_logger_config() -> Dict[(str, Any)]:
+    """
+    获取日志配置，确保结构完整
+    
+    :return: 日志配置字典
+    """
+    ...
+
+def get_storage_config() -> Dict[(str, Any)]:
+    """
+    获取存储模块配置
+    
+    :return: 存储配置字典
+    """
+    ...
+
+def get_framework_config() -> Dict[(str, Any)]:
+    """
+    获取框架配置
+    
+    :return: 框架配置字典
+    """
+    ...

ErisPulse/Core/adapter.py

@@ -14,8 +14,9 @@ from .logger import logger
 from .Bases.adapter import BaseAdapter
 from .config import config
 from .lifecycle import lifecycle
+from .Bases.manager import ManagerBase
 
-class AdapterManager:
+class AdapterManager(ManagerBase):
     """
     适配器管理器
 
@@ -269,6 +270,9 @@ class AdapterManager:
         from .router import router
         await router.stop()
 
+        # 清空已启动实例集合
+        self._started_instances.clear()
+
         # 提交适配器关闭完成事件
         await lifecycle.submit_event(
             "adapter.stopped",
@@ -301,9 +305,8 @@ class AdapterManager:
         :param platform: 平台名称
         :return: [bool] 平台是否存在
         """
-        # 检查平台是否在配置中注册
-        adapter_statuses = config.getConfig("ErisPulse.adapters.status", {})
-        return platform in adapter_statuses
+        # 检查平台是否已注册（在 _adapters 中）
+        return platform in self._adapters
 
     def is_enabled(self, platform: str) -> bool:
         """
@@ -332,10 +335,11 @@ class AdapterManager:
         :param platform: 平台名称
         :return: [bool] 操作是否成功
         """
-        if not self.exists(platform):
+        # 启用平台时自动在配置中注册
+        if platform not in self._adapters:
             logger.error(f"平台 {platform} 不存在")
             return False
-
+        
         config.setConfig(f"ErisPulse.adapters.status.{platform}", True)
         logger.info(f"平台 {platform} 已启用")
         return True
@@ -347,21 +351,77 @@ class AdapterManager:
         :param platform: 平台名称
         :return: [bool] 操作是否成功
         """
-        if not self.exists(platform):
+        # 禁用平台时自动在配置中注册
+        if platform not in self._adapters:
             logger.error(f"平台 {platform} 不存在")
             return False
-
+        
         config.setConfig(f"ErisPulse.adapters.status.{platform}", False)
         logger.info(f"平台 {platform} 已禁用")
         return True
 
+    def unregister(self, platform: str) -> bool:
+        """
+        取消注册适配器
+        
+        :param platform: 平台名称
+        :return: 是否取消成功
+        
+        {!--< internal-use >!--}
+        注意：此方法仅取消注册，不关闭已启动的适配器
+        {!--< /internal-use >!--}
+        """
+        if platform not in self._adapters:
+            logger.warning(f"平台 {platform} 未注册")
+            return False
+        
+        # 移除适配器实例
+        adapter = self._adapters.pop(platform)
+        
+        # 移除平台属性
+        if len(platform) <= 10:
+            from itertools import product
+            combinations = [''.join(c) for c in product(*[(ch.lower(), ch.upper()) for ch in platform])]
+            for name in set(combinations):
+                if hasattr(self, name):
+                    delattr(self, name)
+        else:
+            if hasattr(self, platform.lower()):
+                delattr(self, platform.lower())
+            if hasattr(self, platform.upper()):
+                delattr(self, platform.upper())
+            if hasattr(self, platform.capitalize()):
+                delattr(self, platform.capitalize())
+        
+        logger.info(f"平台 {platform} 已取消注册")
+        return True
+    
+    def list_registered(self) -> List[str]:
+        """
+        列出所有已注册的平台
+        
+        :return: 平台名称列表
+        """
+        return list(self._adapters.keys())
+    
+    def list_items(self) -> Dict[str, bool]:
+        """
+        列出所有平台适配器状态
+        
+        :return: {平台名: 是否启用} 字典
+        """
+        return config.getConfig("ErisPulse.adapters.status", {})
+    
+    # 兼容性方法 - 保持向后兼容
     def list_adapters(self) -> Dict[str, bool]:
         """
         列出所有平台适配器状态
-
+        
+        {!--< deprecated >!--} 请使用 list_items() 代替
+        
         :return: [Dict[str, bool]] 平台适配器状态字典
         """
-        return config.getConfig("ErisPulse.adapters.status", {})
+        return self.list_items()
 
     # ==================== 事件处理与消息发送 ====================
 

ErisPulse/Core/adapter.pyi

@@ -0,0 +1,246 @@
+# type: ignore
+#
+# Auto-generated type stub for adapter.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 适配器系统
+
+提供平台适配器管理功能。支持多平台消息处理、事件驱动和生命周期管理。
+"""
+
+import functools
+import asyncio
+from typing import Callable, Any, Dict, List, Type, Optional, Set
+from collections import defaultdict
+from .logger import logger
+from .Bases.adapter import BaseAdapter
+from .config import config
+from .lifecycle import lifecycle
+from .Bases.manager import ManagerBase
+
+class AdapterManager(ManagerBase):
+    """
+    适配器管理器
+    
+    管理多个平台适配器的注册、启动和关闭，提供与模块管理器一致的接口
+    
+    {!--< tips >!--}
+    1. 通过register方法注册适配器
+    2. 通过startup方法启动适配器
+    3. 通过shutdown方法关闭所有适配器
+    4. 通过on装饰器注册OneBot12协议事件处理器
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        ...
+    def register(self: object, platform: str, adapter_class: Type[BaseAdapter], adapter_info: Optional[Dict] = ...) -> bool:
+        """
+        注册新的适配器类（标准化注册方法）
+        
+        :param platform: 平台名称
+        :param adapter_class: 适配器类
+        :param adapter_info: 适配器信息
+        :return: 注册是否成功
+        
+        :raises TypeError: 当适配器类无效时抛出
+        
+        :example:
+        >>> adapter.register("MyPlatform", MyPlatformAdapter)
+        """
+        ...
+    def _register_platform_attributes(self: object, platform: str, instance: BaseAdapter) -> None:
+        """
+        注册平台名称的多种大小写形式作为属性
+        
+        :param platform: 平台名称
+        :param instance: 适配器实例
+        """
+        ...
+    async def startup(self: object, platforms: ... = ...) -> None:
+        """
+        启动指定的适配器
+        
+        :param platforms: 要启动的平台列表，None表示所有平台
+        
+        :raises ValueError: 当平台未注册时抛出
+        
+        :example:
+        >>> # 启动所有适配器
+        >>> await adapter.startup()
+        >>> # 启动指定适配器
+        >>> await adapter.startup(["Platform1", "Platform2"])
+        """
+        ...
+    async def shutdown(self: object) -> None:
+        """
+        关闭所有适配器
+        """
+        ...
+    def _config_register(self: object, platform: str, enabled: bool = ...) -> bool:
+        """
+        注册新平台适配器（仅当平台不存在时注册）
+        
+        :param platform: 平台名称
+        :param enabled: [bool] 是否启用适配器
+        :return: [bool] 操作是否成功
+        """
+        ...
+    def exists(self: object, platform: str) -> bool:
+        """
+        检查平台是否存在
+        
+        :param platform: 平台名称
+        :return: [bool] 平台是否存在
+        """
+        ...
+    def is_enabled(self: object, platform: str) -> bool:
+        """
+        检查平台适配器是否启用
+        
+        :param platform: 平台名称
+        :return: [bool] 平台适配器是否启用
+        """
+        ...
+    def enable(self: object, platform: str) -> bool:
+        """
+        启用平台适配器
+        
+        :param platform: 平台名称
+        :return: [bool] 操作是否成功
+        """
+        ...
+    def disable(self: object, platform: str) -> bool:
+        """
+        禁用平台适配器
+        
+        :param platform: 平台名称
+        :return: [bool] 操作是否成功
+        """
+        ...
+    def list_registered(self: object) -> List[str]:
+        """
+        列出所有已注册的平台
+        
+        :return: 平台名称列表
+        """
+        ...
+    def list_items(self: object) -> Dict[(str, bool)]:
+        """
+        列出所有平台适配器状态
+        
+        :return: {平台名: 是否启用} 字典
+        """
+        ...
+    def list_adapters(self: object) -> Dict[(str, bool)]:
+        """
+        列出所有平台适配器状态
+        
+        {!--< deprecated >!--} 请使用 list_items() 代替
+        
+        :return: [Dict[str, bool]] 平台适配器状态字典
+        """
+        ...
+    def on(self: object, event_type: str = ...) -> Callable[([Callable], Callable)]:
+        """
+        OneBot12协议事件监听装饰器
+        
+        :param event_type: OneBot12事件类型
+        :param raw: 是否监听原生事件
+        :param platform: 指定平台，None表示监听所有平台
+        :return: 装饰器函数
+        
+        :example:
+        >>> # 监听OneBot12标准事件（所有平台）
+        >>> @sdk.adapter.on("message")
+        >>> async def handle_message(data):
+        >>>     print(f"收到OneBot12消息: {data}")
+        >>>
+        >>> # 监听特定平台的OneBot12标准事件
+        >>> @sdk.adapter.on("message", platform="onebot11")
+        >>> async def handle_onebot11_message(data):
+        >>>     print(f"收到OneBot11标准消息: {data}")
+        >>>
+        >>> # 监听平台原生事件
+        >>> @sdk.adapter.on("message", raw=True, platform="onebot11")
+        >>> async def handle_raw_message(data):
+        >>>     print(f"收到OneBot11原生事件: {data}")
+        >>>
+        >>> # 监听所有平台的原生事件
+        >>> @sdk.adapter.on("message", raw=True)
+        >>> async def handle_all_raw_message(data):
+        >>>     print(f"收到原生事件: {data}")
+        """
+        ...
+    def middleware(self: object, func: Callable) -> Callable:
+        """
+        添加OneBot12中间件处理器
+        
+        :param func: 中间件函数
+        :return: 中间件函数
+        
+        :example:
+        >>> @sdk.adapter.middleware
+        >>> async def onebot_middleware(data):
+        >>>     print("处理OneBot12数据:", data)
+        >>>     return data
+        """
+        ...
+    async def emit(self: object, data: Any) -> None:
+        """
+        提交OneBot12协议事件到指定平台
+        
+        :param data: 符合OneBot12标准的事件数据
+        
+        :example:
+        >>> await sdk.adapter.emit({
+        >>>     "id": "123",
+        >>>     "time": 1620000000,
+        >>>     "type": "message",
+        >>>     "detail_type": "private",
+        >>>     "message": [{"type": "text", "data": {"text": "Hello"}}],
+        >>>     "platform": "myplatform",
+        >>>     "myplatform_raw": {...平台原生事件数据...},
+        >>>     "myplatform_raw_type": "text_message"
+        >>> })
+        """
+        ...
+    def get(self: object, platform: str) -> Optional[BaseAdapter]:
+        """
+        获取指定平台的适配器实例
+        
+        :param platform: 平台名称
+        :return: 适配器实例或None
+        
+        :example:
+        >>> adapter = adapter.get("MyPlatform")
+        """
+        ...
+    def platforms(self: object) -> List[str]:
+        """
+        获取所有已注册的平台列表
+        
+        :return: 平台名称列表
+        
+        :example:
+        >>> print("已注册平台:", adapter.platforms)
+        """
+        ...
+    def __getattr__(self: object, platform: str) -> BaseAdapter:
+        """
+        通过属性访问获取适配器实例
+        
+        :param platform: 平台名称
+        :return: 适配器实例
+        :raises AttributeError: 当平台不存在或未启用时
+        """
+        ...
+    def __contains__(self: object, platform: str) -> bool:
+        """
+        检查平台是否存在且处于启用状态
+        
+        :param platform: 平台名称
+        :return: [bool] 平台是否存在且启用
+        """
+        ...

ErisPulse/Core/config.pyi

@@ -0,0 +1,70 @@
+# type: ignore
+#
+# Auto-generated type stub for config.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 配置中心
+
+集中管理所有配置项，避免循环导入问题
+提供自动补全缺失配置项的功能
+添加内存缓存和延迟写入机制以提高性能
+"""
+
+import os
+import time
+import toml
+import threading
+from typing import Any, Dict
+
+class ConfigManager:
+    def __init__(self: None, config_file: str = ...) -> ...:
+        ...
+    def _load_config(self: object) -> None:
+        """
+        从文件加载配置到缓存
+        """
+        ...
+    def _flush_config(self: object) -> None:
+        """
+        将待写入的配置刷新到文件
+        """
+        ...
+    def _schedule_write(self: object) -> None:
+        """
+        安排延迟写入
+        """
+        ...
+    def _check_cache_validity(self: object) -> None:
+        """
+        检查缓存有效性，必要时重新加载
+        """
+        ...
+    def getConfig(self: object, key: str, default: Any = ...) -> Any:
+        """
+        获取模块/适配器配置项（优先从缓存获取）
+        :param key: 配置项的键(支持点分隔符如"module.sub.key")
+        :param default: 默认值
+        :return: 配置项的值
+        """
+        ...
+    def setConfig(self: object, key: str, value: Any, immediate: bool = ...) -> bool:
+        """
+        设置模块/适配器配置（缓存+延迟写入）
+        :param key: 配置项键名(支持点分隔符如"module.sub.key")
+        :param value: 配置项值
+        :param immediate: 是否立即写入磁盘（默认为False，延迟写入）
+        :return: 操作是否成功
+        """
+        ...
+    def force_save(self: object) -> None:
+        """
+        强制立即保存所有待写入的配置到磁盘
+        """
+        ...
+    def reload(self: object) -> None:
+        """
+        重新从磁盘加载配置，丢弃所有未保存的更改
+        """
+        ...

ErisPulse/Core/exceptions.py

@@ -108,6 +108,8 @@ def setup_async_loop(loop: asyncio.AbstractEventLoop = None) -> None:   # type:
 
 sys.excepthook = global_exception_handler
 try:
-    asyncio.get_event_loop().set_exception_handler(async_exception_handler)
+    loop = asyncio.get_running_loop()
+    loop.set_exception_handler(async_exception_handler)
 except RuntimeError:
-    pass
+    # 没有运行中的事件循环，这是正常的，在运行时再设置
+    pass

ErisPulse/Core/exceptions.pyi

@@ -0,0 +1,60 @@
+# type: ignore
+#
+# Auto-generated type stub for exceptions.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 全局异常处理系统
+
+提供统一的异常捕获和格式化功能，支持同步和异步代码的异常处理。
+"""
+
+import sys
+import traceback
+import asyncio
+import os
+from typing import Dict, Any, Type
+
+class ExceptionHandler:
+    def format_exception(exc_type: Type[Exception], exc_value: Exception, exc_traceback: Any) -> str:
+        """
+        :param exc_type: 异常类型
+        :param exc_value: 异常值
+        :param exc_traceback: 追踪信息
+        :return: 格式化后的异常信息
+        """
+        ...
+    def format_async_exception(exception: Exception) -> str:
+        """
+        :param exception: 异常对象
+        :return: 格式化后的异常信息
+        """
+        ...
+
+def global_exception_handler(exc_type: Type[Exception], exc_value: Exception, exc_traceback: Any) -> None:
+    """
+    全局异常处理器
+    
+    :param exc_type: 异常类型
+    :param exc_value: 异常值
+    :param exc_traceback: 追踪信息
+    """
+    ...
+
+def async_exception_handler(loop: asyncio.AbstractEventLoop, context: Dict[(str, Any)]) -> None:
+    """
+    异步异常处理器
+    
+    :param loop: 事件循环
+    :param context: 上下文字典
+    """
+    ...
+
+def setup_async_loop(loop: asyncio.AbstractEventLoop = ...) -> None:
+    """
+    为指定的事件循环设置异常处理器
+    
+    :param loop: 事件循环实例，如果为None则使用当前事件循环
+    """
+    ...