mirror of
https://github.com/nonebot/nonebot2.git
synced 2025-01-19 09:38:21 +08:00
📝 update docs
This commit is contained in:
parent
be674c0efc
commit
247456df56
@ -17,6 +17,16 @@ sidebarDepth: 0
|
|||||||
Bot 基类。用于处理上报消息,并提供 API 调用接口。
|
Bot 基类。用于处理上报消息,并提供 API 调用接口。
|
||||||
|
|
||||||
|
|
||||||
|
### `driver`
|
||||||
|
|
||||||
|
Driver 对象
|
||||||
|
|
||||||
|
|
||||||
|
### `config`
|
||||||
|
|
||||||
|
Config 配置对象
|
||||||
|
|
||||||
|
|
||||||
### _abstract_ `__init__(connection_type, self_id, *, websocket=None)`
|
### _abstract_ `__init__(connection_type, self_id, *, websocket=None)`
|
||||||
|
|
||||||
|
|
||||||
@ -33,34 +43,35 @@ Bot 基类。用于处理上报消息,并提供 API 调用接口。
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract async_ `call_api(api, **data)`
|
### `connection_type`
|
||||||
|
|
||||||
|
连接类型
|
||||||
|
|
||||||
|
|
||||||
|
### `self_id`
|
||||||
|
|
||||||
|
机器人 ID
|
||||||
|
|
||||||
|
|
||||||
|
### `websocket`
|
||||||
|
|
||||||
|
Websocket 连接对象
|
||||||
|
|
||||||
|
|
||||||
|
### _abstract property_ `type`
|
||||||
|
|
||||||
|
Adapter 类型
|
||||||
|
|
||||||
|
|
||||||
|
### _classmethod_ `register(driver, config)`
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
* **说明**
|
||||||
|
|
||||||
调用机器人 API 接口,可以通过该函数或直接通过 bot 属性进行调用
|
register 方法会在 driver.register_adapter 时被调用,用于初始化相关配置
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **参数**
|
|
||||||
|
|
||||||
|
|
||||||
* `api: str`: API 名称
|
|
||||||
|
|
||||||
|
|
||||||
* `**data`: API 数据
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **示例**
|
|
||||||
|
|
||||||
|
|
||||||
```python
|
|
||||||
await bot.call_api("send_msg", message="hello world")
|
|
||||||
await bot.send_msg(message="hello world")
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract async classmethod_ `check_permission(driver, connection_type, headers, body)`
|
### _abstract async classmethod_ `check_permission(driver, connection_type, headers, body)`
|
||||||
|
|
||||||
|
|
||||||
@ -116,15 +127,34 @@ await bot.send_msg(message="hello world")
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _classmethod_ `register(driver, config)`
|
### _abstract async_ `call_api(api, **data)`
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
* **说明**
|
||||||
|
|
||||||
register 方法会在 driver.register_adapter 时被调用,用于初始化相关配置
|
调用机器人 API 接口,可以通过该函数或直接通过 bot 属性进行调用
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **参数**
|
||||||
|
|
||||||
|
|
||||||
|
* `api: str`: API 名称
|
||||||
|
|
||||||
|
|
||||||
|
* `**data`: API 数据
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **示例**
|
||||||
|
|
||||||
|
|
||||||
|
```python
|
||||||
|
await bot.call_api("send_msg", message="hello world")
|
||||||
|
await bot.send_msg(message="hello world")
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### _abstract async_ `send(event, message, **kwargs)`
|
### _abstract async_ `send(event, message, **kwargs)`
|
||||||
|
|
||||||
|
|
||||||
@ -147,167 +177,29 @@ await bot.send_msg(message="hello world")
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract property_ `type`
|
## _class_ `MessageSegment`
|
||||||
|
|
||||||
Adapter 类型
|
基类:`abc.ABC`
|
||||||
|
|
||||||
|
消息段基类
|
||||||
|
|
||||||
## _class_ `Event`
|
|
||||||
|
|
||||||
基类:`abc.ABC`, `pydantic.main.BaseModel`
|
### `type`
|
||||||
|
|
||||||
Event 基类。提供获取关键信息的方法,其余信息可直接获取。
|
|
||||||
|
|
||||||
|
* 类型: `str`
|
||||||
|
|
||||||
### _abstract_ `get_event_description()`
|
|
||||||
|
|
||||||
|
* 说明: 消息段类型
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取事件描述的方法,通常为事件具体内容。
|
### `data`
|
||||||
|
|
||||||
|
|
||||||
|
* 类型: `Dict[str, Union[str, list]]`
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `str`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract_ `get_event_name()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取事件名称的方法。
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `str`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### `get_log_string()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取事件日志信息的方法,通常你不需要修改这个方法,只有当希望 NoneBot 隐藏该事件日志时,可以抛出 `NoLogException` 异常。
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `str`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **异常**
|
|
||||||
|
|
||||||
|
|
||||||
* `NoLogException`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract_ `get_message()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取事件消息内容的方法。
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `Message`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### `get_plaintext()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取消息纯文本的方法,通常不需要修改,默认通过 `get_message().extract_plain_text` 获取。
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `str`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract_ `get_session_id()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取会话 id 的方法,用于判断当前事件属于哪一个会话,通常是用户 id、群组 id 组合。
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `str`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract_ `get_type()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取事件类型的方法,类型通常为 NoneBot 内置的四种类型。
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `Literal["message", "notice", "request", "meta_event"]`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract_ `get_user_id()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取事件主体 id 的方法,通常是用户 id 。
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `str`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### _abstract_ `is_tome()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
获取事件是否与机器人有关的方法。
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **返回**
|
|
||||||
|
|
||||||
|
|
||||||
* `bool`
|
|
||||||
|
|
||||||
|
* 说明: 消息段数据
|
||||||
|
|
||||||
|
|
||||||
## _class_ `Message`
|
## _class_ `Message`
|
||||||
@ -359,15 +251,6 @@ Event 基类。提供获取关键信息的方法,其余信息可直接获取
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
### `extract_plain_text()`
|
|
||||||
|
|
||||||
|
|
||||||
* **说明**
|
|
||||||
|
|
||||||
提取消息内纯文本消息
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### `reduce()`
|
### `reduce()`
|
||||||
|
|
||||||
|
|
||||||
@ -377,8 +260,167 @@ Event 基类。提供获取关键信息的方法,其余信息可直接获取
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
## _class_ `MessageSegment`
|
### `extract_plain_text()`
|
||||||
|
|
||||||
基类:`abc.ABC`
|
|
||||||
|
|
||||||
消息段基类
|
* **说明**
|
||||||
|
|
||||||
|
提取消息内纯文本消息
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## _class_ `Event`
|
||||||
|
|
||||||
|
基类:`abc.ABC`, `pydantic.main.BaseModel`
|
||||||
|
|
||||||
|
Event 基类。提供获取关键信息的方法,其余信息可直接获取。
|
||||||
|
|
||||||
|
|
||||||
|
### _abstract_ `get_type()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取事件类型的方法,类型通常为 NoneBot 内置的四种类型。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `Literal["message", "notice", "request", "meta_event"]`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### _abstract_ `get_event_name()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取事件名称的方法。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `str`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### _abstract_ `get_event_description()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取事件描述的方法,通常为事件具体内容。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `str`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### `get_log_string()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取事件日志信息的方法,通常你不需要修改这个方法,只有当希望 NoneBot 隐藏该事件日志时,可以抛出 `NoLogException` 异常。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `str`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **异常**
|
||||||
|
|
||||||
|
|
||||||
|
* `NoLogException`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### _abstract_ `get_user_id()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取事件主体 id 的方法,通常是用户 id 。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `str`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### _abstract_ `get_session_id()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取会话 id 的方法,用于判断当前事件属于哪一个会话,通常是用户 id、群组 id 组合。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `str`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### _abstract_ `get_message()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取事件消息内容的方法。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `Message`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### `get_plaintext()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取消息纯文本的方法,通常不需要修改,默认通过 `get_message().extract_plain_text` 获取。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `str`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### _abstract_ `is_tome()`
|
||||||
|
|
||||||
|
|
||||||
|
* **说明**
|
||||||
|
|
||||||
|
获取事件是否与机器人有关的方法。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* **返回**
|
||||||
|
|
||||||
|
|
||||||
|
* `bool`
|
||||||
|
@ -193,7 +193,7 @@ CQHTTP 配置类
|
|||||||
|
|
||||||
## _class_ `Bot`
|
## _class_ `Bot`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Bot`](README.md#nonebot.adapters.Bot)
|
基类:[`nonebot.adapters._base.Bot`](README.md#nonebot.adapters._base.Bot)
|
||||||
|
|
||||||
CQHTTP 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
|
CQHTTP 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
|
||||||
|
|
||||||
@ -307,14 +307,14 @@ CQHTTP 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
|
|||||||
|
|
||||||
## _class_ `MessageSegment`
|
## _class_ `MessageSegment`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.MessageSegment`](README.md#nonebot.adapters.MessageSegment)
|
基类:[`nonebot.adapters._base.MessageSegment`](README.md#nonebot.adapters._base.MessageSegment)
|
||||||
|
|
||||||
CQHTTP 协议 MessageSegment 适配。具体方法参考协议消息段类型或源码。
|
CQHTTP 协议 MessageSegment 适配。具体方法参考协议消息段类型或源码。
|
||||||
|
|
||||||
|
|
||||||
## _class_ `Message`
|
## _class_ `Message`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Message`](README.md#nonebot.adapters.Message)
|
基类:[`nonebot.adapters._base.Message`](README.md#nonebot.adapters._base.Message)
|
||||||
|
|
||||||
CQHTTP 协议 Message 适配。
|
CQHTTP 协议 Message 适配。
|
||||||
|
|
||||||
@ -377,7 +377,7 @@ CQHTTP 协议 Message 适配。
|
|||||||
|
|
||||||
## _class_ `Event`
|
## _class_ `Event`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Event`](README.md#nonebot.adapters.Event)
|
基类:[`nonebot.adapters._base.Event`](README.md#nonebot.adapters._base.Event)
|
||||||
|
|
||||||
CQHTTP 协议事件,字段与 CQHTTP 一致。各事件字段参考 [CQHTTP 文档](https://github.com/howmanybots/onebot/blob/master/README.md)
|
CQHTTP 协议事件,字段与 CQHTTP 一致。各事件字段参考 [CQHTTP 文档](https://github.com/howmanybots/onebot/blob/master/README.md)
|
||||||
|
|
||||||
|
@ -94,7 +94,7 @@ sidebarDepth: 0
|
|||||||
|
|
||||||
## _class_ `Bot`
|
## _class_ `Bot`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Bot`](README.md#nonebot.adapters.Bot)
|
基类:[`nonebot.adapters._base.Bot`](README.md#nonebot.adapters._base.Bot)
|
||||||
|
|
||||||
钉钉 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
|
钉钉 协议 Bot 适配。继承属性参考 [BaseBot](./#class-basebot) 。
|
||||||
|
|
||||||
@ -199,7 +199,7 @@ sidebarDepth: 0
|
|||||||
|
|
||||||
## _class_ `MessageSegment`
|
## _class_ `MessageSegment`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.MessageSegment`](README.md#nonebot.adapters.MessageSegment)
|
基类:[`nonebot.adapters._base.MessageSegment`](README.md#nonebot.adapters._base.MessageSegment)
|
||||||
|
|
||||||
钉钉 协议 MessageSegment 适配。具体方法参考协议消息段类型或源码。
|
钉钉 协议 MessageSegment 适配。具体方法参考协议消息段类型或源码。
|
||||||
|
|
||||||
@ -283,7 +283,7 @@ message += MessageSegment.atDingtalkIds(event.senderId)
|
|||||||
|
|
||||||
## _class_ `Message`
|
## _class_ `Message`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Message`](README.md#nonebot.adapters.Message)
|
基类:[`nonebot.adapters._base.Message`](README.md#nonebot.adapters._base.Message)
|
||||||
|
|
||||||
钉钉 协议 Message 适配。
|
钉钉 协议 Message 适配。
|
||||||
|
|
||||||
@ -292,7 +292,7 @@ message += MessageSegment.atDingtalkIds(event.senderId)
|
|||||||
|
|
||||||
## _class_ `Event`
|
## _class_ `Event`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Event`](README.md#nonebot.adapters.Event)
|
基类:[`nonebot.adapters._base.Event`](README.md#nonebot.adapters._base.Event)
|
||||||
|
|
||||||
钉钉协议事件。各事件字段参考 [钉钉文档](https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p)
|
钉钉协议事件。各事件字段参考 [钉钉文档](https://ding-doc.dingtalk.com/document#/org-dev-guide/elzz1p)
|
||||||
|
|
||||||
|
@ -117,7 +117,7 @@ Bot会话管理器, 提供API主动调用接口
|
|||||||
|
|
||||||
## _class_ `Bot`
|
## _class_ `Bot`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Bot`](README.md#nonebot.adapters.Bot)
|
基类:[`nonebot.adapters._base.Bot`](README.md#nonebot.adapters._base.Bot)
|
||||||
|
|
||||||
mirai-api-http 协议 Bot 适配。
|
mirai-api-http 协议 Bot 适配。
|
||||||
|
|
||||||
@ -722,7 +722,7 @@ mirai-api-http 正向 Websocket 协议 Bot 适配。
|
|||||||
|
|
||||||
## _class_ `MessageSegment`
|
## _class_ `MessageSegment`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.MessageSegment`](README.md#nonebot.adapters.MessageSegment)
|
基类:[`nonebot.adapters._base.MessageSegment`](README.md#nonebot.adapters._base.MessageSegment)
|
||||||
|
|
||||||
CQHTTP 协议 MessageSegment 适配。具体方法参考 [mirai-api-http 消息类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/MessageType.md)
|
CQHTTP 协议 MessageSegment 适配。具体方法参考 [mirai-api-http 消息类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/MessageType.md)
|
||||||
|
|
||||||
@ -963,7 +963,7 @@ CQHTTP 协议 MessageSegment 适配。具体方法参考 [mirai-api-http 消息
|
|||||||
|
|
||||||
## _class_ `MessageChain`
|
## _class_ `MessageChain`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Message`](README.md#nonebot.adapters.Message)
|
基类:[`nonebot.adapters._base.Message`](README.md#nonebot.adapters._base.Message)
|
||||||
|
|
||||||
Mirai 协议 Message 适配
|
Mirai 协议 Message 适配
|
||||||
|
|
||||||
@ -1060,7 +1060,7 @@ Mirai 协议 Message 适配
|
|||||||
|
|
||||||
## _class_ `Event`
|
## _class_ `Event`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Event`](README.md#nonebot.adapters.Event)
|
基类:[`nonebot.adapters._base.Event`](README.md#nonebot.adapters._base.Event)
|
||||||
|
|
||||||
mirai-api-http 协议事件,字段与 mirai-api-http 一致。各事件字段参考 [mirai-api-http 事件类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/EventType.md)
|
mirai-api-http 协议事件,字段与 mirai-api-http 一致。各事件字段参考 [mirai-api-http 事件类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/EventType.md)
|
||||||
|
|
||||||
@ -1486,7 +1486,7 @@ Bot被邀请入群申请
|
|||||||
|
|
||||||
## _class_ `Event`
|
## _class_ `Event`
|
||||||
|
|
||||||
基类:[`nonebot.adapters.Event`](README.md#nonebot.adapters.Event)
|
基类:[`nonebot.adapters._base.Event`](README.md#nonebot.adapters._base.Event)
|
||||||
|
|
||||||
mirai-api-http 协议事件,字段与 mirai-api-http 一致。各事件字段参考 [mirai-api-http 事件类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/EventType.md)
|
mirai-api-http 协议事件,字段与 mirai-api-http 一致。各事件字段参考 [mirai-api-http 事件类型](https://github.com/project-mirai/mirai-api-http/blob/master/docs/EventType.md)
|
||||||
|
|
||||||
|
@ -6,7 +6,7 @@ sidebarDepth: 0
|
|||||||
NoneBot.adapters 模块
|
NoneBot.adapters 模块
|
||||||
=====================
|
=====================
|
||||||
|
|
||||||
.. automodule:: nonebot.adapters
|
.. automodule:: nonebot.adapters._base
|
||||||
:members:
|
:members:
|
||||||
:private-members:
|
:private-members:
|
||||||
:special-members: __init__
|
:special-members: __init__
|
||||||
|
@ -1,24 +1,4 @@
|
|||||||
"""
|
from typing import Iterable
|
||||||
协议适配基类
|
|
||||||
============
|
|
||||||
|
|
||||||
各协议请继承以下基类,并使用 ``driver.register_adapter`` 注册适配器
|
|
||||||
"""
|
|
||||||
|
|
||||||
import abc
|
|
||||||
from copy import copy
|
|
||||||
from typing_extensions import Literal
|
|
||||||
from functools import reduce, partial
|
|
||||||
from dataclasses import dataclass, field
|
|
||||||
from typing import Any, Dict, Union, TypeVar, Mapping, Optional, Callable, Iterable, Iterator, Awaitable, TYPE_CHECKING
|
|
||||||
|
|
||||||
from pydantic import BaseModel
|
|
||||||
|
|
||||||
from nonebot.utils import DataclassEncoder
|
|
||||||
|
|
||||||
if TYPE_CHECKING:
|
|
||||||
from nonebot.config import Config
|
|
||||||
from nonebot.drivers import Driver, WebSocket
|
|
||||||
|
|
||||||
try:
|
try:
|
||||||
import pkg_resources
|
import pkg_resources
|
||||||
@ -31,454 +11,4 @@ except ImportError:
|
|||||||
except Exception:
|
except Exception:
|
||||||
pass
|
pass
|
||||||
|
|
||||||
|
from ._base import Bot, Event, Message, MessageSegment
|
||||||
class Bot(abc.ABC):
|
|
||||||
"""
|
|
||||||
Bot 基类。用于处理上报消息,并提供 API 调用接口。
|
|
||||||
"""
|
|
||||||
|
|
||||||
driver: "Driver"
|
|
||||||
"""Driver 对象"""
|
|
||||||
config: "Config"
|
|
||||||
"""Config 配置对象"""
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def __init__(self,
|
|
||||||
connection_type: str,
|
|
||||||
self_id: str,
|
|
||||||
*,
|
|
||||||
websocket: Optional["WebSocket"] = None):
|
|
||||||
"""
|
|
||||||
:参数:
|
|
||||||
|
|
||||||
* ``connection_type: str``: http 或者 websocket
|
|
||||||
* ``self_id: str``: 机器人 ID
|
|
||||||
* ``websocket: Optional[WebSocket]``: Websocket 连接对象
|
|
||||||
"""
|
|
||||||
self.connection_type = connection_type
|
|
||||||
"""连接类型"""
|
|
||||||
self.self_id = self_id
|
|
||||||
"""机器人 ID"""
|
|
||||||
self.websocket = websocket
|
|
||||||
"""Websocket 连接对象"""
|
|
||||||
|
|
||||||
def __getattr__(self, name: str) -> Callable[..., Awaitable[Any]]:
|
|
||||||
return partial(self.call_api, name)
|
|
||||||
|
|
||||||
@property
|
|
||||||
@abc.abstractmethod
|
|
||||||
def type(self) -> str:
|
|
||||||
"""Adapter 类型"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@classmethod
|
|
||||||
def register(cls, driver: "Driver", config: "Config"):
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
`register` 方法会在 `driver.register_adapter` 时被调用,用于初始化相关配置
|
|
||||||
"""
|
|
||||||
cls.driver = driver
|
|
||||||
cls.config = config
|
|
||||||
|
|
||||||
@classmethod
|
|
||||||
@abc.abstractmethod
|
|
||||||
async def check_permission(cls, driver: "Driver", connection_type: str,
|
|
||||||
headers: dict, body: Optional[dict]) -> str:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
检查连接请求是否合法的函数,如果合法则返回当前连接 ``唯一标识符``,通常为机器人 ID;如果不合法则抛出 ``RequestDenied`` 异常。
|
|
||||||
|
|
||||||
:参数:
|
|
||||||
|
|
||||||
* ``driver: Driver``: Driver 对象
|
|
||||||
* ``connection_type: str``: 连接类型
|
|
||||||
* ``headers: dict``: 请求头
|
|
||||||
* ``body: Optional[dict]``: 请求数据,WebSocket 连接该部分为空
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
- ``str``: 连接唯一标识符
|
|
||||||
|
|
||||||
:异常:
|
|
||||||
|
|
||||||
- ``RequestDenied``: 请求非法
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
async def handle_message(self, message: dict):
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
处理上报消息的函数,转换为 ``Event`` 事件后调用 ``nonebot.message.handle_event`` 进一步处理事件。
|
|
||||||
|
|
||||||
:参数:
|
|
||||||
|
|
||||||
* ``message: dict``: 收到的上报消息
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
async def call_api(self, api: str, **data):
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
调用机器人 API 接口,可以通过该函数或直接通过 bot 属性进行调用
|
|
||||||
|
|
||||||
:参数:
|
|
||||||
|
|
||||||
* ``api: str``: API 名称
|
|
||||||
* ``**data``: API 数据
|
|
||||||
|
|
||||||
:示例:
|
|
||||||
|
|
||||||
.. code-block:: python
|
|
||||||
|
|
||||||
await bot.call_api("send_msg", message="hello world")
|
|
||||||
await bot.send_msg(message="hello world")
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
async def send(self, event: "Event",
|
|
||||||
message: Union[str, "Message", "MessageSegment"], **kwargs):
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
调用机器人基础发送消息接口
|
|
||||||
|
|
||||||
:参数:
|
|
||||||
|
|
||||||
* ``event: Event``: 上报事件
|
|
||||||
* ``message: Union[str, Message, MessageSegment]``: 要发送的消息
|
|
||||||
* ``**kwargs``
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
|
|
||||||
T_Message = TypeVar("T_Message", bound="Message")
|
|
||||||
T_MessageSegment = TypeVar("T_MessageSegment", bound="MessageSegment")
|
|
||||||
|
|
||||||
|
|
||||||
@dataclass
|
|
||||||
class MessageSegment(abc.ABC):
|
|
||||||
"""消息段基类"""
|
|
||||||
type: str
|
|
||||||
"""
|
|
||||||
- 类型: ``str``
|
|
||||||
- 说明: 消息段类型
|
|
||||||
"""
|
|
||||||
data: Dict[str, Any] = field(default_factory=lambda: {})
|
|
||||||
"""
|
|
||||||
- 类型: ``Dict[str, Union[str, list]]``
|
|
||||||
- 说明: 消息段数据
|
|
||||||
"""
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def __str__(self: T_MessageSegment) -> str:
|
|
||||||
"""该消息段所代表的 str,在命令匹配部分使用"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def __add__(self: T_MessageSegment, other: Union[str, T_MessageSegment,
|
|
||||||
T_Message]) -> T_Message:
|
|
||||||
"""你需要在这里实现不同消息段的合并:
|
|
||||||
比如:
|
|
||||||
if isinstance(other, str):
|
|
||||||
...
|
|
||||||
elif isinstance(other, MessageSegment):
|
|
||||||
...
|
|
||||||
注意:需要返回一个新生成的对象
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def __radd__(
|
|
||||||
self: T_MessageSegment, other: Union[str, dict, list, T_MessageSegment,
|
|
||||||
T_Message]) -> "T_Message":
|
|
||||||
"""你需要在这里实现不同消息段的合并:
|
|
||||||
比如:
|
|
||||||
if isinstance(other, str):
|
|
||||||
...
|
|
||||||
elif isinstance(other, MessageSegment):
|
|
||||||
...
|
|
||||||
注意:需要返回一个新生成的对象
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
def __getitem__(self, key):
|
|
||||||
return getattr(self, key)
|
|
||||||
|
|
||||||
def __setitem__(self, key, value):
|
|
||||||
return setattr(self, key, value)
|
|
||||||
|
|
||||||
def get(self, key, default=None):
|
|
||||||
return getattr(self, key, default)
|
|
||||||
|
|
||||||
def copy(self: T_MessageSegment) -> T_MessageSegment:
|
|
||||||
return copy(self)
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def is_text(self) -> bool:
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
|
|
||||||
class Message(list, abc.ABC):
|
|
||||||
"""消息数组"""
|
|
||||||
|
|
||||||
def __init__(self,
|
|
||||||
message: Union[str, None, Mapping, Iterable[Mapping],
|
|
||||||
T_MessageSegment, T_Message, Any] = None,
|
|
||||||
*args,
|
|
||||||
**kwargs):
|
|
||||||
"""
|
|
||||||
:参数:
|
|
||||||
|
|
||||||
* ``message: Union[str, list, dict, MessageSegment, Message, Any]``: 消息内容
|
|
||||||
"""
|
|
||||||
super().__init__(*args, **kwargs)
|
|
||||||
if message is None:
|
|
||||||
return
|
|
||||||
elif isinstance(message, Message):
|
|
||||||
self.extend(message)
|
|
||||||
elif isinstance(message, MessageSegment):
|
|
||||||
self.append(message)
|
|
||||||
else:
|
|
||||||
self.extend(self._construct(message))
|
|
||||||
|
|
||||||
def __str__(self):
|
|
||||||
return ''.join((str(seg) for seg in self))
|
|
||||||
|
|
||||||
@classmethod
|
|
||||||
def __get_validators__(cls):
|
|
||||||
yield cls._validate
|
|
||||||
|
|
||||||
@classmethod
|
|
||||||
def _validate(cls, value):
|
|
||||||
return cls(value)
|
|
||||||
|
|
||||||
@staticmethod
|
|
||||||
@abc.abstractmethod
|
|
||||||
def _construct(
|
|
||||||
msg: Union[str, Mapping, Iterable[Mapping], Any]
|
|
||||||
) -> Iterable[T_MessageSegment]:
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
def __add__(self: T_Message, other: Union[str, T_MessageSegment,
|
|
||||||
T_Message]) -> T_Message:
|
|
||||||
result = self.__class__(self)
|
|
||||||
if isinstance(other, str):
|
|
||||||
result.extend(self._construct(other))
|
|
||||||
elif isinstance(other, MessageSegment):
|
|
||||||
result.append(other)
|
|
||||||
elif isinstance(other, Message):
|
|
||||||
result.extend(other)
|
|
||||||
return result
|
|
||||||
|
|
||||||
def __radd__(self: T_Message, other: Union[str, T_MessageSegment,
|
|
||||||
T_Message]) -> T_Message:
|
|
||||||
result = self.__class__(other)
|
|
||||||
return result.__add__(self)
|
|
||||||
|
|
||||||
def __iadd__(self: T_Message, other: Union[str, T_MessageSegment,
|
|
||||||
T_Message]) -> T_Message:
|
|
||||||
if isinstance(other, str):
|
|
||||||
self.extend(self._construct(other))
|
|
||||||
elif isinstance(other, MessageSegment):
|
|
||||||
self.append(other)
|
|
||||||
elif isinstance(other, Message):
|
|
||||||
self.extend(other)
|
|
||||||
return self
|
|
||||||
|
|
||||||
def append(self: T_Message, obj: Union[str, T_MessageSegment]) -> T_Message:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
添加一个消息段到消息数组末尾
|
|
||||||
|
|
||||||
:参数:
|
|
||||||
|
|
||||||
* ``obj: Union[str, MessageSegment]``: 要添加的消息段
|
|
||||||
"""
|
|
||||||
if isinstance(obj, MessageSegment):
|
|
||||||
super().append(obj)
|
|
||||||
elif isinstance(obj, str):
|
|
||||||
self.extend(self._construct(obj))
|
|
||||||
else:
|
|
||||||
raise ValueError(f"Unexpected type: {type(obj)} {obj}")
|
|
||||||
return self
|
|
||||||
|
|
||||||
def extend(self: T_Message,
|
|
||||||
obj: Union[T_Message, Iterable[T_MessageSegment]]) -> T_Message:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
拼接一个消息数组或多个消息段到消息数组末尾
|
|
||||||
|
|
||||||
:参数:
|
|
||||||
|
|
||||||
* ``obj: Union[Message, Iterable[MessageSegment]]``: 要添加的消息数组
|
|
||||||
"""
|
|
||||||
for segment in obj:
|
|
||||||
self.append(segment)
|
|
||||||
return self
|
|
||||||
|
|
||||||
def reduce(self: T_Message) -> None:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
缩减消息数组,即按 MessageSegment 的实现拼接相邻消息段
|
|
||||||
"""
|
|
||||||
index = 0
|
|
||||||
while index < len(self):
|
|
||||||
if index > 0 and self[index -
|
|
||||||
1].is_text() and self[index].is_text():
|
|
||||||
self[index - 1] += self[index]
|
|
||||||
del self[index]
|
|
||||||
else:
|
|
||||||
index += 1
|
|
||||||
|
|
||||||
def extract_plain_text(self: T_Message) -> str:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
提取消息内纯文本消息
|
|
||||||
"""
|
|
||||||
|
|
||||||
def _concat(x: str, y: T_MessageSegment) -> str:
|
|
||||||
return f"{x} {y}" if y.is_text() else x
|
|
||||||
|
|
||||||
plain_text = reduce(_concat, self, "")
|
|
||||||
return plain_text[1:] if plain_text else plain_text
|
|
||||||
|
|
||||||
|
|
||||||
class Event(abc.ABC, BaseModel):
|
|
||||||
"""Event 基类。提供获取关键信息的方法,其余信息可直接获取。"""
|
|
||||||
|
|
||||||
class Config:
|
|
||||||
extra = "allow"
|
|
||||||
json_encoders = {Message: DataclassEncoder}
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def get_type(self) -> Literal["message", "notice", "request", "meta_event"]:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取事件类型的方法,类型通常为 NoneBot 内置的四种类型。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``Literal["message", "notice", "request", "meta_event"]``
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def get_event_name(self) -> str:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取事件名称的方法。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``str``
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def get_event_description(self) -> str:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取事件描述的方法,通常为事件具体内容。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``str``
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
def __str__(self) -> str:
|
|
||||||
return f"[{self.get_event_name()}]: {self.get_event_description()}"
|
|
||||||
|
|
||||||
def get_log_string(self) -> str:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取事件日志信息的方法,通常你不需要修改这个方法,只有当希望 NoneBot 隐藏该事件日志时,可以抛出 ``NoLogException`` 异常。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``str``
|
|
||||||
|
|
||||||
:异常:
|
|
||||||
|
|
||||||
- ``NoLogException``
|
|
||||||
"""
|
|
||||||
return f"[{self.get_event_name()}]: {self.get_event_description()}"
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def get_user_id(self) -> str:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取事件主体 id 的方法,通常是用户 id 。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``str``
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def get_session_id(self) -> str:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取会话 id 的方法,用于判断当前事件属于哪一个会话,通常是用户 id、群组 id 组合。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``str``
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def get_message(self) -> "Message":
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取事件消息内容的方法。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``Message``
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
|
||||||
def get_plaintext(self) -> str:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取消息纯文本的方法,通常不需要修改,默认通过 ``get_message().extract_plain_text`` 获取。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``str``
|
|
||||||
"""
|
|
||||||
return self.get_message().extract_plain_text()
|
|
||||||
|
|
||||||
@abc.abstractmethod
|
|
||||||
def is_tome(self) -> bool:
|
|
||||||
"""
|
|
||||||
:说明:
|
|
||||||
|
|
||||||
获取事件是否与机器人有关的方法。
|
|
||||||
|
|
||||||
:返回:
|
|
||||||
|
|
||||||
* ``bool``
|
|
||||||
"""
|
|
||||||
raise NotImplementedError
|
|
||||||
|
473
nonebot/adapters/_base.py
Normal file
473
nonebot/adapters/_base.py
Normal file
@ -0,0 +1,473 @@
|
|||||||
|
"""
|
||||||
|
协议适配基类
|
||||||
|
============
|
||||||
|
|
||||||
|
各协议请继承以下基类,并使用 ``driver.register_adapter`` 注册适配器
|
||||||
|
"""
|
||||||
|
|
||||||
|
import abc
|
||||||
|
from copy import copy
|
||||||
|
from typing_extensions import Literal
|
||||||
|
from functools import reduce, partial
|
||||||
|
from dataclasses import dataclass, field
|
||||||
|
from typing import Any, Dict, Union, TypeVar, Mapping, Optional, Callable, Iterable, Iterator, Awaitable, TYPE_CHECKING
|
||||||
|
|
||||||
|
from pydantic import BaseModel
|
||||||
|
|
||||||
|
from nonebot.utils import DataclassEncoder
|
||||||
|
|
||||||
|
if TYPE_CHECKING:
|
||||||
|
from nonebot.config import Config
|
||||||
|
from nonebot.drivers import Driver, WebSocket
|
||||||
|
|
||||||
|
|
||||||
|
class Bot(abc.ABC):
|
||||||
|
"""
|
||||||
|
Bot 基类。用于处理上报消息,并提供 API 调用接口。
|
||||||
|
"""
|
||||||
|
|
||||||
|
driver: "Driver"
|
||||||
|
"""Driver 对象"""
|
||||||
|
config: "Config"
|
||||||
|
"""Config 配置对象"""
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def __init__(self,
|
||||||
|
connection_type: str,
|
||||||
|
self_id: str,
|
||||||
|
*,
|
||||||
|
websocket: Optional["WebSocket"] = None):
|
||||||
|
"""
|
||||||
|
:参数:
|
||||||
|
|
||||||
|
* ``connection_type: str``: http 或者 websocket
|
||||||
|
* ``self_id: str``: 机器人 ID
|
||||||
|
* ``websocket: Optional[WebSocket]``: Websocket 连接对象
|
||||||
|
"""
|
||||||
|
self.connection_type = connection_type
|
||||||
|
"""连接类型"""
|
||||||
|
self.self_id = self_id
|
||||||
|
"""机器人 ID"""
|
||||||
|
self.websocket = websocket
|
||||||
|
"""Websocket 连接对象"""
|
||||||
|
|
||||||
|
def __getattr__(self, name: str) -> Callable[..., Awaitable[Any]]:
|
||||||
|
return partial(self.call_api, name)
|
||||||
|
|
||||||
|
@property
|
||||||
|
@abc.abstractmethod
|
||||||
|
def type(self) -> str:
|
||||||
|
"""Adapter 类型"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@classmethod
|
||||||
|
def register(cls, driver: "Driver", config: "Config"):
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
`register` 方法会在 `driver.register_adapter` 时被调用,用于初始化相关配置
|
||||||
|
"""
|
||||||
|
cls.driver = driver
|
||||||
|
cls.config = config
|
||||||
|
|
||||||
|
@classmethod
|
||||||
|
@abc.abstractmethod
|
||||||
|
async def check_permission(cls, driver: "Driver", connection_type: str,
|
||||||
|
headers: dict, body: Optional[dict]) -> str:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
检查连接请求是否合法的函数,如果合法则返回当前连接 ``唯一标识符``,通常为机器人 ID;如果不合法则抛出 ``RequestDenied`` 异常。
|
||||||
|
|
||||||
|
:参数:
|
||||||
|
|
||||||
|
* ``driver: Driver``: Driver 对象
|
||||||
|
* ``connection_type: str``: 连接类型
|
||||||
|
* ``headers: dict``: 请求头
|
||||||
|
* ``body: Optional[dict]``: 请求数据,WebSocket 连接该部分为空
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
- ``str``: 连接唯一标识符
|
||||||
|
|
||||||
|
:异常:
|
||||||
|
|
||||||
|
- ``RequestDenied``: 请求非法
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
async def handle_message(self, message: dict):
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
处理上报消息的函数,转换为 ``Event`` 事件后调用 ``nonebot.message.handle_event`` 进一步处理事件。
|
||||||
|
|
||||||
|
:参数:
|
||||||
|
|
||||||
|
* ``message: dict``: 收到的上报消息
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
async def call_api(self, api: str, **data):
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
调用机器人 API 接口,可以通过该函数或直接通过 bot 属性进行调用
|
||||||
|
|
||||||
|
:参数:
|
||||||
|
|
||||||
|
* ``api: str``: API 名称
|
||||||
|
* ``**data``: API 数据
|
||||||
|
|
||||||
|
:示例:
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
await bot.call_api("send_msg", message="hello world")
|
||||||
|
await bot.send_msg(message="hello world")
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
async def send(self, event: "Event",
|
||||||
|
message: Union[str, "Message", "MessageSegment"], **kwargs):
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
调用机器人基础发送消息接口
|
||||||
|
|
||||||
|
:参数:
|
||||||
|
|
||||||
|
* ``event: Event``: 上报事件
|
||||||
|
* ``message: Union[str, Message, MessageSegment]``: 要发送的消息
|
||||||
|
* ``**kwargs``
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
|
||||||
|
T_Message = TypeVar("T_Message", bound="Message")
|
||||||
|
T_MessageSegment = TypeVar("T_MessageSegment", bound="MessageSegment")
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass
|
||||||
|
class MessageSegment(abc.ABC):
|
||||||
|
"""消息段基类"""
|
||||||
|
type: str
|
||||||
|
"""
|
||||||
|
- 类型: ``str``
|
||||||
|
- 说明: 消息段类型
|
||||||
|
"""
|
||||||
|
data: Dict[str, Any] = field(default_factory=lambda: {})
|
||||||
|
"""
|
||||||
|
- 类型: ``Dict[str, Union[str, list]]``
|
||||||
|
- 说明: 消息段数据
|
||||||
|
"""
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def __str__(self: T_MessageSegment) -> str:
|
||||||
|
"""该消息段所代表的 str,在命令匹配部分使用"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def __add__(self: T_MessageSegment, other: Union[str, T_MessageSegment,
|
||||||
|
T_Message]) -> T_Message:
|
||||||
|
"""你需要在这里实现不同消息段的合并:
|
||||||
|
比如:
|
||||||
|
if isinstance(other, str):
|
||||||
|
...
|
||||||
|
elif isinstance(other, MessageSegment):
|
||||||
|
...
|
||||||
|
注意:需要返回一个新生成的对象
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def __radd__(
|
||||||
|
self: T_MessageSegment, other: Union[str, dict, list, T_MessageSegment,
|
||||||
|
T_Message]) -> "T_Message":
|
||||||
|
"""你需要在这里实现不同消息段的合并:
|
||||||
|
比如:
|
||||||
|
if isinstance(other, str):
|
||||||
|
...
|
||||||
|
elif isinstance(other, MessageSegment):
|
||||||
|
...
|
||||||
|
注意:需要返回一个新生成的对象
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
def __getitem__(self, key):
|
||||||
|
return getattr(self, key)
|
||||||
|
|
||||||
|
def __setitem__(self, key, value):
|
||||||
|
return setattr(self, key, value)
|
||||||
|
|
||||||
|
def get(self, key, default=None):
|
||||||
|
return getattr(self, key, default)
|
||||||
|
|
||||||
|
def copy(self: T_MessageSegment) -> T_MessageSegment:
|
||||||
|
return copy(self)
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def is_text(self) -> bool:
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
|
||||||
|
class Message(list, abc.ABC):
|
||||||
|
"""消息数组"""
|
||||||
|
|
||||||
|
def __init__(self,
|
||||||
|
message: Union[str, None, Mapping, Iterable[Mapping],
|
||||||
|
T_MessageSegment, T_Message, Any] = None,
|
||||||
|
*args,
|
||||||
|
**kwargs):
|
||||||
|
"""
|
||||||
|
:参数:
|
||||||
|
|
||||||
|
* ``message: Union[str, list, dict, MessageSegment, Message, Any]``: 消息内容
|
||||||
|
"""
|
||||||
|
super().__init__(*args, **kwargs)
|
||||||
|
if message is None:
|
||||||
|
return
|
||||||
|
elif isinstance(message, Message):
|
||||||
|
self.extend(message)
|
||||||
|
elif isinstance(message, MessageSegment):
|
||||||
|
self.append(message)
|
||||||
|
else:
|
||||||
|
self.extend(self._construct(message))
|
||||||
|
|
||||||
|
def __str__(self):
|
||||||
|
return ''.join((str(seg) for seg in self))
|
||||||
|
|
||||||
|
@classmethod
|
||||||
|
def __get_validators__(cls):
|
||||||
|
yield cls._validate
|
||||||
|
|
||||||
|
@classmethod
|
||||||
|
def _validate(cls, value):
|
||||||
|
return cls(value)
|
||||||
|
|
||||||
|
@staticmethod
|
||||||
|
@abc.abstractmethod
|
||||||
|
def _construct(
|
||||||
|
msg: Union[str, Mapping, Iterable[Mapping], Any]
|
||||||
|
) -> Iterable[T_MessageSegment]:
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
def __add__(self: T_Message, other: Union[str, T_MessageSegment,
|
||||||
|
T_Message]) -> T_Message:
|
||||||
|
result = self.__class__(self)
|
||||||
|
if isinstance(other, str):
|
||||||
|
result.extend(self._construct(other))
|
||||||
|
elif isinstance(other, MessageSegment):
|
||||||
|
result.append(other)
|
||||||
|
elif isinstance(other, Message):
|
||||||
|
result.extend(other)
|
||||||
|
return result
|
||||||
|
|
||||||
|
def __radd__(self: T_Message, other: Union[str, T_MessageSegment,
|
||||||
|
T_Message]) -> T_Message:
|
||||||
|
result = self.__class__(other)
|
||||||
|
return result.__add__(self)
|
||||||
|
|
||||||
|
def __iadd__(self: T_Message, other: Union[str, T_MessageSegment,
|
||||||
|
T_Message]) -> T_Message:
|
||||||
|
if isinstance(other, str):
|
||||||
|
self.extend(self._construct(other))
|
||||||
|
elif isinstance(other, MessageSegment):
|
||||||
|
self.append(other)
|
||||||
|
elif isinstance(other, Message):
|
||||||
|
self.extend(other)
|
||||||
|
return self
|
||||||
|
|
||||||
|
def append(self: T_Message, obj: Union[str, T_MessageSegment]) -> T_Message:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
添加一个消息段到消息数组末尾
|
||||||
|
|
||||||
|
:参数:
|
||||||
|
|
||||||
|
* ``obj: Union[str, MessageSegment]``: 要添加的消息段
|
||||||
|
"""
|
||||||
|
if isinstance(obj, MessageSegment):
|
||||||
|
super().append(obj)
|
||||||
|
elif isinstance(obj, str):
|
||||||
|
self.extend(self._construct(obj))
|
||||||
|
else:
|
||||||
|
raise ValueError(f"Unexpected type: {type(obj)} {obj}")
|
||||||
|
return self
|
||||||
|
|
||||||
|
def extend(self: T_Message,
|
||||||
|
obj: Union[T_Message, Iterable[T_MessageSegment]]) -> T_Message:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
拼接一个消息数组或多个消息段到消息数组末尾
|
||||||
|
|
||||||
|
:参数:
|
||||||
|
|
||||||
|
* ``obj: Union[Message, Iterable[MessageSegment]]``: 要添加的消息数组
|
||||||
|
"""
|
||||||
|
for segment in obj:
|
||||||
|
self.append(segment)
|
||||||
|
return self
|
||||||
|
|
||||||
|
def reduce(self: T_Message) -> None:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
缩减消息数组,即按 MessageSegment 的实现拼接相邻消息段
|
||||||
|
"""
|
||||||
|
index = 0
|
||||||
|
while index < len(self):
|
||||||
|
if index > 0 and self[index -
|
||||||
|
1].is_text() and self[index].is_text():
|
||||||
|
self[index - 1] += self[index]
|
||||||
|
del self[index]
|
||||||
|
else:
|
||||||
|
index += 1
|
||||||
|
|
||||||
|
def extract_plain_text(self: T_Message) -> str:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
提取消息内纯文本消息
|
||||||
|
"""
|
||||||
|
|
||||||
|
def _concat(x: str, y: T_MessageSegment) -> str:
|
||||||
|
return f"{x} {y}" if y.is_text() else x
|
||||||
|
|
||||||
|
plain_text = reduce(_concat, self, "")
|
||||||
|
return plain_text[1:] if plain_text else plain_text
|
||||||
|
|
||||||
|
|
||||||
|
class Event(abc.ABC, BaseModel):
|
||||||
|
"""Event 基类。提供获取关键信息的方法,其余信息可直接获取。"""
|
||||||
|
|
||||||
|
class Config:
|
||||||
|
extra = "allow"
|
||||||
|
json_encoders = {Message: DataclassEncoder}
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def get_type(self) -> Literal["message", "notice", "request", "meta_event"]:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取事件类型的方法,类型通常为 NoneBot 内置的四种类型。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``Literal["message", "notice", "request", "meta_event"]``
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def get_event_name(self) -> str:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取事件名称的方法。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``str``
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def get_event_description(self) -> str:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取事件描述的方法,通常为事件具体内容。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``str``
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
def __str__(self) -> str:
|
||||||
|
return f"[{self.get_event_name()}]: {self.get_event_description()}"
|
||||||
|
|
||||||
|
def get_log_string(self) -> str:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取事件日志信息的方法,通常你不需要修改这个方法,只有当希望 NoneBot 隐藏该事件日志时,可以抛出 ``NoLogException`` 异常。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``str``
|
||||||
|
|
||||||
|
:异常:
|
||||||
|
|
||||||
|
- ``NoLogException``
|
||||||
|
"""
|
||||||
|
return f"[{self.get_event_name()}]: {self.get_event_description()}"
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def get_user_id(self) -> str:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取事件主体 id 的方法,通常是用户 id 。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``str``
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def get_session_id(self) -> str:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取会话 id 的方法,用于判断当前事件属于哪一个会话,通常是用户 id、群组 id 组合。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``str``
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def get_message(self) -> "Message":
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取事件消息内容的方法。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``Message``
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
def get_plaintext(self) -> str:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取消息纯文本的方法,通常不需要修改,默认通过 ``get_message().extract_plain_text`` 获取。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``str``
|
||||||
|
"""
|
||||||
|
return self.get_message().extract_plain_text()
|
||||||
|
|
||||||
|
@abc.abstractmethod
|
||||||
|
def is_tome(self) -> bool:
|
||||||
|
"""
|
||||||
|
:说明:
|
||||||
|
|
||||||
|
获取事件是否与机器人有关的方法。
|
||||||
|
|
||||||
|
:返回:
|
||||||
|
|
||||||
|
* ``bool``
|
||||||
|
"""
|
||||||
|
raise NotImplementedError
|
@ -7,6 +7,7 @@ sidebar: auto
|
|||||||
## v2.0.0a11
|
## v2.0.0a11
|
||||||
|
|
||||||
- 修改 `nonebot` 项目结构,分离所有 `adapter`
|
- 修改 `nonebot` 项目结构,分离所有 `adapter`
|
||||||
|
- 修改插件加载逻辑,使用 `import hook` (PEP 302)
|
||||||
|
|
||||||
## v2.0.0a10
|
## v2.0.0a10
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user