Руководство по переменным окружения для администратора

Пример 1: Загрузка окружения в зависимости от режима (development/production)

Использование разных .env файлов для разных сред. Файлы .env.development, .env.production. Загрузка с переменной окружения ENV.

import os
from dotenv import load_dotenv

env_mode = os.getenv('ENV', 'development')
env_file = f'.env.{env_mode}'

if not load_dotenv(env_file):
    print(f'Предупреждение: файл {env_file} не найден')
    # fallback на .env
    load_dotenv('.env')

# Теперь переменные из соответствующего файла загружены
print(os.getenv('DATABASE_URL'))

# При запуске с ENV=production
# postgresql://prod_user:prod_pass@prod_host/db

Пример 2: Чтение Docker secrets через переменные окружения

Docker монтирует секреты как файлы в /run/secrets/. Можно прочитать их и записать в os.environ для использования приложением.

import os

def load_docker_secrets(secrets_dir='/run/secrets'):
    if not os.path.isdir(secrets_dir):
        return
    for secret_file in os.listdir(secrets_dir):
        secret_path = os.path.join(secrets_dir, secret_file)
        with open(secret_path, 'r') as f:
            value = f.read().strip()
        os.environ[secret_file.upper()] = value

load_docker_secrets()
# Теперь os.getenv('DB_PASSWORD') вернёт содержимое файла /run/secrets/db_password

Пример 3: Переопределение системных переменных с python-dotenv

По умолчанию dotenv не перезаписывает существующие переменные. Пример принудительной перезаписи.

# .env
MY_VAR=from_dotenv

import os
os.environ['MY_VAR'] = 'from_system'

from dotenv import load_dotenv
load_dotenv(override=True)  # перезаписать системные значениями из .env

print(os.getenv('MY_VAR'))  # from_dotenv

from_dotenv

Пример 4: Валидация с Pydantic и несколько источников

Модель может читать как из .env, так и из переменных окружения. Показывает, как обрабатывать ошибки валидации.

from pydantic_settings import BaseSettings, SettingsConfigDict
from pydantic import ValidationError

class DatabaseSettings(BaseSettings):
    model_config = SettingsConfigDict(env_prefix='DB_', env_file='.env')

    host: str = 'localhost'
    port: int = 5432
    user: str
    password: str

try:
    db_settings = DatabaseSettings()
except ValidationError as e:
    print(f'Ошибка в конфигурации: {e}')
    exit(1)

print(f'Connecting to {db_settings.user}@{db_settings.host}:{db_settings.port}')

# Если переменная DB_USER не задана
# Ошибка в конфигурации: 1 validation error for DatabaseSettings
# user: field required (type=value_error.missing)

Пример 5: Передача переменных окружения в подпроцесс

При запуске внешней программы через subprocess можно передать изменённое окружение.

import subprocess
import os

# Создаём новое окружение с дополнительными переменными
env = os.environ.copy()
env['MY_ENV_VAR'] = 'custom_value'

# Запускаем скрипт, который выводит переменную
result = subprocess.run(
    ['python', '-c', 'import os; print(os.getenv("MY_ENV_VAR"))'],
    capture_output=True,
    text=True,
    env=env
)
print(result.stdout)  # custom_value

custom_value

Пример 6: Использование os.environ для временной установки переменной в тестах

В модульных тестах часто нужно временно изменить переменную окружения. Для этого применяется контекстный менеджер unittest.mock.patch.dict.

import os
from unittest.mock import patch

def test_my_function():
    with patch.dict(os.environ, {'MY_VAR': 'test_value'}):
        # внутри блока MY_VAR = test_value
        assert os.getenv('MY_VAR') == 'test_value'
    # после выхода восстанавливается исходное значение

# Тест проходит