gqlparser

README

gqlparser

This repo is still under heavy development while it is being integrated with gqlgen. APIs will break, use it at your own peril.

This is a parser for graphql, written to mirror the graphql-js reference implementation as closely as possible.

spec target: 06614fb52871bbaf940f8cac7148db26df00c562 (master 2018-04-29)

This parser aims to replace the one in graph-gophers/internal for use by gqlgen.

Guiding principles:

• maintainability: It should be easy to stay up to date with the spec
• well tested: It shouldnt need a graphql server to validate itself. Changes to this repo should be self contained.
• server agnostic: It should be usable by any of the graphql server implementations, and any graphql client tooling.
• idiomatic & stable api: It should follow go best practices, especially around forwards compatibility.
• fast: Where it doesnt impact on the above it should be fast. Avoid unnecessary allocs in hot paths.
• close to reference: Where it doesnt impact on the above, it should stay close to the graphql/graphql-js reference implementation.

Documentation

Index

• func LoadQuery(schema *ast.Schema, str string) (*ast.QueryDocument, gqlerror.List)
• func LoadSchema(str ...*ast.Source) (*ast.Schema, *gqlerror.Error)
• func MustLoadQuery(schema *ast.Schema, str string) *ast.QueryDocument
• func MustLoadSchema(str ...*ast.Source) *ast.Schema

Functions

func LoadQuery

func LoadQuery(schema *ast.Schema, str string) (*ast.QueryDocument, gqlerror.List)

func LoadSchema

func LoadSchema(str ...*ast.Source) (*ast.Schema, *gqlerror.Error)

func MustLoadQuery

func MustLoadQuery(schema *ast.Schema, str string) *ast.QueryDocument

func MustLoadSchema

func MustLoadSchema(str ...*ast.Source) *ast.Schema