Об этом проекте

Loguru — это библиотека логирования для Python, разработанная для устранения сложности традиционных настроек логирования. Она предоставляет один предварительно настроенный логгер, доступный через `from loguru import logger`, который не требует обработчиков (handlers), форматеров или фильтров для начала работы. Сообщения логов можно записывать немедленно, используя такие методы, как `logger.debug()` или `logger.info()`, при этом по умолчанию вывод направляется в stderr. Ключевые особенности включают: простое логирование в файлы с автоматической ротацией (по размеру, времени или возрасту), политики хранения и сжатие; современное форматирование строк в стиле фигурных скобок, совместимое с `str.format()`; автоматическую раскраску в терминалах; поддержку асинхронного, потокобезопасного и многопроцессорного логирования через `enqueue=True`; а также полное отображение трассировки исключений, включая значения переменных. Библиотека поддерживает структурированное логирование через сериализацию JSON и контекстную привязку (`bind()`, `contextualize()`, `patch()`). Пользователи могут настраивать уровни, добавлять ленивые вычисления для ресурсоемких функций и интегрироваться со стандартным логированием Python через слои совместимости. Переменные окружения позволяют персонализировать такие значения по умолчанию, как формат или цвет. Loguru также включает парсер для извлечения логов на основе регулярных выражений и интегрируется с инструментами уведомлений, такими как Apprise, для оповещения об ошибках. Разработанная как для скриптов, так и для библиотек, она позволяет отключать/включать логирование для каждого пространства имен модуля. Хотя ранее заявлялось о 10-кратном преимуществе в скорости по сравнению со встроенным логированием, это утверждение теперь считается устаревшим. Библиотека делает упор на удобство использования, конфигурируемость и возможности отладки без ущерба для производительности или гибкости.