система логирования для разработчиков

[iAmScienceMan]

что это

система логов для разработчиков (не дискорд-логи юзеров) с уровнями debug / info / warning / error.

что внутри

• services/logger.py — централизованная настройка корневого логгера: уровень из LOG_LEVEL, цветной вывод в консоль (только в tty), глушение болтливых логгеров discord.py. warn принимается как синоним warning, кривой уровень не роняет запуск.
• services/discord_log.py — дублирование логов эмбедами в дискан через вебхук, который бот заводит сам (url не живёт в окружении). emit не блокирует: кладёт запись в очередь, фоновый воркер постит. цвет эмбеда по уровню, error и выше пингуют ответственного. фильтр режет записи discord.* и самого модуля, чтобы не было цикла.
• cogs/dev.py — команда /logtest (только для админов) для проверки логирования по уровням.
• настройки в config.py: LOG_LEVEL, LOG_CHANNEL_ID, DISCORD_LOG_LEVEL (по умолчанию warning), LOG_PING_USER_ID.

заметки

• самые ранние логи (до setup_hook) идут только в консоль, в дискан не попадают.
• хендлер не закрывается явно при выключении бота. на обычном завершении некритично.

проверка

122 теста зелёные, ruff и mypy чистые.

[codecov]

Codecov Report

❌ Patch coverage is 86.55172% with 39 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
bot.py	19.04%	17 Missing ⚠️
cogs/dev.py	53.12%	15 Missing ⚠️
services/discord_log.py	92.30%	5 Missing ⚠️
services/logger.py	95.65%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!