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

ErisPulse/utils/cli.pyi

@@ -1,145 +0,0 @@
-# type: ignore
-#
-# Auto-generated type stub for cli.py
-# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
-#
-
-import argparse
-import importlib.metadata
-import sys
-import os
-import time
-import asyncio
-from typing import List, Dict, Optional, Any
-from watchdog.observers import Observer
-from rich.panel import Panel
-from rich.table import Table
-from rich.prompt import Confirm, Prompt
-from rich.box import SIMPLE
-from .console import console
-
-class CLI:
-    """
-    ErisPulse命令行接口
-    
-    提供完整的命令行交互功能
-    
-    {!--< tips >!--}
-    1. 支持动态加载第三方命令
-    2. 支持模块化子命令系统
-    {!--< /tips >!--}
-    """
-    def __init__(self: None) -> ...:
-        """
-        初始化CLI
-        """
-        ...
-    def _create_parser(self: object) -> argparse.ArgumentParser:
-        """
-        创建命令行参数解析器
-        
-        :return: 配置好的ArgumentParser实例
-        """
-        ...
-    def _get_external_commands(self: object) -> List[str]:
-        """
-        获取所有已注册的第三方命令名称
-        
-        :return: 第三方命令名称列表
-        """
-        ...
-    def _load_external_commands(self: object, subparsers: ...) -> ...:
-        """
-        加载第三方CLI命令
-        
-        :param subparsers: 子命令解析器
-        
-        :raises ImportError: 加载命令失败时抛出
-        """
-        ...
-    def _print_version(self: object) -> ...:
-        """
-        打印版本信息
-        """
-        ...
-    def _print_installed_packages(self: object, pkg_type: str, outdated_only: bool = ...) -> ...:
-        """
-        打印已安装包信息
-        
-        :param pkg_type: 包类型 (modules/adapters/cli/all)
-        :param outdated_only: 是否只显示可升级的包
-        """
-        ...
-    def _print_remote_packages(self: object, pkg_type: str) -> ...:
-        """
-        打印远程包信息
-        
-        :param pkg_type: 包类型 (modules/adapters/cli/all)
-        """
-        ...
-    def _is_package_outdated(self: object, package_name: str, current_version: str) -> bool:
-        """
-        检查包是否过时
-        
-        :param package_name: 包名
-        :param current_version: 当前版本
-        :return: 是否有新版本可用
-        """
-        ...
-    def _resolve_package_name(self: object, short_name: str) -> Optional[str]:
-        """
-        解析简称到完整包名（大小写不敏感）
-        
-        :param short_name: 模块/适配器简称
-        :return: 完整包名，未找到返回None
-        """
-        ...
-    def _print_search_results(self: object, query: str, results: Dict[(str, List[Dict[(str, str)]])]) -> ...:
-        """
-        打印搜索结果
-        
-        :param query: 搜索关键词
-        :param results: 搜索结果
-        """
-        ...
-    def _print_version_list(self: object, versions: List[Dict[(str, Any)]], include_pre: bool = ...) -> ...:
-        """
-        打印版本列表
-        
-        :param versions: 版本信息列表
-        :param include_pre: 是否包含预发布版本
-        """
-        ...
-    def _setup_watchdog(self: object, script_path: str, reload_mode: bool) -> ...:
-        """
-        设置文件监控
-        
-        :param script_path: 要监控的脚本路径
-        :param reload_mode: 是否启用重载模式
-        """
-        ...
-    def _cleanup(self: object) -> ...:
-        """
-        清理资源
-        """
-        ...
-    def run(self: object) -> ...:
-        """
-        运行CLI
-        
-        :raises KeyboardInterrupt: 用户中断时抛出
-        :raises Exception: 命令执行失败时抛出
-        """
-        ...
-
-def _cleanup_adapters() -> ...:
-    """
-    清理适配器资源
-    """
-    ...
-
-def _cleanup_modules() -> ...:
-    """
-    清理模块资源
-    """
-    ...

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/Bases/__init__.pyi

