nonebot2/archive/2.0.0a14/api/drivers/fastapi.md
2021-08-04 13:42:21 +08:00

2.4 KiB

contentSidebar sidebarDepth
true 0

NoneBot.drivers.fastapi 模块

FastAPI 驱动适配

本驱动同时支持服务端以及客户端连接

后端使用方法请参考: FastAPI 文档

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, 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

on_shutdown(func)

参考文档: Events

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