---

Из названия переменной окружения должно быть ясно, что конкретно в ней лежит и для какой цели она используется.

---

Пример 1¶

В данном случае все переменные относятся к базе данных, значит необходимо добавить специфический информативный префикс.

Плохо:

from environs import Env


env = Env()
env.read_env()


DATABASES = {
    'default': {
        'ENGINE': env.str('ENGINE'),
        'HOST': env.str('HOST'),
        'PORT': env.str('PORT'),
        'NAME': env.str('NAME'),
        'USER': env.str('USER'),
        'PASSWORD': env.str('PASSWORD'),
    }
}

Хорошо:

from environs import Env


env = Env()
env.read_env()


DATABASES = {
    'default': {
        'ENGINE': env.str('DB_ENGINE'),
        'HOST': env.str('DB_HOST'),
        'PORT': env.str('DB_PORT'),
        'NAME': env.str('DB_NAME'),
        'USER': env.str('DB_USER'),
        'PASSWORD': env.str('DB_PASSWORD'),
    }
}

---

Пример 2¶

Переменная окружения всегда должна называться специфично, чтобы помочь тому, кто решит поменять её значение.

Плохо:

from environs import Env


def main():
    env = Env()
    env.read_env()
    token = env.str('TOKEN')

Хорошо:

from environs import Env


def main():
    env = Env()
    env.read_env()
    token = env.str('YANDEX_GEOCODER_TOKEN')