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

ErisPulse/Core/Bases/manager.pyi

@@ -0,0 +1,108 @@
+# type: ignore
+#
+# Auto-generated type stub for manager.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 管理器基类
+
+提供适配器和模块管理器的统一接口定义
+
+{!--< tips >!--}
+适配器管理器和模块管理器都应继承此基类以保持接口一致性
+{!--< /tips >!--}
+"""
+
+from abc import ABC, abstractmethod
+from typing import Dict, List, Any, Type, Optional
+
+class ManagerBase(ABC):
+    """
+    管理器基类
+    
+    定义适配器和模块管理器的统一接口
+    
+    {!--< tips >!--}
+    统一方法：
+    - register(): 注册类
+    - unregister(): 取消注册
+    - get(): 获取实例
+    - exists(): 检查是否存在
+    - enable()/disable(): 启用/禁用
+    - is_enabled(): 检查是否启用
+    - list_*(): 列出相关项
+    {!--< /tips >!--}
+    """
+    def register(self: object, name: str, class_type: Type, info: Optional[Dict] = ...) -> bool:
+        """
+        注册类
+        
+        :param name: 名称
+        :param class_type: 类类型
+        :param info: 额外信息
+        :return: 是否注册成功
+        """
+        ...
+    def unregister(self: object, name: str) -> bool:
+        """
+        取消注册
+        
+        :param name: 名称
+        :return: 是否取消成功
+        """
+        ...
+    def get(self: object, name: str) -> Any:
+        """
+        获取实例
+        
+        :param name: 名称
+        :return: 实例或 None
+        """
+        ...
+    def exists(self: object, name: str) -> bool:
+        """
+        检查是否存在（在配置中注册）
+        
+        :param name: 名称
+        :return: 是否存在
+        """
+        ...
+    def is_enabled(self: object, name: str) -> bool:
+        """
+        检查是否启用
+        
+        :param name: 名称
+        :return: 是否启用
+        """
+        ...
+    def enable(self: object, name: str) -> bool:
+        """
+        启用
+        
+        :param name: 名称
+        :return: 是否成功
+        """
+        ...
+    def disable(self: object, name: str) -> bool:
+        """
+        禁用
+        
+        :param name: 名称
+        :return: 是否成功
+        """
+        ...
+    def list_registered(self: object) -> List[str]:
+        """
+        列出所有已注册的项
+        
+        :return: 名称列表
+        """
+        ...
+    def list_items(self: object) -> Dict[(str, bool)]:
+        """
+        列出所有项及其状态
+        
+        :return: {名称: 是否启用} 字典
+        """
+        ...

ErisPulse/Core/Bases/module.py

@@ -4,6 +4,10 @@ ErisPulse 模块基础模块
 提供模块基类定义和标准接口
 """
 
+from typing import Union, Dict, Any
+from ...loaders.strategy import ModuleLoadStrategy
+
+
 class BaseModule:
     """
     模块基类
@@ -11,15 +15,63 @@ class BaseModule:
     提供模块加载和卸载的标准接口
     """
     
+    @staticmethod
+    def get_load_strategy() -> Union[ModuleLoadStrategy, Dict[str, Any]]:
+        """
+        获取模块加载策略
+        
+        支持返回 ModuleLoadStrategy 对象或字典
+        所有属性统一处理，没有任何预定义字段
+        
+        :return: 加载策略对象或字典
+        
+        {!--< tips >!--}
+        常用配置项：
+        - lazy_load: bool, 是否懒加载（默认 True）
+        - priority: int, 加载优先级（默认 0，数值越大优先级越高）
+        
+        使用方式：
+        >>> class MyModule(BaseModule):
+        ...     @staticmethod
+        ...     def get_load_strategy() -> ModuleLoadStrategy:
+        ...         return ModuleLoadStrategy(
+        ...             lazy_load=False,
+        ...             priority=100
+        ...         )
+        
+        或使用字典：
+        >>> class MyModule(BaseModule):
+        ...     @staticmethod
+        ...     def get_load_strategy() -> dict:
+        ...         return {
+        ...             "lazy_load": False,
+        ...             "priority": 100
+        ...         }
+        {!--< /tips >!--}
+        """
+        return ModuleLoadStrategy(
+            lazy_load=True,   # 默认懒加载
+            priority=0        # 默认优先级
+        )
+    
     @staticmethod
     def should_eager_load() -> bool:
         """
         模块是否应该在启动时加载
         默认为False(即懒加载)
+        
+        兼容方法，实际调用 get_load_strategy()
 
         :return: 是否应该在启动时加载
+        
+        {!--< tips >!--}
+        旧版方法，建议使用 get_load_strategy() 替代
+        {!--< /tips >!--}
         """
