Djangae

Join the chat at https://gitter.im/potatolondon/djangae build-status-image

The best way to run Django on Google Cloud.

Djangae (djan-gee) is a Django app that allows you to run Django applications on the Google Cloud platform, including (if you want to) using Django’s models with Google Cloud Datastore as the underlying database.

:earth_africa:  Website  |   :octocat:  GitHub  |   :closed_book:   Docs  |   :busts_in_silhouette:  Google Group


Looking for Commercial Support?

Potato offers Commercial Support for all its Open Source projects and we can tailor a support package to your needs.

If you’re interested in commercial support, training, or consultancy then go ahead and contact us at opensource@potatolondon.com


Note: Djangae is under heavy development, stability is not guaranteed. A 2.0 release will happen when it’s ready. If you are using Django 1.11 / Python 2.7, please use the 1.x branch

Features

Supported Django Versions

Djangae currently supports Django 2.2.

Documentation

https://djangae.readthedocs.io/

Installation

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

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

  1. First off, head to our Github page and fork the repository to have your own copy of it.
  2. Clone it locally to start setting up your development environment
  3. Run all tests to make sure your local version is working: tox -e py37

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. 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.

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 mailing list.

Pull request requirements

For pull request to be merged, following requirements should be met:

Running tests

On setting up the first time, create a Python 3 virtualenv and install the prerequisites with

# install tox
pip install tox

# install the datastore emulator
gcloud components install cloud-datastore-emulator

If you don’t have gcloud (the Google Cloud SDK) installed, installation instructions can be found here

For running the tests, you just need to run:

$ tox -e py37

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

tox -e py37 -- some_app.SomeTestCase.some_test_method