Design goals
- One definition model. Object types, inputs, interfaces, operations, enums, unions, and scalars use a consistent decorator contract.
- Progressive explicitness. Python annotations cover ordinary fields;
Field,Arg, andAnnotatedadd GraphQL-specific metadata when needed. - Spec-oriented behavior. The parser, validator, coercion system, and executor are designed around GraphQL semantics rather than transport conventions.
- Inspectable internals. Schema output and architecture documentation make the compilation and execution stages visible.
Build a schema
Start with a complete executable example.
Understand the model
Trace definitions through execution.