kennethreitz.org/data/software/dj-database-url.md

dj-database-url

dj-database-url is a Python library that allows you to configure your Django application to use a database URL.

This need arose at my time at Heroku, where we allowed users to configure their Django application by setting an environment variable called DATABASE_URL.

This library emerged from Kenneth's work at Heroku, where the twelve-factor app methodology emphasized configuration through environment variables. The simple act of parsing database URLs became essential for cloud-native Django applications.

Installation

Installing dj-database-url is simple:

$ pip install dj-database-url

Usage

Then, in your settings.py file, you can use dj-database-url to configure your database:

import dj_database_url

DATABASES['default'] = dj_database_url.config(
    conn_max_age=600,
    conn_health_checks=True,
)

There are many options you can pass to dj-database-url.config(). See the dj-database-url documentation for more information.

https://pypi.org/project/dj-database-url/