Skip to main content

This package simplifies running a Django app on Heroku platform.

Project description

This has been forked from django-heroku because it was abandoned and then renamed to django-on-heroku because old project has been archived.

Current updates:

  • renamed package from django-heroku to django-on-heroku

  • changed psycopg2 to psycopg2-binary so it works and is installable

  • added installation instructions

  • fixed wipe’ing tables in Postgres

  • whitenoise.middleware.WhiteNoiseMiddleware is injected after django.middleware.security.SecurityMiddleware


This is a Django library for Heroku applications that ensures a seamless deployment and development experience.

This library provides:

  • Settings configuration (Static files / WhiteNoise).

  • Logging configuration.

  • Test runner (important for Heroku CI).


Django 2.0 is targeted, but older versions of Django should be compatible. Only Python 3 is supported.

Installation

pip install django-on-heroku

Usage of Django-Heroku

In settings.py, at the very bottom:

# Configure Django App for Heroku.
import django_on_heroku
django_on_heroku.settings(locals())

This will automatically configure DATABASE_URL, ALLOWED_HOSTS, WhiteNoise (for static assets), Logging, and Heroku CI for your application.

Bonus points!

If you set the SECRET_KEY environment variable, it will automatically be used in your Django settings, too!

If you set the CONN_MAX_AGE environment variable, it will automatically be used in your database settings, too!

Enabling Functionality

settings() accepts keyword arguments that are by default set to False

  • geodjango - set it to True if you want to use GeoDjango in our app

Disabling Functionality

settings() also accepts keyword arguments that can be passed False as a value, which will disable automatic configuration for their specific areas of responsibility:

  • databases

  • test_runner

  • staticfiles

  • allowed_hosts

  • logging

  • secret_key

  • db_ssl_required


You can also just use this library to provide a test runner for your Django application, for use on Heroku CI:

import django_on_heroku
TEST_RUNNER = 'django_on_heroku.HerokuDiscoverRunner'

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

django-on-heroku-1.1.2.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

django_on_heroku-1.1.2-py2.py3-none-any.whl (6.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-on-heroku-1.1.2.tar.gz.

File metadata

  • Download URL: django-on-heroku-1.1.2.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.8.5

File hashes

Hashes for django-on-heroku-1.1.2.tar.gz
Algorithm Hash digest
SHA256 a41fe83ef7ecb022ca92b2950a61f79fef156e58f4f35fc7fc4ecacdc5225fb8
MD5 644be20f339f4a2839ea3a6c6338598e
BLAKE2b-256 55eff2518a11ce08e0a0cf8dce658b5353eb503735ad134da2ef8096568fd101

See more details on using hashes here.

File details

Details for the file django_on_heroku-1.1.2-py2.py3-none-any.whl.

File metadata

  • Download URL: django_on_heroku-1.1.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.8.5

File hashes

Hashes for django_on_heroku-1.1.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4a72ade056335112cba22eea332552d840b718dd8140d43c2d70bb739875955b
MD5 2a01e680cd4aa354ac0422c24a9fb86c
BLAKE2b-256 348e2efcb3afdc78f3222cf53dc0ab0684805d79a973ed83c2fd2c25b2351df7

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