Connect Telegram Bot

Introduction

Connect Telegram Bot is the base class which helps to build custom commands for the django models. It allows getting historical data from django models, as well as develop custom pre-defined filters and execute custom django management commands (i.e. those which are executed through python manage.py $command)

Install

Connect Telegram Bot requires python 3.8 or later and has the following dependencies:

• python-telegram-bot >=13.3
• django>=2.2.19

Connect Telegram Bot can be installed from pypi.org using pip:

$ pip install connect-telegram-bot

Running The Bot

Define your command class extending the base

For example:

from myapp.models import MyAppModel

from telegram_bot.telegram_conversation import TelegramConversation


class MyAppConversation(TelegramConversation):
    COMMANDS_DIR = '/app/myapp/management/commands'

    def __init__(self, logger, suffix):
        super().__init__(logger, suffix)
        self.model = MyAppModel

    @property
    def saved_filters(self):
        return [
            'count',
        ]

    def get_count(self, update):
        amount = self._get_initial_queryset().count()
        self._reply(update, amount)
        self._default_query_context()

Create a directory in your project where these conversation implementations will be placed. Connect Telegram Bot requires multiple environment variables to be setup before executing:

Running The Bot

export TELEGRAM_BOT_TOKEN='....'; export DJANGO_SETTINGS_MODULE='settings.common'; export TELEGRAM_BOT_HANDLERS='/app/telegram_bot/conversation_handlers/'; export TELEGRAM_BOT_COMMAND_SUFFIX='suf1'; python telegram_bot/bot.py

Testing

• Create virtualenv
• Install project dependencies

python -m pip install --upgrade pip
pip install poetry
poetry update

• Run tests

poetry run pytest

License

Connect Telegram Bot is released under the Apache License Version 2.0.