PAWT: a Python API Wrapper for Telegram

AKA Pre-Alpha Wrapper for Telegram

About

This code is pre-alpha. I believe I have full coverage of the Telegram API, but the code still needs to be restructured and improved.

Installation

python3 -m pip install git+https://github.com/jarhill0/pawt.git

Usage

To use a Telegram instance:

import pawt

tg = pawt.Telegram(token='YOUR TOKEN') # use your token

To build a bot class, inherit from pawt.bots.TelegramBotInterface and override the desired methods. Call .run() to run the bot:

from pawt.bots import TelegramBotInterface
from pawt.exceptions import APIException

class MyBot(TelegramBotInterface):
    def message_handler(self, message):
        try:
            message.reply.send_message('Thanks for your message.')
        except APIException:
            # something we can't reply to
            pass
            
bot = MyBot(token='YOUR TOKEN') # use your token
bot.run()

Bot classes have a perform_extra_task() method that can be overridden to do a specific task after processing each set of updates, or after timeout.

Running tests

python3 setup.py test

Warnings

Don't be stupid. Don't use this package yet. I made it for myself, and it's likely riddled with bugs. Search for a Python Telegram API Wrapper that's established and use that.

If you are stupid enough to use it, know that methods and names and classes and EVERYTHING can and will change without warning as I make the package more friendly.