mirror of
https://github.com/nonebot/nonebot2.git
synced 2024-11-24 09:05:04 +08:00
280 lines
9.4 KiB
Python
280 lines
9.4 KiB
Python
"""
|
|
FastAPI 驱动适配
|
|
================
|
|
|
|
后端使用方法请参考: `FastAPI 文档`_
|
|
|
|
.. _FastAPI 文档:
|
|
https://fastapi.tiangolo.com/
|
|
"""
|
|
|
|
import hmac
|
|
import json
|
|
import asyncio
|
|
import logging
|
|
|
|
import uvicorn
|
|
from fastapi.responses import Response
|
|
from fastapi import Body, status, Header, FastAPI, Depends, HTTPException
|
|
from starlette.websockets import WebSocketDisconnect, WebSocket as FastAPIWebSocket
|
|
|
|
from nonebot.log import logger
|
|
from nonebot.config import Env, Config
|
|
from nonebot.utils import DataclassEncoder
|
|
from nonebot.drivers import BaseDriver, BaseWebSocket
|
|
from nonebot.typing import Optional, Callable, overrides
|
|
|
|
|
|
def get_auth_bearer(access_token: Optional[str] = Header(
|
|
None, alias="Authorization")):
|
|
if not access_token:
|
|
return None
|
|
scheme, _, param = access_token.partition(" ")
|
|
if scheme.lower() not in ["bearer", "token"]:
|
|
raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED,
|
|
detail="Not authenticated",
|
|
headers={"WWW-Authenticate": "Bearer"})
|
|
return param
|
|
|
|
|
|
class Driver(BaseDriver):
|
|
"""FastAPI 驱动框架"""
|
|
|
|
def __init__(self, env: Env, config: Config):
|
|
super().__init__(env, config)
|
|
|
|
self._server_app = FastAPI(
|
|
debug=config.debug,
|
|
openapi_url=None,
|
|
docs_url=None,
|
|
redoc_url=None,
|
|
)
|
|
|
|
self._server_app.post("/{adapter}/")(self._handle_http)
|
|
self._server_app.post("/{adapter}/http")(self._handle_http)
|
|
self._server_app.websocket("/{adapter}/ws")(self._handle_ws_reverse)
|
|
self._server_app.websocket("/{adapter}/ws/")(self._handle_ws_reverse)
|
|
|
|
@property
|
|
@overrides(BaseDriver)
|
|
def type(self) -> str:
|
|
"""驱动名称: ``fastapi``"""
|
|
return "fastapi"
|
|
|
|
@property
|
|
@overrides(BaseDriver)
|
|
def server_app(self) -> FastAPI:
|
|
"""``FastAPI APP`` 对象"""
|
|
return self._server_app
|
|
|
|
@property
|
|
@overrides(BaseDriver)
|
|
def asgi(self):
|
|
"""``FastAPI APP`` 对象"""
|
|
return self._server_app
|
|
|
|
@property
|
|
@overrides(BaseDriver)
|
|
def logger(self) -> logging.Logger:
|
|
"""fastapi 使用的 logger"""
|
|
return logging.getLogger("fastapi")
|
|
|
|
@overrides(BaseDriver)
|
|
def on_startup(self, func: Callable) -> Callable:
|
|
"""参考文档: `Events <https://fastapi.tiangolo.com/advanced/events/#startup-event>`_"""
|
|
return self.server_app.on_event("startup")(func)
|
|
|
|
@overrides(BaseDriver)
|
|
def on_shutdown(self, func: Callable) -> Callable:
|
|
"""参考文档: `Events <https://fastapi.tiangolo.com/advanced/events/#startup-event>`_"""
|
|
return self.server_app.on_event("shutdown")(func)
|
|
|
|
@overrides(BaseDriver)
|
|
def run(self,
|
|
host: Optional[str] = None,
|
|
port: Optional[int] = None,
|
|
*,
|
|
app: Optional[str] = None,
|
|
**kwargs):
|
|
"""使用 ``uvicorn`` 启动 FastAPI"""
|
|
LOGGING_CONFIG = {
|
|
"version": 1,
|
|
"disable_existing_loggers": False,
|
|
"handlers": {
|
|
"default": {
|
|
"class": "nonebot.log.LoguruHandler",
|
|
},
|
|
},
|
|
"loggers": {
|
|
"uvicorn.error": {
|
|
"handlers": ["default"],
|
|
"level": "INFO"
|
|
},
|
|
"uvicorn.access": {
|
|
"handlers": ["default"],
|
|
"level": "INFO",
|
|
},
|
|
},
|
|
}
|
|
uvicorn.run(app or self.server_app,
|
|
host=host or str(self.config.host),
|
|
port=port or self.config.port,
|
|
reload=bool(app) and self.config.debug,
|
|
debug=self.config.debug,
|
|
log_config=LOGGING_CONFIG,
|
|
**kwargs)
|
|
|
|
@overrides(BaseDriver)
|
|
async def _handle_http(self,
|
|
adapter: str,
|
|
data: dict = Body(...),
|
|
x_self_id: Optional[str] = Header(None),
|
|
x_signature: Optional[str] = Header(None),
|
|
auth: Optional[str] = Depends(get_auth_bearer)):
|
|
# 检查self_id
|
|
if not x_self_id:
|
|
logger.warning("Missing X-Self-ID Header")
|
|
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST,
|
|
detail="Missing X-Self-ID Header")
|
|
|
|
# 检查签名
|
|
secret = self.config.secret
|
|
if secret:
|
|
if not x_signature:
|
|
logger.warning("Missing Signature Header")
|
|
raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED,
|
|
detail="Missing Signature")
|
|
sig = hmac.new(secret.encode("utf-8"),
|
|
json.dumps(data).encode(), "sha1").hexdigest()
|
|
if x_signature != "sha1=" + sig:
|
|
logger.warning("Signature Header is invalid")
|
|
raise HTTPException(status_code=status.HTTP_403_FORBIDDEN,
|
|
detail="Signature is invalid")
|
|
|
|
access_token = self.config.access_token
|
|
if access_token and access_token != auth:
|
|
logger.warning("Authorization Header is invalid"
|
|
if auth else "Missing Authorization Header")
|
|
raise HTTPException(status_code=status.HTTP_403_FORBIDDEN,
|
|
detail="Authorization Header is invalid"
|
|
if auth else "Missing Authorization Header")
|
|
|
|
if not isinstance(data, dict):
|
|
logger.warning("Data received is invalid")
|
|
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST)
|
|
|
|
if x_self_id in self._clients:
|
|
logger.warning("There's already a reverse websocket api connection,"
|
|
"so the event may be handled twice.")
|
|
|
|
# 创建 Bot 对象
|
|
if adapter in self._adapters:
|
|
BotClass = self._adapters[adapter]
|
|
bot = BotClass(self, "http", self.config, x_self_id)
|
|
else:
|
|
logger.warning("Unknown adapter")
|
|
raise HTTPException(status_code=status.HTTP_404_NOT_FOUND,
|
|
detail="adapter not found")
|
|
|
|
asyncio.create_task(bot.handle_message(data))
|
|
return Response("", 204)
|
|
|
|
@overrides(BaseDriver)
|
|
async def _handle_ws_reverse(
|
|
self,
|
|
adapter: str,
|
|
websocket: FastAPIWebSocket,
|
|
x_self_id: str = Header(None),
|
|
auth: Optional[str] = Depends(get_auth_bearer)):
|
|
ws = WebSocket(websocket)
|
|
|
|
access_token = self.config.access_token
|
|
if access_token and access_token != auth:
|
|
logger.warning("Authorization Header is invalid"
|
|
if auth else "Missing Authorization Header")
|
|
await ws.close(code=status.WS_1008_POLICY_VIOLATION)
|
|
return
|
|
|
|
if not x_self_id:
|
|
logger.warning(f"Missing X-Self-ID Header")
|
|
await ws.close(code=status.WS_1008_POLICY_VIOLATION)
|
|
return
|
|
|
|
if x_self_id in self._clients:
|
|
logger.warning(f"Connection Conflict: self_id {x_self_id}")
|
|
await ws.close(code=status.WS_1008_POLICY_VIOLATION)
|
|
return
|
|
|
|
# Create Bot Object
|
|
if adapter in self._adapters:
|
|
BotClass = self._adapters[adapter]
|
|
bot = BotClass(self,
|
|
"websocket",
|
|
self.config,
|
|
x_self_id,
|
|
websocket=ws)
|
|
else:
|
|
logger.warning("Unknown adapter")
|
|
await ws.close(code=status.WS_1008_POLICY_VIOLATION)
|
|
return
|
|
|
|
await ws.accept()
|
|
self._clients[x_self_id] = bot
|
|
logger.opt(colors=True).info(
|
|
f"WebSocket Connection from <y>{adapter.upper()} "
|
|
f"Bot {x_self_id}</y> Accepted!")
|
|
|
|
try:
|
|
while not ws.closed:
|
|
data = await ws.receive()
|
|
|
|
if not data:
|
|
continue
|
|
|
|
asyncio.create_task(bot.handle_message(data))
|
|
finally:
|
|
del self._clients[x_self_id]
|
|
|
|
|
|
class WebSocket(BaseWebSocket):
|
|
|
|
def __init__(self, websocket: FastAPIWebSocket):
|
|
super().__init__(websocket)
|
|
self._closed = None
|
|
|
|
@property
|
|
@overrides(BaseWebSocket)
|
|
def closed(self):
|
|
return self._closed
|
|
|
|
@overrides(BaseWebSocket)
|
|
async def accept(self):
|
|
await self.websocket.accept()
|
|
self._closed = False
|
|
|
|
@overrides(BaseWebSocket)
|
|
async def close(self, code: int = status.WS_1000_NORMAL_CLOSURE):
|
|
await self.websocket.close(code=code)
|
|
self._closed = True
|
|
|
|
@overrides(BaseWebSocket)
|
|
async def receive(self) -> Optional[dict]:
|
|
data = None
|
|
try:
|
|
data = await self.websocket.receive_json()
|
|
if not isinstance(data, dict):
|
|
data = None
|
|
raise ValueError
|
|
except ValueError:
|
|
logger.warning("Received an invalid json message.")
|
|
except WebSocketDisconnect:
|
|
self._closed = True
|
|
logger.error("WebSocket disconnected by peer.")
|
|
|
|
return data
|
|
|
|
@overrides(BaseWebSocket)
|
|
async def send(self, data: dict) -> None:
|
|
text = json.dumps(data, cls=DataclassEncoder)
|
|
await self.websocket.send({"type": "websocket.send", "text": text})
|