Rate-limited Telegram notifications with priority queue
Project description
tg-notify
CMDOP Skill — install and use via CMDOP agent:
cmdop-skill install tg-notify
Rate-limited Telegram notifications with priority queue.
Install
pip install tg-notify
Quick Start
export TELEGRAM_BOT_TOKEN="your-bot-token"
export TELEGRAM_CHAT_ID="-1001234567890"
from tg_notify import send_telegram_message
send_telegram_message("Hello from tg-notify!")
Shortcuts
from tg_notify import send_error, send_success, send_warning, send_info, send_stats, send_alert
send_error("DB connection failed", {"host": "db.example.com"})
send_success("Deploy complete", {"version": "1.2.3"})
send_warning("Disk usage high", {"usage": "89%"})
send_info("New user registered", {"email": "user@example.com"})
send_stats("Daily Report", {"users": 1500, "revenue": "$3200"})
send_alert("Server down!", {"server": "prod-1"})
TelegramSender
from tg_notify import TelegramSender
sender = TelegramSender(bot_token="your-token", chat_id=-123456)
sender.send_message("Hello!")
sender.send_photo("chart.png", caption="Daily stats")
sender.send_document("report.pdf")
Priority Queue
Messages are queued with 4 priority levels and rate-limited to 20 msg/sec:
| Priority | Use case |
|---|---|
CRITICAL (1) |
Security alerts, system down |
HIGH (2) |
Errors, important warnings |
NORMAL (3) |
Info, success messages |
LOW (4) |
Stats, debug |
Auto-cleanup drops low-priority messages when queue fills up.
from tg_notify import telegram_queue
# Flush before exit (CLI scripts)
telegram_queue.flush(timeout=5)
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
tg_notify-0.1.7.tar.gz
(10.2 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
tg_notify-0.1.7-py3-none-any.whl
(12.9 kB
view details)
File details
Details for the file tg_notify-0.1.7.tar.gz.
File metadata
- Download URL: tg_notify-0.1.7.tar.gz
- Upload date:
- Size: 10.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fca64117ba32dc55263419ffb3bfdb8d228467839bbf4505e71962b2b0a433a2
|
|
| MD5 |
baed0254983eb5879485ba7657b08bbb
|
|
| BLAKE2b-256 |
428705c94d9c12332224121fab0cd7b430fcc28fdeead05a34369f2201a750d2
|
File details
Details for the file tg_notify-0.1.7-py3-none-any.whl.
File metadata
- Download URL: tg_notify-0.1.7-py3-none-any.whl
- Upload date:
- Size: 12.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ad1eaf607d48c55fcf38bf9d7e96a0983d29274f8b30a859d98e4d5a30f5e4e5
|
|
| MD5 |
b9d0e2b157d15d09688cf3987b9e40f0
|
|
| BLAKE2b-256 |
4eba929282a877fbf60c1bc56152b52493d248fbed6536dd20c946b2d5d86495
|
