Skip to main content

No project description provided

Project description

Telegram Exception Alerts

Code style: black PyPI PyPI - Python Version PyPI - Wheel PyPI - Downloads

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 token
  • ALERT_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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

telegram_exception_alerts-1.0.1.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file telegram_exception_alerts-1.0.1.tar.gz.

File metadata

  • Download URL: telegram_exception_alerts-1.0.1.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.5 CPython/3.7.10 Linux/5.4.0-1041-azure

File hashes

Hashes for telegram_exception_alerts-1.0.1.tar.gz
Algorithm Hash digest
SHA256 3e352fa402a06617d1620b48b2a7cccb5e75004f3e28707eec2ee907416557e1
MD5 ed6cd0728d6b4e8077cc3c6010b079f4
BLAKE2b-256 bc13ec59278cc9b6c806ee6d1050151532ee6dca06c2bf839ab8b25facfe54f6

See more details on using hashes here.

File details

Details for the file telegram_exception_alerts-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for telegram_exception_alerts-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1710fd170f473dae933454de202c04e1b5bf9c74d961389c16412a4207be5574
MD5 ebd522810206d38f2ad36fe39960c536
BLAKE2b-256 ac91312095a1ef9d3ff41b64d264ffd357f2bc4e161cc19cc265e4bb81c5bc45

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page