# -*- coding: utf-8 -*- """测试用 AstrBot 宿主打桩。 陪伴插件的大模块(atrelay / llm_tool_actions / command_handlers / private_image / user_memory)在导入期就需要真实 AstrBot 宿主包。本模块让任意 `astrbot.*` 解析为 一个宽松的桩模块,从而可以在没有宿主的环境下对纯业务逻辑做定向测试。 被测业务逻辑本身不依赖这些桩的行为。 """ from __future__ import annotations import importlib.abc import importlib.machinery import logging import sys import types from typing import Any class _StubClass: def __init__(self, *args: Any, **kwargs: Any) -> None: pass def __call__(self, *args: Any, **kwargs: Any) -> "_StubClass": return self def __getattr__(self, name: str) -> Any: return _StubClass() class _FilterStub: def __getattr__(self, name: str) -> Any: def decorator(*args: Any, **kwargs: Any) -> Any: def wrap(func: Any) -> Any: return func if args and callable(args[0]): return args[0] return wrap return decorator def _stub_attribute(name: str) -> Any: if name == "logger": return logging.getLogger("astrbot.stub") if name == "filter": return _FilterStub() if name == "AstrBotConfig": return dict if name == "register": return lambda *args, **kwargs: (lambda cls: cls) return _StubClass class MagicModule(types.ModuleType): __path__: list[str] = [] def __getattr__(self, name: str) -> Any: if name.startswith("__"): raise AttributeError(name) value = _stub_attribute(name) setattr(self, name, value) return value class _AstrbotStubFinder(importlib.abc.MetaPathFinder, importlib.abc.Loader): def find_spec(self, fullname, path=None, target=None): # type: ignore[override] if fullname == "astrbot" or fullname.startswith("astrbot."): if fullname in sys.modules: return None return importlib.machinery.ModuleSpec(fullname, self, is_package=True) return None def create_module(self, spec): # type: ignore[override] return MagicModule(spec.name) def exec_module(self, module): # type: ignore[override] pass def _augment(module: types.ModuleType) -> None: """把别的测试模块预先放进 sys.modules 的极简桩升级成宽松桩,不替换对象。""" if module is None or isinstance(module, MagicModule): return if not hasattr(module, "__path__"): module.__path__ = [] # type: ignore[attr-defined] if "__getattr__" not in module.__dict__: def _module_getattr(name: str, _module: types.ModuleType = module) -> Any: if name.startswith("__"): raise AttributeError(name) value = _stub_attribute(name) setattr(_module, name, value) return value module.__dict__["__getattr__"] = _module_getattr def install() -> None: if not any(isinstance(finder, _AstrbotStubFinder) for finder in sys.meta_path): sys.meta_path.insert(0, _AstrbotStubFinder()) for name in ("astrbot", "astrbot.api", "astrbot.core"): _augment(sys.modules.get(name))