fdemmer-django-environ 0.11.3

django-environ 是一个Python包，允许您使用Twelve-factor方法论，通过从环境文件和操作系统获取的环境变量来配置您的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 来配置你的应用程序。有关与 Django 项目一起使用的具体示例，请参阅 cookiecutter-django。

功能支持

• 快速简单的多环境部署

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

• 变量转换

• 将 URL 变量展开为 Django 特定的设置包

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