@@ -1,14 +0,0 @@
-# type: ignore
-#
-# Auto-generated type stub for __init__.py
-# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
-#
-
-"""
-ErisPulse 基础模块
-
-提供核心基类定义，包括适配器和模块基类
-"""
-
-from .adapter import SendDSL, BaseAdapter
-from .module import BaseModule

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

@@ -1,140 +0,0 @@
-# type: ignore
-#
-# Auto-generated type stub for adapter.py
-# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
-#
-
-"""
-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: None, adapter: BaseAdapter, target_type: Optional[str] = ..., target_id: Optional[str] = ..., account_id: Optional[str] = ...) -> ...:
-        """
-        初始化DSL发送器
-        
-        :param adapter: 所属适配器实例
-        :param target_type: 目标类型(可选)
-        :param target_id: 目标ID(可选)
-        :param _account_id: 发送账号(可选)
-        """
-        ...
-    def To(self: object, target_type: str = ..., target_id: Union[(str, int)] = ...) -> SendDSL:
-        """
-        设置消息目标
-        
-        :param target_type: 目标类型(可选)
-        :param target_id: 目标ID(可选)
-        :return: SendDSL实例
-        
-        :example:
-        >>> adapter.Send.To("user", "123").Text("Hello")
-        >>> adapter.Send.To("123").Text("Hello")  # 简化形式
-        """
-        ...
-    def Using(self: object, 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")  # 支持乱序
-        """
-        ...
-    def Account(self: object, account_id: Union[(str, int)]) -> SendDSL:
-        """
-        设置发送账号
-        
-        :param _account_id: 发送账号
-        :return: SendDSL实例
-        
-        :example:
-        >>> adapter.Send.Account("bot1").To("123").Text("Hello")
-        >>> adapter.Send.To("123").Account("bot1").Text("Hello")  # 支持乱序
-        """
-        ...
-
-class BaseAdapter:
-    """
-    适配器基类
-    
-    提供与外部平台交互的标准接口，子类必须实现必要方法
-    
-    {!--< tips >!--}
-    1. 必须实现call_api, start和shutdown方法
-    2. 可以自定义Send类实现平台特定的消息发送逻辑
-    3. 通过on装饰器注册事件处理器
-    4. 支持OneBot12协议的事件处理
-    {!--< /tips >!--}
-    """
-    def __init__(self: None) -> ...:
-        ...
-    async def call_api(self: object, endpoint: str, **params: Any) -> Any:
-        """
-        调用平台API的抽象方法
-        
-        :param endpoint: API端点
-        :param params: API参数
-        :return: API调用结果
-        :raises NotImplementedError: 必须由子类实现
-        """
-        ...
-    async def start(self: object) -> None:
-        """
-        启动适配器的抽象方法
-        
-        :raises NotImplementedError: 必须由子类实现
-        """
-        ...
-    async def shutdown(self: object) -> None:
-        """
-        关闭适配器的抽象方法
-        
-        :raises NotImplementedError: 必须由子类实现
-        """
-        ...
-    async def emit(self: object) -> None:
-        ...
-    def send(self: object, 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")  # 直接等待
-        """
-        ...

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/Bases/module.pyi

@@ -1,52 +0,0 @@
-# type: ignore
-#
-# Auto-generated type stub for module.py
-# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
-#
-
-"""
-ErisPulse 模块基础模块
-
-提供模块基类定义和标准接口
-"""
-
-class BaseModule:
-    """
-    模块基类
-    
-    提供模块加载和卸载的标准接口
-    """
-    def should_eager_load() -> bool:
-        """
-        模块是否应该在启动时加载
-        默认为False(即懒加载)
-        
-        :return: 是否应该在启动时加载
-        """
-        ...
-    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-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/Event/__init__.pyi

@@ -1,26 +0,0 @@
-# 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-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/Event/base.pyi

@@ -1,62 +0,0 @@
-# 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-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/Event/command.pyi

@@ -1,113 +0,0 @@
-# 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-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/Event/exceptions.pyi

@@ -1,43 +0,0 @@
-# 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-2.3.3.data/data/ErisPulse-stubs/ErisPulse/Core/Event/message.pyi

@@ -1,93 +0,0 @@
-# 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: 是否成功取消注册
-        """
-        ...