Без точного названия сложно понять, для чего нужен токен. Речь идёт одновременно и про переменные в коде, и про переменные окружения. А если, например, API поддерживает несколько видов токенов, то, тем более, в названии каждого из них необходимо указать специфический тип.


Пример 1

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

Плохо:


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')

Хорошо:


from environs import Env


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


Пример 2

Плохо:


from environs import Env


def main():
    env = Env()
    env.read_env()
    chat_id = env.str('CHAT_ID')

Допустимо:


from environs import Env


def main():
    env = Env()
    env.read_env()
    chat_id = env.str('TG_CHAT_ID')

Хорошо:


from environs import Env


def main():
    env = Env()
    env.read_env()
    tg_chat_id = env.str('TG_CHAT_ID')