ErisPulse 2.3.2__py3-none-any.whl → 2.3.3__py3-none-any.whl

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/adapter.pyi

@@ -0,0 +1,229 @@
+# 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
+
+class AdapterManager:
+    """
+    适配器管理器
+    
+    管理多个平台适配器的注册、启动和关闭，提供与模块管理器一致的接口
+    
+    {!--< 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_adapters(self: object) -> Dict[(str, bool)]:
+        """
+        列出所有平台适配器状态
+        
+        :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-2.3.3.data/data/ErisPulse-stubs/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-2.3.3.data/data/ErisPulse-stubs/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则使用当前事件循环
+    """
+    ...

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/lifecycle.pyi

@@ -0,0 +1,92 @@
+# type: ignore
+#
+# Auto-generated type stub for lifecycle.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 生命周期管理模块
+
+提供统一的生命周期事件管理和触发机制
+
+事件标准格式:
+{
+    "event": "事件名称",  # 必填
+    "timestamp": float,  # 必填，Unix时间戳
+    "data": dict,        # 可选，事件相关数据
+    "source": str,       # 必填，事件来源
+    "msg": str           # 可选，事件描述
+}
+"""
+
+import asyncio
+import time
+from typing import Callable, List, Dict, Any
+from .logger import logger
+
+class LifecycleManager:
+    """
+    生命周期管理器
+    
+    管理SDK的生命周期事件，提供事件注册和触发功能
+    支持点式结构事件监听，例如 module.init 可以被 module 监听到
+    """
+    def __init__(self: None) -> ...:
+        ...
+    def _validate_event(self: object, event_data: Dict[(str, Any)]) -> bool:
+        """
+        验证事件数据格式
+        
+        :param event_data: 事件数据字典
+        :return: 是否有效
+        """
+        ...
+    def on(self: object, event: str) -> Callable:
+        """
+        注册生命周期事件处理器
+        
+        :param event: 事件名称，支持点式结构如 module.init
+        :return: 装饰器函数
+        
+        :raises ValueError: 当事件名无效时抛出
+        """
+        ...
+    def start_timer(self: object, timer_id: str) -> None:
+        """
+        开始计时
+        
+        :param timer_id: 计时器ID
+        """
+        ...
+    def get_duration(self: object, timer_id: str) -> float:
+        """
+        获取指定计时器的持续时间
+        
+        :param timer_id: 计时器ID
+        :return: 持续时间(秒)
+        """
+        ...
+    def stop_timer(self: object, timer_id: str) -> float:
+        """
+        停止计时并返回持续时间
+        
+        :param timer_id: 计时器ID
+        :return: 持续时间(秒)
+        """
+        ...
+    async def submit_event(self: object, event_type: str) -> None:
+        """
+        提交生命周期事件
+        
+        :param event: 事件名称
+        :param event_data: 事件数据字典
+        """
+        ...
+    async def _execute_handlers(self: object, event: str, event_data: Dict[(str, Any)]) -> None:
+        """
+        执行事件处理器
+        
+        :param event: 事件名称
+        :param event_data: 事件数据
+        """
+        ...

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/logger.pyi

