Repolode
Предложить
Delgan

Delgan/loguru

Библиотека логирования для Python, которая заменяет настройку стандартного logging единым логгером, ротацией файлов, цветным выводом и структурированными логами.

Открыть на GitHubСайт
Звёзды
24,153
Форки
828
Открытые issues
261
Последний коммит
6 дней назад

Что это?

Loguru — библиотека логирования для Python, призванная избавить от шаблонного кода при работе со стандартным модулем logging. Она предоставляет один предварительно настроенный логгер, который сразу пишет в stderr, поэтому начать логирование можно с одного импорта. Дополнительные приёмники, форматы, фильтры и уровни настраиваются одной функцией add().

Логирование в файлы поддерживает ротацию по размеру, времени или сроку хранения, очистку старых файлов и сжатие при закрытии. Библиотека также предлагает форматирование строк с фигурными скобками, цветной вывод, трассировки исключений со значениями переменных, а также потокобезопасные приёмники и приёмники с очередью, безопасные для многопроцессного использования. Контекст можно добавить с помощью bind() или contextualize(), а сообщения — сериализовать в JSON.

В Loguru есть вспомогательные средства совместимости со стандартным logging: они позволяют направлять существующие объекты logging.Handler в приёмники Loguru или передавать сообщения Loguru обратно в стандартный модуль. Библиотека поддерживает Python 3.5 и новее, а также PyPy.

Ключевые возможности

  • 01Предварительно настроенный логгер, работающий без дополнительной настройки
  • 02Единая функция add() для управления приёмниками, форматами, фильтрами и уровнями
  • 03Настройки ротации, хранения и сжатия файлов
  • 04Цветной вывод в терминал и полные трассировки исключений со значениями переменных
  • 05Потокобезопасные приёмники и многопроцессное логирование с безопасной работой через очередь
  • 06Интеграция со стандартным модулем logging для передачи сообщений в обе стороны

Сценарии использования

  • Добавление логирования в скрипт Python без настройки логгера
  • Запись логов в файлы с ротацией и сжатием для долго работающих сервисов
  • Перехват исключений в потоках, чтобы они попадали в логи
  • Настройка библиотеки Python так, чтобы по умолчанию она не выводила логи, но позволяла приложению включать их

Быстрый старт

  1. 1

    Установите loguru из PyPI

    pip install loguru
  2. 2

    Импортируйте готовый к использованию логгер и запишите сообщение в лог

В подборках

OpenTelemetry и платформы наблюдаемости

Темы

#logging#python#logger#log-rotation#structured-logging#debugging#log

Частые вопросы

Что такое loguru?
Библиотека логирования для Python, которая заменяет настройку стандартного logging единым логгером, ротацией файлов, цветным выводом и структурированными логами. Loguru — библиотека логирования для Python, призванная избавить от шаблонного кода при работе со стандартным модулем logging. Она предоставляет один предварительно настроенный логгер, который сразу пишет в stderr, поэтому начать логирование можно с одного импорта. Дополнительные приёмники, форматы, фильтры и уровни настраиваются одной функцией add().
loguru можно использовать бесплатно? Какая у него лицензия?
loguru распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
loguru всё ещё поддерживается?
Активно поддерживается. Последний коммит в loguru — 18 окт. 2026 г..
Для чего можно использовать loguru?
Добавление логирования в скрипт Python без настройки логгера Запись логов в файлы с ротацией и сжатием для долго работающих сервисов Перехват исключений в потоках, чтобы они попадали в логи Настройка библиотеки Python так, чтобы по умолчанию она не выводила логи, но позволяла приложению включать их
Как установить loguru?
Установите loguru из PyPI: pip install loguru Импортируйте готовый к использованию логгер и запишите сообщение в лог
Где скачать loguru?
Исходный код и инструкции по установке — на GitHub: https://github.com/Delgan/loguru

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты