telelog-py 0.1.0

Envie logs e alertas para o Telegram em 60s (Python)

telelog-py

Envie logs e alertas para o Telegram em 60 segundos (Python).

Instalação

pip install telelog-py

Uso mínimo

from telelog import send_telegram
send_telegram("job concluído ✅")

Logging

import logging
from telelog import TelegramLogHandler

log = logging.getLogger("myapp")
log.setLevel(logging.INFO)
log.addHandler(TelegramLogHandler())
log.error("falhou", exc_info=True)

Variáveis de ambiente

• TELEGRAM_BOT_TOKEN
• TELEGRAM_CHAT_ID ou TELEGRAM_CHAT_IDS (separados por vírgula)
• TELEGRAM_PARSE_MODE (opcional: MarkdownV2 ou HTML; padrão: texto puro)

CLI

telelog "mensagem"

Códigos de saída:

• 0: sucesso
• 1: falha de envio
• 2: uso incorreto ou configuração ausente

Comportamento

• Truncamento em 4096 caracteres com sufixo ....
• Retries (3), timeout (5s), backoff exponencial base 500ms com jitter ±20%.
• 429: respeita retry_after do Telegram.
• MarkdownV2/HTML: escape automático quando TELEGRAM_PARSE_MODE definido.

Segurança

Nunca commitar .env. Use .env.example como referência e secrets no CI/CD.