Resolvers

Resolvers can be regular or async methods. FastQL inspects their annotations to build GraphQL arguments and inject framework values.

from fastql import Field, Query


@Query
class QueryRoot:
    @Field
    async def user(self, id: str) -> User | None:
        return await repository.find_user(id)

At execution time, sibling fields are scheduled concurrently. Resolver exceptions become GraphQL errors with field paths; unaffected nullable branches continue. The resolver source is the parent object. Root classes are instantiated for the operation. Ordinary parameters become GraphQL arguments unless FastQL classifies them as Info, Context, or registered dependencies. Use explicit Arg metadata to rename, document, deprecate, or default an argument:

@Field
def users(self, limit: int = Arg(default=20, description="Maximum rows.")) -> list[User]:
    return repository.list_users(limit=limit)

Start

Build schemas

Resolve data

Data & performance

Protocol features

Federation

Integrations

Operations

Tooling

Reference

Architecture

Specifications

Contribute