maxibot 0.98.1__py3-none-any.whl

maxibot/util.py

@@ -0,0 +1,98 @@
+from io import BytesIO
+from typing import Union
+
+try:
+    # noinspection PyPackageRequirements
+    from PIL import Image
+    pil_imported = True
+except ImportError:
+    pil_imported = False
+
+
+def is_command(text: str) -> bool:
+    """
+    Проверка, является ли строка командой
+
+    :param text: строка
+    :type text: str
+    :return: Флаг, является ли строка командой
+    :rtype: bool
+    """
+    if text is None:
+        return False
+    return text.startswith('/')
+
+
+def extract_command(text: str) -> Union[str, None]:
+    """
+    Вытаскивает команду из текста сообщения
+
+    :param text: Description
+    :type text: str
+    :return: Description
+    :rtype: Union[str, None]
+    """
+    if text is None:
+        return None
+    return text.split()[0].split('@')[0][1:] if is_command(text) else None
+
+
+def is_pil_image(var) -> bool:
+    """
+    Returns True if the given object is a PIL.Image.Image object.
+
+    :param var: object to be checked
+    :type var: :obj:`object`
+
+    :return: True if the given object is a PIL.Image.Image object.
+    :rtype: :obj:`bool`
+    """
+    return pil_imported and isinstance(var, Image.Image)
+
+
+def pil_image_to_bytes(image, extension='JPEG', quality='web_low') -> bool:
+    """
+    Returns True if the given object is a PIL.Image.Image object.
+
+    :param var: object to be checked
+    :type var: :obj:`object`
+
+    :return: True if the given object is a PIL.Image.Image object.
+    :rtype: :obj:`bool`
+    """
+    if pil_imported:
+        photoBuffer = BytesIO()
+        image.convert('RGB').save(photoBuffer, extension, quality=quality)
+        photoBuffer.seek(0)
+        return photoBuffer
+    else:
+        raise RuntimeError('PIL module is not imported')
+
+
+def get_text(media):
+    """
+    Метод получения текста из media
+
+    :param media: Объект медиа
+    """
+    try:
+        text = media.caption
+    except Exception:
+        text = None
+    finally:
+        return text
+
+
+def get_parce_mode(media, parse_mode: str):
+    """
+    Метод получения parce_mode из media
+
+    :param media: Объект медиа
+    :param parse_mode: Тип парсинга раметки
+    """
+    try:
+        parse_mode_res = media.parse_mode.lower()
+    except Exception:
+        parse_mode_res = parse_mode.lower()
+    finally:
+        return parse_mode_res

maxibot-0.98.1.dist-info/METADATA

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: maxibot
+Version: 0.98.1
+Summary: Library for build bot in MAX
+Description-Content-Type: text/markdown
+Requires-Dist: requests==2.32.5
+
+## Быстрый старт
+Необходимо установить библиотеку  
+```sh
+pip install -i https://test.pypi.org/simple/ maxibot
+```
+## Просто эхо-бот
+Необходимо создать файл `echo_bot.py` и добавить в него следующий код.
+Для начала надо проинициализировать бота, делается это следующим образом:
+```python
+from maxibot import MaxiBot
+
+bot = maxibot.Maxibot("TOKEN")
+```
+После этой декларации нам нужно зарегистрировать так называемых обработчиков сообщений. Обработчики сообщений определяют фильтры, которые должно проходить сообщение. Если сообщение проходит через фильтр, вызывается декорированная функция и входящее сообщение передается в качестве аргумента.
+
+Определите определим обработчик сообщений, который обрабатывает входящие `/start` и `/help` команды.
+```python
+@bot.message_handler(commands=['start', 'help'])
+def send_welcome(message):
+	bot.send_message(message, "Привет! Как дела?")
+```
+Добавим ещё один обработчик сообщения, который будет повторять отправленный текст:
+```python
+@bot.message_handler(func=lambda m: True)
+def echo_all(message):
+	bot.send_message(message, message.text)
+```
+Для того, чтобы запустить бота, запустим полинг событий следующей командой:
+```python
+bot.polling()
+```
+Для простого эхо-бота это всё. Наш файл теперь выглядит так:
+```python
+from maxibot import MaxiBot
+
+bot = maxibot.Maxibot("TOKEN")
+
+@bot.message_handler(commands=['start', 'help'])
+def send_welcome(message):
+	bot.send_message(message, "Привет! Как дела?")
+
+@bot.message_handler(func=lambda m: True)
+def echo_all(message):
+	bot.send_message(message, message.text)
+
+bot.polling()
+```
+Чтобы запустить бота, просто откройте терминал и введите `python echo_bot.py`, чтобы запустить бота.  
+Проверьте его, отправив команды (`/start` и `/help`) и произвольные текстовые сообщения.

maxibot-0.98.1.dist-info/RECORD

@@ -0,0 +1,11 @@
+maxibot/__init__.py,sha256=yoJtEuiyiEEMAHve9s3UNiPRMc_kqkwZz6WjX30qdTY,24534
+maxibot/apihelper.py,sha256=tX5N7l77GJtCWDXEeCvW2BBDwEnRCYvi_oNm8Hytt1k,9710
+maxibot/types.py,sha256=pYHk-t6pFNypREEesOtQMvOgZlOy0jGXPOwSBe6l2F0,26769
+maxibot/util.py,sha256=Ps263znGfLrHODi6fvYfibhpGOYOzThoQiZoHduwBi0,2545
+maxibot/core/attachments/photo.py,sha256=ZaqSHuIw4ik8bxIS3VOQyD949B2AGyY5GSKSbSvf1Dg,1472
+maxibot/core/network/client.py,sha256=-k9fihDINR5tWbU3IIORE4udiliCrLPIpWfDAW1zuEU,3845
+maxibot/core/network/polling.py,sha256=E7z4SWIyiuFv0UMwRpPCQ0ilhbGAQ8VQ9LBFJVdvQDU,2301
+maxibot-0.98.1.dist-info/METADATA,sha256=fuu7UJvqwclY-A3pd8LG61fPmoUu6VzIGF3g8emhu6w,2808
+maxibot-0.98.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+maxibot-0.98.1.dist-info/top_level.txt,sha256=WNdB_JJYD7kB8YacJAru3eguPKZ5UIlkQS_opytFaSE,8
+maxibot-0.98.1.dist-info/RECORD,,

maxibot-0.98.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

maxibot-0.98.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+maxibot