Context and Info

Pass request-scoped state through the context argument to execute.

from dataclasses import dataclass

from fastql import Context, Field, Info, Query, execute


@dataclass
class RequestContext(Context):
    user_id: str | None
    request_id: str


@Query
class QueryRoot:
    @Field
    def viewer(self, ctx: RequestContext, info: Info[RequestContext, object]) -> str | None:
        assert info.context is ctx
        return ctx.user_id


result = await execute(schema, "{ viewer }", context=request_context)

Type annotations are the primary injection signal. A parameter typed as a Context subclass receives the context object regardless of its name. Parameters named context or ctx are also treated as context for compatibility. Info exposes the schema, field name, parent type, path, variables, operation, root value, and typed context. Keep authentication principals, request identifiers, loaders, and service handles on a context object created per request. Avoid mutable process-global request state.

Start

Build schemas

Resolve data

Data & performance

Protocol features

Federation

Integrations

Operations

Tooling

Reference

Architecture

Specifications

Contribute

Context and Info