ErisPulse 2.2.1__py3-none-any.whl → 2.3.0__py3-none-any.whl

ErisPulse/Core/Bases/__init__.py

@@ -0,0 +1,14 @@
+"""
+ErisPulse 基础模块
+
+提供核心基类定义，包括适配器和模块基类
+"""
+
+from .adapter import SendDSL, BaseAdapter
+from .module import BaseModule
+
+__all__ = [
+    "BaseAdapter",
+    "SendDSL",
+    "BaseModule"
+]

ErisPulse/Core/Bases/adapter.py

@@ -0,0 +1,196 @@
+"""
+ErisPulse 适配器基础模块
+
+提供适配器和消息发送DSL的基类实现
+
+{!--< tips >!--}
+1. 用于实现与不同平台的交互接口
+2. 提供统一的消息发送DSL风格接口
+{!--< /tips >!--}
+"""
+
+import asyncio
+from typing import (
+    Any, Optional,
+    Union, Awaitable
+)
+
+class SendDSL:
+    """
+    消息发送DSL基类
+    
+    用于实现 Send.To(...).Func(...) 风格的链式调用接口
+    
+    {!--< tips >!--}
+    1. 子类应实现具体的消息发送方法(如Text, Image等)
+    2. 通过__getattr__实现动态方法调用
+    {!--< /tips >!--}
+    """
+    
+    def __init__(self, adapter: 'BaseAdapter', target_type: Optional[str] = None, target_id: Optional[str] = None, account_id: Optional[str] = None):
+        """
+        初始化DSL发送器
+        
+        :param adapter: 所属适配器实例
+        :param target_type: 目标类型(可选)
+        :param target_id: 目标ID(可选)
+        :param _account_id: 发送账号(可选)
+        """
+        self._adapter = adapter
+        self._target_type = target_type
+        self._target_id = target_id
+        self._target_to = target_id
+        self._account_id = account_id
+
+    def To(self, target_type: str = None, target_id: Union[str, int] = None) -> 'SendDSL':
+        """
+        设置消息目标
+        
+        :param target_type: 目标类型(可选)
+        :param target_id: 目标ID(可选)
+        :return: SendDSL实例
+        
+        :example:
+        >>> adapter.Send.To("user", "123").Text("Hello")
+        >>> adapter.Send.To("123").Text("Hello")  # 简化形式
+        """
+        if target_id is None and target_type is not None:
+            target_id = target_type
+            target_type = None
+
+        return self.__class__(self._adapter, target_type, target_id, self._account_id)
+
+    def Using(self, account_id: Union[str, int]) -> 'SendDSL':
+        """
+        设置发送账号
+        
+        :param _account_id: 发送账号
+        :return: SendDSL实例
+        
+        :example:
+        >>> adapter.Send.Using("bot1").To("123").Text("Hello")
+        >>> adapter.Send.To("123").Using("bot1").Text("Hello")  # 支持乱序
+        """
+        return self.__class__(self._adapter, self._target_type, self._target_id, account_id)
+
+
+class BaseAdapter:
+    """
+    适配器基类
+    
+    提供与外部平台交互的标准接口，子类必须实现必要方法
+    
+    {!--< tips >!--}
+    1. 必须实现call_api, start和shutdown方法
+    2. 可以自定义Send类实现平台特定的消息发送逻辑
+    3. 通过on装饰器注册事件处理器
+    4. 支持OneBot12协议的事件处理
+    {!--< /tips >!--}
+    """
+    
+    class Send(SendDSL):
+        """
+        消息发送DSL实现
+        
+        {!--< tips >!--}
+        1. 子类可以重写Text方法提供平台特定实现
+        2. 可以添加新的消息类型(如Image, Voice等)
+        {!--< /tips >!--}
+        """
+        
+        def Example(self, text: str) -> Awaitable[Any]:
+            """
+            示例消息发送方法
+            
+            :param text: 文本内容
+            :return: 异步任务
+            :example:
+            >>> await adapter.Send.To("123").Example("Hello")
+            """
+
+            text = {
+                    "status": "ok",
+                    "retcode": 0,
+                    "data": {
+                        "message_id": "1234567890",
+                        "time": 1755801512
+                    },
+                    "message_id": "1234567890",
+                    "message": "",
+                    "echo": None,
+                    "example_raw": {
+                        "result": "success",
+                    }
+                }
+            async def _send_example():
+                from .. import logger
+                logger.info(f"发送示例消息: {text}")
+                return text
+            return asyncio.create_task(_send_example())
+
+    def __init__(self):
+        self.Send = self.__class__.Send(self)
+
+    async def call_api(self, endpoint: str, **params: Any) -> Any:
+        """
+        调用平台API的抽象方法
+        
+        :param endpoint: API端点
+        :param params: API参数
+        :return: API调用结果
+        :raises NotImplementedError: 必须由子类实现
+        """
+        raise NotImplementedError("适配器必须实现call_api方法")
+
+    async def start(self) -> None:
+        """
+        启动适配器的抽象方法
+        
+        :raises NotImplementedError: 必须由子类实现
+        """
+        raise NotImplementedError("适配器必须实现start方法")
+    
+    async def shutdown(self) -> None:
+        """
+        关闭适配器的抽象方法
+        
+        :raises NotImplementedError: 必须由子类实现
+        """
+        raise NotImplementedError("适配器必须实现shutdown方法")
+    
+    async def emit(self) -> None:
+        from .. import logger
+        logger.error("适配器调用了一个被弃用的原生方法emit，请检查适配器的实现，如果你是开发者请查看ErisPulse的文档进行更新。如果你是普通用户请查看本适配器是否有更新")
+
+    def send(self, target_type: str, target_id: str, message: Any, **kwargs: Any) -> asyncio.Task:
+        """
+        发送消息的便捷方法，返回一个 asyncio Task
+        
+        :param target_type: 目标类型
+        :param target_id: 目标ID
+        :param message: 消息内容
+        :param kwargs: 其他参数
+            - method: 发送方法名(默认为"Text")
+        :return: asyncio.Task 对象，用户可以自主决定是否等待
+        
+        :raises AttributeError: 当发送方法不存在时抛出
+            
+        :example:
+        >>> task = adapter.send("user", "123", "Hello")
+        >>> # 用户可以选择等待: result = await task
+        >>> # 或者不等待让其在后台执行
+        >>> await adapter.send("group", "456", "Hello", method="Markdown")  # 直接等待
+        """
+        async def _send_wrapper():
+            method_name = kwargs.pop("method", "Text")
+            method = getattr(self.Send.To(target_type, target_id), method_name, None)
+            if not method:
+                raise AttributeError(f"未找到 {method_name} 方法，请确保已在 Send 类中定义")
+            return await method(message, **kwargs)
+        
+        return asyncio.create_task(_send_wrapper())
+
+__all__ = [
+    "BaseAdapter",
+    "SendDSL",
+]

