tglogger is a logger handler and formatter for Telegram bots.
Project description
tglogger
tglogger
contains utilities to build and redirect logs to
Telegram chat via a bot.
Build | Coverage | |
---|---|---|
Master | ||
Development |
Installing
Install via pip
:
pip install tglogger
Example
tglogger
contains a formatter which formats log records for
Telegram chats and a handler which sends log records to a Telegram
chat.
Assuming you have a logger instance:
logger = logging.getLogger(__name__)
You need to have an instance of TelegramHandler
and
TelegramFormatter
.
from tglogger import TelegramHandler, TelegramFormatter
handler = TelegramHandler(bot_token="foo", receiver="bar")
# you can also set TELEGRAM_BOT_TOKEN and TELEGRAM_RECEIVER
# environment variables so as not to pass these on initialization
formatter = TelegramFormatter() # initialize formatter
handler.setFormatter(formatter) # inject formatter into handler
logger.addHandler(handler) # inject handler into logger
And now your log records that has level above ERROR
will be sent
to the chat you have defined with receiver
by the bot that you
have defined by bot_token
.
logger.error("foo") # you will receive a message by your bot
Documentation
Documentation has more information about how to use tglogger
.
Refer to the
documentation.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.