django-environ 0.11.2

django-environ 是一个Python包，允许您使用十二因素方法使用环境变量来配置Django应用程序。

为此，它提供了一个简单的方法，使用从环境文件中获取并由操作系统提供的环境变量来配置Django应用程序

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
SECRET_KEY = env('SECRET_KEY')

# Parse database connection url strings
# like psql://user:pass@127.0.0.1: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(
        'SQLITE_URL',
        default='sqlite:////tmp/my-tmp-sqlite.db'
    )
}

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')
}

这个包的想法是统一很多做同样事情的工具包：从一个字符串中获取 os.environ，解析并转换为一些有用的Python类型变量。为了做到这一点，并使用12factor方法，一些连接字符串以URL的形式表达，因此这个包可以解析它并返回一个urllib.parse.ParseResult。这些来自os.environ的字符串是从一个.env文件加载的，并通过setdefault方法填充到os.environ中，以避免覆盖真正的环境变量。在《Two Scoops of Django》书籍中使用了类似的方法，并在12factor-django文章中进行了解释。

使用 django-environ，你可以停止创建许多未版本化的 settings_*.py 来配置你的应用程序。请查看 cookiecutter-django 以了解如何与Django项目一起使用的具体示例。

功能支持

• 快速且容易的多环境部署

• 使用.env文件变量填充 os.environ

• 变量转换

• 将URL变量分解为Django特定包的设置

• 可选支持Docker风格的文件配置变量（使用 environ.FileAwareEnv 而不是 environ.Env）