Mehta

A beginner-friendly telegram sdk providing intuitive command decorators.
This package is a wrapper that uses pyTeleBot and Telethon for Telegram-related features.
When you install it, all required dependencies including pyTeleBot, Telethon, and others are automatically installed to ensure full functionality and seamless integration.

Installation

pip install mehta

Basic Setup

from mehta import telegram

bot = telegram()

@bot.commands(['start'])
def start(message):
    return "Hello! Bot started."

@bot.message()
def echo(message):
    return f"Echo: {message.text}"

bot.run("YOUR_BOT_TOKEN")

Auto-injection: Helper functions (text, photo, etc.) are imported as globals for you automatically when you create a bot/client instance and works without prefixes.
Error handling: For both pyTelebot and Telethon, errors are printed nicely by default.
CLI: mehta run:yourfile.py, auto detects main bot and starts automatically.
Rate limits: Use rate_limit in command decorators for anti-spam.
Timeout: Force handlers to exit after N seconds if unresponsive.

Decorators Reference

Decorator	Parameters	Use Case
`@bot.commands`	`commandlist`, `rate_limit=None`, `timeout=None`	Bind handler to Telegram commands
`@bot.message`	None	Handles all non-command messages
`@bot.callback`	None	Handles callback queries (inlines)
`@bot.error`	None	Handles errors for all handlers

Example:

@bot.commands(['hi', 'hello'], rate_limit=1, timeout=3)
def hi(message):
    return text("Hi, rate limit 1/min, timeout 3s!")

command([""]): list of commands
rate_limit: int, calls/user/min
timeout: int, seconds for auto-timeout

Text and Media Messages

Function	Parameters	Use Case
text	content, parse, receiver, reply_to, preview, notify	Send plain text
photo	file, caption, parse, receiver, reply_to, notify	Send image/photo
video	file, caption, parse, receiver, reply_to, notify	Send video
audio	file, caption, parse, receiver, reply_to, notify	Send audio
document	file, caption, parse, receiver, reply_to, notify	Send document
sticker	file, receiver, reply_to, notify	Send sticker
voice	file, caption, parse, receiver, reply_to, notify	Send voice message
animation	file, caption, parse, receiver, reply_to, notify	Send GIF/animation
mediagroup	media_list, receiver, reply_to, notify	Send multiple media items

Location and Interaction

Function	Parameters	Use Case
location	lat, lon, receiver, reply_to, notify	Send location
venue	lat, lon, title, address, receiver, reply_to, notify	Send venue
contact	phone, first_name, last_name, receiver, reply_to, notify	Send contact
poll	question, options, receiver, reply_to, notify	Send Telegram poll
dice	emoji, receiver, reply_to, notify	Send dice animation

Message Management

Function	Parameters	Use Case
delete	message_id, receiver	Delete a specific message
edit	message_id, text, parse, receiver, preview	Edit an existing text or caption
forward	to_chat, message_id, receiver, notify	Forward message to another chat
copy	to_chat, message_id, caption, parse, receiver, notify	Copy a message
pin	message_id, receiver, notify	Pin message in chat
unpin	message_id, receiver	Unpin one message
unpin_all	receiver	Unpin all messages

Chat Control and Moderation

Function	Parameters	Use Case
ban	user_id, until_date, receiver	Ban a user
unban	user_id, receiver	Unban a user
restrict	user_id, permissions, until_date, receiver	Restrict user permissions
promote	user_id, privileges, receiver	Promote member with privileges
chat_info	receiver	Get chat information
member_count	receiver	Get total members
member_info	user_id, receiver	Get info about specific user
invite_link	receiver	Generate chat invite link

Chat Configuration

Function	Parameters	Use Case
set_title	title, receiver	Set chat title
set_description	description, receiver	Set chat description
set_photo	file, receiver	Set chat photo
delete_photo	receiver	Delete chat photo

Inline and Keyboard Components

Function	Parameters	Use Case
keyboard	text, buttons, parse, receiver, reply_to, preview, notify	Send reply keyboard
inline	text, buttons, parse, receiver, reply_to, preview, notify	Inline buttons with callback data
remove_keyboard	text, parse, receiver, reply_to, preview, notify	Hide keyboard
force_reply	text, parse, receiver, reply_to, preview, notify	Force user reply
edit_message	message_id, text, parse, receiver, preview, buttons, caption, reply_markup	Edit message with buttons
answer_callback	query_id, text, show_alert, url	Answer callback query (inline button)

Response Types

Text Message

return text(
    content="Hello World",
    parse="HTML",
    receiver=message.chat.id,
    reply_to=message.message_id,
    preview=False,
    notify=False
)

Optional: parse, receiver, reply_to, preview, notify