platform/graphql_parser
2019-08-07 22:47:51 -04:00
..
example Remove "new " 2019-08-07 22:24:19 -04:00
lib Update comments in directive.dart 2019-08-07 22:47:51 -04:00
test Formatting 2019-08-07 22:45:51 -04:00
.gitignore ignore dart tool 2018-08-04 20:58:59 -04:00
analysis_options.yaml pedantic: ast/alias.dart 2019-08-07 22:24:02 -04:00
CHANGELOG.md 1.2.0 CHANGELOG 2019-08-07 22:05:09 -04:00
graphql_parser.iml Fix type errors in tests 2018-08-02 09:05:52 -04:00
LICENSE Restructure 2018-08-02 08:48:53 -04:00
mono_pkg.yaml mono_repo 2019-01-23 14:52:02 -05:00
pubspec.yaml pedantic: ast/alias.dart 2019-08-07 22:24:02 -04:00
README.md Remove "new " 2019-08-07 22:24:19 -04:00

graphql_parser

Pub build status

Parses GraphQL queries and schemas.

This library is merely a parser/visitor. Any sort of actual GraphQL API functionality must be implemented by you, or by a third-party package.

Angel framework users should consider package:angel_graphql as a dead-simple way to add GraphQL functionality to their servers.

Installation

Add graphql_parser as a dependency in your pubspec.yaml file:

dependencies:
  graphql_parser: ^1.0.0

Usage

The AST featured in this library was originally directly based off this ANTLR4 grammar created by Joseph T. McBride: https://github.com/antlr/grammars-v4/blob/master/graphql/GraphQL.g4

It has since been updated to reflect upon the grammar in the official GraphQL specification ( June 2018).

import 'package:graphql_parser/graphql_parser.dart';

doSomething(String text) {
  var tokens = scan(text);
  var parser = Parser(tokens);
  
  if (parser.errors.isNotEmpty) {
    // Handle errors...
  }
  
  // Parse the GraphQL document using recursive descent
  var doc = parser.parseDocument();
  
  // Do something with the parsed GraphQL document...
}