Django integration with Google App Engine
[![Join the chat at https://gitter.im/potatolondon/djangae](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/potatolondon/djangae?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Issue Stats](http://issuestats.com/github/potatolondon/djangae/badge/pr)](http://issuestats.com/github/potatolondon/djangae) [![Issue Stats](http://issuestats.com/github/potatolondon/djangae/badge/issue)](http://issuestats.com/github/potatolondon/djangae)
The best way to run Django on Google App Engine.
Djangae (djan-gee) is a Django app that allows you to run Django applications on Google App Engine, including (if you want to) using Django’s models with the App Engine Datastore as the underlying database.
Google Group: https://groups.google.com/forum/#!forum/djangae-users
Note: Djangae is under heavy development, stability is not guaranteed. See [1.0 release changes issue](https://github.com/potatolondon/djangae/issues/593) to follow progress on Djangae 1.0 release.
## Supported Django Versions
The intention is always to support the currently-supported versions of Django, although older versions may work. Currently Django 1.8, 1.9 and 1.10 are supported.
# Contributing to Djangae
Djangae is actively developed and maintained, so if you’re thinking of contributing to the codebase, here is how to get started.
## Get started with development
## Pick an issue & send a pull request
If you spotted a bug in Djangae that you want to fix, it’s a good idea to start off by [adding an issue](https://github.com/potatolondon/djangae/issues/new). This will allow us to verify that your issue is valid, and suggest ideas for fixing it, so no time is wasted for you.
For help with creating the pull request, check out [Github documentation](https://help.github.com/articles/creating-a-pull-request/).
## Code style
Code style should follow PEP-8 with a loose line length of 100 characters.
## Need help?
Reach out to us on [djangae-users](https://groups.google.com/forum/#!forum/djangae-users) mailing list.
## Pull request requirements
For pull request to be merged, following requirements should be met:
# Running tests
For running the tests, you just need to run:
On the first run this will download the App Engine SDK, pip install a bunch of stuff locally (into a folder, no virtualenv needed), download the Django tests and run them. Subsequent runs will just run the tests. If you want to run the tests on a specific Django version, you can switch the installed version by doing:
$ DJANGO_VERSION=1.8 ./runtests.sh –install_deps
Currently the default is 1.8. TravisCI runs on 1.8 and 1.9 currently.
If you want to run the tests on a specific App Engine SDK version, then you can switch the installed version by doing:
$ SDK_VERSION=1.9.35 ./runtests.sh –install_sdk
Note that this also re-installs the dependencies, so will reset the Django version to the default of 1.8.
You can run specific tests in the usual way by doing:
[build-status-image]: https://secure.travis-ci.org/potatolondon/djangae.png?branch=master [travis]: https://travis-ci.org/potatolondon/djangae?branch=master