Convenience tools and wrappers for aiogram
Project description
aiokilogram
Convenience tools and wrappers for aiogram
,
the asynchronous Telegram Bot API framework.
Installation
pip install aiokilogram
Basic Examples
Class-Based Command Handlers
The aiokilogram
toolkit is centered around the notion of class-based
command handlers. Basically this means that you can group several commands
as methods in a class and assign them to message and callback patterns
at class level.
Handler classes look something like this:
from aiokilogram.handler import CommandHandler
class TestCommandHandler(CommandHandler):
async def test_handler(self, event) -> None:
await self.send_text(user_id=event.from_user.id, text=f'This is a test reply')
# other related commands go here
def register(self, dispatcher) -> None:
dispatcher.register_message_handler(self.test_handler, commands={'hello'})
# register other commands here
The whole bot application will then be run like this:
import asyncio
import os
from aiokilogram.bot import KiloBot
from aiokilogram.settings import BaseGlobalSettings
class TestBot(KiloBot):
def register(self, bot, dispatcher) -> None:
TestCommandHandler(global_settings=self._global_settings, bot=bot).register(dispatcher)
# other command handlers can be added here
def run_bot():
bot = TestBot(global_settings=BaseGlobalSettings(
tg_bot_token=os.environ['TG_BOT_TOKEN']
))
asyncio.run(bot.run())
if __name__ == '__main__':
run_bot()
For more info you can take a look at a simple boilerplate bot
Set the TG_BOT_TOKEN
env variable to run it.
Action Buttons
The package also provides a simplified mechanism of using buttons and binding handlers to their callbacks. This is useful when you want your buttons to contain a combination of several parameters and don't want to implement their serialization, deserialization and callback bindings each time.
The idea is simple.
- Define an action (a
CallbackAction
subclass) using a combination of fields:
from enum import Enum
from aiokilogram.action import CallbackAction, StringActionField, EnumActionField
class ActionType(Enum):
show_recipe = 'show_recipe'
like_recipe = 'like_recipe'
class SingleRecipeAction(CallbackAction):
action_type = EnumActionField(enum_cls=ActionType)
recipe_title = StringActionField()
- Create a page containing action buttons:
from aiokilogram.page import ActionMessageButton, MessagePage, MessageBody, MessageKeyboard
page = MessagePage(
body=MessageBody(text='Main Recipe Menu'),
keyboard=MessageKeyboard(buttons=[
ActionMessageButton(
text='Button Text',
action=SingleRecipeAction(
action_type=ActionType.show_recipe,
recipe_title='Fantastic Menemen',
),
),
# ...
])
)
- Send it as a response to some command in your handler class:
await self.send_message_page(user_id=event.from_user.id, page=page)
- Define a handler method for this action where you deserialize the action parameters and somehow use them in your logic:
async def do_single_recipe_action(self, query: types.CallbackQuery) -> None:
action = SingleRecipeAction.deserialize(query.data)
if 'soup' in action.recipe_title.lower():
do_soup_stuff() # whatever
# ...
- Bind this method to the action class in the
register
method of the handler class:
dispatcher.register_callback_query_handler(
self.do_single_recipe_action, action=SingleRecipeAction,
)
or you can be more precise and limit the binding to specific values of the action's fields:
dispatcher.register_callback_query_handler(
self.do_single_recipe_action,
action=SingleRecipeAction.when(action_type=ActionType.like_recipe),
)
See boilerplate bot with buttons
Set the TG_BOT_TOKEN
env variable to run it.
Links
Homepage on GitHub: https://github.com/altvod/aiokilogram
Project's page on PyPi: https://pypi.org/project/aiokilogram/
aiogram
's homepage on GitHub: https://github.com/aiogram/aiogram
Telegram Bot API: https://core.telegram.org/bots/api
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aiokilogram-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 321bf38c7c096df90f6371fdd858170fea1b6795afc86a3b00a1d6b428197a3f |
|
MD5 | feb564aae3879b1fe306dcb3de09fe4a |
|
BLAKE2b-256 | bfede1fdae6e3cdd73a6322704a9cf14c3cea0dcd1d193a048e6626c51e3b781 |