Naming and configuration

SchemaConfig(auto_camel_case=True) converts inferred Python names to GraphQL camel case during schema compilation.

from fastql import Field, SchemaConfig, Type, build_schema


@Type
class UserProfile:
    display_name: str
    legacy_code: str = Field(name="legacyID")


schema = build_schema(
    query=QueryRoot,
    config=SchemaConfig(auto_camel_case=True),
)

display_name becomes displayName; the explicit legacyID name is preserved. Naming precedence is:

Explicit GraphQL name on Field, Arg, or a type decorator
Inferred Python name transformed by auto_camel_case
Original Python name when automatic camel case is disabled

Explicit names are appropriate for compatibility contracts. Inferred names reduce repetition in new schemas.

Start

Build schemas

Resolve data

Data & performance

Protocol features

Federation

Integrations

Operations

Tooling

Reference

Architecture

Specifications

Contribute

Naming and configuration