Djangae

Join the chat at https://gitter.im/potatolondon/djangae

build-status-image codecov.io

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.

Documentation: http://djangae.readthedocs.org/

Google Group: https://groups.google.com/forum/#!forum/djangae-users

Website: https://potatolondon.github.io/djangae/

GitHub: https://github.com/potatolondon/djangae

Note: Djangae is under heavy development, stability is not guaranteed. A 1.0 release will happen when it’s ready

Features

Documentation

http://djangae.readthedocs.org/

Supported Django Versions

The intention is always to support the last two versions of Django, although older versions may work. Currently Django 1.7 and 1.8 are supported. Django 1.9 support (master) isn’t too far away!

** 1.6 is no longer supported by Djangae, as it’s not supported by Django either! **

Installation

See https://djangae.readthedocs.org/en/latest/installation/

Testing

For running the tests, you just need to run:

$ ./runtests.sh

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. If you want to run the tests on a specific Django version, simply do:

$ DJANGO_VERSION=1.8 ./runtests.sh

Currently the default is 1.7. TravisCI runs on 1.7 and 1.8 currently.

You can run specific tests in the usual way by doing:

./runtests.sh some_app.SomeTestCase.some_test_method

Contributing

Contributions are accepted via pull request and will be reviewed as soon as possible. If you have access to master, please do not commit directly! Pull requests only!

Code style should follow PEP-8 with a loose line length of 100 characters (don’t make the code ugly).