Skip to content

Maze21127/aiogram-template

Repository files navigation

Шаблон для Aiogram 3

Features

  • Commitizen (проверка стиля коммитов)
  • Pre-commit (пре-коммит хуки)
  • Ruff (линтер)
  • Python Semantic Release (семантическое версионирование)
  • CI/CD github workflow
  • Redis
  • SQLAlchemy via Alembic

Клонирование из шаблона

Установить copier
https://copier.readthedocs.io/en/stable/
pipx

pipx install copier

pip

pip install copier

Скопировать шаблон

copier copy gh:Maze21127/aiogram-template project_name --trust

Локальная разработка

Установить зависимости

poetry install --with DEV

Установить git хуки

poetry run pre-commit install
poetry run pre-commit install --hook-type commit-msg
poetry run pre-commit install --hook-type pre-push

Создание коммитов и публикация изменений.

Для проекта используется семантическое версионирование.

Коммиты должны соответствовать шаблону tag: message

Публикация изменений осуществляется с помощью команды:

semantic-release version 

Github actions

Добавить в secrets следующие переменные:

  • SSH_HOST
  • SSH_USER
  • SSH_KEY
  • BOT_TOKEN
  • REDIS_DSN (если есть Redis)
  • DB_DSN (если есть SQLAlchemy (PostgreSQL))