Skip to main content

Some helper functionality for binding Heroku configuration to Django

Project description

Djheroku is a helper script that reads Heroku configuration from environment variables and injects them to Django configuration.

Build Status Test Coverage Requirements Status Latest Version Wheel Status License

Autopilot for Heroku settings

This is an easier way to control what Django does. Just add a few lines to your settings.py:

from djheroku import autopilot
autopilot(vars())

Then you can make runtime changes to your application settings:

heroku addons:add sendgrid
heroku config:set ADDONS=sendgrid
heroku addons:add memcachier
heroku config:set ADDONS=sendgrid,memcachier

Djheroku will change the variables accordingly.

Configuration helpers

Example:

# settings.py
from djheroku import sendgrid
vars().update(sendgrid())

This is equivalent of typing in:

# settings.py
import os

if 'SENDGRID_USERNAME' in os.environ and 'SENDGRID_PASSWORD' in os.environ:
    EMAIL_HOST = 'smtp.sendgrid.net'
    EMAIL_HOST_USER = os.environ['SENDGRID_USERNAME']
    EMAIL_HOST_PASSWORD = os.environ['SENDGRID_PASSWORD']
    EMAIL_PORT = 587
    EMAIL_USE_TLS = True

If any of the variables are not present, the configuration will be left as it is. Currently there are two helpers: sendgrid() and mailgun().

Middleware

There are three middleware classes in Djheroku. They are used to redirect permanently from one URL to another.

  • NoWwwMiddleware removed www. from URLs of incoming requests. The opposite is built-in functionality of Django. Enable this Middleware and set NO_WWW = True in settings.py to activate.
  • PreferredDomainMiddleware redirects all domains directed to the application to a preferred one.
  • ForceSSLMiddleware redirects all non-SSL connections to a secure connection.

Each of these middlewares does one thing only and combined they will lead into three separate redirects or even a eternal loop if configured properly wrong.

Project details


Release history Release notifications

This version
History Node

0.5.5

History Node

0.5.4

History Node

0.5.3

History Node

0.5.1

History Node

0.5.0

History Node

0.4.1

History Node

0.4.0-1-g580bd5d

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
Djheroku-0.5.5-py2-none-any.whl (13.8 kB) Copy SHA256 hash SHA256 Wheel py2 Dec 18, 2014
Djheroku-0.5.5-py3-none-any.whl (13.8 kB) Copy SHA256 hash SHA256 Wheel py3 Feb 23, 2016
Djheroku-0.5.5.tar.gz (18.7 kB) Copy SHA256 hash SHA256 Source None Dec 18, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page