2020-08-23 17:03:59 +08:00
|
|
|
---
|
|
|
|
|
contentSidebar: true
|
|
|
|
|
sidebarDepth: 0
|
|
|
|
|
---
|
|
|
|
|
|
2020-08-19 20:29:37 +08:00
|
|
|
# NoneBot.typing 模块
|
|
|
|
|
|
|
|
|
|
## 类型
|
|
|
|
|
|
|
|
|
|
下面的文档中，「类型」部分使用 Python 的 Type Hint 语法，见 [PEP 484](https://www.python.org/dev/peps/pep-0484/)、[PEP 526](https://www.python.org/dev/peps/pep-0526/) 和 [typing](https://docs.python.org/3/library/typing.html)。
|
|
|
|
|
|
|
|
|
|
除了 Python 内置的类型，下面还出现了如下 NoneBot 自定类型，实际上它们是 Python 内置类型的别名。
|
|
|
|
|
|
|
|
|
|
以下类型均可从 nonebot.typing 模块导入。
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_State`
|
2020-08-19 20:29:37 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-12-07 00:52:26 +08:00
|
|
|
`Dict[Any, Any]`
|
2020-08-19 20:29:37 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
2020-12-07 00:52:26 +08:00
|
|
|
事件处理状态 State 类型
|
2020-08-19 20:29:37 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-20 12:15:01 +08:00
|
|
|
## `T_StateFactory`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
|
|
|
|
`Callable[[Bot, Event], Awaitable[T_State]]`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
事件处理状态 State 类工厂函数
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-28 13:57:28 +08:00
|
|
|
## `T_WebSocketConnectionHook`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
|
|
|
|
`Callable[[Bot], Awaitable[None]]`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
WebSocket 连接建立时执行的函数
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## `T_WebSocketDisconnectionHook`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
|
|
|
|
`Callable[[Bot], Awaitable[None]]`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
WebSocket 连接断开时执行的函数
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_EventPreProcessor`
|
2020-08-19 20:29:37 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
`Callable[[Bot, Event, T_State], Awaitable[None]]`
|
2020-08-19 20:29:37 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
2020-11-07 17:52:23 +08:00
|
|
|
事件预处理函数 EventPreProcessor 类型
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_EventPostProcessor`
|
2020-11-07 17:52:23 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
`Callable[[Bot, Event, T_State], Awaitable[None]]`
|
2020-11-07 17:52:23 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
事件预处理函数 EventPostProcessor 类型
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_RunPreProcessor`
|
2020-11-07 17:52:23 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
`Callable[[Matcher, Bot, Event, T_State], Awaitable[None]]`
|
2020-11-07 17:52:23 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
事件响应器运行前预处理函数 RunPreProcessor 类型
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_RunPostProcessor`
|
2020-11-07 17:52:23 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
`Callable[[Matcher, Optional[Exception], Bot, Event, T_State], Awaitable[None]]`
|
2020-11-07 17:52:23 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
2020-11-16 19:42:47 +08:00
|
|
|
事件响应器运行前预处理函数 RunPostProcessor 类型，第二个参数为运行时产生的错误（如果存在）
|
2020-08-19 20:29:37 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_RuleChecker`
|
2020-08-19 23:00:31 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
`Callable[[Bot, Event, T_State], Union[bool, Awaitable[bool]]]`
|
2020-08-19 23:00:31 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
RuleChecker 即判断是否响应事件的处理函数。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_PermissionChecker`
|
2020-08-19 23:00:31 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-09-13 13:01:23 +08:00
|
|
|
`Callable[[Bot, Event], Union[bool, Awaitable[bool]]]`
|
2020-08-19 23:00:31 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
RuleChecker 即判断是否响应消息的处理函数。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_Handler`
|
2020-08-19 23:00:31 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
|
|
|
|
|
* `Callable[[Bot, Event, T_State], Union[Awaitable[None], Awaitable[NoReturn]]]`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* `Callable[[Bot, Event], Union[Awaitable[None], Awaitable[NoReturn]]]`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* `Callable[[Bot, T_State], Union[Awaitable[None], Awaitable[NoReturn]]]`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* `Callable[[Bot], Union[Awaitable[None], Awaitable[NoReturn]]]`
|
2020-08-19 23:00:31 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
Handler 即事件的处理函数。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
## `T_ArgsParser`
|
2020-08-19 23:00:31 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
* **类型**
|
|
|
|
|
|
2020-12-19 15:31:14 +08:00
|
|
|
`Callable[[Bot, Event, T_State], Union[Awaitable[None], Awaitable[NoReturn]]]`
|
2020-08-19 23:00:31 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* **说明**
|
|
|
|
|
|
|
|
|
|
ArgsParser 即消息参数解析函数，在 Matcher.got 获取参数时被运行。
|