-        return False
+        strategy = BaseModule.get_load_strategy()
+        if isinstance(strategy, dict):
+            return not strategy.get('lazy_load', True)
+        return not (strategy.lazy_load if 'lazy_load' in strategy else True)
     
     async def on_load(self, event: dict) -> bool:
         """

ErisPulse/Core/Bases/module.pyi

@@ -0,0 +1,95 @@
+# type: ignore
+#
+# Auto-generated type stub for module.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 模块基础模块
+
+提供模块基类定义和标准接口
+"""
+
+from typing import Union, Dict, Any
+from ...loaders.strategy import ModuleLoadStrategy
+
+class BaseModule:
+    """
+    模块基类
+    
+    提供模块加载和卸载的标准接口
+    """
+    def get_load_strategy() -> Union[(ModuleLoadStrategy, Dict[(str, Any)])]:
+        """
+        获取模块加载策略
+        
+        支持返回 ModuleLoadStrategy 对象或字典
+        所有属性统一处理，没有任何预定义字段
+        
+        :return: 加载策略对象或字典
+        
+        {!--< tips >!--}
+        常用配置项：
+        - lazy_load: bool, 是否懒加载（默认 True）
+        - priority: int, 加载优先级（默认 0，数值越大优先级越高）
+        
+        使用方式：
+        >>> class MyModule(BaseModule):
+        ...     @staticmethod
+        ...     def get_load_strategy() -> ModuleLoadStrategy:
+        ...         return ModuleLoadStrategy(
+        ...             lazy_load=False,
+        ...             priority=100
+        ...         )
+        
+        或使用字典：
+        >>> class MyModule(BaseModule):
+        ...     @staticmethod
+        ...     def get_load_strategy() -> dict:
+        ...         return {
+        ...             "lazy_load": False,
+        ...             "priority": 100
+        ...         }
+        {!--< /tips >!--}
+        """
+        ...
+    def should_eager_load() -> bool:
+        """
+        模块是否应该在启动时加载
+        默认为False(即懒加载)
+        
+        兼容方法，实际调用 get_load_strategy()
+        
+        :return: 是否应该在启动时加载
+        
+        {!--< tips >!--}
+        旧版方法，建议使用 get_load_strategy() 替代
+        {!--< /tips >!--}
+        """
+        ...
+    async def on_load(self: object, event: dict) -> bool:
+        """
+        当模块被加载时调用
+        
+        :param event: 事件内容
+        :return: 处理结果
+        
+        {!--< tips >!--}
+        其中，event事件内容为:
+            `{ "module_name": "模块名" }`
+        {!--< /tips >!--}
+        """
+        ...
+    async def on_unload(self: object, event: dict) -> bool:
+        """
+        当模块被卸载时调用
+        
+        :param event: 事件内容
+        :return: 处理结果
+        
+        {!--< tips >!--}
+        其中，event事件内容为:
+            `{ "module_name": "模块名" }`
+        {!--< /tips >!--}
+        """
+        ...

ErisPulse/Core/Event/__init__.pyi

@@ -0,0 +1,26 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 事件处理模块
+
+提供统一的事件处理接口，支持命令、消息、通知、请求和元事件处理
+
+{!--< tips >!--}
+1. 所有事件处理都基于OneBot12标准事件格式
+2. 通过装饰器方式注册事件处理器
+3. 支持优先级和条件过滤
+{!--< /tips >!--}
+"""
+
+from .command import command
+from .message import message
+from .notice import notice
+from .request import request
+from .meta import meta
+from .wrapper import Event
+from . import exceptions
+from .. import config

ErisPulse/Core/Event/base.pyi

@@ -0,0 +1,62 @@
+# type: ignore
+#
+# Auto-generated type stub for base.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 事件处理基础模块
+
+提供事件处理的核心功能，包括事件注册和处理
+
+{!--< tips >!--}
+1. 所有事件处理都基于OneBot12标准事件格式
+2. 通过适配器系统进行事件分发和接收
+{!--< /tips >!--}
+"""
+
+from .. import adapter, logger
+from typing import Callable, Any, Dict, List
+import asyncio
+from .wrapper import Event
+
+class BaseEventHandler:
+    """
+    基础事件处理器
+    
+    提供事件处理的基本功能，包括处理器注册和注销
+    """
+    def __init__(self: None, event_type: str, module_name: str = ...) -> ...:
+        """
+        初始化事件处理器
+        
+        :param event_type: 事件类型
+        :param module_name: 模块名称
+        """
+        ...
+    def register(self: object, handler: Callable, priority: int = ..., condition: Callable = ...) -> ...:
+        """
+        注册事件处理器
+        
+        :param handler: 事件处理器函数
+        :param priority: 处理器优先级，数值越小优先级越高
+        :param condition: 处理器条件函数，返回True时才会执行处理器
+        """
+        ...
+    def unregister(self: object, handler: Callable) -> bool:
+        """
+        注销事件处理器
+        
+        :param handler: 要注销的事件处理器
+        :return: 是否成功注销
+        """
+        ...
+    def __call__(self: object, priority: int = ..., condition: Callable = ...) -> ...:
+        """
+        装饰器方式注册事件处理器
+        
+        :param priority: 处理器优先级
+        :param condition: 处理器条件函数
+        :return: 装饰器函数
+        """
+        ...

