mirror of
https://github.com/graphql-python/graphene.git
synced 2024-11-11 12:16:58 +03:00
Add Django graphql_schema command documentation
This commit is contained in:
parent
062c0f9ed5
commit
25022f58d8
50
docs/pages/docs/introspection-schema.md
Normal file
50
docs/pages/docs/introspection-schema.md
Normal file
|
@ -0,0 +1,50 @@
|
||||||
|
---
|
||||||
|
title: Introspection Schema
|
||||||
|
description: A guide to instrospection schema in Django
|
||||||
|
---
|
||||||
|
|
||||||
|
# Introspection Schema
|
||||||
|
|
||||||
|
Relay uses [Babel Relay Plugin](https://facebook.github.io/relay/docs/guides-babel-plugin.html)
|
||||||
|
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:
|
||||||
|
|
||||||
|
```python
|
||||||
|
INSTALLED_APPS += ('graphene.django.contrib')
|
||||||
|
```
|
||||||
|
|
||||||
|
Assuming your Graphene schema is at `tutorial.quickstart.schema`, run the command:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./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:
|
||||||
|
|
||||||
|
```python
|
||||||
|
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.
|
Loading…
Reference in New Issue
Block a user