django-environ-settings

从环境变量中加载Django配置项。

安装

pip install django-environ-settings

使用方法

在pro/settings.py结尾处添加以下代码：

from django_environ_settings import django_environ_settings_patch_all

django_environ_settings_patch_all(
    keys=["CONFIG_ITEM_KEY"],
    mapping_keys={
        "ENV_KEY1": "DJANGO_KEY1",
        "ENV_KEY2": "DJANGO_KEY2",
    }
    namespace="DJANGO_",
)

• namespace="DJANGO_"表示只有以DJANGO_开头的环境变量才被django使用，并用于更新移除DJANGO_前缀后对应的配置项。
  • 如django中的数据库配置项DATABASES对应的环境变量为DJANGO_DATABASES。
• keys用于加载不使用namespace前缀的环境变量。允许为空。
  • 如CONFIG_ITEM_KEY表示在djaong.conf.settings中添加了额外的CONFIG_ITEM_KEY配置项。
  • 当前使用namespace前缀的环境变量DJANGO_CONFIG_ITEM_KEY也能实现相同效果，并且优先级更高。
• mapping_keys用于处理环境变量名与django配置项名不一致的情况。
  • 如：把环境变量ENV_KEY1的值加载为django的DJANGO_KEY1配置项。
• 环境变量值使用YAML格式编写。

版本

v0.1.0

• 版本首发，基本功能完成。

v0.1.1

• 添加：内外部KEY值映射的支持。
• 修正：打包后*.whl中没有包含有效代码的问题。
• 修正：加载配置项时没有移除前缀的问题。

v0.1.2

• 修正：需要忽略DJANGO_SETTINGS_MODULE配置项的问题。