✧ Ведём журнал ✧

🚀 Запускаем

Программа тратит смолу и рассказывает, что происходит. Вместо print здесь журнал. Запусти:

import logging
import sys

logging.basicConfig(level=logging.INFO, stream=sys.stdout,
                    format="%(levelname)s: %(message)s")

resin = 60
logging.info("Старт, смолы: %s", resin)
logging.debug("Это видно только на уровне DEBUG")
resin -= 40
logging.info("Потрачено 40, осталось %s", resin)
if resin < 40:
    logging.warning("Смолы мало: %s", resin)
INFO: Старт, смолы: 60
INFO: Потрачено 40, осталось 20
WARNING: Смолы мало: 20

Сообщение про debug не появилось, и это не ошибка. Поменяй в первой строке настройки logging.INFO на logging.DEBUG: теперь выведется и оно. Именно этим журнал лучше print: у каждого сообщения есть важность, и ты одним движением решаешь, что показывать.

📜 Теория: logging

Пять уровней

  • DEBUG — подробности для разработчика: значения переменных, ход вычислений;
  • INFO — обычные события: «программа запущена», «файл прочитан»;
  • WARNING — странно, но работать можно: «смолы мало», «файл настроек не найден, беру по умолчанию»;
  • ERROR — что-то не получилось, функция не выполнена;
  • CRITICAL — программа не может продолжать.

Настройка level=… задаёт порог: показываются сообщения этого уровня и выше. По умолчанию порог — WARNING, поэтому без настройки info и debug молчат.

Настройка: куда и как писать

import logging

logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s %(levelname)s: %(message)s",
    filename="app.log",          # в файл; без этого параметра — в поток ошибок (stderr)
    encoding="utf-8",
)

format — шаблон строки журнала. В нём можно использовать %(levelname)s (уровень), %(message)s (текст), %(asctime)s (время), %(name)s (имя журнала) и другие. Настраивать basicConfig надо один раз, в начале программы, до первой записи. В песочнице мы направляем вывод в sys.stdout, чтобы он попал в результат запуска.

Как передавать значения

logging.info("Потрачено %s, осталось %s", cost, resin)     # так принято
logging.info(f"Потрачено {cost}, осталось {resin}")        # работает, но хуже

Значения принято передавать отдельными аргументами с метками %s: журнал подставит их, только если сообщение действительно будет записано. На отключённом уровне ни время, ни память на сборку строки не тратятся. Для твоих первых программ разницы не заметно, зато так делают в чужом коде, и теперь ты его читаешь без удивления.

Записать ошибку вместе с трассировкой

try:
    cost = int("сорок")
except ValueError:
    logging.exception("Не удалось прочитать трату")

logging.exception вызывают внутри except: она запишет сообщение уровня ERROR и добавит полный текст ошибки с номерами строк. Программа при этом не падает, а в журнале остаётся всё, чтобы потом найти причину.

Как искать ошибки без журнала

Если журнала нет, а программа ведёт себя странно, есть три проверенных приёма:

  • Прочитай сообщение об ошибке снизу вверх. Последняя строка — что случилось, строки выше — где и по какой цепочке вызовов.
  • Выведи подозрительное значение. print(f"{resin=}") покажет и имя, и значение; отлаживать печатью совсем не стыдно.
  • Остановись и посмотри. Вызов breakpoint() в нужном месте открывает встроенный отладчик pdb: в нём можно напечатать переменные, шагать по строкам (n), продолжить (c). Работает на твоём компьютере, в песочнице интерактивного отладчика нет.

🧪 Попробуй сам

★★★

🎯 Задача: Первый журнал

10 очков

Программа читает число n, затем n строк и записывает их в журнал. Обычные строки идут как INFO, а строки, которые начинаются с !, — как WARNING (сам восклицательный знак в сообщение не попадает).

Настрой журнал так, чтобы он писал в sys.stdout в формате УРОВЕНЬ: сообщение, с порогом INFO.

Пример. Ввод:

3
Старт
!Смолы мало
Конец

Вывод:

INFO: Старт
WARNING: Смолы мало
INFO: Конец

Заготовка (кнопка у блока отправит её в песочницу):

import logging
import sys

# 1. Настрой журнал: порог INFO, вывод в sys.stdout, формат «УРОВЕНЬ: сообщение»

# 2. Прочитай n и n строк

# 3. Обычные строки пиши как INFO, начинающиеся с «!» — как WARNING (без знака)
★★★

🎯 Задача: Журнал событий с фильтром

25 очков

Программа получает события в формате уровень текст: debug, info, warning или error и сам текст. Читай число n, затем n событий. Каждое записывай в журнал с соответствующим уровнем. Если слово уровня неизвестно, запиши WARNING с сообщением Неизвестный уровень: <слово>.

Журнал пишет в sys.stdout в формате УРОВЕНЬ: сообщение, порог — INFO, так что debug в вывод не попадает. В конце программа печатает Записей в журнале: <сколько>, то есть сколько строк журнал реально вывел.

Пример. Ввод:

4
info старт
debug детали
error сбой
шум что-то

Вывод:

INFO: старт
ERROR: сбой
WARNING: Неизвестный уровень: шум
Записей в журнале: 3

Заготовка (кнопка у блока отправит её в песочницу):

import logging
import sys

# 1. Настрой журнал: порог INFO, вывод в sys.stdout, формат «УРОВЕНЬ: сообщение»

# 2. Прочитай n и n событий; раздели каждое на слово уровня и текст

# 3. Запиши событие с нужным уровнем (неизвестный уровень — WARNING с пояснением)

# 4. В конце выведи, сколько строк журнал вывел

✅ Что мы узнали

Журнал — это print с важностью: у сообщений есть уровни (DEBUG, INFO, WARNING, ERROR, CRITICAL), а порог и формат задаются один раз через basicConfig. Значения передают аргументами ("…%s", x), ошибки записывают через logging.exception. Когда журнала нет, помогают чтение трассировки снизу вверх, вывод значений и breakpoint().

Остался последний шаг: подготовить рабочее место на своём компьютере.

⟵ Проверяем себя тестами Готовим рабочее место ⟶