tgbot-logging 0.1.0

A Python logging handler that sends log messages to Telegram chats

TGBot-Logging

A Python logging handler that sends log messages to Telegram chats.

Features

• Send log messages to one or multiple Telegram chats
• Support for HTML and MarkdownV2 formatting
• Message batching for better performance
• Automatic retries for failed messages
• Customizable log format
• Environment variables support

Quick Start

1. Install the package:

pip install tgbot-logging

2. Basic usage:

import logging
from tgbot_logging import TelegramHandler

# Create logger
logger = logging.getLogger('MyApp')
logger.setLevel(logging.DEBUG)

# Create TelegramHandler
telegram_handler = TelegramHandler(
    token='YOUR_BOT_TOKEN',
    chat_ids=['YOUR_CHAT_ID'],
    level=logging.INFO
)

# Add handler to logger
logger.addHandler(telegram_handler)

# Example usage
logger.info('This is an info message')

Documentation

Full documentation is available at tgbot-logging.readthedocs.io, including:

• Detailed installation instructions
• Configuration options
• Advanced usage examples
• API reference
• Development guide

Development Installation

For development with testing tools and code formatting:

pip install -e ".[dev]"
# or
pip install -r requirements-dev.txt

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• Documentation
• GitHub Issues
• PyPI Project