Django Environ Save

Django-environ allows you to utilize 12factor inspired environment variables to configure your Django application.

Project README

.. raw:: html

<h1 align="center">django-environ</h1>
<p align="center">
    <a href="">
        <img src="" alt="Latest version released on PyPi" />
    <a href="">
        <img src="" alt="Coverage Status" />
    <a href="">
        <img src="" alt="CI Status" />
    <a href="">
        <img src="" alt="Sponsors on Open Collective" />
    <a href="">
        <img src="" alt="Backers on Open Collective" />
    <a href="">
        <img src="!-1EAEDB.svg" alt="Say Thanks!" />
    <a href="">
        <img src="" alt="Package license" />

.. -teaser-begin-

django-environ is the Python package that allows you to use Twelve-factor methodology <>_ to configure your Django application with environment variables.

.. -teaser-end-

For that, it gives you an easy way to configure Django application using environment variables obtained from an environment file and provided by the OS:

.. -code-begin-

.. code-block:: python

import environ import os

env = environ.Env( # set casting, default value DEBUG=(bool, False) )

Set the project base directory

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(file)))

Take environment variables from .env file

environ.Env.read_env(os.path.join(BASE_DIR, '.env'))

False if not in os.environ because of casting above

DEBUG = env('DEBUG')

Raises Django's ImproperlyConfigured

exception if SECRET_KEY not in os.environ


Parse database connection url strings

like psql://user:[email protected]:8458/db

DATABASES = { # read os.environ['DATABASE_URL'] and raises # ImproperlyConfigured exception if not found # # The db() method is an alias for db_url(). 'default': env.db(),

   # read os.environ['SQLITE_URL']
   'extra': env.db_url(


CACHES = { # Read os.environ['CACHE_URL'] and raises # ImproperlyConfigured exception if not found. # # The cache() method is an alias for cache_url(). 'default': env.cache(),

   # read os.environ['REDIS_URL']
   'redis': env.cache_url('REDIS_URL')


.. -overview-

The idea of this package is to unify a lot of packages that make the same stuff: Take a string from os.environ, parse and cast it to some of useful python typed variables. To do that and to use the 12factor <>_ approach, some connection strings are expressed as url, so this package can parse it and return a urllib.parse.ParseResult. These strings from os.environ are loaded from a .env file and filled in os.environ with setdefault method, to avoid to overwrite the real environ. A similar approach is used in Two Scoops of Django <>_ book and explained in 12factor-django <>_ article.

Using django-environ you can stop to make a lot of unversioned settings_*.py to configure your app. See cookiecutter-django <>_ for a concrete example on using with a django project.

Feature Support

  • Fast and easy multi environment for deploy
  • Fill os.environ with .env file variables
  • Variables casting
  • Url variables exploded to django specific package settings
  • Optional support for Docker-style file based config variables (use environ.FileAwareEnv instead of environ.Env)

.. -project-information-

Project Information

django-environ is released under the MIT / X11 License <>__, its documentation lives at Read the Docs <>, the code on GitHub <>, and the latest release on PyPI <>_.

It’s rigorously tested on Python 3.5+, and officially supports Django 1.11, 2.2, 3.0, 3.1, 3.2 and 4.0.

If you'd like to contribute to django-environ you're most welcome!

.. -support-


Should you have any question, any remark, or if you find a bug, or if there is something you can't do with the django-environ, please open an issue <>_.

Open Source Agenda is not affiliated with "Django Environ" Project. README Source: joke2k/django-environ
Open Issues
Last Commit
3 weeks ago

Open Source Agenda Badge

Open Source Agenda Rating