ErisPulse/Core/Bases/module.py

@@ -0,0 +1,54 @@
+"""
+ErisPulse 模块基础模块
+
+提供模块基类定义和标准接口
+"""
+
+class BaseModule:
+    """
+    模块基类
+    
+    提供模块加载和卸载的标准接口
+    """
+    
+    @staticmethod
+    def should_eager_load() -> bool:
+        """
+        模块是否应该在启动时加载
+        默认为False(即懒加载)
+
+        :return: 是否应该在启动时加载
+        """
+        return False
+    
+    async def on_load(self, event: dict) -> bool:
+        """
+        当模块被加载时调用
+
+        :param event: 事件内容
+        :return: 处理结果
+
+        {!--< tips >!--}
+        其中，event事件内容为:
+            `{ "module_name": "模块名" }`
+        {!--< /tips >!--}
+        """
+        raise NotImplementedError
+    
+    async def on_unload(self, event: dict) -> bool:
+        """
+        当模块被卸载时调用
+
+        :param event: 事件内容
+        :return: 处理结果
+
+        {!--< tips >!--}
+        其中，event事件内容为:
+            `{ "module_name": "模块名" }`
+        {!--< /tips >!--}
+        """
+        raise NotImplementedError
+
+__all__ = [
+    "BaseModule"
+]

ErisPulse/Core/Event/__init__.py

@@ -18,6 +18,20 @@ from .meta import meta
 from . import exceptions
 from .. import config
 
+def _clear_all_handlers():
+    """
+    {!--< internal-use >!--}
+    清除所有已注册的事件处理器和命令
+    """
+    # 清除命令处理器
+    command._clear_commands()
+    
+    # 清除各类事件处理器
+    message._clear_message_handlers()
+    notice._clear_notice_handlers()
+    request._clear_request_handlers()
+    meta._clear_meta_handlers()
+
 # 初始化默认配置
 def _setup_default_config():
     """

ErisPulse/Core/Event/base.py

@@ -10,7 +10,7 @@ ErisPulse 事件处理基础模块
 """
 
 from .. import adapter, logger
