nb_cli.plugin.load

本模块定义插件加载接口。

def load_plugin(module_path)

  • 说明

    加载单个插件,可以是本地插件或是通过 pip 安装的插件。

  • 参数

    • module_path (str | pathlib.Path): 插件名称 path.to.your.plugin 或插件路径 pathlib.Path(path/to/your/plugin)
  • 返回

def load_plugins(*plugin_dir)

  • 说明

    导入文件夹下多个插件,以 _ 开头的插件不会被导入!

  • 参数

    • *plugin_dir (str): 文件夹路径
  • 返回

def load_all_plugins(module_path, plugin_dir)

  • 说明

    导入指定列表中的插件以及指定目录下多个插件,以 _ 开头的插件不会被导入!

  • 参数

    • module_path (Iterable[str]): 指定插件集合

    • plugin_dir (Iterable[str]): 指定文件夹路径集合

  • 返回

def load_from_toml(file_path, encoding='utf-8')

  • 说明

    导入指定 toml 文件 [tool.nonebot] 中的 cli_plugins 以及 cli_plugin_dirs 下多个插件,以 _ 开头的插件不会被导入!

  • 参数

    • file_path (str): 指定 toml 文件路径

    • encoding (str): 指定 toml 文件编码

  • 返回

  • 用法

    pyproject.toml
    [tool.nonebot]
    cli_plugins = ["some_plugin"]
    cli_plugin_dirs = ["some_dir"]

def require(name)

  • 说明

    获取一个插件的导出内容。

    如果为 load_plugins 文件夹导入的插件,则为文件(夹)名。

  • 参数

  • 返回

    • module
  • 异常

    • RuntimeError: 插件无法加载