nonebot2/docs/api/drivers

contentSidebar	sidebarDepth
true	0

NoneBot.drivers 模块

后端驱动适配基类

各驱动请继承以下基类

class Driver

基类：abc.ABC

Driver 基类。

_adapters

• 类型

  Dict[str, Type[Bot]]

• 说明

  已注册的适配器列表

_bot_connection_hook

• 类型

  Set[T_BotConnectionHook]

• 说明

  Bot 连接建立时执行的函数

_bot_disconnection_hook

• 类型

  Set[T_BotDisconnectionHook]

• 说明

  Bot 连接断开时执行的函数

abstract __init__(env, config)

• 参数

  • env: Env: 包含环境信息的 Env 对象

  • config: Config: 包含配置信息的 Config 对象

env

• 类型

  str

• 说明

  环境名称

config

• 类型

  Config

• 说明

  配置对象

_clients

• 类型

  Dict[str, Bot]

• 说明

  已连接的 Bot

property bots

• 类型

  Dict[str, Bot]

• 说明

  获取当前所有已连接的 Bot

register_adapter(name, adapter, **kwargs)

• 说明

  注册一个协议适配器

• 参数

  • name: str: 适配器名称，用于在连接时进行识别

  • adapter: Type[Bot]: 适配器 Class

abstract property type

驱动类型名称

abstract property logger

驱动专属 logger 日志记录器

abstract run(host=None, port=None, *args, **kwargs)

• 说明

  启动驱动框架

• 参数

  • host: Optional[str]: 驱动绑定 IP

  • post: Optional[int]: 驱动绑定端口

  • *args

  • **kwargs

abstract on_startup(func)

注册一个在驱动启动时运行的函数

abstract on_shutdown(func)

注册一个在驱动停止时运行的函数

on_bot_connect(func)

• 说明

  装饰一个函数使他在 bot 通过 WebSocket 连接成功时执行。

• 函数参数

  • bot: Bot: 当前连接上的 Bot 对象

on_bot_disconnect(func)

• 说明

  装饰一个函数使他在 bot 通过 WebSocket 连接断开时执行。

• 函数参数

  • bot: Bot: 当前连接上的 Bot 对象

_bot_connect(bot)

在 WebSocket 连接成功后，调用该函数来注册 bot 对象

_bot_disconnect(bot)

在 WebSocket 连接断开后，调用该函数来注销 bot 对象

class ReverseDriver

基类：nonebot.drivers.Driver

Reverse Driver 基类。将后端框架封装，以满足适配器使用。

abstract property server_app

驱动 APP 对象

abstract property asgi

驱动 ASGI 对象

abstract async _handle_http(*args, **kwargs)

用于处理 HTTP 类型请求的函数

abstract async _handle_ws_reverse(*args, **kwargs)

用于处理 WebSocket 类型请求的函数

class HTTPRequest

基类：object

HTTP 请求封装。参考 asgi http scope。

property type

Always http

property scope

Raw scope from asgi.

The connection scope information, a dictionary that contains at least a type key specifying the protocol that is incoming.

property http_version

One of "1.0", "1.1" or "2".

property method

The HTTP method name, uppercased.

property schema

URL scheme portion (likely "http" or "https"). Optional (but must not be empty); default is "http".

property path

HTTP request target excluding any query string, with percent-encoded sequences and UTF-8 byte sequences decoded into characters.

property query_string

URL portion after the ?, percent-encoded.

property headers

An iterable of [name, value] two-item iterables, where name is the header name, and value is the header value.

Order of header values must be preserved from the original HTTP request; order of header names is not important.

Duplicates are possible and must be preserved in the message as received.

Header names must be lowercased.

property body

Body of the request.

Optional; if missing defaults to b"".

If more_body is set, treat as start of body and concatenate on further chunks.

class HTTPResponse

基类：object

HTTP 响应封装。参考 asgi http scope。

status

HTTP status code.

headers

An iterable of [name, value] two-item iterables, where name is the header name, and value is the header value.

Order must be preserved in the HTTP response.

Header names must be lowercased.

Optional; if missing defaults to an empty list.

body

HTTP body content.

Optional; if missing defaults to None.

property type

Always http

class WebSocket

基类：object

WebSocket 连接封装。参考 asgi websocket scope。

abstract __init__(websocket)

• 参数

  • websocket: Any: WebSocket 连接对象

property websocket

WebSocket 连接对象

abstract property closed

• 类型

  bool

• 说明

  连接是否已经关闭

abstract async accept()

接受 WebSocket 连接请求

abstract async close(code)

关闭 WebSocket 连接请求

abstract async receive()

接收一条 WebSocket 信息

abstract async send(data)

发送一条 WebSocket 信息