Skip to main content

An Elegant Modern Bot Framework for Python

Project description

Telegant

Telegant

Telegant is an elegant modern bot framework for Python, designed to provide developers with simple and elegant access to the Telegram bot API. The project is currently at the alpha testing stage and provides only the required basic features to prove the concept of simplicity.

Installation

To install the project, simply run:

pip install telegant

Example

from telegant import Telegant
import asyncio

bot = Telegant("YOUR_BOT_TOKEN_HERE")

@bot.hears("hello")
async def say_hello(bot, update): 
    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": "What's up?"
        }
    )

#Your code here (Recommended to write your functions in order)

asyncio.run(bot.start_polling())

Usage

On text

If you need your bot to respond to specified text just use @bot.hears()

@bot.hears("hello")
async def say_hello(bot, update): 
    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": "What's up?"
        }
    )

Sending bot with buttons

Inline buttons example

@bot.hears("hello")
async def say_hello(bot, update): 
 
    buttons = [
        {"text": "Option 1 (inline)", "data": "option1"},  
    ]

    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": "What's up?",
            "reply_markup": bot.create_reply_markup(buttons)
        }
    )

Reply buttons example

@bot.hears("hello")
async def say_hello(bot, update): 
 
    buttons = [
        {"text": "Option 1 (reply)"},  
    ]

    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": "What's up?",
            "reply_markup": bot.create_reply_markup(buttons)
        }
    )

Bot always detects your buttons type automatically by data key. If you want to use inline buttons you have to write text and data values for each button. As it is detects your inline button when you have "data" key in your button. Otherwise, it will detect as reply keyboard.

Commands

You can assign to one function one command or many commands as needed. For single command use @bot.command() decorator.

@bot.command("start")
async def say_hello(bot, update):  
    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": "Sup I'm start"
        }
    )

For several commands use @bot.commands() decorator.

@bot.commands(['help', 'ask'])
async def say_hello(bot, update):  
    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": "You've reached for help"
        }
    )

Export data after command by your keys

@bot.commands(['usernameandage'])
@bot.with_args(['username', 'age'])
async def handler(bot, update, data): 
    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": f"Hello {data['username']}, you are {data['age']} years old."
        }
    )

Callbacks

Telegant also offers to you simply detect your callbacks where you able to assign many or one callback to your function

Many callbacks example

@bot.callbacks('option1', 'option2')
async def say_hello(bot, update):  
    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": "Callbacks are perfect!"
        }
    )

Single callback example

@bot.callback('option1')
async def say_hello(bot, update):  
    await bot.sendMessage(
        {
            "chat_id": update["message"]["chat"]["id"],
            "text": "Callback is perfect"
        }
    )

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Telegant-0.1.3.tar.gz (5.4 kB view hashes)

Uploaded Source

Built Distribution

Telegant-0.1.3-py3-none-any.whl (6.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page