quiz_bot

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

Поиграть можно в VK и в Telegram.

Локальная установка

Скачайте код:

git clone https://github.com/jmuriki/quiz_bot.git

Перейдите в каталог проекта:

cd quiz_bot

Установите Python, если ещё не успели.

Проверьте, что python установлен и корректно настроен. Запустите в командной строке:

python --version

Код написан на версии 3.8.

Возможно, вместо команды python здесь и в остальных инструкциях этого README придётся использовать python3. Это зависит от операционной системы и от того, установлен ли у вас python2.

В каталоге проекта создайте виртуальное окружение:

python -m venv venv

Активируйте его. На разных операционных системах это делается разными командами:

• Windows: .\venv\Scripts\activate
• MacOS/Linux: source venv/bin/activate

Установите зависимости в виртуальное окружение:

pip install -r requirements.txt

Переменные окружения

Определите переменные окружения:

• TELEGRAM_BOT_TOKEN - токен вашего telegram бота

• VK_API_TOKEN - токен вашего сообщества vk

• REDIS_PASSWORD - пароль аккаунта Redis (бесплатно)

• REDIS_PUBLIC_ENDPOINT - public endpoint вашей БД Redis

• REDIS_PORT - порт вашей БД Redis

• TELEGRAM_NOTIFY_TOKEN - токен вашего вспомогательного бота для логов (опционально)

• TELEGRAM_NOTIFY_CHAT_ID - id вашего telegram чата для логов (опционально)

• PATH_TO_QUIZ_QUESTIONS - путь к папке с вопросами и ответами (опционально)

Создайте файл .env в каталоге quiz_bot/ и положите туда такой код, заполнив значения переменных:

TELEGRAM_BOT_TOKEN=
VK_API_TOKEN=
REDIS_PUBLIC_ENDPOINT=
REDIS_PORT=
REDIS_PASSWORD=

PATH_TO_QUIZ_QUESTIONS=
TELEGRAM_NOTIFY_TOKEN=
TELEGRAM_NOTIFY_CHAT_ID=

База вопросов и ответов

Скачайте архив с вопросами и распакуйте его в предварительно созданную папку quiz_bot/quiz-question/ или же разместите в другом месте, указав путь в переменной PATH_TO_QUIZ_QUESTIONS.

Запуск

vk_quiz_bot.py

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

Находясь в директории проекта, откройте с помощью python файл vk_quiz_bot.py:

python vk_quiz_bot.py

tg_quiz_bot.py

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

Находясь в директории проекта, откройте с помощью python файл tg_quiz_bot.py:

python tg_quiz_bot.py

vk_quiz_bot_full.py

Данная версия бота работает с полной базой вопросов и ответов.

Находясь в директории проекта, откройте с помощью python файл vk_quiz_bot_full.py:

python vk_quiz_bot_full.py

tg_quiz_bot_full.py

Данная версия бота работает с полной базой вопросов и ответов.

Находясь в директории проекта, откройте с помощью python файл tg_quiz_bot_full_full.py:

python tg_quiz_bot_full.py

telegram_logs_handler.py, general_module

Это вспомогательные модули для обработки логов/исключений, учёта результатов и подборки вопросов/ответов.

Цели проекта

Код написан в учебных целях — это урок в курсе по Python и веб-разработке на сайте Devman.