Roboto

A type-hinted async Telegram bot library, supporting trio, curio and asyncio.

Roboto's API is not perfectly stable nor complete yet. It will be kept a 0.x.0 until the Telegram Bot API is completely implemented, and will be bumped to 1.0.0 when it is complete.

Basic usage

Roboto is still a low-level bot API, meaning it does not provide much abstraction over the Bot API yet (that is planned, though).

Currently, a basic echo bot with roboto looks like:

from roboto import Token, BotAPI
from trio import run  # This could be asyncio or curio as well!


api_token = Token('your-bot-token')


async def main() -> None:
    async with BotAPI.make(api_token) as bot:
        offset = 0

        while True:
            updates = await bot.get_updates(offset)

            for update in updates:
                if update.message is not None and update.message.text is not None:
                    await bot.send_message(
                        update.message.chat.id,
                        update.message.text,
                    )

            if updates:
                offset = updates[-1].update_id + 1


# In asyncio it should be "main()".
run(main)

Being statically-typed, Roboto supports easy autocompletion and mypy static checking.

Contributing

Check our contributing guide to know how to develop on Roboto and contribute to our project.

Goals

Principles

• Ease of static checking for client code, especially static typing.
• Forwards compatibility (additions to the bot HTTP API should not break older versions of Roboto easily).

Achieved milestones

• Support for other async runtimes other than asyncio (especially trio) (done in v0.2.0).

Next milestones

• All functions under Available methods in the documentation (0.3.0).
• All functions under Updating messages in the documentation (0.4.0).
• All functions under Stickers in the documentation (0.5.0).
• Inline mode functionality (0.6.0).
• Payments functionality (0.7.0).
• Telegram Passport functionality (0.8.0).
• Games functionality (0.9.0).
• Tests for all bot API functions in bot_tester.
• API cleanup/streamlining (e.g. use kw-only arguments in bot methods) (1.0.0).
• High-level API (abstraction for command handlers, necessary internal state, etc.).

Acknowledgements

This package currently contains the code for a modified version of asks v2.3.7, which is under the MIT License as well. Thanks @theelous3 for the great library!