Metadata-Version: 2.1
Name: dj_config
Version: 0.0.1
Summary: This is a fork of the Django library for Heroku apps.
Home-page: https://github.com/ochui/dj_config
Author: Ochui Princewill
Author-email: ochui.princewill@gmail.com
License: MIT
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
License-File: LICENSE
Requires-Dist: dj-database-url>=0.5.0
Requires-Dist: whitenoise
Requires-Dist: psycopg2
Requires-Dist: django
Requires-Dist: python-dotenv


dj_config (Python Library)
==============================
.. image:: https://img.shields.io/pypi/v/dj-config.svg
    :target: https://pypi.python.org/pypi/dj-config
    :alt: Latest Version

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.

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

Django 4.0 is targeted, but older versions of Django should be compatible.

Usage of dj_config
----------------------

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

    …
    # Configure Django App for Heroku.
    import dj_config
    from dotenv import load_dotenv
    load_dotenv()  # take environment variables
    django_xconfig.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!

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``
- ``staticfiles``
- ``allowed_hosts``
- ``logging``
- ``secret_key``
