#graphql #tools #gql #validation #ast

graphql-tools

Tools for working with GraphQL in Rust, based on graphql-parser Document

24 releases

0.2.2 Feb 13, 2023
0.2.1 Dec 5, 2022
0.2.0 Sep 11, 2022
0.1.0 Aug 16, 2022
0.0.9 Dec 28, 2021

#86 in Development tools

Download history 1411/week @ 2022-11-27 841/week @ 2022-12-04 808/week @ 2022-12-11 709/week @ 2022-12-18 432/week @ 2022-12-25 578/week @ 2023-01-01 1244/week @ 2023-01-08 1157/week @ 2023-01-15 1154/week @ 2023-01-22 911/week @ 2023-01-29 2450/week @ 2023-02-05 2089/week @ 2023-02-12 1498/week @ 2023-02-19 1714/week @ 2023-02-26 1869/week @ 2023-03-05 890/week @ 2023-03-12

6,149 downloads per month

MIT/Apache

495KB
13K SLoC

graphql-tools (Rust)

Documentation | Crate | GitHub

Note: this crate is still under development (see roadmap below)

The graphql_tools crate implements tooling around GraphQL for Rust libraries. Most of the tools are based on traits and structs implemented in graphql_parser crate.

The goal of this library is to create a common layer of tools that has similar/improved APIs to graphql-js reference implementation and graphql-tools from the JS/TS ecosystem.

Getting Started

Crates.io

Add graphql-tools as a dependency of your project by adding the following to your Cargo.toml file:

[dependencies]
graphql-tools = "..."

Or, if you are using cargo-edit:

cargo add graphql-tools

Roadmap and progress

  • Better documentation
  • AST Visitor for GraphQL schema (graphql_parser::schema::Document)
  • AST Visitor for GraphQL operations (graphql_parser::operation::Document)
  • AST Visitor with TypeInfo
  • AST tools (ongoing)
  • struct extensions
  • GraphQL Validation engine
  • Validation rules
  • GraphQL operations transformer

If you have an idea / missing feature, feel free to open an issue / start a GitHub discussion!

Validation Rules

This comparison is based on graphql-js refernece implementation.

  • ExecutableDefinitions (not actually needed)
  • UniqueOperationNames
  • LoneAnonymousOperation
  • SingleFieldSubscriptions
  • KnownTypeNames
  • FragmentsOnCompositeTypes
  • VariablesAreInputTypes
  • LeafFieldSelections
  • FieldsOnCorrectType
  • UniqueFragmentNames
  • KnownFragmentNames
  • NoUnusedFragments
  • PossibleFragmentSpreads
  • NoFragmentCycles
  • UniqueVariableNames
  • NoUndefinedVariables
  • NoUnusedVariables
  • KnownDirectives
  • UniqueDirectivesPerLocation
  • KnownArgumentNames
  • UniqueArgumentNames
  • ValuesOfCorrectType
  • ProvidedRequiredArguments
  • VariablesInAllowedPosition
  • OverlappingFieldsCanBeMerged
  • UniqueInputFieldNames (blocked by https://github.com/graphql-rust/graphql-parser/issues/59)

Dependencies

~3.5MB
~75K SLoC