mirror of
https://github.com/graphql-python/graphene-django.git
synced 2024-12-02 14:33:46 +03:00
a000d58514
Currently the relay cookbook's readme has a link to the plain tutorial page. The plain cookbook readme also instructs the user to change directory into the directory for the relay example. This change fixes both issues. Also changed the title for the relay example to specify that it uses relay.
65 lines
1.6 KiB
Markdown
65 lines
1.6 KiB
Markdown
Cookbook Example Django Project
|
|
===============================
|
|
|
|
This example project demos integration between Graphene and Django.
|
|
The project contains two apps, one named `ingredients` and another
|
|
named `recipes`.
|
|
|
|
Getting started
|
|
---------------
|
|
|
|
First you'll need to get the source of the project. Do this by cloning the
|
|
whole Graphene repository:
|
|
|
|
```bash
|
|
# Get the example project code
|
|
git clone https://github.com/graphql-python/graphene-django.git
|
|
cd graphene-django/examples/cookbook-plain
|
|
```
|
|
|
|
It is good idea (but not required) to create a virtual environment
|
|
for this project. We'll do this using
|
|
[virtualenv](http://docs.python-guide.org/en/latest/dev/virtualenvs/)
|
|
to keep things simple,
|
|
but you may also find something like
|
|
[virtualenvwrapper](https://virtualenvwrapper.readthedocs.org/en/latest/)
|
|
to be useful:
|
|
|
|
```bash
|
|
# Create a virtualenv in which we can install the dependencies
|
|
virtualenv env
|
|
source env/bin/activate
|
|
```
|
|
|
|
Now we can install our dependencies:
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
Now setup our database:
|
|
|
|
```bash
|
|
# Setup the database
|
|
./manage.py migrate
|
|
|
|
# Load some example data
|
|
./manage.py loaddata ingredients
|
|
|
|
# Create an admin user (useful for logging into the admin UI
|
|
# at http://127.0.0.1:8000/admin)
|
|
./manage.py createsuperuser
|
|
```
|
|
|
|
Now you should be ready to start the server:
|
|
|
|
```bash
|
|
./manage.py runserver
|
|
```
|
|
|
|
Now head on over to
|
|
[http://127.0.0.1:8000/graphql](http://127.0.0.1:8000/graphql)
|
|
and run some queries!
|
|
(See the [Graphene-Django Tutorial](http://docs.graphene-python.org/projects/django/en/latest/tutorial-plain/#testing-our-graphql-schema)
|
|
for some example queries)
|