Loads environment variables from .env
Latest commit fb0fb72 Jan 17, 2017 @jpadilla committed on GitHub Merge pull request #22 from merwok-forks/fix-warning-stacklevel
Show calling function in warning



build-status-image pypi-version

foreman reads from .env. manage.py doesn't. Let's fix that.

Original implementation was written by @jacobian.

Tested on Python 2.7, 3.3, 3.4, and 3.5.


pip install django-dotenv


Your manage.py should look like:

#!/usr/bin/env python
import os
import sys

import dotenv

if __name__ == "__main__":

    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "project.settings")

    from django.core.management import execute_from_command_line


You can also pass read_dotenv() an explicit path to the .env file, or to the directory where it lives. It's smart, it'll figure it out.

Check out tests.py to see all the supported formats that your .env can have.

Using with WSGI

If you're running Django with WSGI and want to load a .env file, your wsgi.py would look like this:

import os

import dotenv
from django.core.wsgi import get_wsgi_application

dotenv.read_dotenv(os.path.join(os.path.dirname(os.path.dirname(__file__)), '.env'))

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "project.settings")

application = get_wsgi_application()

That's it. Now go 12 factor the crap out of something.