mirror of
https://github.com/nonebot/nonebot2.git
synced 2024-12-18 17:35:46 +08:00
208 lines
6.1 KiB
Markdown
208 lines
6.1 KiB
Markdown
---
|
||
sidebar_position: 0
|
||
description: nonebot 模块
|
||
---
|
||
|
||
# nonebot
|
||
|
||
本模块主要定义了 NoneBot 启动所需函数，供 bot 入口文件调用。
|
||
|
||
## 快捷导入
|
||
|
||
为方便使用，本模块从子模块导入了部分内容，以下内容可以直接通过本模块导入:
|
||
|
||
- `on` => [`on`](./plugin/on.md#on)
|
||
- `on_metaevent` => [`on_metaevent`](./plugin/on.md#on_metaevent)
|
||
- `on_message` => [`on_message`](./plugin/on.md#on_message)
|
||
- `on_notice` => [`on_notice`](./plugin/on.md#on_notice)
|
||
- `on_request` => [`on_request`](./plugin/on.md#on_request)
|
||
- `on_startswith` => [`on_startswith`](./plugin/on.md#on_startswith)
|
||
- `on_endswith` => [`on_endswith`](./plugin/on.md#on_endswith)
|
||
- `on_fullmatch` => [`on_fullmatch`](./plugin/on.md#on_fullmatch)
|
||
- `on_keyword` => [`on_keyword`](./plugin/on.md#on_keyword)
|
||
- `on_command` => [`on_command`](./plugin/on.md#on_command)
|
||
- `on_shell_command` => [`on_shell_command`](./plugin/on.md#on_shell_command)
|
||
- `on_regex` => [`on_regex`](./plugin/on.md#on_regex)
|
||
- `on_type` => [`on_type`](./plugin/on.md#on_type)
|
||
- `CommandGroup` => [`CommandGroup`](./plugin/on.md#CommandGroup)
|
||
- `Matchergroup` => [`MatcherGroup`](./plugin/on.md#MatcherGroup)
|
||
- `load_plugin` => [`load_plugin`](./plugin/load.md#load_plugin)
|
||
- `load_plugins` => [`load_plugins`](./plugin/load.md#load_plugins)
|
||
- `load_all_plugins` => [`load_all_plugins`](./plugin/load.md#load_all_plugins)
|
||
- `load_from_json` => [`load_from_json`](./plugin/load.md#load_from_json)
|
||
- `load_from_toml` => [`load_from_toml`](./plugin/load.md#load_from_toml)
|
||
- `load_builtin_plugin` => [`load_builtin_plugin`](./plugin/load.md#load_builtin_plugin)
|
||
- `load_builtin_plugins` => [`load_builtin_plugins`](./plugin/load.md#load_builtin_plugins)
|
||
- `get_plugin` => [`get_plugin`](./plugin/index.md#get_plugin)
|
||
- `get_plugin_by_module_name` => [`get_plugin_by_module_name`](./plugin/index.md#get_plugin_by_module_name)
|
||
- `get_loaded_plugins` => [`get_loaded_plugins`](./plugin/index.md#get_loaded_plugins)
|
||
- `get_available_plugin_names` => [`get_available_plugin_names`](./plugin/index.md#get_available_plugin_names)
|
||
- `require` => [`require`](./plugin/load.md#require)
|
||
|
||
## _def_ `get_driver()` {#get_driver}
|
||
|
||
- **说明**
|
||
|
||
获取全局 [Driver](./drivers/index.md#Driver) 实例。
|
||
|
||
可用于在计划任务的回调等情形中获取当前 [Driver](./drivers/index.md#Driver) 实例。
|
||
|
||
- **返回**
|
||
|
||
- nonebot.internal.driver.driver.Driver: 全局 [Driver](./drivers/index.md#Driver) 对象
|
||
|
||
- **异常**
|
||
|
||
- `ValueError`: 全局 [Driver](./drivers/index.md#Driver) 对象尚未初始化 ([nonebot.init](#init) 尚未调用)
|
||
|
||
- **用法**
|
||
|
||
```python
|
||
driver = nonebot.get_driver()
|
||
```
|
||
|
||
## _def_ `get_app()` {#get_app}
|
||
|
||
- **说明**
|
||
|
||
获取全局 [ReverseDriver](./drivers/index.md#ReverseDriver) 对应的 Server App 对象。
|
||
|
||
- **返回**
|
||
|
||
- Any: Server App 对象
|
||
|
||
- **异常**
|
||
|
||
- `AssertionError`: 全局 Driver 对象不是 [ReverseDriver](./drivers/index.md#ReverseDriver) 类型
|
||
|
||
- `ValueError`: 全局 [Driver](./drivers/index.md#Driver) 对象尚未初始化 ([nonebot.init](#init) 尚未调用)
|
||
|
||
- **用法**
|
||
|
||
```python
|
||
app = nonebot.get_app()
|
||
```
|
||
|
||
## _def_ `get_asgi()` {#get_asgi}
|
||
|
||
- **说明**
|
||
|
||
获取全局 [ReverseDriver](./drivers/index.md#ReverseDriver) 对应 [ASGI](https://asgi.readthedocs.io/) 对象。
|
||
|
||
- **返回**
|
||
|
||
- Any: ASGI 对象
|
||
|
||
- **异常**
|
||
|
||
- `AssertionError`: 全局 Driver 对象不是 [ReverseDriver](./drivers/index.md#ReverseDriver) 类型
|
||
|
||
- `ValueError`: 全局 [Driver](./drivers/index.md#Driver) 对象尚未初始化 ([nonebot.init](#init) 尚未调用)
|
||
|
||
- **用法**
|
||
|
||
```python
|
||
asgi = nonebot.get_asgi()
|
||
```
|
||
|
||
## _def_ `get_bot(self_id=None)` {#get_bot}
|
||
|
||
- **说明**
|
||
|
||
获取一个连接到 NoneBot 的 [Bot](./adapters/index.md#Bot) 对象。
|
||
|
||
当提供 `self_id` 时，此函数是 `get_bots()[self_id]` 的简写；
|
||
当不提供时，返回一个 [Bot](./adapters/index.md#Bot)。
|
||
|
||
- **参数**
|
||
|
||
- `self_id` (str | None): 用来识别 [Bot](./adapters/index.md#Bot) 的 {ref}`nonebot.adapters.Bot.self_id` 属性
|
||
|
||
- **返回**
|
||
|
||
- nonebot.internal.adapter.bot.Bot: [Bot](./adapters/index.md#Bot) 对象
|
||
|
||
- **异常**
|
||
|
||
- `KeyError`: 对应 self_id 的 Bot 不存在
|
||
|
||
- `ValueError`: 没有传入 self_id 且没有 Bot 可用
|
||
|
||
- `ValueError`: 全局 [Driver](./drivers/index.md#Driver) 对象尚未初始化 ([nonebot.init](#init) 尚未调用)
|
||
|
||
- **用法**
|
||
|
||
```python
|
||
assert nonebot.get_bot("12345") == nonebot.get_bots()["12345"]
|
||
|
||
another_unspecified_bot = nonebot.get_bot()
|
||
```
|
||
|
||
## _def_ `get_bots()` {#get_bots}
|
||
|
||
- **说明**
|
||
|
||
获取所有连接到 NoneBot 的 [Bot](./adapters/index.md#Bot) 对象。
|
||
|
||
- **返回**
|
||
|
||
- dict[str, nonebot.internal.adapter.bot.Bot]: 一个以 {ref}`nonebot.adapters.Bot.self_id` 为键，[Bot](./adapters/index.md#Bot) 对象为值的字典
|
||
|
||
- **异常**
|
||
|
||
- `ValueError`: 全局 [Driver](./drivers/index.md#Driver) 对象尚未初始化 ([nonebot.init](#init) 尚未调用)
|
||
|
||
- **用法**
|
||
|
||
```python
|
||
bots = nonebot.get_bots()
|
||
```
|
||
|
||
## _def_ `init(*, _env_file=None, **kwargs)` {#init}
|
||
|
||
- **说明**
|
||
|
||
初始化 NoneBot 以及 全局 [Driver](./drivers/index.md#Driver) 对象。
|
||
|
||
NoneBot 将会从 .env 文件中读取环境信息，并使用相应的 env 文件配置。
|
||
|
||
也可以传入自定义的 `_env_file` 来指定 NoneBot 从该文件读取配置。
|
||
|
||
- **参数**
|
||
|
||
- `_env_file` (str | os.PathLike | list[str | os.PathLike] | tuple[str | os.PathLike, ...] | NoneType): 配置文件名，默认从 `.env.{env_name}` 中读取配置
|
||
|
||
- `**kwargs` (Any): 任意变量，将会存储到 {ref}`nonebot.drivers.Driver.config` 对象里
|
||
|
||
- **返回**
|
||
|
||
- None
|
||
|
||
- **用法**
|
||
|
||
```python
|
||
nonebot.init(database=Database(...))
|
||
```
|
||
|
||
## _def_ `run(*args, **kwargs)` {#run}
|
||
|
||
- **说明**
|
||
|
||
启动 NoneBot，即运行全局 [Driver](./drivers/index.md#Driver) 对象。
|
||
|
||
- **参数**
|
||
|
||
- `*args` (Any): 传入 [Driver.run](./drivers/index.md#Driver-run) 的位置参数
|
||
|
||
- `**kwargs` (Any): 传入 [Driver.run](./drivers/index.md#Driver-run) 的命名参数
|
||
|
||
- **返回**
|
||
|
||
- None
|
||
|
||
- **用法**
|
||
|
||
```python
|
||
nonebot.run(host="127.0.0.1", port=8080)
|
||
```
|