extergram 0.5.1

A simple and convenient library for creating Telegram bots.

Extergram v0.5.0 — Asynchronous Telegram Bot Framework

Extergram is a simple, modern, and fully asynchronous library for creating Telegram bots in Python.

Quick Start

Installation

pip install extergram

Complete Example (main.py)

import asyncio import datetime from extergram import Bot, ButtonsDesign, Message, CallbackQuery, errors from extergram.api_types import BotCommand from extergram.ext import CommandHandler, CallbackQueryHandler, MessageHandler

bot = Bot('YOUR_BOT_TOKEN')

main_menu = ButtonsDesign().add_row( ButtonsDesign.create_button("Show time", "show_time"), ButtonsDesign.create_button("About", "about") ).add_row( ButtonsDesign.create_button("Delete this message", "delete") )

async def start(bot_instance: Bot, message: Message): user_name = message.from_user.first_name await bot_instance.send_message( chat_id=message.chat.id, text=f"Hello, {user_name}! I am running on Extergram v0.5.0.", reply_markup=main_menu )

async def handle_callbacks(bot_instance: Bot, callback: CallbackQuery): await bot_instance.answer_callback_query(callback.id)

if callback.data == 'show_time':
    now = datetime.datetime.now().strftime("%H:%M:%S")
    await bot_instance.edit_message_text(
        chat_id=callback.message.chat.id,
        message_id=callback.message.message_id,
        text=f"The current time is: {now}",
        reply_markup=main_menu
    )
elif callback.data == 'delete':
    try:
        await bot_instance.delete_message(callback.message.chat.id, callback.message.message_id)
    except errors.BadRequestError:
        await bot_instance.answer_callback_query(callback.id, "Error: Message too old.", show_alert=True)

async def main(): bot.add_handler(CommandHandler("start", start)) bot.add_handler(CallbackQueryHandler(handle_callbacks))

print("Bot is polling...")
bot.polling()

if name == 'main': try: asyncio.run(main()) except KeyboardInterrupt: pass

Features & Core Concepts

• Fully Async: High-performance non-blocking operations using httpx.
• Handler System: Manage updates with CommandHandler, MessageHandler, and CallbackQueryHandler.
• Type Hinting: Comprehensive api_types for better IDE support.
• Error Handling:
  • errors.NetworkError: Connection issues.
  • errors.BadRequestError: Invalid API requests.
  • errors.ForbiddenError: Bot blocked by user.
  • errors.UnauthorizedError: Invalid token.

Local Documentation

You can access the full documentation directly from your terminal: from extergram import Docs Docs.print_docs()

License

MIT License. Copyright (c) 2024-2025.