Metadata-Version: 2.0
Name: django-heroku
Version: 0.1.0
Summary: This is a (work in progress) Django library for Heroku apps.
Home-page: https://github.com/heroku/django-heroku
Author: Kenneth Reitz
Author-email: kreitz@salesforce.com
License: MIT
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Dist: dj-database-url
Requires-Dist: whitenoise
Requires-Dist: psycopg2
Requires-Dist: django


django-heroku
=============

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 <https://www.heroku.com/continuous-integration>`_).

--------------

Django 2.0 is targetted, but older versions of Django should be compatible.

Usage of Django-Heroku
----------------------

In ``settings.py``, at the very bottom

.. codeblock: python

    …
    # Configure Django App for Heroku.
    import django_heroku
    django_heroku.configure(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!

✨🍰✨

