This library contains a lexer and parser as well as the complete GraphQL AST model that allows you to work with GraphQL documents compatible with the October 2021 spec.
The parser from this library is used by the GraphQL.NET project and was verified by many test data sets.
Preview versions of this package are available on GitHub Packages.
Generates token based on input text. Lexer takes advantage of ReadOnlyMemory<char>
and in most cases
does not allocate memory on the managed heap at all.
var token = Lexer.Lex("\"str\"");
Lex method always returns the first token it finds. In this case case the result would look like following.
Parses provided GraphQL expression into AST (abstract syntax tree). Parser also takes advantage of
ReadOnlyMemory<char>
but still allocates memory for AST.
var ast1 = Parser.Parse(@"
{
field
}");
var ast2 = Parser.Parse(@"
{
field
}", new ParserOptions { Ignore = IgnoreOptions.Comments });
By default ParserOptions.Ignore
is IgnoreOptions.None
. If you want
to ignore all comments use IgnoreOptions.Comments
. If you don't need
information about tokens locations in the source document, then use flag
IgnoreOptions.Locations
. Or just use IgnoreOptions.All
and this
will maximize the saving of memory allocated in the managed heap for AST.
ASTVisitor
provides API to traverse AST of the parsed GraphQL document.
Default implementation traverses all AST nodes of the provided one. You can
inherit from it and override desired methods to implement your own AST
processing algorithm.
For printing SDL from AST, you can use SDLPrinter
. This is a highly
optimized visitor for asynchronous non-blocking SDL output into provided
TextWriter
. In the majority of cases it does not allocate memory in
the managed heap at all.
You can also find a StructurePrinter
visitor that prints AST into the
provided TextWriter
as a hierarchy of node types. It can be useful
when debugging for better understanding the AST structure.
Consider GraphQL document
query a { name age }
After StructurePrinter
processing the output text will be
Document
OperationDefinition
Name [a]
SelectionSet
Field
Name [name]
Field
Name [age]
public static async Task Print(string text)
{
using var document = Parser.Parse(text);
var writer = new StringWriter();
var printer = new SDLPrinter()
await printer.PrintAsync(document, writer);
var rendered = writer.ToString();
Console.WriteLine(rendered);
}