graphql-schema-linter

graphql-schema-linter

This package provides a command line tool to validate GraphQL schema definitions against a set of rules.

If you're looking to lint your GraphQL queries, check out this ESLint plugin: apollographql/eslint-plugin-graphql.

Install

Yarn:

yarn global add graphql-schema-linter

npm:

npm install -g graphql-schema-linter

Usage

Usage: graphql-schema-linter [options] [schema.graphql]


Options:

  -o, --only <rules>

    only the rules specified will be used to validate the schema

    example: --only FieldsHaveDescriptions,TypesHaveDescriptions

  -e, --except <rules>

    all rules except the ones specified will be used to validate the schema

    example: --except FieldsHaveDescriptions,TypesHaveDescriptions

  -f, --format <format>

    choose the output format of the report

    possible values: json, text

  -s, --stdin

    schema definition will be read from STDIN instead of specified file

  --version

    output the version number

  -h, --help

    output usage information

Built-in rules

DeprecationsHaveAReason

This rule will validate that all deprecations have a reason.

FieldsHaveDescriptions

This rule will validate that all fields have a description.

TypesAreCapitalized

This rule will validate that interface types and object types have capitalized names.

TypesHaveDescriptions

This will will validate that interface types and object types have descriptions.

Output formatters

The format of the output can be controlled via the --format option.

The following formatters are currently available: text, json.

TextFormatter (default)

Sample output:

5:1 The object type `QueryRoot` is missing a description.
6:3 The field `QueryRoot.a` is missing a description.

Each error is prefixed with the line number and column the error occurred on.

JSONFormatter

Sample output:

{
  "errors": [
    {
      "message": "The object type `QueryRoot` is missing a description.",
      "location": {
        "line": 5,
        "column": 1
      }
    },
    {
      "message": "The field `QueryRoot.a` is missing a description.",
      "location": {
        "line": 6,
        "column": 3
      }
    }
  ]
}

Changelog

0.0.4 (August 4th, 2017)

New features

• Added --only and --except to control what rules get used to validate the schema.
• Added --help and usage.
• Added --version to obtain the version of graphql-schema-linter.