No project description provided
Project description
Telegram Exception Alerts
THIS LIBRARY HAS BEEN EXTENSIVELY TESTED AND IS CONSIDERED VERY STABLE: IT WORKS FINE AND HAS NO EXTERNAL DEPENDENCIES. SO NO FUTURE UPDATES ARE EXPECTED UNLESS I HAVE SOME VERY BRIGHT IDEA ABOUT IT.
A very lightweight library for sending exception details to Telegram using a decorator. It uses no external dependencies.
Installation
pip install telegram-exception-alerts
or
poetry add telegram-exception-alerts
Usage
After you initialize the alerter instance you can attach the decorator to any function. If it
raises an exception information will be send to the chat specified in chat_id
(don't forget
that if you want to send notification to a channel you need to prepend that chat_id
with -100
).
Normal initialization
from telegram_exception_alerts import Alerter
tg_alert = Alerter(bot_token='YOUR_BOT_TOKEN', chat_id='YOUR_CHAT_ID')
@tg_alert
def some_func_that_can_raise_an_exception():
raise RuntimeError('this is an exception')
Initialization from environment (recommended)
You can also initialize the alerter from environment variables. This is the recommended way because it will make sure you're not committing sensitive information to the repo.
ALERT_BOT_TOKEN
- your bot tokenALERT_CHAT_ID
- your chat id to receive notifications
from telegram_exception_alerts import Alerter
tg_alert = Alerter.from_environment()
@tg_alert
def some_func_that_can_raise_an_exception():
raise RuntimeError('this is an exception')
Here's what a telegram message from an example above looks like:
Sending messages
You can also use the Alerter
as a simple way to send messages to Telegram:
from telegram_exception_alerts import Alerter
tg_alert = Alerter.from_environment()
tg_alert.send_message(chat_id=111222333, text='Message text')
For real bot programming I highly recommend the excellent python-telegram-bot library.
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.
Source Distribution
Built Distribution
Hashes for telegram_exception_alerts-1.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3e352fa402a06617d1620b48b2a7cccb5e75004f3e28707eec2ee907416557e1 |
|
MD5 | ed6cd0728d6b4e8077cc3c6010b079f4 |
|
BLAKE2b-256 | bc13ec59278cc9b6c806ee6d1050151532ee6dca06c2bf839ab8b25facfe54f6 |
Hashes for telegram_exception_alerts-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1710fd170f473dae933454de202c04e1b5bf9c74d961389c16412a4207be5574 |
|
MD5 | ebd522810206d38f2ad36fe39960c536 |
|
BLAKE2b-256 | ac91312095a1ef9d3ff41b64d264ffd357f2bc4e161cc19cc265e4bb81c5bc45 |