-from typing import Callable, Any, Dict, List, Optional
+from typing import Callable, Any, Dict, List
 import asyncio
 
 class BaseEventHandler:
@@ -56,7 +56,8 @@ class BaseEventHandler:
         if self.event_type and not self._adapter_handler_registered:
             adapter.on(self.event_type)(self._process_event)
             self._adapter_handler_registered = True
-    
+        logger.debug(f"[Event] 已注册事件处理器: {self.event_type}, Called by: {self.module_name}")
+
     def unregister(self, handler: Callable) -> bool:
         """
         注销事件处理器
@@ -108,3 +109,15 @@ class BaseEventHandler:
                     handler(event)
             except Exception as e:
                 logger.error(f"事件处理器执行错误: {e}")
+
+    def _clear_handlers(self):
+        """
+        {!--< internal-use >!--}
+        清除所有已注册的事件处理器
+        
+        :return: 被清除的处理器数量
+        """
+        count = len(self.handlers)
+        self.handlers.clear()
+        self._handler_map.clear()
+        return count

ErisPulse/Core/Event/command.py

@@ -15,10 +15,14 @@ from .base import BaseEventHandler
 from .. import adapter, config, logger
 from typing import Callable, Union, List, Dict, Any, Optional, Awaitable
 import asyncio
-import re
-from collections import defaultdict
 
 class CommandHandler:
+    """
+    命令处理器
+    
+    提供命令注册、处理和管理功能
+    """
+
     def __init__(self):
         self.commands: Dict[str, Dict] = {}
         self.aliases: Dict[str, str] = {}  # 别名映射
@@ -398,6 +402,21 @@ class CommandHandler:
                 await adapter_instance.Send.To(detail_type, target_id).Text(f"命令执行出错: {error}")
         except Exception as e:
             logger.error(f"发送命令错误消息失败: {e}")
+
+    def _clear_commands(self):
+        """
+        {!--< internal-use >!--}
+        清除所有已注册的命令
+        
+        :return: 被清除的命令数量
+        """
+        count = len(self.commands)
+        self.commands.clear()
+        self.aliases.clear()
+        self.groups.clear()
+        self.permissions.clear()
+        self._waiting_replies.clear()
+        return count
     
     def get_command(self, name: str) -> Optional[Dict]:
         """

ErisPulse/Core/Event/message.py

@@ -14,6 +14,12 @@ from .base import BaseEventHandler
 from typing import Callable, Dict, Any
 
 class MessageHandler:
+    """
+    消息事件处理器
+    
+    提供不同类型消息事件的处理功能
+    """
+    
     def __init__(self):
         self.handler = BaseEventHandler("message", "message")
     
@@ -117,4 +123,13 @@ class MessageHandler:
         """
         return self.handler.unregister(handler)
 
+    def _clear_message_handlers(self):
+        """
+        {!--< internal-use >!--}
+        清除所有已注册的消息处理器
+        
+        :return: 被清除的处理器数量
+        """
+        return self.handler._clear_handlers()
+
 message = MessageHandler()

ErisPulse/Core/Event/meta.py

@@ -13,6 +13,12 @@ from .base import BaseEventHandler
 from typing import Callable, Dict, Any
 
 class MetaHandler:
+    """
+    元事件处理器
+    
+    提供元事件处理功能，如连接、断开连接等
+    """
+    
     def __init__(self):
         self.handler = BaseEventHandler("meta", "meta")
     
@@ -108,5 +114,14 @@ class MetaHandler:
         :return: 是否成功取消注册
         """
         return self.handler.unregister(handler)
+    
+    def _clear_meta_handlers(self):
+        """
+        {!--< internal-use >!--}
+        清除所有已注册的元事件处理器
+        
+        :return: 被清除的处理器数量
+        """
+        return self.handler._clear_handlers()
 
 meta = MetaHandler()

ErisPulse/Core/Event/notice.py

@@ -13,6 +13,12 @@ from .base import BaseEventHandler
 from typing import Callable, Dict, Any
 
 class NoticeHandler:
+    """
+    通知事件处理器
+    
+    提供通知事件处理功能
+    """
+    
     def __init__(self):
         self.handler = BaseEventHandler("notice", "notice")
     