ErisPulse/Core/Event/command.py

@@ -94,7 +94,7 @@ class CommandHandler:
                     "main_name": main_name
                 }
                 
-                # 注册别名映射
+                # 注册别名映射（name列表中的额外名称）
                 if cmd_name != main_name:
                     self.aliases[cmd_name] = main_name
                 
@@ -102,6 +102,11 @@ class CommandHandler:
                 if permission and cmd_name not in self.permissions:
                     self.permissions[cmd_name] = permission
             
+            # 注册aliases参数中的别名
+            for alias in alias_list:
+                if alias not in self.aliases:
+                    self.aliases[alias] = main_name
+            
             # 添加到命令组
             if group:
                 if group not in self.groups:

ErisPulse/Core/Event/command.pyi

@@ -0,0 +1,113 @@
+# type: ignore
+#
+# Auto-generated type stub for command.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 命令处理模块
+
+提供基于装饰器的命令注册和处理功能
+
+{!--< tips >!--}
+1. 支持命令别名和命令组
+2. 支持命令权限控制
+3. 支持命令帮助系统
+4. 支持等待用户回复交互
+{!--< /tips >!--}
+"""
+
+from .base import BaseEventHandler
+from .. import adapter, config, logger
+from typing import Callable, Union, List, Dict, Any, Optional, Awaitable
+import asyncio
+
+class CommandHandler:
+    """
+    命令处理器
+    
+    提供命令注册、处理和管理功能
+    """
+    def __init__(self: None) -> ...:
+        ...
+    def __call__(self: object, name: Union[(str, List[str])] = ..., aliases: List[str] = ..., group: str = ..., priority: int = ..., permission: Callable = ..., help: str = ..., usage: str = ..., hidden: bool = ...) -> ...:
+        """
+        命令装饰器
+        
+        :param name: 命令名称，可以是字符串或字符串列表
+        :param aliases: 命令别名列表
+        :param group: 命令组名称
+        :param priority: 处理器优先级
+        :param permission: 权限检查函数，返回True时允许执行命令
+        :param help: 命令帮助信息
+        :param usage: 命令使用方法
+        :param hidden: 是否在帮助中隐藏命令
+        :return: 装饰器函数
+        """
+        ...
+    def unregister(self: object, handler: Callable) -> bool:
+        """
+        注销命令处理器
+        
+        :param handler: 要注销的命令处理器
+        :return: 是否成功注销
+        """
+        ...
+    async def wait_reply(self: object, event: Dict[(str, Any)], prompt: str = ..., timeout: float = ..., callback: Callable[([Dict[(str, Any)]], Awaitable[Any])] = ..., validator: Callable[([Dict[(str, Any)]], bool)] = ...) -> Optional[Dict[(str, Any)]]:
+        """
+        等待用户回复
+        
+        :param event: 原始事件数据
+        :param prompt: 提示消息，如果提供会发送给用户
+        :param timeout: 等待超时时间(秒)
+        :param callback: 回调函数，当收到回复时执行
+        :param validator: 验证函数，用于验证回复是否有效
+        :return: 用户回复的事件数据，如果超时则返回None
+        """
+        ...
+    async def _check_pending_reply(self: object, event: Dict[(str, Any)]) -> ...:
+        """
+        检查是否是等待回复的消息
+        
+        :param event: 消息事件数据
+        """
+        ...
+    def get_command(self: object, name: str) -> Optional[Dict]:
+        """
+        获取命令信息
+        
+        :param name: 命令名称
+        :return: 命令信息字典，如果不存在则返回None
+        """
+        ...
+    def get_commands(self: object) -> Dict[(str, Dict)]:
+        """
+        获取所有命令
+        
+        :return: 命令信息字典
+        """
+        ...
+    def get_group_commands(self: object, group: str) -> List[str]:
+        """
+        获取命令组中的命令
+        
+        :param group: 命令组名称
+        :return: 命令名称列表
+        """
+        ...
+    def get_visible_commands(self: object) -> Dict[(str, Dict)]:
+        """
+        获取所有可见命令（非隐藏命令）
+        
+        :return: 可见命令信息字典
+        """
+        ...
+    def help(self: object, command_name: str = ..., show_hidden: bool = ...) -> str:
+        """
+        生成帮助信息
+        
+        :param command_name: 命令名称，如果为None则生成所有命令的帮助
+        :param show_hidden: 是否显示隐藏命令
+        :return: 帮助信息字符串
+        """
+        ...

ErisPulse/Core/Event/exceptions.pyi

@@ -0,0 +1,43 @@
+# type: ignore
+#
+# Auto-generated type stub for exceptions.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 事件系统异常处理模块
+
+提供事件系统中可能发生的各种异常类型定义
+"""
+
+class EventException(Exception):
+    """
+    事件系统基础异常
+    
+    所有事件系统相关异常的基类
+    """
+    ...
+
+class CommandException(EventException):
+    """
+    命令处理异常
+    
+    当命令处理过程中发生错误时抛出
+    """
+    ...
+
+class EventHandlerException(EventException):
+    """
+    事件处理器异常
+    
+    当事件处理器执行过程中发生错误时抛出
+    """
+    ...
+
+class EventNotFoundException(EventException):
+    """
+    事件未找到异常
+    
+    当尝试获取不存在的事件处理器时抛出
+    """
+    ...

