maxapi-python 1.1.20__tar.gz → 1.1.21__tar.gz

maxapi_python-1.1.21/.coderabbit.yaml

@@ -0,0 +1,6 @@
+reviews:
+  auto_review:
+    enabled: true
+    branches:
+      include:
+        - "*"  

{maxapi_python-1.1.20 → maxapi_python-1.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxapi-python
-Version: 1.1.20
+Version: 1.1.21
 Summary: Python wrapper для API мессенджера Max
 Project-URL: Homepage, https://github.com/ink-developer/PyMax
 Project-URL: Repository, https://github.com/ink-developer/PyMax
@@ -79,65 +79,47 @@ uv add -U maxapi-python
 
 ```python
 import asyncio
+
 from pymax import MaxClient, Message
+from pymax.filters import Filters
+
+client = MaxClient(
+    phone="+1234567890",
+    work_dir="cache",  # директория для сессий
+)
+
+
+# Обработка входящих сообщений
+@client.on_message(Filters.chat(0))  # фильтр по ID чата
+async def on_message(msg: Message) -> None:
+    print(f"[{msg.sender}] {msg.text}")
 
-# Инициализация клиента
-phone = "+1234567890"
-client = MaxClient(phone=phone, work_dir="cache")
+    await client.send_message(
+        chat_id=msg.chat_id,
+        text="Привет, я бот на PyMax!",
+    )
+
+    await client.add_reaction(
+        chat_id=msg.chat_id,
+        message_id=str(msg.id),
+        reaction="👍",
+    )
 
-# Обработчик входящих сообщений
-@client.on_message()
-async def handle_message(message: Message) -> None:
-    print(f"{message.sender}: {message.text}")
 
-# Обработчик запуска клиента
 @client.on_start
-async def handle_start() -> None:
-    print("Клиент запущен")
+async def on_start() -> None:
+    print(f"Клиент запущен. Ваш ID: {client.me.id}")
 
-    # Получение истории сообщений
+    # Получение истории
     history = await client.fetch_history(chat_id=0)
-    if history:
-        for message in history:
-            user = await client.get_user(message.sender)
-            if user:
-                print(f"{user.names[0].name}: {message.text}")
-
-async def main() -> None:
-    await client.start()
-
-    # Работа с чатами
-    for chat in client.chats:
-        print(f"Чат: {chat.title}")
-
-        # Отправка сообщения
-        message = await client.send_message(
-            "Привет от PyMax!",
-            chat.id,
-            notify=True
-        )
-
-        # Редактирование сообщения
-        await asyncio.sleep(2)
-        await client.edit_message(
-            chat.id,
-            message.id,
-            "Привет от PyMax! (отредактировано)"
-        )
-
-        # Удаление сообщения
-        await asyncio.sleep(2)
-        await client.delete_message(chat.id, [message.id], for_me=False)
-
-    # Работа с диалогами
-    for dialog in client.dialogs:
-        print(f"Диалог: {dialog.last_message.text}")
-
-    # Работа с каналами
-    for channel in client.channels:
-        print(f"Канал: {channel.title}")
-
-    await client.close()
+    print("Последние сообщения из чата 0:")
+    for m in history:
+        print(f"- {m.text}")
+
+
+async def main():
+    await client.start()  # подключение и авторизация
+
 
 if __name__ == "__main__":
     asyncio.run(main())
@@ -145,7 +127,8 @@ if __name__ == "__main__":
 
 ## Документация
 
-[WIP](https://ink-developer.github.io/PyMax)
+[GitHub Pages](https://maxapiteam.github.io/PyMax/)
+[DeepWiki](https://deepwiki.com/MaxApiTeam/PyMax)
 
 ## Лицензия
 

{maxapi_python-1.1.20 → maxapi_python-1.1.21}/README.md

@@ -57,65 +57,47 @@ uv add -U maxapi-python
 
 ```python
 import asyncio
+
 from pymax import MaxClient, Message
+from pymax.filters import Filters
+
+client = MaxClient(
+    phone="+1234567890",
+    work_dir="cache",  # директория для сессий
+)
+
+
+# Обработка входящих сообщений
+@client.on_message(Filters.chat(0))  # фильтр по ID чата
+async def on_message(msg: Message) -> None:
+    print(f"[{msg.sender}] {msg.text}")
 
-# Инициализация клиента
-phone = "+1234567890"
-client = MaxClient(phone=phone, work_dir="cache")
+    await client.send_message(
+        chat_id=msg.chat_id,
+        text="Привет, я бот на PyMax!",
+    )
+
+    await client.add_reaction(
+        chat_id=msg.chat_id,
+        message_id=str(msg.id),
+        reaction="👍",
+    )
 
-# Обработчик входящих сообщений
-@client.on_message()
-async def handle_message(message: Message) -> None:
-    print(f"{message.sender}: {message.text}")
 
-# Обработчик запуска клиента
 @client.on_start
-async def handle_start() -> None:
-    print("Клиент запущен")
+async def on_start() -> None:
+    print(f"Клиент запущен. Ваш ID: {client.me.id}")
 
-    # Получение истории сообщений
+    # Получение истории
     history = await client.fetch_history(chat_id=0)
-    if history:
-        for message in history:
-            user = await client.get_user(message.sender)
-            if user:
-                print(f"{user.names[0].name}: {message.text}")
-
-async def main() -> None:
-    await client.start()
-
-    # Работа с чатами
-    for chat in client.chats:
-        print(f"Чат: {chat.title}")
-
-        # Отправка сообщения
-        message = await client.send_message(
-            "Привет от PyMax!",
-            chat.id,
-            notify=True
-        )
-
-        # Редактирование сообщения
-        await asyncio.sleep(2)
-        await client.edit_message(
-            chat.id,
-            message.id,
-            "Привет от PyMax! (отредактировано)"
-        )
-
-        # Удаление сообщения
-        await asyncio.sleep(2)
-        await client.delete_message(chat.id, [message.id], for_me=False)
-
-    # Работа с диалогами
-    for dialog in client.dialogs:
-        print(f"Диалог: {dialog.last_message.text}")
-
-    # Работа с каналами
-    for channel in client.channels:
-        print(f"Канал: {channel.title}")
-
-    await client.close()
+    print("Последние сообщения из чата 0:")
+    for m in history:
+        print(f"- {m.text}")
+
+
+async def main():
+    await client.start()  # подключение и авторизация
+
 
 if __name__ == "__main__":
     asyncio.run(main())
@@ -123,7 +105,8 @@ if __name__ == "__main__":
 
 ## Документация
 
-[WIP](https://ink-developer.github.io/PyMax)
+[GitHub Pages](https://maxapiteam.github.io/PyMax/)
+[DeepWiki](https://deepwiki.com/MaxApiTeam/PyMax)
 
 ## Лицензия
 

{maxapi_python-1.1.20 → maxapi_python-1.1.21}/examples/example.py

@@ -1,26 +1,75 @@
 import asyncio
 import datetime
+import logging
+from time import time
+from typing import Any
 
+import pymax
 from pymax import MaxClient, Message, ReactionInfo, SocketMaxClient
 from pymax.files import File, Video
-from pymax.filters import Filter
+from pymax.payloads import UserAgentPayload
 from pymax.static.enum import AttachType, Opcode
 from pymax.types import Chat
 
-phone = "+7903223423"
+phone = "+7903223111"
+headers = UserAgentPayload(device_type="WEB")
 
+client = MaxClient(
+    phone=phone,
+    work_dir="cache",
+    reconnect=False,
+    logger=None,
+    headers=headers,
+)
+client.logger.setLevel(logging.INFO)
 
-client = MaxClient(phone=phone, work_dir="cache", reconnect=False, logger=None)
+
+@client.on_raw_receive
+async def handle_raw_receive(data: dict[str, Any]) -> None:
+    print(f"Raw data received: {data}")
+
+
+@client.task(seconds=10)
+async def periodic_task() -> None:
+    # print(f"Periodic task executed at {datetime.datetime.now()}")
+    ...
 
 
 @client.on_start
 async def handle_start() -> None:
     print(f"Client started as {client.me.names[0].first_name}!")
-    folder_list = await client.get_folders()
-    for folder in folder_list.folders:
-        if folder.title == "My Folder Renamed":
-            folder_update = await client.delete_folder(folder_id=folder.id)
-            print(f"Folder deleted: {folder_update.folder_sync}")
+
+    chat_id = -1
+    max_messages = 1000
+    messages = []
+    from_time = int(time() * 1000)
+    while len(messages) < max_messages:
+        r = await client.fetch_history(
+            chat_id=chat_id, from_time=from_time, backward=30
+        )
+        if not r:
+            break
+        from_time = r[0].time
+        messages.extend(r)
+        print(f"First message time: {from_time}, id: {r[0].id}, text: {r[0].text}")
+        print(f"Last message time: {from_time}, id: {r[-1].id}, text: {r[-1].text}")
+        print(f"Loaded {len(messages)}/{max_messages} messages...")
+    # channel = await client.resolve_channel_by_name("fm92")
+    # if channel:
+    #     print(f"Resolved channel by name: {channel.title}, ID: {channel.id}")
+    # else:
+    #     print("Channel not found by name.")
+
+    # channel = await client.join_channel(link)
+    # if channel:
+    #     print(f"Joined channel: {channel.title}, ID: {channel.id}")
+    # else:
+    #     print("Failed to join channel.")
+    # await client.send_message(
+    #     "Hello! The client has started successfully.",
+    #     chat_id=2265456546456,
+    #     notify=True,
+    # )
     # folder_update = await client.create_folder(
     #     title="My Folder",
     #     chat_include=[0],
@@ -63,21 +112,41 @@ async def handle_start() -> None:
     #     print(f"Member {member.contact.names[0].first_name}, ID: {member.contact.id}")
 
 
-@client.on_reaction_change
-async def handle_reaction_change(
-    message_id: str, chat_id: int, reaction_info: ReactionInfo
-) -> None:
+# @client.on_reaction_change
+# async def handle_reaction_change(
+#     message_id: str, chat_id: int, reaction_info: ReactionInfo
+# ) -> None:
+#     print(
+#         f"Reaction changed on message {message_id} in chat {chat_id}: "
+#         f"Total count: {reaction_info.total_count}, "
+#         f"Your reaction: {reaction_info.your_reaction}, "
+#         f"Counters: {reaction_info.counters[0].reaction}={reaction_info.counters[0].count}"
+#     )
+
+
+# @client.on_chat_update
+# async def handle_chat_update(chat: Chat) -> None:
+#     print(f"Chat updated: {chat.id}, new title: {chat.title}")
+
+
+@client.on_message()
+async def handle_message(message: Message) -> None:
     print(
-        f"Reaction changed on message {message_id} in chat {chat_id}: "
-        f"Total count: {reaction_info.total_count}, "
-        f"Your reaction: {reaction_info.your_reaction}, "
-        f"Counters: {reaction_info.counters[0].reaction}={reaction_info.counters[0].count}"
+        f"New message in chat {message.chat_id} from {message.sender}: {message.text}"
     )
+    # if message.link and message.link.message.attaches:
+    #     for attach in message.link.message.attaches:
+    #         print(f"Link attach type: {attach.type}")
+
+
+@client.on_message_edit()
+async def handle_edited_message(message: Message) -> None:
+    print(f"Edited message in chat {message.chat_id}: {message.text}")
 
 
-@client.on_chat_update
-async def handle_chat_update(chat: Chat) -> None:
-    print(f"Chat updated: {chat.id}, new title: {chat.title}")
+@client.on_message_delete()
+async def handle_deleted_message(message: Message) -> None:
+    print(f"Deleted message in chat {message.chat_id}: {message.id}")
 
 
 # async def login_flow_test():

maxapi_python-1.1.21/examples/flt_test.py

@@ -0,0 +1,51 @@
+import asyncio
+import logging
+
+import pymax
+import pymax.static
+from pymax import MaxClient
+from pymax.filters import Filters
+from pymax.payloads import UserAgentPayload
+from pymax.static.enum import Opcode
+
+phone = "+7903223423"
+headers = UserAgentPayload(device_type="WEB")
+
+client = MaxClient(
+    phone=phone,
+    work_dir="cache",
+    reconnect=False,
+    logger=None,
+    headers=headers,
+)
+client.logger.setLevel(logging.DEBUG)
+
+
+@client.task(seconds=10)
+async def periodic_task() -> None:
+    client.logger.info("Periodic task executed")
+
+
+@client.on_message(Filters.text("test") & ~Filters.chat(0))
+async def handle_message(message: pymax.Message) -> None:
+    print(f"New message from {message.sender}: {message.text}")
+
+
+@client.on_start
+async def on_start():
+    print("Client started")
+    data = await client._send_and_wait(
+        opcode=Opcode.FILE_UPLOAD,
+        payload={"count": 1},
+    )
+    print("File upload response:", data)
+    #     opcode=pymax.static.enum.Opcode.CHATS_LIST,
+    #     payload={
+    #         "marker": 1765721869777,
+    #     },
+    # )
+
+    # print("Chats list:", data)
+
+
+asyncio.run(client.start())

maxapi_python-1.1.21/examples/large_file_upload.py

@@ -0,0 +1,51 @@
+import asyncio
+import logging
+from pathlib import Path
+
+from pymax import MaxClient
+from pymax.files import File, Video
+
+client = MaxClient(phone="+1234567890", work_dir="cache", reconnect=False)
+client.logger.setLevel(logging.INFO)
+
+
+def create_big_file(file_path: Path, size_in_mb: int) -> None:
+    with open(file_path, "wb") as f:
+        f.seek(size_in_mb * 1024 * 1024 - 1)
+        f.write(b"\0")
+
+
+@client.on_start
+async def upload_large_file_example():
+    await asyncio.sleep(2)
+
+    file_path = Path("tests2/large_file.dat")
+
+    if not file_path.exists():
+        create_big_file(file_path, size_in_mb=300)
+    file_size = file_path.stat().st_size
+    client.logger.info(f"File size: {file_size / (1024 * 1024):.2f} MB")
+
+    file = File(path=str(file_path))
+    chat_id = 0
+
+    client.logger.info("Starting file upload...")
+
+    try:
+        await client.send_message(
+            chat_id=chat_id,
+            text="📎 Вот большой файл",
+            attachment=file,
+        )
+        client.logger.info("File uploaded successfully!")
+
+    except OSError as e:
+        if "malloc failure" in str(e):
+            client.logger.error("Memory error - file too large for current memory")
+            client.logger.info("Recommendation: Upload smaller files or free up memory")
+        else:
+            raise
+
+
+if __name__ == "__main__":
+    asyncio.run(client.start())

maxapi_python-1.1.21/examples/reg.py

@@ -0,0 +1,34 @@
+import asyncio
+
+from pymax import MaxClient, Message
+from pymax.filters import Filters
+
+client = MaxClient(
+    phone="+1234567890",
+    work_dir="cache",
+)
+
+
+@client.on_message(Filters.chat(0))
+async def on_message(msg: Message):
+    print(f"[{msg.sender}] {msg.text}")
+    await client.send_message(chat_id=msg.chat_id, text="Привет!")
+    await client.add_reaction(
+        chat_id=msg.chat_id, message_id=str(msg.id), reaction="👍"
+    )
+
+
+@client.on_start
+async def on_start():
+    print(f"Клиент запущен. Ваш ID: {client.me.id}")
+    history = await client.fetch_history(chat_id=0)
+    for m in history:
+        print(f"- {m.text}")
+
+
+async def main():
+    await client.start()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{maxapi_python-1.1.20 → maxapi_python-1.1.21}/examples/telegram_bridge.py

@@ -1,31 +1,26 @@
+# Всякая всячина
 import asyncio
-import os
+
+# Библиотека для работы с файлами
 from io import BytesIO
 
 import aiohttp
+
+# Импорты библиотеки aiogram для TG-бота
 from aiogram import Bot, Dispatcher, types
-from dotenv import load_dotenv
 
-from pymax import Chat, MaxClient, Message, User
+# Импорты библиотеки PyMax
+from pymax import MaxClient, Message, Photo
 from pymax.types import FileAttach, PhotoAttach, VideoAttach
 
-"""
-Зависимости:
-
-pip install maxapi-python==1.1.13 aiogram==3.22.0 python-dotenv
-
-"""
-
-
-"""
-В .env нужно указать:
+# УСТАНОВИТЬ ЗАВИСИМОСТИ - pip install maxapi-python aiogram==3.22.0
 
-PHONE = "+7123456789"  # Твой номер для Max
-BOT_TOKEN = "23456789:AAH0cJ3SNzZ2zzD0uF8HOqmxtKpwsKwggM"  # Твой токен Telegram-бота
 
-"""
+# Настройки ботов
+PHONE = "+79998887766"  # Номер телефона Max
+telegram_bot_TOKEN = "token"  # Токен TG-бота
 
-chats = {  # В формате айди чата в Max: айди чата в Telegram
+chats = {  # В формате айди чата в Max: айди чата в Telegram (айди чата Max можно узнать из ссылки на чат в веб версии web.max.ru)
     -68690734055662: -1003177746657,
 }
 
@@ -34,16 +29,8 @@ chats = {  # В формате айди чата в Max: айди чата в Te
 chats_telegram = {value: key for key, value in chats.items()}
 
 
-# Загружаем .env
-load_dotenv(override=True)
-
-
-# Настройки из .env
-PHONE = os.getenv("PHONE")  # Номер телефона Max
-telegram_bot_TOKEN = os.getenv("BOT_TOKEN")  # Токен TG-бота
-
-
-client = MaxClient(phone=PHONE, work_dir="cache")
+# Инициализация клиента MAX
+client = MaxClient(phone=PHONE, work_dir="cache", reconnect=True)
 
 
 # Инициализация TG-бота
@@ -54,7 +41,10 @@ dp = Dispatcher()
 # Обработчик входящих сообщений MAX
 @client.on_message()
 async def handle_message(message: Message) -> None:
-    tg_id = chats[message.chat_id]
+    try:
+        tg_id = chats[message.chat_id]
+    except KeyError:
+        return
 
     sender = await client.get_user(user_id=message.sender)
 
@@ -75,17 +65,14 @@ async def handle_message(message: Message) -> None:
                         async with session.get(video.url) as response:
                             response.raise_for_status()  # Проверка на ошибки HTTP
                             video_bytes = BytesIO(await response.read())
-                            video_bytes.name = response.headers.get(
-                                "X-File-Name"
-                            )
+                            video_bytes.name = response.headers.get("X-File-Name")
 
                         # Отправляем видео через телеграм бота
                         await telegram_bot.send_video(
                             chat_id=tg_id,
                             caption=f"{sender.names[0].name}: {message.text}",
                             video=types.BufferedInputFile(
-                                video_bytes.getvalue(),
-                                filename=video_bytes.name,
+                                video_bytes.getvalue(), filename=video_bytes.name
                             ),
                         )
 
@@ -105,17 +92,14 @@ async def handle_message(message: Message) -> None:
                         async with session.get(attach.base_url) as response:
                             response.raise_for_status()  # Проверка на ошибки HTTP
                             photo_bytes = BytesIO(await response.read())
-                            photo_bytes.name = response.headers.get(
-                                "X-File-Name"
-                            )
+                            photo_bytes.name = response.headers.get("X-File-Name")
 
                         # Отправляем фото через телеграм бота
                         await telegram_bot.send_photo(
                             chat_id=tg_id,
                             caption=f"{sender.names[0].name}: {message.text}",
                             photo=types.BufferedInputFile(
-                                photo_bytes.getvalue(),
-                                filename=photo_bytes.name,
+                                photo_bytes.getvalue(), filename=photo_bytes.name
                             ),
                         )
 
@@ -142,9 +126,7 @@ async def handle_message(message: Message) -> None:
                         async with session.get(file.url) as response:
                             response.raise_for_status()  # Проверка на ошибки HTTP
                             file_bytes = BytesIO(await response.read())
-                            file_bytes.name = response.headers.get(
-                                "X-File-Name"
-                            )
+                            file_bytes.name = response.headers.get("X-File-Name")
 
                         # Отправляем файл через телеграм бота
                         await telegram_bot.send_document(
@@ -184,9 +166,13 @@ async def handle_start() -> None:
 
 # Обработчик сообщений Telegram
 @dp.message()
-async def handle_message(message: types.Message, bot: Bot) -> None:
+async def handle_tg_message(message: types.Message, bot: Bot) -> None:
     max_id = chats_telegram[message.chat.id]
-    await client.send_message(chat_id=max_id, text=message.text, notify=True)
+    await client.send_message(
+        chat_id=max_id,
+        text=f"{message.from_user.first_name}: {message.text}",
+        notify=True,
+    )
 
 
 # Раннер ботов
@@ -195,9 +181,7 @@ async def main() -> None:
     telegram_bot_task = asyncio.create_task(dp.start_polling(telegram_bot))
 
     try:
-        while True:  # (Не) спрашивайте 😃
-            await client.start()
-
+        await client.start()
     finally:
         await client.close()
         telegram_bot_task.cancel()

{maxapi_python-1.1.20 → maxapi_python-1.1.21}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "maxapi-python"
-version = "1.1.20"
+version = "1.1.21"
 description = "Python wrapper для API мессенджера Max"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -37,11 +37,14 @@ where = ["src"]
 
 [dependency-groups]
 dev = [
+  "furo>=2025.9.25",
+  "ghp-import>=2.1.0",
   "mkdocs>=1.6.1",
   "mkdocs-material>=9.6.18",
   "mkdocstrings[python]>=0.30.0",
   "pre-commit>=4.3.0",
   "pydocstring>=0.2.1",
+  "sphinx>=8.1.3",
 ]
 
 [tool.hatch.build.targets.wheel]