📅 Duckling - телеграм-бот

Бот для удобного просмотра расписания Вологодского государственного университета

• 💻 Основной разработчик: Semyon Golgan
• 💬 Telegram: https://t.me/duckling_schedule_bot

from imeikn import Student

# Для ИМЕиКН с любовью
me = Student()
me.sendLove()

🌟 Возможности

• Получение расписания для своей группы на 3 недели вперед
• Удобный выбор группы (по курсам и названиям)
• Автоматическое определение текущей недели
• Поддержка нескольких институтов ВоГУ

🤝 Как помочь проекту

Мы рады вкладу от сообщества! Как помочь:

• Форкните репозиторий
• Создайте ветку с вашими изменениями (git checkout -b feature/amazing-feature)
• Сделайте коммит (git commit -m 'Add some amazing feature')
• Запушьте в форк (git push origin feature/amazing-feature)
• Откройте Pull Request

🛠 Установка

1. Клонируйте репозиторий:

git clone https://github.com/black-evil-dragon/duckling-bot.git
cd duckling-bot

2. Активируйте виртуальную среду:

python3.12 -m venv ./venv # py -3.12 -m venv ./venv

3. Добавьте переменные окружения и проверьте файл конфигурации

# ./core/settings/config.py
from dotenv import dotenv_values

config = dotenv_values('.env')

BOT_TOKEN=config.get('BOT_TOKEN')
DB_FILEPATH=config.get('DB_FILEPATH')

API_ID=config.get('API_ID')
API_KEY=config.get('API_KEY')
API_URL = config.get('API_URL')

4. Запустите бота

python main.py

⚖️ Правовые аспекты

1. Источник данных:
   Бот получает информацию исключительно из публично доступного расписания на официальном сайте ВоГУ

2. Ответственность:
   Разработчик не несет ответственности за:

   • Точность предоставляемых данных
   • Изменения в работе API университета

     Реализованны алгоритмы API не прошли проверку временем и аналогично боту нуждаются в документировании, рефакторинге и прочему.

   • Временную недоступность сервиса

📜 Лицензия

Этот проект распространяется под лицензией MIT. При использовании кода просьба указывать оригинального автора.

MIT License
Copyright (c) 2025 Semyon Golgan