telelog-py 0.1.1

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.

Requisitos

• Python >= 3.8

Variáveis de ambiente e .env

• A biblioteca lê um arquivo .env do diretório atual (CWD), se existir.
• Variáveis já definidas no ambiente têm precedência e não são sobrescritas pelo .env.
• Necessárias:
  • TELEGRAM_BOT_TOKEN
  • TELEGRAM_CHAT_ID ou TELEGRAM_CHAT_IDS (múltiplos separados por vírgula)

Autor & Contato

• GitHub: https://github.com/ZarabaDev
• E-mail: [e-mail]
• Site: https://zarabatech.com.br