nonebot2/nonebot/plugin/plugin.py
2022-01-12 19:10:29 +08:00

84 lines
2.0 KiB
Python

from types import ModuleType
from dataclasses import field, dataclass
from typing import TYPE_CHECKING, Set, Dict, Type, Optional
from .export import Export
from nonebot.matcher import Matcher
if TYPE_CHECKING:
from .manager import PluginManager
plugins: Dict[str, "Plugin"] = {}
"""
已加载的插件
"""
@dataclass(eq=False)
class Plugin(object):
"""存储插件信息"""
name: str
"""
插件名称,使用 文件/文件夹 名称作为插件名
"""
module: ModuleType
"""
插件模块对象
"""
module_name: str
"""
点分割模块路径
"""
manager: "PluginManager"
"""
导入该插件的插件管理器
"""
export: Export = field(default_factory=Export)
"""
插件内定义的导出内容
"""
matcher: Set[Type[Matcher]] = field(default_factory=set)
"""
插件内定义的 `Matcher`
"""
parent_plugin: Optional["Plugin"] = None
"""
父插件
"""
sub_plugins: Set["Plugin"] = field(default_factory=set)
"""
子插件集合
"""
def get_plugin(name: str) -> Optional[Plugin]:
"""
获取当前导入的某个插件。
参数:
name: 插件名,与 `load_plugin` 参数一致。如果为 `load_plugins` 导入的插件,则为文件(夹)名。
"""
return plugins.get(name)
def get_loaded_plugins() -> Set[Plugin]:
"""
获取当前已导入的所有插件。
"""
return set(plugins.values())
def _new_plugin(fullname: str, module: ModuleType, manager: "PluginManager") -> Plugin:
name = fullname.rsplit(".", 1)[-1] if "." in fullname else fullname
if name in plugins:
raise RuntimeError("Plugin already exists! Check your plugin name.")
plugin = Plugin(name, module, fullname, manager)
return plugin
def _confirm_plugin(plugin: Plugin) -> None:
if plugin.name in plugins:
raise RuntimeError("Plugin already exists! Check your plugin name.")
plugins[plugin.name] = plugin