ASGI, Starlette, and FastAPI - FastQL

Generic ASGI

GraphQLASGI is dependency-free and can run directly or be mounted by an ASGI router.

from fastql.integrations import GraphQLASGI

application = GraphQLASGI(
    schema,
    graphiql=True,
    schema_path="/schema.graphql",
)

The context’s native request is an ASGIRequest containing scope, receive, and send. WebSocket scopes are closed because subscription transports are not part of the initial integration contract.

Starlette

from starlette.applications import Starlette
from fastql.integrations.starlette import create_starlette_router

router = create_starlette_router(schema, graphiql=True)
app = Starlette(routes=list(router.routes))

Mounting the router under a prefix composes all enabled routes with that prefix. Starlette middleware runs before FastQL and HTTPContext.request is the native Starlette Request.

FastAPI

from fastapi import Depends, FastAPI
from fastql.integrations.fastapi import create_fastapi_router

router = create_fastapi_router(
    schema,
    dependencies=[Depends(require_user)],
    tags=["GraphQL"],
    include_in_schema=False,
)

app = FastAPI()
app.include_router(router, prefix="/api")

FastAPI resolves router dependencies before GraphQL execution. Tags and include_in_schema control FastAPI’s OpenAPI document without changing FastQL execution behavior.