ErisPulse/Core/Event/message.pyi

@@ -0,0 +1,93 @@
+# type: ignore
+#
+# Auto-generated type stub for message.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 消息处理模块
+
+提供基于装饰器的消息事件处理功能
+
+{!--< tips >!--}
+1. 支持私聊、群聊消息分类处理
+2. 支持@消息特殊处理
+3. 支持自定义条件过滤
+{!--< /tips >!--}
+"""
+
+from .base import BaseEventHandler
+from typing import Callable, Dict, Any
+
+class MessageHandler:
+    """
+    消息事件处理器
+    
+    提供不同类型消息事件的处理功能
+    """
+    def __init__(self: None) -> ...:
+        ...
+    def on_message(self: object, priority: int = ...) -> ...:
+        """
+        消息事件装饰器
+        
+        :param priority: 处理器优先级
+        :return: 装饰器函数
+        """
+        ...
+    def remove_message_handler(self: object, handler: Callable) -> bool:
+        """
+        取消注册消息事件处理器
+        
+        :param handler: 要取消注册的处理器
+        :return: 是否成功取消注册
+        """
+        ...
+    def on_private_message(self: object, priority: int = ...) -> ...:
+        """
+        私聊消息事件装饰器
+        
+        :param priority: 处理器优先级
+        :return: 装饰器函数
+        """
+        ...
+    def remove_private_message_handler(self: object, handler: Callable) -> bool:
+        """
+        取消注册私聊消息事件处理器
+        
+        :param handler: 要取消注册的处理器
+        :return: 是否成功取消注册
+        """
+        ...
+    def on_group_message(self: object, priority: int = ...) -> ...:
+        """
+        群聊消息事件装饰器
+        
+        :param priority: 处理器优先级
+        :return: 装饰器函数
+        """
+        ...
+    def remove_group_message_handler(self: object, handler: Callable) -> bool:
+        """
+        取消注册群聊消息事件处理器
+        
+        :param handler: 要取消注册的处理器
+        :return: 是否成功取消注册
+        """
+        ...
+    def on_at_message(self: object, priority: int = ...) -> ...:
+        """
+        @消息事件装饰器
+        
+        :param priority: 处理器优先级
+        :return: 装饰器函数
+        """
+        ...
+    def remove_at_message_handler(self: object, handler: Callable) -> bool:
+        """
+        取消注册@消息事件处理器
+        
+        :param handler: 要取消注册的处理器
+        :return: 是否成功取消注册
+        """
+        ...