llsd-asgi

llsd-asgi 使用一行代码为ASGI应用（Starlette、FastAPI、Quart等）添加自动 LLSD 内容协商

app.add_middleware(LLSDMiddleware)

llsd-asgi 的代码基于 msgpack-asgi，这是一个用于 MessagePack 二进制格式的类似中间件库。

安装

使用pip安装

pip install llsd-asgi

快速入门（FastAPI）

您可以使用 llsd-asgi 与 FastAPI 如此

from fastapi import FastAPI
from llsd_asgi import LLSDMiddleware

app = FastAPI()
app.add_middleware(LLSDMiddleware)

快速入门（Starlette）

作为一个使用 Starlette 的低级示例

from llsd_asgi import LLSDMiddleware
from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route


async def homepage(request):
    return JSONResponse({"hello": "world"})


app = Starlette(debug=True, routes=[
    Route('/', homepage),
])

# Wrap your application with the LLSD middleware
app = LLSDMiddleware(app)

工作原理

flowchart TD
    A(Client) <-->|LLSD| B(LLSDMiddleware)
    B <-->|JSON| C(App)

您的ASGI应用程序被 LLSDMiddleware 包装，该中间件根据 Content-Type 和 Accept HTTP头进行内容协商。

怪癖模式

将 quirks=True 传递给中间件启用 🤪 怪癖模式。此模式的行为与表现不佳的Linden Lab服务相匹配，即使客户端没有请求，服务器也会返回LLSD。