Skip to main content

None

Project description

https://badge.fury.io/py/django-appengine-toolkit.png https://travis-ci.org/masci/django-appengine-toolkit.png?branch=master https://pypip.in/d/django-appengine-toolkit/badge.png

Appengine Toolkit pimps Django with some utilities which help deploying projects on Google App Engine with Google Cloud SQL as data backend.

Features

  • collects project dependencies symlinking needed modules and packages and configuring App Engine environment

  • configures DATABASE setting parsing connection strings similar to those on Heroku

Documentation

The full documentation is at http://django-appengine-toolkit.rtfd.org.

Quickstart

Install appengine-toolkit:

pip install django-appengine-toolkit

Add it to the installed apps:

INSTALLED_APPS = (
    # ...
    'appengine_toolkit',
)

To automatically configure database settings reading connection string from the DATABASE_URL enviroment var:

import appengine_toolkit
DATABASES = {
    'default': appengine_toolkit.config(),
}

You can set DATABASE_URL directly in your app.yaml file:

env_variables:
  DJANGO_SETTINGS_MODULE: 'myapp.settings'
  DATABASE_URL: 'mysql://root@project_id:instance_id/database_name'

To collect project dependencies, first configure Appengine Toolkit in your settings file, specifying the full path to your app.yaml file:

APPENGINE_TOOLKIT = {
    'APP_YAML': os.path.join(BASE_DIR, '../../', 'app.yaml'),
}

…then run the command collectdeps specifying the requirement file containing the list of packages needed by your project to run:

python manage.py collectdeps -r my_requirements.txt

a folder named libs will be created on your application root (i.e. the same folder where the YAML file resides) containing symlinks needed by App Engine to include dependencies in the production runtime enviroment.

A file appengine_config.py will be created in the same folder and will contain code needed to configure the environment. If you need to customize the module appengine_config tell the command to not overwrite it - the command will then output the code you need to paste inside the module to complete the configuration process

History

0.1.0 (2013-11-30)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

appengine-toolkit-0.1.0.tar.gz (8.8 kB view details)

Uploaded Source

File details

Details for the file appengine-toolkit-0.1.0.tar.gz.

File metadata

File hashes

Hashes for appengine-toolkit-0.1.0.tar.gz
Algorithm Hash digest
SHA256 d14b5171c31851e062e0efcf9a1c080e4aeda1dc9bda0e88277eecead5a810e3
MD5 f017d6ff53a044078950765bea37e1ea
BLAKE2b-256 986707ec84acb41f585b441d70c33484c07dcfbb71cd41519585a0b2c213b82d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page