Skip to content
tglogger contains utilities to build and redirect logs to Telegram chat via a bot.
Python
Branch: development
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

tglogger

PyPI PyPI PyPI PyPI - Django Version PyPI Telegram Code Style

tglogger contains utilities to build and redirect logs to Telegram chat via a bot.

Build Coverage
Master Travis (.com) master Codecov (master)
Development Travis (.com) development Codecov (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.

You can’t perform that action at this time.