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

ErisPulse/utils/cli.pyi

@@ -0,0 +1,145 @@
+# 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/utils/console.pyi

@@ -0,0 +1,20 @@
+# type: ignore
+#
+# Auto-generated type stub for console.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+import sys
+from rich.console import Console
+from rich.theme import Theme
+from rich.highlighter import RegexHighlighter
+
+class CommandHighlighter(RegexHighlighter):
+    """
+    高亮CLI命令和参数
+    
+    {!--< tips >!--}
+    使用正则表达式匹配命令行参数和选项
+    {!--< /tips >!--}
+    """
+    ...

ErisPulse/utils/package_manager.pyi

@@ -0,0 +1,224 @@
+# type: ignore
+#
+# Auto-generated type stub for package_manager.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 包管理器
+
+提供包安装、卸载、升级和查询功能
+"""
+
+import os
+import asyncio
+import importlib.metadata
+import json
+import subprocess
+import sys
+import time
+from typing import List, Dict, Tuple, Optional, Any
+from rich.panel import Panel
+from rich.progress import Progress, BarColumn, TextColumn
+from rich.prompt import Confirm
+from .console import console
+
+class PackageManager:
+    """
+    ErisPulse包管理器
+    
+    提供包安装、卸载、升级和查询功能
+    
+    {!--< tips >!--}
+    1. 支持本地和远程包管理
+    2. 包含1小时缓存机制
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化包管理器
+        """
+        ...
+    async def _fetch_remote_packages(self: object, url: str) -> Optional[dict]:
+        """
+        从指定URL获取远程包数据
+        
+        :param url: 远程包数据URL
+        :return: 解析后的JSON数据，失败返回None
+        
+        :raises ClientError: 网络请求失败时抛出
+        :raises JSONDecodeError: JSON解析失败时抛出
+        """
+        ...
+    async def get_remote_packages(self: object, force_refresh: bool = ...) -> dict:
+        """
+        获取远程包列表，带缓存机制
+        
+        :param force_refresh: 是否强制刷新缓存
+        :return: 包含模块和适配器的字典
+        
+        :return:
+            dict: {
+                "modules": {模块名: 模块信息},
+                "adapters": {适配器名: 适配器信息},
+                "cli_extensions": {扩展名: 扩展信息}
+            }
+        """
+        ...
+    def get_installed_packages(self: object) -> Dict[(str, Dict[(str, Dict[(str, str)])])]:
+        """
+        获取已安装的包信息
+        
+        :return: 已安装包字典，包含模块、适配器和CLI扩展
+        
+        :return:
+            dict: {
+                "modules": {模块名: 模块信息},
+                "adapters": {适配器名: 适配器信息},
+                "cli_extensions": {扩展名: 扩展信息}
+            }
+        """
+        ...
+    def _is_module_enabled(self: object, module_name: str) -> bool:
+        """
+        检查模块是否启用
+        
+        :param module_name: 模块名称
+        :return: 模块是否启用
+        
+        :raises ImportError: 核心模块不可用时抛出
+        """
+        ...
+    def _normalize_name(self: object, name: str) -> str:
+        """
+        标准化包名，统一转为小写以实现大小写不敏感比较
+        
+        :param name: 原始名称
+        :return: 标准化后的名称
+        """
+        ...
+    async def _find_package_by_alias(self: object, alias: str) -> Optional[str]:
+        """
+        通过别名查找实际包名（大小写不敏感）
+        
+        :param alias: 包别名
+        :return: 实际包名，未找到返回None
+        """
+        ...
+    def _find_installed_package_by_name(self: object, name: str) -> Optional[str]:
+        """
+        在已安装包中查找实际包名（大小写不敏感）
+        
+        :param name: 包名或别名
+        :return: 实际包名，未找到返回None
+        """
+        ...
+    def _run_pip_command_with_output(self: object, args: List[str], description: str) -> Tuple[(bool, str, str)]:
+        """
+        执行pip命令并捕获输出
+        
+        :param args: pip命令参数列表
+        :param description: 进度条描述
+        :return: (是否成功, 标准输出, 标准错误)
+        """
+        ...
+    def _compare_versions(self: object, version1: str, version2: str) -> int:
+        """
+        比较两个版本号
+        
+        :param version1: 版本号1
+        :param version2: 版本号2
+        :return: 1 if version1 > version2, -1 if version1 < version2, 0 if equal
+        """
+        ...
+    def _check_sdk_compatibility(self: object, min_sdk_version: str) -> Tuple[(bool, str)]:
+        """
+        检查SDK版本兼容性
+        
+        :param min_sdk_version: 所需的最小SDK版本
+        :return: (是否兼容, 当前版本信息)
+        """
+        ...
+    async def _get_package_info(self: object, package_name: str) -> Optional[Dict[(str, Any)]]:
+        """
+        获取包的详细信息（包括min_sdk_version等）
+        
+        :param package_name: 包名或别名
+        :return: 包信息字典
+        """
+        ...
+    def install_package(self: object, package_names: List[str], upgrade: bool = ..., pre: bool = ...) -> bool:
+        """
+        安装指定包（支持多个包）
+        
+        :param package_names: 要安装的包名或别名列表
+        :param upgrade: 是否升级已安装的包
+        :param pre: 是否包含预发布版本
+        :return: 安装是否成功
+        """
+        ...
+    def uninstall_package(self: object, package_names: List[str]) -> bool:
+        """
+        卸载指定包（支持多个包，支持别名）
+        
+        :param package_names: 要卸载的包名或别名列表
+        :return: 卸载是否成功
+        """
+        ...
+    def upgrade_all(self: object) -> bool:
+        """
+        升级所有已安装的ErisPulse包
+        
+        :return: 升级是否成功
+        
+        :raises KeyboardInterrupt: 用户取消操作时抛出
+        """
+        ...
+    def upgrade_package(self: object, package_names: List[str], pre: bool = ...) -> bool:
+        """
+        升级指定包（支持多个包）
+        
+        :param package_names: 要升级的包名或别名列表
+        :param pre: 是否包含预发布版本
+        :return: 升级是否成功
+        """
+        ...
+    def search_package(self: object, query: str) -> Dict[(str, List[Dict[(str, str)]])]:
+        """
+        搜索包（本地和远程）
+        
+        :param query: 搜索关键词
+        :return: 匹配的包信息
+        """
+        ...
+    def get_installed_version(self: object) -> str:
+        """
+        获取当前安装的ErisPulse版本
+        
+        :return: 当前版本号
+        """
+        ...
+    async def get_pypi_versions(self: object) -> List[Dict[(str, Any)]]:
+        """
+        从PyPI获取ErisPulse的所有可用版本
+        
+        :return: 版本信息列表
+        """
+        ...
+    def _is_pre_release(self: object, version: str) -> bool:
+        """
+        判断版本是否为预发布版本
+        
+        :param version: 版本号
+        :return: 是否为预发布版本
+        """
+        ...
+    def update_self(self: object, target_version: str = ..., force: bool = ...) -> bool:
+        """
+        更新ErisPulse SDK本身
+        
+        :param target_version: 目标版本号，None表示更新到最新版本
+        :param force: 是否强制更新
+        :return: 更新是否成功
+        """
+        ...

ErisPulse/utils/reload_handler.pyi

@@ -0,0 +1,64 @@
+# type: ignore
+#
+# Auto-generated type stub for reload_handler.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 热重载处理器
+
+实现热重载功能，监控文件变化并重启进程
+"""
+
+import os
+import subprocess
+import sys
+import time
+from watchdog.events import FileSystemEventHandler
+from .console import console
+
+class ReloadHandler(FileSystemEventHandler):
+    """
+    文件系统事件处理器
+    
+    实现热重载功能，监控文件变化并重启进程
+    
+    {!--< tips >!--}
+    1. 支持.py文件修改重载
+    2. 支持配置文件修改重载
+    {!--< /tips >!--}
+    """
+    def __init__(self: None, script_path: str, reload_mode: bool = ...) -> ...:
+        """
+        初始化处理器
+        
+        :param script_path: 要监控的脚本路径
+        :param reload_mode: 是否启用重载模式
+        """
+        ...
+    def start_process(self: object) -> ...:
+        """
+        启动监控进程
+        """
+        ...
+    def _terminate_process(self: object) -> ...:
+        """
+        终止当前进程
+        
+        :raises subprocess.TimeoutExpired: 进程终止超时时抛出
+        """
+        ...
+    def on_modified(self: object, event: ...) -> ...:
+        """
+        文件修改事件处理
+        
+        :param event: 文件系统事件
+        """
+        ...
+    def _handle_reload(self: object, event: ..., reason: str) -> ...:
+        """
+        处理热重载逻辑
+        :param event: 文件系统事件
+        :param reason: 重载原因
+        """
+        ...

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

@@ -0,0 +1,14 @@
+# 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

@@ -0,0 +1,140 @@
+# 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

@@ -0,0 +1,52 @@
+# 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

@@ -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