@@ -132,5 +138,14 @@ class NoticeHandler:
         :return: 是否成功取消注册
         """
         return self.handler.unregister(handler)
+    
+    def _clear_notice_handlers(self):
+        """
+        {!--< internal-use >!--}
+        清除所有已注册的通知处理器
+        
+        :return: 被清除的处理器数量
+        """
+        return self.handler._clear_handlers()
 
 notice = NoticeHandler()

ErisPulse/Core/Event/request.py

@@ -13,6 +13,12 @@ from .base import BaseEventHandler
 from typing import Callable, Dict, Any
 
 class RequestHandler:
+    """
+    请求事件处理器
+    
+    提供请求事件处理功能
+    """
+    
     def __init__(self):
         self.handler = BaseEventHandler("request", "request")
     
@@ -84,5 +90,14 @@ class RequestHandler:
         :return: 是否成功取消注册
         """
         return self.handler.unregister(handler)
-
+    
+    def _clear_request_handlers(self):
+        """
+        {!--< internal-use >!--}
+        清除所有已注册的请求处理器
+        
+        :return: 被清除的处理器数量
+        """
+        return self.handler._clear_handlers()
+    
 request = RequestHandler()

ErisPulse/Core/__init__.py

@@ -1,30 +1,49 @@
-from .adapter import AdapterFather, SendDSL, adapter
+from .lifecycle import lifecycle
+from .adapter import adapter
+from .Bases import BaseAdapter, BaseModule, SendDSL
 from .storage import storage
-from .env import env
 from .logger import logger
-from .module_registry import module_registry
 from .module import module
-from .router import router, adapter_server
+from .router import router
 from .config import config
+from .ux import ux, UXManager
 from . import exceptions
-
 from . import Event
 
-BaseAdapter = AdapterFather
+# 兼容性别名定义
+adapter_server  = router        # 路由管理器别名
+env             = storage       # 存储管理器别名
+AdapterFather   = BaseAdapter   # 适配器基类别名
 
 __all__ = [
+    # 事件模块
     'Event',
-    'BaseAdapter',
-    'AdapterFather',
-    'SendDSL',
-    'adapter',
-    'module',
-    'storage',
-    'env',
-    'logger',
-    'module_registry',
-    'exceptions',
-    'router',
-    'adapter_server',
-    'config'
+
+    # 适配器相关
+    'adapter',          # 适配器管理器
+    'AdapterFather',    # 适配器基类
+    'BaseAdapter',      # 适配器基类别名
+    'SendDSL',          # DSL发送接口基类
+
+    # 模块相关
+    'module',           # 模块管理器
+    'BaseModule',       # 模块基类
+    
+    # 存储和配置相关
+    'storage',          # 存储管理器
+    'config',           # 配置管理器
+    'env',              # 配置管理器别名
+
+    # 路由相关
+    'router',           # 路由管理器
+    'adapter_server',   # 路由管理器别名
+
+    # UX
+    'ux',               # UX管理器实例
+    'UXManager',        # UX管理器类
+
+    # 基础设施
+    'logger',           # 日志管理器
+    'exceptions',       # 异常处理模块
+    'lifecycle'         # 生命周期管理器
 ]

ErisPulse/Core/{erispulse_config.py → _self_config.py}

@@ -19,6 +19,14 @@ DEFAULT_ERISPULSE_CONFIG = {
         "level": "INFO",
         "log_files": [],
         "memory_limit": 1000
+    },
+    "storage":  {
+        "max_snapshot": 20
+    },
+    "modules": {},
+    "adapters": {},
+    "framework": {
+        "enable_lazy_loading": True
     }
 }
 
@@ -29,7 +37,6 @@ def _ensure_erispulse_config_structure(config_dict: Dict[str, Any]) -> Dict[str,
     :param config_dict: 当前配置
     :return: 补全后的完整配置
     """
-    merged_config = DEFAULT_ERISPULSE_CONFIG.copy()
     
     # 深度合并配置
     for section, default_values in DEFAULT_ERISPULSE_CONFIG.items():
@@ -102,4 +109,22 @@ def get_logger_config() -> Dict[str, Any]:
     :return: 日志配置字典
     """
     erispulse_config = get_erispulse_config()
-    return erispulse_config["logger"]
+    return erispulse_config["logger"]
+
+def get_storage_config() -> Dict[str, Any]:
+    """
+    获取存储模块配置
+
+    :return: 存储配置字典
+    """
+    erispulse_config = get_erispulse_config()
+    return erispulse_config["storage"]
+
+def get_framework_config() -> Dict[str, Any]:
+    """
+    获取框架配置
+
+    :return: 框架配置字典
+    """
+    erispulse_config = get_erispulse_config()
+    return erispulse_config["framework"]