splatform/vk
Archived
2
0
Fork 0
Code Issues Pull requests Releases Activity
Vkontakte bot for splatform based on v5.8
This repository has been archived on 2025-08-03. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
26 commits 1 branch 4 tags 843 KiB
  • Python 100%
Find a file
Exact
Milinuri Nirvalen deaa085edb Add handler loader
2024-07-11 17:52:58 +04:00
docs/_images Uodate readme 2024-07-10 12:45:20 +04:00
spvk Add handler loader 2024-07-11 17:52:58 +04:00
tools Port check updates script from sp tg 2024-07-11 16:09:13 +04:00
.env.dist Add dotenv file 2024-07-09 23:21:50 +04:00
.gitignore Add Sp files in .gitignore 2024-07-11 10:22:11 +04:00
changelog.rst Release v1.3.2 2024-07-11 12:18:15 +04:00
LICENSE Initial commit 2024-07-09 13:15:12 +00:00
poetry.lock Fix start vk bot; up sp version 2024-07-11 10:01:16 +04:00
pyproject.toml Fix start vk bot; up sp version 2024-07-11 10:01:16 +04:00
README.md Release v1.3.2 2024-07-11 12:18:15 +04:00

README.md

Sp Vk

Бот ВКонтакте для работы с SPlatform. Портирует все функции из Telegram версии бота.

Documentation sp vk license python Sp branch

Приветствуем в репозитории ВК бота для SPlatform. Долгое время он поставлялся вместе с остальными компонентами. Однако обновления вк бот получал несколько реже. Потому было принято решение отделить репозитория ВК бота, чтобы более точно поставлять для него обновления.

Что умеет бот:

  • Быстро получать расписание на сегодня/завтра/неделю.
  • Отправлять уведомления об изменениях в расписании.
  • Автоматически рассылать расписание в указаный час.
  • Работать в групповых чатах!
  • И многое другое...

Проект портирует и реализует функции из Telegram бота.

О боте (v1.3 / sp v5.8)

Разделы на фото:

  • Смена класса (/set_class).
  • Главное меню (справка).
  • Результат запроса к расписанию.
  • Информация о боте и парсере.

Копирует функции Telegram версии бота. Иногда некоторые функции урезаются, некоторые напротив расшираются. Из-за особенностей каждой из платформ.

Вы также можете использовать текстовые запросы. Клавиатура бота в отличие от Telegram не прибита к сообщению и всегда расположена внизу, что позволяет быстро получить доступ к разделам, даже без использования команд.

К сожалению у нас нет такой же красивой схемы для вк бота. Вам придётся поверить на слово, что тут не так много отличий. Ваш опыт использования будет аналогичным, поскольку разделы не изменились.

Статья о боте в Вк. Написана для более старой версии бота и может быть места устаревшей. Тем не менее, всё подробно и с картинками. До тех пор, пока не появилось страницы документации.

Установка и первый запуск

Вы легко можете поднять своего собственного ВК бота с расписанием.

Для начала давайте загрузим репозитория с ботом для себя.

git clone https://codeberg.org/Salormoon/spvk
cd spvk

Теперь установим все необхоидмые зависимости для запуска проекта. Для этого мы воспользуемся poetry.

poetry install

Мы не будем описывать традиционный запуск через виртуальное окружение. Давайте сразуц приучаться к хорошему.

Теперь, чтобы запустить бота нужно будет укзаать некоотрые секретики. Боту нужно будет передать токен сообщества ВК с правами доступа к сообщениям. А также должен быть включен Long polling. Думаю вы и сами сможете почитать об этом.

Когда вы получили токен, скопируйте файл .env.dist в .env и запишите токен от вашего сообщества в файл.

# .env
VK_TOKEN="Your vk group (bot) token here"

И теперь всё что вам осталось для запуска бота - использовать poetry:

poetry run python -m spvk

поддержка

Мы будем очень рады, если вы хотите помочь проекту. Вы свободно можете предлагать свои идеи и отправлять PR. Спасибо что используете бота и SPlatform.