mirror of
https://github.com/nonebot/nonebot2.git
synced 2024-11-29 00:25:58 +08:00
175 lines
2.4 KiB
Markdown
175 lines
2.4 KiB
Markdown
|
---
|
||
|
|
contentSidebar: true
|
||
|
|
sidebarDepth: 0
|
||
|
|
---
|
||
|
|
|
||
|
|
# NoneBot.drivers.fastapi 模块
|
||
|
|
|
||
|
|
## FastAPI 驱动适配
|
||
|
|
|
||
|
|
本驱动同时支持服务端以及客户端连接
|
||
|
|
|
||
|
|
后端使用方法请参考: [FastAPI 文档](https://fastapi.tiangolo.com/)
|
||
|
|
|
||
|
|
|
||
|
|
## _class_ `Config`
|
||
|
|
|
||
|
|
基类：`pydantic.env_settings.BaseSettings`
|
||
|
|
|
||
|
|
FastAPI 驱动框架设置，详情参考 FastAPI 文档
|
||
|
|
|
||
|
|
|
||
|
|
### `fastapi_openapi_url`
|
||
|
|
|
||
|
|
|
||
|
|
* **类型**
|
||
|
|
|
||
|
|
`Optional[str]`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
* **说明**
|
||
|
|
|
||
|
|
`openapi.json` 地址，默认为 `None` 即关闭
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
### `fastapi_docs_url`
|
||
|
|
|
||
|
|
|
||
|
|
* **类型**
|
||
|
|
|
||
|
|
`Optional[str]`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
* **说明**
|
||
|
|
|
||
|
|
`swagger` 地址，默认为 `None` 即关闭
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
### `fastapi_redoc_url`
|
||
|
|
|
||
|
|
|
||
|
|
* **类型**
|
||
|
|
|
||
|
|
`Optional[str]`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
* **说明**
|
||
|
|
|
||
|
|
`redoc` 地址，默认为 `None` 即关闭
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
### `fastapi_reload_dirs`
|
||
|
|
|
||
|
|
|
||
|
|
* **类型**
|
||
|
|
|
||
|
|
`List[str]`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
* **说明**
|
||
|
|
|
||
|
|
`debug` 模式下重载监控文件夹列表，默认为 uvicorn 默认值
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## _class_ `Driver`
|
||
|
|
|
||
|
|
基类：[`nonebot.drivers.ReverseDriver`](README.md#nonebot.drivers.ReverseDriver), [`nonebot.drivers.ForwardDriver`](README.md#nonebot.drivers.ForwardDriver)
|
||
|
|
|
||
|
|
FastAPI 驱动框架
|
||
|
|
|
||
|
|
|
||
|
|
* **上报地址**
|
||
|
|
|
||
|
|
|
||
|
|
* `/{adapter name}/`: HTTP POST 上报
|
||
|
|
|
||
|
|
|
||
|
|
* `/{adapter name}/http/`: HTTP POST 上报
|
||
|
|
|
||
|
|
|
||
|
|
* `/{adapter name}/ws`: WebSocket 上报
|
||
|
|
|
||
|
|
|
||
|
|
* `/{adapter name}/ws/`: WebSocket 上报
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
### _property_ `type`
|
||
|
|
|
||
|
|
驱动名称: `fastapi`
|
||
|
|
|
||
|
|
|
||
|
|
### _property_ `server_app`
|
||
|
|
|
||
|
|
`FastAPI APP` 对象
|
||
|
|
|
||
|
|
|
||
|
|
### _property_ `asgi`
|
||
|
|
|
||
|
|
`FastAPI APP` 对象
|
||
|
|
|
||
|
|
|
||
|
|
### _property_ `logger`
|
||
|
|
|
||
|
|
fastapi 使用的 logger
|
||
|
|
|
||
|
|
|
||
|
|
### `on_startup(func)`
|
||
|
|
|
||
|
|
参考文档: [Events](https://fastapi.tiangolo.com/advanced/events/#startup-event)
|
||
|
|
|
||
|
|
|
||
|
|
### `on_shutdown(func)`
|
||
|
|
|
||
|
|
参考文档: [Events](https://fastapi.tiangolo.com/advanced/events/#startup-event)
|
||
|
|
|
||
|
|
|
||
|
|
### `setup_http_polling(setup)`
|
||
|
|
|
||
|
|
|
||
|
|
* **说明**
|
||
|
|
|
||
|
|
注册一个 HTTP 轮询连接，如果传入一个函数，则该函数会在每次连接时被调用
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
* **参数**
|
||
|
|
|
||
|
|
|
||
|
|
* `setup: Union[HTTPPollingSetup, Callable[[], Awaitable[HTTPPollingSetup]]]`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
### `setup_websocket(setup)`
|
||
|
|
|
||
|
|
|
||
|
|
* **说明**
|
||
|
|
|
||
|
|
注册一个 WebSocket 连接，如果传入一个函数，则该函数会在每次重连时被调用
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
* **参数**
|
||
|
|
|
||
|
|
|
||
|
|
* `setup: Union[WebSocketSetup, Callable[[], Awaitable[WebSocketSetup]]]`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
### `run(host=None, port=None, *, app=None, **kwargs)`
|
||
|
|
|
||
|
|
使用 `uvicorn` 启动 FastAPI
|
||
|
|
|
||
|
|
|
||
|
|
## _class_ `WebSocket`
|
||
|
|
|
||
|
|
基类：[`nonebot.drivers.WebSocket`](README.md#nonebot.drivers.WebSocket)
|