Code Separation

There is a Dispatch class to separate the code:

1
2
3
from telegrinder import Dispatch

dp = Dispatch()  # blueprint

Let's imagine a project tree:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
telegram_bot
├── .env
├── __main__.py
├── handlers
│   ├── admin.py
│   ├── __init__.py
│   ├── ravioli.py
│   └── start.py
├── middlewares
│   └── chat_protect.py
└── rules
    ├── admins.py
    └── users.py

The .env file contains environment variables. Examples for middlewares and handlers folders contents: Custom rule and Middleware.

Let's write code in start.py:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
from telegrinder import Dispatch, Message
from telegrinder.rules import Text
from telegrinder.tools import HTMLFormatter

dp = Dispatch()


@dp.message(Text("/start"))
async def start(message: Message):
    await message.reply(
        HTMLFormatter("Hello, {:italic}!").format(message.from_user.first_name),
        parse_mode=HTMLFormatter.PARSE_MODE,
    )

The other files are similar. Now let's import them into the handlers/__init__.py file:

1
2
3
4
5
6
7
from . import admin, ravioli, start

dps = (
    admin.dp,
    ravioli.dp,
    start.dp,
)

Let's upload dps from handlers/__init__.py to the Telegrinder.dispatch in the __main__.py file:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
from telegrinder import API, Telegrinder, Token
from telegrinder import logger
from handlers import dps

api = API(Token.from_env())
bot = Telegrinder(api)
logger.set_level("INFO")

if __name__ == "__main__":
    for dp in dps:
        bot.dispatch.load(dp)
    bot.run_forever()