mirror of
https://github.com/graphql-python/graphene-django.git
synced 2024-11-25 19:14:11 +03:00
ce9d989bcd
This uses the new URL routing syntax introduced in Django 2.0 (https://docs.djangoproject.com/en/2.2/releases/2.0/#simplified-url-routing-syntax). The older `url()` syntax will deprecated at some point in future https://docs.djangoproject.com/en/2.2/ref/urls/#url
69 lines
1.6 KiB
ReStructuredText
69 lines
1.6 KiB
ReStructuredText
Installation
|
|
============
|
|
|
|
Graphene-Django takes a few seconds to install and set up.
|
|
|
|
Requirements
|
|
------------
|
|
|
|
Graphene-Django currently supports the following versions of Django:
|
|
|
|
* Django 2.X
|
|
|
|
Installation
|
|
------------
|
|
|
|
.. code:: bash
|
|
|
|
pip install graphene-django
|
|
|
|
**We strongly recommend pinning against a specific version of Graphene-Django because new versions could introduce breaking changes to your project.**
|
|
|
|
Add ``graphene_django`` to the ``INSTALLED_APPS`` in the ``settings.py`` file of your Django project:
|
|
|
|
.. code:: python
|
|
|
|
INSTALLED_APPS = [
|
|
...
|
|
'django.contrib.staticfiles', # Required for GraphiQL
|
|
'graphene_django'
|
|
]
|
|
|
|
|
|
We need to add a ``graphql`` URL to the ``urls.py`` of your Django project:
|
|
|
|
.. code:: python
|
|
|
|
from django.urls import path
|
|
from graphene_django.views import GraphQLView
|
|
|
|
urlpatterns = [
|
|
# ...
|
|
path("graphql", GraphQLView.as_view(graphiql=True)),
|
|
]
|
|
|
|
(Change ``graphiql=True`` to ``graphiql=False`` if you do not want to use the GraphiQL API browser.)
|
|
|
|
Finally, define the schema location for Graphene in the ``settings.py`` file of your Django project:
|
|
|
|
.. code:: python
|
|
|
|
GRAPHENE = {
|
|
'SCHEMA': 'django_root.schema.schema'
|
|
}
|
|
|
|
Where ``path.schema.schema`` is the location of the ``Schema`` object in your Django project.
|
|
|
|
The most basic ``schema.py`` looks like this:
|
|
|
|
.. code:: python
|
|
|
|
import graphene
|
|
|
|
class Query(graphene.ObjectType):
|
|
pass
|
|
|
|
schema = graphene.Schema(query=Query)
|
|
|
|
|
|
To learn how to extend the schema object for your project, read the basic tutorial. |