Python实用工具：解密python-decouple——环境变量管理的瑞士军刀

pip install python-decouple

# 基础配置
DEBUG=True
SECRET_KEY=my_secret_key_123
DB_HOST=localhost
DB_PORT=5432

# 数值型配置
MAX_CONNECTIONS=100
TIMEOUT=30.5

# 列表型配置（用逗号分隔）
ALLOWED_HOSTS=localhost,127.0.0.1,example.com

# 敏感信息（如API密钥）
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

from decouple import config

# 读取布尔型变量（自动转换）
debug_mode = config('DEBUG', cast=bool)
print(f"Debug模式：{'开启' if debug_mode else '关闭'}")  # 输出：Debug模式：开启

# 读取字符串型变量（默认值处理）
secret_key = config('SECRET_KEY', default='default_key')
print(f"密钥：{secret_key}")  # 输出：密钥：my_secret_key_123

# 读取整数型变量
db_port = config('DB_PORT', cast=int)
print(f"数据库端口：{db_port}")  # 输出：数据库端口：5432

# 读取浮点型变量
timeout = config('TIMEOUT', cast=float)
print(f"超时时间：{timeout}秒")  # 输出：超时时间：30.5秒

# 读取逗号分隔的列表
allowed_hosts = config('ALLOWED_HOSTS', cast=lambda v: [s.strip() for s in v.split(',')])
print("允许的主机列表：", allowed_hosts)  # 输出：['localhost', '127.0.0.1', 'example.com']

# 读取JSON格式的字典（需先导入json模块）
import json
database_config = config('DB_CONFIG', cast=lambda v: json.loads(v))
# 假设.env中定义：DB_CONFIG={"user":"admin","password":"secret"}
print(f"数据库用户：{database_config['user']}")  # 输出：数据库用户：admin

ENVIRONMENT=development

from decouple import config, Csv

# 获取当前环境
environment = config('ENVIRONMENT', default='development')

# 根据环境读取不同配置
if environment == 'development':
    db_host = config('DEV_DB_HOST', default='localhost')
    db_port = config('DEV_DB_PORT', cast=int, default=5432)
elif environment == 'production':
    db_host = config('PROD_DB_HOST')
    db_port = config('PROD_DB_PORT', cast=int)
else:
    raise ValueError("不支持的环境类型")

print(f"当前环境：{environment}，数据库地址：{db_host}:{db_port}")

from decouple import RepositoryEnv, config

# 指定.env文件路径（如项目根目录下的config目录）
env_path = 'config/.env'
env = RepositoryEnv(env_path)
# 加载配置
env.load()

# 正常读取变量
secret_key = config('SECRET_KEY')

# 示例：将字符串转换为IPv4地址格式
def validate_ip(v):
    import ipaddress
    try:
        ipaddress.IPv4Address(v)
        return v
    except ValueError:
        raise ValueError(f"{v} 不是有效的IPv4地址")

# 使用自定义转换函数
db_ip = config('DB_IP', cast=validate_ip)
print(f"数据库IP：{db_ip}")

from decouple import config
import re

# 校验邮箱格式
email = config('ADMIN_EMAIL')
if not re.match(r'^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+$', email):
    raise ValueError("管理员邮箱格式错误")

print(f"管理员邮箱：{email}")

# 基础配置
DEBUG=True
SECRET_KEY=my_django_secret_key_123
ALLOWED_HOSTS=localhost,127.0.0.1

# 数据库配置（使用PostgreSQL）
DATABASE_URL=postgresql://user:password@localhost:5432/mydb

from pathlib import Path
from decouple import config, Csv

# Build paths inside the project like this: BASE_DIR / 'subdir'.
BASE_DIR = Path(__file__).resolve().parent.parent

# 读取环境变量
DEBUG = config('DEBUG', cast=bool)
SECRET_KEY = config('SECRET_KEY')
ALLOWED_HOSTS = config('ALLOWED_HOSTS', cast=Csv())  # Csv()自动解析为列表

# 数据库配置
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': config('DATABASE_NAME', default='mydb'),  # 从DATABASE_URL中解析或使用默认值
        'USER': config('DATABASE_USER', default='user'),
        'PASSWORD': config('DATABASE_PASSWORD', default='password'),
        'HOST': config('DATABASE_HOST', default='localhost'),
        'PORT': config('DATABASE_PORT', cast=int, default=5432),
    }
}

# 生产环境优化（示例）
if not DEBUG:
    SECURE_SSL_REDIRECT = config('SECURE_SSL_REDIRECT', cast=bool, default=False)
    SESSION_COOKIE_SECURE = True

from urllib.parse import urlparse

def parse_database_url(url):
    parsed = urlparse(url)
    return {
        'ENGINE': 'django.db.backends.postgresql',  # 假设为PostgreSQL，可根据协议调整
        'NAME': parsed.path[1:],
        'USER': parsed.username,
        'PASSWORD': parsed.password,
        'HOST': parsed.hostname,
        'PORT': parsed.port or 5432,
    }

# 在settings.py中使用
DATABASE_URL = config('DATABASE_URL')
DATABASES['default'] = parse_database_url(DATABASE_URL)

export DEBUG=False
export SECRET_KEY=production_secret_key_456
export ALLOWED_HOSTS=example.com
export DATABASE_URL=postgresql://prod_user:prod_password@prod_host:5432/prod_db

project-root/
├── .env                # 开发环境配置（不提交到版本控制）
├── .gitignore          # 包含.env等敏感文件
├── app/                # 应用代码
│   ├── __init__.py
│   ├── settings.py     # 导入python-decouple配置
│   └── ...
├── requirements.txt    # 包含python-decouple依赖
└── scripts/            # 部署脚本（可动态生成环境变量）

  from pydantic import BaseModel
  from decouple import config

  class AppConfig(BaseModel):
      debug: bool
      secret_key: str
      allowed_hosts: list[str]
      db_port: int

  # 读取配置并校验
  config_data = {
      'debug': config('DEBUG', cast=bool),
      'secret_key': config('SECRET_KEY'),
      'allowed_hosts': config('ALLOWED_HOSTS', cast=lambda v: v.split(',')),
      'db_port': config('DB_PORT', cast=int),
  }
  app_config = AppConfig(**config_data)

  version: '3'
  services:
    web:
      build: .
      environment:
        - DEBUG=${DEBUG}
        - SECRET_KEY=${SECRET_KEY}
        - DATABASE_URL=${DATABASE_URL}
      ports:
        - "8000:8000"