@@ -0,0 +1,168 @@
+# type: ignore
+#
+# Auto-generated type stub for logger.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 日志系统
+
+提供模块化日志记录功能，支持多级日志、模块过滤和内存存储。
+
+{!--< tips >!--}
+1. 支持按模块设置不同日志级别
+2. 日志可存储在内存中供后续分析
+3. 自动识别调用模块名称
+{!--< /tips >!--}
+"""
+
+import logging
+import inspect
+import datetime
+from rich.logging import RichHandler
+from rich.console import Console
+
+class Logger:
+    """
+    日志管理器
+    
+    提供模块化日志记录和存储功能
+    
+    {!--< tips >!--}
+    1. 使用set_module_level设置模块日志级别
+    2. 使用get_logs获取历史日志
+    3. 支持标准日志级别(DEBUG, INFO等)
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        ...
+    def set_memory_limit(self: object, limit: int) -> bool:
+        """
+        设置日志内存存储上限
+        
+        :param limit: 日志存储上限
+        :return: bool 设置是否成功
+        """
+        ...
+    def set_level(self: object, level: str) -> bool:
+        """
+        设置全局日志级别
+        
+        :param level: 日志级别(DEBUG/INFO/WARNING/ERROR/CRITICAL)
+        :return: bool 设置是否成功
+        """
+        ...
+    def set_module_level(self: object, module_name: str, level: str) -> bool:
+        """
+        设置指定模块日志级别
+        
+        :param module_name: 模块名称
+        :param level: 日志级别(DEBUG/INFO/WARNING/ERROR/CRITICAL)
+        :return: bool 设置是否成功
+        """
+        ...
+    def set_output_file(self: object, path: ...) -> bool:
+        """
+        设置日志输出
+        
+        :param path: 日志文件路径 Str/List
+        :return: bool 设置是否成功
+        """
+        ...
+    def save_logs(self: object, path: ...) -> bool:
+        """
+        保存所有在内存中记录的日志
+        
+        :param path: 日志文件路径 Str/List
+        :return: bool 设置是否成功
+        """
+        ...
+    def get_logs(self: object, module_name: str = ...) -> dict:
+        """
+        获取日志内容
+        
+        :param module_name (可选): 模块名称
+        :return: dict 日志内容
+        """
+        ...
+    def _save_in_memory(self: object, ModuleName: ..., msg: ...) -> ...:
+        ...
+    def _setup_config(self: object) -> ...:
+        ...
+    def _get_effective_level(self: object, module_name: ...) -> ...:
+        ...
+    def _get_caller(self: object) -> ...:
+        ...
+    def get_child(self: object, child_name: str = ...) -> ...:
+        """
+        获取子日志记录器
+        
+        :param child_name: 子模块名称(可选)
+        :return: LoggerChild 子日志记录器实例
+        """
+        ...
+    def debug(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def info(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def warning(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def error(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def critical(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        """
+        记录 CRITICAL 级别日志
+        这是最高级别的日志，表示严重的系统错误
+        注意：此方法不会触发程序崩溃，仅记录日志
+        
+        {!--< tips >!--}
+        1. 这是最高级别的日志，表示严重系统错误
+        2. 不会触发程序崩溃，如需终止程序请显式调用 sys.exit()
+        3. 会在日志文件中添加 CRITICAL 标记便于后续分析
+        {!--< /tips >!--}
+        """
+        ...
+
+class LoggerChild:
+    """
+    子日志记录器
+    
+    用于创建具有特定名称的子日志记录器，仅改变模块名称，其他功能全部委托给父日志记录器
+    """
+    def __init__(self: None, parent_logger: Logger, name: str) -> ...:
+        """
+        初始化子日志记录器
+        
+        :param parent_logger: 父日志记录器实例
+        :param name: 子日志记录器名称
+        """
+        ...
+    def debug(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def info(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def warning(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def error(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        ...
+    def critical(self: object, msg: ..., *args: ..., **kwargs: ...) -> ...:
+        """
+        记录 CRITICAL 级别日志
+        这是最高级别的日志，表示严重的系统错误
+        注意：此方法不会触发程序崩溃，仅记录日志
+        
+        {!--< tips >!--}
+        1. 这是最高级别的日志，表示严重系统错误
+        2. 不会触发程序崩溃，如需终止程序请显式调用 sys.exit()
+        3. 会在日志文件中添加 CRITICAL 标记便于后续分析
+        {!--< /tips >!--}
+        """
+        ...
+    def get_child(self: object, child_name: str) -> ...:
+        """
+        获取子日志记录器的子记录器
+        
+        :param child_name: 子模块名称
+        :return: LoggerChild 子日志记录器实例
+        """
+        ...