graphene/docs/pages/docs/introspection-schema.md
2016-01-04 01:51:25 +08:00

1.3 KiB

title description
Introspection Schema A guide to instrospection schema in Django

Introspection Schema

Relay uses Babel Relay Plugin that requires you to provide your GraphQL schema data.

Graphene comes with a management command for Django to dump your schema data to schema.json that is compatible with babel-relay-plugin.

Usage

Include graphene.django.contrib to INSTALLED_APPS in you project settings:

INSTALLED_APPS += ('graphene.django.contrib')

Assuming your Graphene schema is at tutorial.quickstart.schema, run the command:

./manage.py graphql_schema --schema tutorial.quickstart.schema --out schema.json

It dumps your full introspection schema to schema.json inside your project root directory. Point babel-relay-plugin to this file and you're ready to use Relay with Graphene GraphQL implementation.

Advanced Usage

To simplify the command to ./manage.py graphql_schema, you can specify the parameters in your settings.py:

GRAPHENE_SCHEMA = 'tutorial.quickstart.schema'
GRAPHENE_SCHEMA_OUTPUT = 'data/schema.json'  # defaults to schema.json

Running ./manage.py graphql_schema dumps your schema to <project root>/data/schema.json.

Help

Run ./manage.py graphql_schema -h for command usage.