GitLocker: The Coding Marketplace

Description:

pywood 0.1.3

PROJECT STATUS: DEVELOPMENT
Что такое pytelegrambots?
pytelegrambots - легковесный фреймворк для создания ботов для телеграма.
Содержание

Установка
Общее описание
Использование
API
Пример создания бота
Получение помощи
Помощь в разработке
Лицензия

Установка
pip install pytelegrambots

Общее описание
Использование
Для того, что бы создать бота, используя pytelegrambots вы должны:
API
Класс FSM
События

Состояние
Описание

IncomingCommandEvent
Update есть число

IncomingStartCommandEvent
Update есть команда /start

IncomingHelpCommandEvent
Update есть команда /help

IncomingNumberEvent
Update есть число

IncomingStrictNumberEvent
Update есть число

IncomingTextEvent
Update есть текст

IncomingStrictTextEvent
Update есть строгий текст

IncomingSinglePhotoEvent
Update есть единичное фото

Реализация собственных классов событий
Для того, что бы создать свой класс события, необходимо:

Создать класс, унаследованный от класса eventlib.UpdateEvent
Реализовать метод happened(). Метод должен принимать в качестве аргумента объект класса Update, и возвращать True или False, в зависимости от того определяет ли update данное событие или нет.
Пример:
cdferfre

Пример создания бота

Формулировка задачи
Предварительная подготовка
Диаграмма состояний
Создание пользовательского события

Формулировка задачи
Создадим примитивного бота для доставки пиццы.
Сформулируем, что бот должен делать.
Сначала бот приветствует пользователя.
После приветствия, бот просит написать какую пиццу же``лает клиент. (pizza_type: str)
Потом бот просит указать количество пицц. (quantity: int)
Потом посредством клавиатуры просит указать способ получения пиццы клиентом: самовывоз или доставка курьером. (delivery_type: str)
Если самовывоз, бот присылает собеседнику сообщение "Пицца {pizza_type} в количестве {quantity} будет готова через 15 минут. Номер заказа {chat_id}}"
Если клиент выбрал доставку курьером, "Пиццу {pizza_type} в количестве {quantity} курьер привезет через 45 минут."
Предварительная подготовка<a name="example-preliminaries>
Создайте бота при помощи @botfather и получите токен.
Диаграмма состояний
Дадим названия состояниям, в которым может находиться чат пользователя с ботом:

Состояние
Описание

AfterStart
Чат сразу после старта перед приветственным сообщением

AfterWelcomeMessage
Чат после приветственного сообщения

PromptedForPizzaType
Чат после отображения предложения пользователю написать тип пиццы, который он хочет заказать

PromptedForQuantity
Чат после отображения предложения пользователю написать количества заказываемой пиццы

PromptedForDeliveryType
Чат после отображения пользователя клавиатуры с выбором одного из двух способов доставки

DeliveryByCouurierMessagePosted
Чат после отображения клиенту сообщения о времени получении пицц

HimselfDeliveryPosted
Чат после отображения клиенту сообщения о времени получении пицц

Создание пользовательского события
Получение помощи
Рекомендуемый способ получения помощи- создание вопроса в данном репозитарии.
Можете также обратиться по эл. адресу maliuzhenetsdzmitry @ гугляком ()
Помощь в разработке
Лицензия
MIT License Copyright (c) 2020 Dzmitry Maliuzhenets