ErisPulse 2.8.0.dev0__tar.gz → 2.8.0.dev2__tar.gz

{erispulse-2.8.0.dev0 → erispulse-2.8.0.dev2}/.gitignore

@@ -1,6 +1,7 @@
 # dev gnore ignore file for Python projects
 devs/videos
 main.py
+plugins/
 venvs
 config.toml
 uv.lock

{erispulse-2.8.0.dev0 → erispulse-2.8.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ErisPulse
-Version: 2.8.0.dev0
+Version: 2.8.0.dev2
 Summary: Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署
 Project-URL: Homepage, https://github.com/ErisPulse/ErisPulse
 Project-URL: Documentation, https://www.erisdev.com#docs
@@ -10,27 +10,7 @@ Project-URL: Bug Tracker, https://github.com/ErisPulse/ErisPulse/blob/main/docs/
 Project-URL: Changelog, https://github.com/ErisPulse/ErisPulse/blob/main/CHANGELOG.md
 Author: ErisDev
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
-License: MIT License
-        
-        Copyright (c) 2025-2026 ErisPulse
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
+License-Expression: MIT
 License-File: LICENSE
 Keywords: async,asyncio,bot,bot-framework,chatbot,email,extensible,framework,instant-messaging,kook,matrix,modular,multi-platform,onebot,onebot12,qq,robot,sdk,telegram,yunhu
 Classifier: Development Status :: 4 - Beta
@@ -49,16 +29,16 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: aiosqlite>=0.20.0
 Requires-Dist: fastapi>=0.116.1
 Requires-Dist: rich>=13.0.0
-Requires-Dist: toml>=0.10.2
+Requires-Dist: tomlkit>=0.15.1
 Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: websockets>=12.0
-Provides-Extra: dev
-Requires-Dist: basedpyright>=1.20.0; extra == 'dev'
-Requires-Dist: pyclean>=3.6.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.7; extra == 'dev'
-Requires-Dist: typing-extensions>=4.7.0; (python_version < '3.11') and extra == 'dev'
+Provides-Extra: mysql
+Requires-Dist: aiomysql>=0.2.0; extra == 'mysql'
+Provides-Extra: postgres
+Requires-Dist: asyncpg>=0.29.0; extra == 'postgres'
 Provides-Extra: test
 Requires-Dist: httpx>=0.24.0; extra == 'test'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
@@ -69,8 +49,6 @@ Requires-Dist: pytest-xdist>=3.0.0; extra == 'test'
 Requires-Dist: pytest>=7.0.0; extra == 'test'
 Description-Content-Type: text/markdown
 
-![ErisPulse](https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/mascot-hero.png)
-
 # ErisPulse
 
 **Write once, deploy on multiple platforms.**
@@ -99,7 +77,9 @@ It ships with a flexible plugin system, hot reload, a visual Dashboard, an AI Bu
 - **Event-driven architecture** — Clear event model based on OneBot12, making message handling intuitive and consistent across platforms.
 - **Cross-platform compatibility** — Write handlers once, deploy to 15+ platforms without rewriting business logic.
 - **Modular design** — Flexible plugin system with hot-plug module management and per-module configuration.
-- **Hot reload** — Iterate on code during development without restarting the bot process.
+- **Hot reload** — Local plugins reload on save; any module (including PyPI-installed ones) hot-reloads via a single `sdk.reload_module()` call — no process restart, even after pip upgrades.
+- **Unified Event Overrides** — Override message triggers, command params and user permissions for *every* event type with a single config — no module code changes, takes effect instantly.
+- **Scope Control** — Three-dimensional scope (module availability / event admission / outbound limits) with runtime-adjustable fine-grained control.
 - **Chainable SendDSL** — Express `@mention`, reply, retry, timeout, progress hook and bulk send as a single fluent chain.
 - **Complete toolchain** — `epsdk` CLI, visual Dashboard, AI Builder and Module Market included out of the box.
 

{erispulse-2.8.0.dev0 → erispulse-2.8.0.dev2}/README.pypi.md

@@ -1,5 +1,3 @@
-![ErisPulse](https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/mascot-hero.png)
-
 # ErisPulse
 
 **Write once, deploy on multiple platforms.**
@@ -28,7 +26,9 @@ It ships with a flexible plugin system, hot reload, a visual Dashboard, an AI Bu
 - **Event-driven architecture** — Clear event model based on OneBot12, making message handling intuitive and consistent across platforms.
 - **Cross-platform compatibility** — Write handlers once, deploy to 15+ platforms without rewriting business logic.
 - **Modular design** — Flexible plugin system with hot-plug module management and per-module configuration.
-- **Hot reload** — Iterate on code during development without restarting the bot process.
+- **Hot reload** — Local plugins reload on save; any module (including PyPI-installed ones) hot-reloads via a single `sdk.reload_module()` call — no process restart, even after pip upgrades.
+- **Unified Event Overrides** — Override message triggers, command params and user permissions for *every* event type with a single config — no module code changes, takes effect instantly.
+- **Scope Control** — Three-dimensional scope (module availability / event admission / outbound limits) with runtime-adjustable fine-grained control.
 - **Chainable SendDSL** — Express `@mention`, reply, retry, timeout, progress hook and bulk send as a single fluent chain.
 - **Complete toolchain** — `epsdk` CLI, visual Dashboard, AI Builder and Module Market included out of the box.
 

{erispulse-2.8.0.dev0 → erispulse-2.8.0.dev2}/pyproject.toml

@@ -1,14 +1,15 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling>=1.26"]
 build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.8.0-dev.0"
+version = "2.8.0-dev.2"
 description = "Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署"
 readme = "README.pypi.md"
 requires-python = ">=3.10"
-license = { file = "LICENSE" }
+license = "MIT"
+license-files = ["LICENSE"]
 
 authors = [
     { name = "ErisDev" }
@@ -60,13 +61,14 @@ classifiers = [
 
 dependencies = [
     "rich>=13.0.0",
-    "toml>=0.10.2",
-
+    "tomlkit>=0.15.1",
     # network 相关
     "websockets>=12.0",
     "aiohttp>=3.9.0",
     "fastapi>=0.116.1",
     "uvicorn>=0.30.0",
+    # storage 相关（默认 SQLite 后端异步驱动，开箱即用）
+    "aiosqlite>=0.20.0",
 ]
 
 [project.urls]
@@ -78,6 +80,13 @@ Issues = "https://github.com/ErisPulse/ErisPulse/issues"
 Changelog = "https://github.com/ErisPulse/ErisPulse/blob/main/CHANGELOG.md"
 
 [project.optional-dependencies]
+# 存储后端可选驱动：pip install ErisPulse[mysql] / ErisPulse[postgres]
+mysql = [
+    "aiomysql>=0.2.0",
+]
+postgres = [
+    "asyncpg>=0.29.0",
+]
 test = [
     "pytest>=7.0.0",
     "pytest-cov>=4.0.0",
@@ -87,11 +96,14 @@ test = [
     "pytest-benchmark>=4.0.0",
     "httpx>=0.24.0",
 ]
+
+[dependency-groups]
 dev = [
     "pyclean>=3.6.0",
     "ruff>=0.1.7",
     "basedpyright>=1.20.0",
-    "typing_extensions>=4.7.0; python_version < '3.11'"]
+    "typing_extensions>=4.7.0; python_version < '3.11'",
+]
 
 [project.scripts]
 ep-init = "ErisPulse.__init__:init_sync"
@@ -118,7 +130,7 @@ include = [
 target-version = "py310"
 line-length = 120
 
-include = ["src/**/*.py"]
+include = ["src/**/*.py", "tests/**/*.py"]
 
 extend-exclude = [
     "__pycache__",
@@ -161,6 +173,7 @@ ignore = [
     "PLR0912",  # too-many-branches
     "PLR0913",  # too-many-arguments
     "PLR0915",  # too-many-statements
+    "PLR0917",  # too-many-positional-arguments —— 同 PLR0913，既有公共 API 签名不可破坏
     "PLR2004",  # magic-value-comparison —— 数值阈值判定过于严格
     "PLR1714",  # repeated-equality-comparison
     "PLW0602",  # global-variable-not-assigned
@@ -169,6 +182,7 @@ ignore = [
     "PERF203",  # try-except-in-loop —— 异步轮询/重试场景的常见且必要写法，性能影响极小
     "RUF012",   # mutable-class-default —— 类属性容器（handlers/事件表）是项目既有 API
     "RUF005",   # collection-literal-concatenation —— `list + list` 有时比 unpack 更清晰
+    "RUF022",   # unsorted-dunder-all —— __all__ 常按语义分组并附加注释，强制排序破坏可读性
     "RET504",   # unnecessary-assign —— “先 assign 再 return”有时更易调试
 
     # 风格偏好（不强加于现有代码）
@@ -194,7 +208,15 @@ ignore = [
 
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = ["F401", "PLC0415", "I001"]  # 导出式 __init__ 经常按需导入
-"tests/**/*.py" = ["S101", "PLR2004", "SLF001", "ARG", "ANN", "PTH"]
+"tests/**/*.py" = [
+    # 断言/夹具相关（测试代码天然模式）
+    "S101", "PLR2004", "SLF001", "ARG", "ANN", "PTH",
+    "E712", "B011", "B017", "B018", "RUF043",
+    # 测试内常见的宽松写法
+    "E702", "E402", "F841", "RUF059", "PLW0108",
+    "UP031", "N814", "PERF401", "PLR0917", "RUF015",
+    "B007", "PIE810", "PLR0124", "PLW1510", "SIM118",
+]
 
 [tool.ruff.lint.pep8-naming]
 # 装饰器方法、classmethod 的首参数名允许保留

erispulse-2.8.0.dev2/src/ErisPulse/CLI/commands/config.py

@@ -0,0 +1,208 @@
+"""
+Config 命令实现
+
+交互式配置适配器/模块（schema 驱动向导，含适配器多账户管理）
+"""
+
+import json
+from argparse import ArgumentParser
+
+from rich.box import SIMPLE
+from rich.prompt import Prompt
+from rich.table import Table
+
+from ..base import Command
+from ..console import console
+from ..i18n import i18n
+from ..utils import config_wizard
+from ..utils.config_wizard import (
+    STATUS_INCOMPLETE,
+    STATUS_NONE,
+    STATUS_OK,
+    STATUS_UNCONFIGURED,
+)
+from ..utils.display import section_header
+
+
+class ConfigCommand(Command):
+    """
+    config 命令
+
+    交互式配置适配器/模块；适配器支持多账户（bot 账户）管理
+    """
+
+    name = "config"
+    description = i18n.t("cli.config.description")
+    aliases = ["cfg", "conf"]
+
+    def add_arguments(self, parser: ArgumentParser):
+        parser.add_argument(
+            "name",
+            nargs="?",
+            help=i18n.t("cli.config.name_help"),
+        )
+        parser.add_argument(
+            "--list",
+            "-l",
+            action="store_true",
+            help=i18n.t("cli.config.list_help"),
+        )
+        parser.add_argument(
+            "--json",
+            action="store_true",
+            help=i18n.t("cli.config.json_help"),
+        )
+
+    def execute(self, args):
+        from ErisPulse import config
+
+        targets = config_wizard.load_config_targets()
+        if not targets:
+            console.print(f"[dim]  {i18n.t('cli.config.no_targets')}[/]")
+            console.print(f"[dim]  {i18n.t('cli.config.install_hint')}[/]")
+            return
+
+        if getattr(args, "json", False):
+            self._print_status_json(targets, config)
+            return
+
+        if args.name:
+            self._run_named(targets, args.name, config)
+            return
+
+        self._print_status_table(targets, config)
+
+        if args.list:
+            return
+
+        if not config_wizard.is_interactive():
+            console.print(f"[dim]  {i18n.t('cli.config.non_interactive_hint')}[/]")
+            return
+
+        self._interactive_select(targets, config)
+
+    def _print_status_json(self, targets, config):
+        """
+        以 JSON 输出全部目标及其配置状态（供 CI / 脚本消费）
+
+        :param targets: ConfigTarget 列表
+        :param config: ConfigManager 实例
+        """
+        result = {}
+        for target in sorted(targets, key=lambda t: (t.kind != "adapter", t.name.lower())):
+            status, errors = config_wizard.get_target_status(target, config)
+            result[target.name] = {
+                "kind": target.kind,
+                "config_key": target.config_key,
+                "status": status,
+                "errors": errors,
+            }
+        console.print_json(json.dumps(result, ensure_ascii=False, indent=2))
+
+    def _run_named(self, targets, name: str, config):
+        """
+        按名称定位目标并直接进入向导
+
+        :param targets: ConfigTarget 列表
+        :param name: 目标名（适配器平台名/模块名，或适配器配置键）
+        :param config: ConfigManager 实例
+        """
+        for target in targets:
+            if target.name == name or target.config_key == name:
+                if not target.configurable:
+                    console.print(f"[warning]  {i18n.t('cli.config.no_declaration', name=target.name)}[/]")
+                    return
+                config_wizard.run_wizard(target, config)
+                return
+        console.print(f"[error]  {i18n.t('cli.config.not_found', name=name)}[/]")
+
+    def _status_text(self, status: str) -> str:
+        """
+        将状态常量渲染为带颜色的显示文本
+
+        :param status: get_target_status 返回的状态常量
+        :return: rich 标记的状态文本
+        """
+        mapping = {
+            STATUS_OK: ("cli.config.status_ok", "green"),
+            STATUS_INCOMPLETE: ("cli.config.status_incomplete", "yellow"),
+            STATUS_UNCONFIGURED: ("cli.config.status_unconfigured", "cyan"),
+            STATUS_NONE: ("cli.config.status_none", "dim"),
+        }
+        key, style = mapping.get(status, ("cli.config.status_none", "dim"))
+        return f"[{style}]{i18n.t(key)}[/]"
+
+    def _print_status_table(self, targets, config):
+        """
+        打印全部目标及其配置状态表
+
+        :param targets: ConfigTarget 列表
+        :param config: ConfigManager 实例
+        """
+        table = Table(box=SIMPLE, show_lines=False, header_style="bold", pad_edge=False)
+        table.add_column(i18n.t("cli.config.header_kind"), width=8)
+        table.add_column(i18n.t("cli.config.header_name"), min_width=12)
+        table.add_column(i18n.t("cli.config.header_status"), width=10)
+        table.add_column(i18n.t("cli.config.header_detail"))
+
+        for target in sorted(targets, key=lambda t: (t.kind != "adapter", t.name.lower())):
+            status, errors = config_wizard.get_target_status(target, config)
+            detail = "；".join(errors[:3])
+            if len(errors) > 3:
+                detail += f" (+{len(errors) - 3})"
+            kind_style = "adapter" if target.kind == "adapter" else "module"
+            table.add_row(
+                f"[{kind_style}]{target.kind_label}[/]",
+                target.name,
+                self._status_text(status),
+                detail,
+            )
+
+        console.print(table)
+
+    def _interactive_select(self, targets, config):
+        """
+        交互式选择目标并进入向导（可连续配置多个）
+
+        :param targets: ConfigTarget 列表
+        :param config: ConfigManager 实例
+        """
+        selectable = [t for t in targets if t.configurable]
+        if not selectable:
+            console.print(f"[dim]  {i18n.t('cli.config.no_configurable')}[/]")
+            return
+
+        selectable.sort(key=lambda t: (t.kind != "adapter", t.name.lower()))
+
+        while True:
+            section_header(i18n.t("cli.config.select_section"))
+            for idx, target in enumerate(selectable, 1):
+                status, _ = config_wizard.get_target_status(target, config)
+                kind_style = "adapter" if target.kind == "adapter" else "module"
+                console.print(f"    [bold]{idx}.[/] [{kind_style}]{target.name}[/]  {self._status_text(status)}")
+
+            try:
+                raw = Prompt.ask(
+                    f"  {i18n.t('cli.config.select_prompt')}",
+                    default="",
+                    show_default=False,
+                )
+            except (EOFError, KeyboardInterrupt):
+                break
+
+            raw = raw.strip()
+            if not raw:
+                break
+
+            try:
+                idx = int(raw)
+            except ValueError:
+                console.print(f"[warning]  {i18n.t('cli.config.invalid_index', idx=raw)}[/]")
+                continue
+
+            if not 1 <= idx <= len(selectable):
+                console.print(f"[warning]  {i18n.t('cli.config.invalid_index', idx=idx)}[/]")
+                continue
+
+            config_wizard.run_wizard(selectable[idx - 1], config)
+            # 向导结束后回到选择菜单（状态重新刷新），支持连续配置多个目标

{erispulse-2.8.0.dev0 → erispulse-2.8.0.dev2}/src/ErisPulse/CLI/commands/create.py

@@ -58,6 +58,13 @@ dependencies = [
 
 [project.entry-points]
 "erispulse.module" = {{ "{name}" = "{name}:Main" }}
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["{name}"]
 """
 
 _MODULE_INIT = """from .Core import Main
@@ -79,7 +86,11 @@ class Main(BaseModule):
     # {text[module.config_hint]}
     @dataclass
     class ConfigClass(BaseConfig):
-        \"\"\"{text[module.config_doc]}\"\"\"
+        \"\"\"
+        {text[module.config_doc]}
+
+        :ivar advanced_threshold: 高级阈值（docstring :ivar: 声明即为字段描述，无需 metadata）
+        \"\"\"
 
         enabled: bool = field(
             default=True,
@@ -87,6 +98,11 @@ class Main(BaseModule):
                 \"description\": {{\"i18n\": \"module.{name}.enabled\", \"default\": \"Enable module\"}},
             }},
         )
+        # example 字段：默认不写入 config.toml（仅记录在 config.full.example，用户按需启用）
+        advanced_threshold: int = field(
+            default=100,
+            metadata={{\"example\": True, \"min\": 0}},
+        )
 
     # {text[module.i18n_hint]}
     class I18nClass(BaseI18n):
@@ -152,6 +168,9 @@ class Main(BaseModule):
             author=\"ErisDev\",
             group=\"default\",
             tags=[\"{name}\"],
+            # 对外服务白名单（可选）：声明后其他模块可经 sdk.module.call() 调用这些方法；
+            # 缺省时公开方法全开放（限制由用户通过 scope.actions 配置）
+            # services=[\"get_welcome_message\"],
         )
 
     @staticmethod
@@ -192,6 +211,12 @@ class Main(BaseModule):
         self.logger.info(\"{text[module.log.config_updated]}\")
 
     async def _register_commands(self):
+        # 命令权限（可选）：permission 为调用函数，返回 True 才执行命令；
+        # master=True 限定框架主人（仅开发者默认值，用户可在统一覆写系统
+        # ErisPulse.event.overrides.command.<module>.<cmd>.master = true/false 覆写收紧或放开）；
+        # 跨命令的用户黑白名单用覆写系统 ACL
+        # （ErisPulse.event.overrides.acl 或 overrides.acl.set(name, allow/deny)，命令名支持 glob）；
+        # 模块级可用性 / 事件准入 / 出站限制由作用域 scope 管理（用户可控）
         @command(\"hello\", help=i18n.t(\"module.{name}.command.hello.help\"))
         async def hello_command(event: Event):
             await event.reply(i18n.t(\"module.{name}.command.hello.reply\"))
@@ -205,6 +230,11 @@ class Main(BaseModule):
         async def group_message_handler(event: Event):
             pass
 
+        # 消息装饰器支持 pattern（glob 通配符）/ regex（正则），不匹配则不触发
+        @message.on_message(pattern=\"签到*\")
+        async def signin_handler(event: Event):
+            await event.reply(\"签到成功\")
+
         @notice.on_friend_add()
         async def friend_add_handler(event: Event):
             self.logger.info((\"{text[module.log.friend_add]}\").format(nickname=event.get_user_nickname()))
@@ -227,6 +257,13 @@ dependencies = [
 
 [project.entry-points]
 "erispulse.adapter" = {{ "{entry_key}" = "{name}:{name}" }}
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["{name}"]
 """
 
 _ADAPTER_INIT = """from .Core import {name}
@@ -263,7 +300,11 @@ class {name}(BaseAdapter):
     # {text[adapter.config_hint]}
     @dataclass
     class ConfigClass(BaseConfig):
-        \"\"\"{text[adapter.config_doc]}\"\"\"
+        \"\"\"
+        {text[adapter.config_doc]}
+
+        :ivar request_timeout: 请求超时秒数（docstring :ivar: 声明即为字段描述，无需 metadata）
+        \"\"\"
 
         endpoint: str = field(
             default="https://api.example.com",
@@ -282,6 +323,11 @@ class {name}(BaseAdapter):
                 "ui": {{"widget": "password", "group": "basic", "order": 2}},
             }},
         )
+        # example 字段：默认不写入 config.toml（仅记录在 config.full.example，用户按需启用）
+        request_timeout: int = field(
+            default=30,
+            metadata={{"example": True, "min": 1, "max": 300}},
+        )
 
     # {text[adapter.i18n_hint]}
     class I18nClass(BaseI18n):