Skip to content

vip2ip/tgbot_template_v3

 
 

Repository files navigation

Цей темплейт використовується для розробки Telegram ботів з використанням бібліотеки aiogram v3.0+.

SQLAlchemy + Alembic

В коді є приклади таблички User з використанням SQLAlchemy 2.0, та скрипти для алембіку (ініціалізація алембік, створення та застосування міграцій).

Але, якщо ви з цими інструментами ніколи не працювали, то зверніться до документації і дізнайтесь про ці інструменти. Також, в мене є англомовний курс по цим інструментам на Udemy.

img.png

Для того, щоб почати використовувати:

  1. Скопіюйте .env.dist в .env і заповніть необхідні дані.
  2. Створіть нові хендлери.
  3. Docker:
    1. Можете одразу запускати проєкт із Docker, а якщо в вас його немає, то завантажте, та встановіть.
    2. Запустіть проєкт з команди docker-compose up
  4. Без Docker:
    1. Створіть venv
    2. Встановить залежності із requirements.txt: pip install -r requirements.txt --pre
    3. Запустіть проєкт з команди python3 bot.py

Як робити та реєструвати хендлери:

Створюєте модуль you_name.py у папці handlers.

Створюєте роутер у you_name.py.

from aiogram import Router
user_router = Router()

Можна робити декілька роутерів в одному модулі, та на кожний з них навішувати хендлери. Можна реєструвати хендлери декораторами:

@user_router.message(commands=["start"])
async def user_start(message):
    await message.reply("Вітаю, звичайний користувач!")

Заходимо у файл bot.py і додаємо всі роутери в нього:

from tgbot.handlers.admin import admin_router
from tgbot.handlers.echo import echo_router
from tgbot.handlers.user import user_router

...

async def main():
   
   ...

    for router in [
        admin_router,
        user_router,
        ...,
        echo_router,

    ]:
        dp.include_router(router)

Туторіали з aiogram v3

Відосів поки що немає, але @Groosha вже почав робити свій підручник.

About

Aiogram tgbot

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 95.5%
  • Shell 2.4%
  • Dockerfile 2.1%