Use Database URLs in your Django Application.
Find a file
2012-04-30 15:08:20 -04:00
dj_database_url.py typo 2012-04-30 15:04:06 -04:00
LICENSE lawyer up 2012-04-30 13:43:46 -04:00
README.rst readme notes 2012-04-30 15:08:20 -04:00
setup.py readme notes 2012-04-30 15:08:20 -04:00

DJ-Database-URL
~~~~~~~~~~~~~~

This simple Django utility allows you to utilize the
`12factor <http://www.12factor.net/backing-services>`_ inspired
``DATABASE_URL`` environment variable to configure your Django application.


Usage
-----

Configure your database in ``settings.py`` from ``DATABASE_URL``::

    DATABASES['default'] = dj_database_url.config()

Parse an arbitrary Database URL::

    DATABASES['default'] = dj_database_url.parse('postgres://...')


Installation
------------

Installation is simple too::

    $ pip install dj-database-url