Программа курса Урок 46 из 250 · Файлы, ошибки и модули
Файлы, ошибки и модули

Конфигурация и секреты

Реальным программам нужны настройки, которые не должны не находиться в коде: API ключи, URL базы данных, флаг отладки. Есть две причины держать их отдельно. Во-первых, секреты в исходном коде утекают: как только вы фиксируете API ключ в git, он остается в истории навсегда, а отправка в публичный репозиторий передает его всему миру. Во-вторых, один и тот же код должен работать в разных местах (ваш ноутбук, сервер) с разными настройками.

Стандартный ответ - переменные окружения: именованные значения, которые операционная система передает вашему процессу. Python читает их из os.environ, который ведет себя как словарь:

import os
key = os.environ["API_KEY"]              # raises KeyError if missing
debug = os.environ.get("DEBUG", "off")   # a safe default instead

В разработке вы храните их в .env файле который вы никогда не коммитите (вы добавляете .env в .gitignore). Это просто KEY=value строки:

API_KEY=sk-abc123
# a comment
MODEL=claude-opus-5-5
DEBUG=on

Библиотеки вроде python-dotenv загружают этот файл в os.environ за вас. Под капотом они разбирают именно такие строки. В этом упражнении вы сами напишете такой разборщик, а также помощника, который скрывает секрет, чтобы его можно было безопасно напечатать в лог.

Золотое правило: читайте секреты из окружения, логируйте их в скрытом виде и никогда не вшивайте их в код.

Твоя очередь

Создайте три помощника. (1) load_env(text) парсит содержимое файла .env в словарь. Пропускайте пустые строки и строки с комментариями (начинающиеся с #). Разделите каждую оставшуюся строку по первому =. Удалите пробелы по краям и удалите одну пару окружающих кавычек у значения, если они есть. Оставляйте строку только если ключ является валидным именем окружения: все заглавные буквы и валидный Python идентификатор (буквы, цифры и подчеркивания, не начинающийся с цифры). (2) get_setting(env, key, default=None) возвращает env[key], если он есть, иначе default. (3) redact(value) возвращает безопасную для логов строку, показывающую только последние 4 символа, например redact("sk-abc123") это "****c123"; значения из 4 символов или меньше становятся "****".

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.