maxapi-python 1.1.5__tar.gz → 1.1.8__tar.gz

maxapi_python-1.1.8/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,25 @@
+---
+name: Bug report
+about: Сообщить о баге
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Описание**
+Что пошло не так?
+
+**Шаги для воспроизведения**
+1. 
+2. 
+3. 
+
+**Ожидаемый результат**
+Что должно было произойти
+
+**Фактический результат**
+Что произошло на самом деле
+
+**Дополнительно**
+Логи, скриншоты, версия Python/API

maxapi_python-1.1.8/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature Request
+about: Предложить новую функциональность
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+**Описание**
+Опишите новую функцию или улучшение.
+
+**Зачем это нужно**
+Кратко объясните, какую проблему решает или что улучшает.
+
+**Пример использования**
+Как это будет использоваться в коде:
+
+```python
+# пример

maxapi_python-1.1.8/.github/ISSUE_TEMPLATE/refactor.md

@@ -0,0 +1,25 @@
+---
+name: Refactor
+about: Предложение по улучшению кода без изменения функционала
+title: ''
+labels: refactor
+assignees: ''
+---
+
+## Описание
+Опишите часть кода, которую нужно улучшить или рефакторить, без изменения функциональности.
+
+## Причина
+Почему требуется рефакторинг? Например:
+- Улучшение читаемости кода
+- Повышение производительности
+- Упрощение поддержки
+
+## Предлагаемые изменения
+Опишите, как вы планируете изменить код, чтобы улучшить его структуру или качество.
+
+## Влияние
+Какие модули/части библиотеки могут быть затронуты? Нужно убедиться, что функционал остаётся прежним.
+
+## Дополнительно
+Любая дополнительная информация, ссылки на документацию, примеры кода.

maxapi_python-1.1.8/.github/pull_request_template.md

@@ -0,0 +1,19 @@
+## Описание
+Кратко, что делает этот PR. Например, добавляет новый метод, исправляет баг, улучшает документацию.
+
+## Тип изменений
+- [ ] Исправление бага
+- [ ] Новая функциональность
+- [ ] Улучшение документации
+- [ ] Рефакторинг
+
+## Связанные задачи / Issue
+Ссылка на issue, если есть: #
+
+## Тестирование
+Покажите пример кода, который проверяет изменения:
+
+```python
+import pymax
+
+# пример использования нового функционала

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxapi-python
-Version: 1.1.5
+Version: 1.1.8
 Summary: Python wrapper для API мессенджера Max
 Project-URL: Homepage, https://github.com/noxzion/PyMax
 Project-URL: Repository, https://github.com/noxzion/PyMax
@@ -157,7 +157,13 @@ if __name__ == "__main__":
 
 ## Авторы
 
-- **[noxzion](https://github.com/noxzion)** — оригинальный автор проекта
-- **[ink](https://github.com/ink-developer)** — второй разработчик, исследование API и его документация
-- **[fresh-milkshake](https://github.com/fresh-milkshake)** — контрибьютор и автор лого
+- **[noxzion](https://github.com/noxzion)** — Оригинальный автор проекта
+- **[ink](https://github.com/ink-developer)** — Главный разработчик, исследование API и его документация
 
+## Контрибьюторы
+
+Спасибо всем за помощь в разработке!
+
+<a href="https://github.com/ink-developer/PyMax/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=ink-developer/PyMax" />
+</a>

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/README.md

@@ -135,7 +135,13 @@ if __name__ == "__main__":
 
 ## Авторы
 
-- **[noxzion](https://github.com/noxzion)** — оригинальный автор проекта
-- **[ink](https://github.com/ink-developer)** — второй разработчик, исследование API и его документация
-- **[fresh-milkshake](https://github.com/fresh-milkshake)** — контрибьютор и автор лого
+- **[noxzion](https://github.com/noxzion)** — Оригинальный автор проекта
+- **[ink](https://github.com/ink-developer)** — Главный разработчик, исследование API и его документация
 
+## Контрибьюторы
+
+Спасибо всем за помощь в разработке!
+
+<a href="https://github.com/ink-developer/PyMax/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=ink-developer/PyMax" />
+</a>

maxapi_python-1.1.8/examples/example.py

@@ -0,0 +1,62 @@
+import asyncio
+import logging
+
+from pymax import MaxClient, Message, SocketMaxClient
+from pymax.files import Photo
+from pymax.filters import Filter
+from pymax.static import AttachType
+
+phone = "+1234567890"
+
+
+client = MaxClient(phone=phone, work_dir="cache")
+# client = SocketMaxClient(phone=phone, work_dir="cache")
+
+
+@client.on_message(filter=Filter(chat_id=0))
+async def handle_message(message: Message) -> None:
+    print(str(message.sender) + ": " + message.text)
+
+
+@client.on_start
+async def handle_start() -> None:
+    print("Client started successfully!")
+    # print(client.dialogs)
+    history = await client.fetch_history(chat_id=0)
+    if history:
+        for message in history:
+            if message.attaches:
+                for attach in message.attaches:
+                    if attach.type == AttachType.CONTROL:
+                        print(attach.event)
+                        print(attach.extra)
+                    # if attach.type == AttachType.VIDEO:
+                    #     print(message)
+                    #     vid = await client.get_video_by_id(
+                    #         chat_id=0,
+                    #         video_id=attach.video_id,
+                    #         message_id=message.id,
+                    #     )
+                    #     print(vid.url)
+                    # elif attach.type == AttachType.FILE:
+                    #     file = await client.get_file_by_id(
+                    #         chat_id=0,
+                    #         file_id=attach.file_id,
+                    #         message_id=message.id,
+                    #     )
+                    #     print(file.url)
+    # print(client.me.names[0].first_name)
+    # user = await client.get_user(client.me.id)
+
+    # print(user.names[0].first_name)
+
+    # photo1 = Photo(path="tests/test.jpeg")
+    # photo2 = Photo(path="tests/test.jpg")
+
+    # await client.send_message(
+    #     "Hello with photo!", chat_id=0, photos=[photo1, photo2], notify=True
+    # )
+
+
+if __name__ == "__main__":
+    asyncio.run(client.start())

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "maxapi-python"
-version = "1.1.5"
+version = "1.1.8"
 description = "Python wrapper для API мессенджера Max"
 readme = "README.md"
 requires-python = ">=3.10"

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/src/pymax/files.py

@@ -56,7 +56,7 @@ class Photo(BaseFile):
             return (extension[1:], ("image/" + extension[1:]).lower())
         elif self.url:
             extension = Path(self.url).suffix.lower()
-            if extension in self.ALLOWED_EXTENSIONS:
+            if extension not in self.ALLOWED_EXTENSIONS:
                 raise ValueError(
                     f"Invalid photo extension in URL: {extension}. Allowed: {self.ALLOWED_EXTENSIONS}"
                 )

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/src/pymax/mixins/message.py

@@ -10,16 +10,16 @@ from pymax.payloads import (
     DeleteMessagePayload,
     EditMessagePayload,
     FetchHistoryPayload,
+    GetFilePayload,
+    GetVideoPayload,
     PinMessagePayload,
     ReplyLink,
     SendMessagePayload,
     SendMessagePayloadMessage,
     UploadPhotoPayload,
-    GetVideoPayload,
-    GetFilePayload,
 )
 from pymax.static import AttachType, Opcode
-from pymax.types import Attach, Message, FileRequest, VideoRequest
+from pymax.types import Attach, FileRequest, Message, VideoRequest
 
 
 class MessageMixin(ClientProtocol):
@@ -143,7 +143,6 @@ class MessageMixin(ClientProtocol):
             data = await self._send_and_wait(opcode=Opcode.MSG_SEND, payload=payload)
             if error := data.get("payload", {}).get("error"):
                 self.logger.error("Send message error: %s", error)
-                print(data)
                 return None
             msg = Message.from_dict(data["payload"]) if data.get("payload") else None
             self.logger.debug("send_message result: %r", msg)
@@ -286,12 +285,11 @@ class MessageMixin(ClientProtocol):
             self.logger.exception("Fetch history failed")
             return None
 
-
     async def get_video_by_id(
         self,
         chat_id: int,
         message_id: int,
-        video_id: str,
+        video_id: int,
     ) -> VideoRequest | None:
         """
         Получает видео
@@ -307,33 +305,37 @@ class MessageMixin(ClientProtocol):
             url (str): Ссылка на видео
         """
         try:
-            self.logger.info(
-                "Getting video_id=%s message_id=%s", video_id, message_id
-            )
+            self.logger.info("Getting video_id=%s message_id=%s", video_id, message_id)
 
-            payload = GetVideoPayload(
-                chat_id=chat_id,
-                message_id=message_id,
-                video_id=video_id
-            ).model_dump(by_alias=True)
+            if self.is_connected and self._socket is not None:
+                payload = GetVideoPayload(
+                    chat_id=chat_id, message_id=message_id, video_id=video_id
+                ).model_dump(by_alias=True)
+            else:
+                payload = GetVideoPayload(
+                    chat_id=chat_id, message_id=str(message_id), video_id=video_id
+                ).model_dump(by_alias=True)
 
             data = await self._send_and_wait(opcode=Opcode.VIDEO_PLAY, payload=payload)
 
             if error := data.get("payload", {}).get("error"):
                 self.logger.error("Get video error: %s", error)
-            
-            video = VideoRequest.from_dict(data["payload"]) if data.get("payload") else None 
-            self.logger.debug(" result: %r", video)
+                return
+
+            video = (
+                VideoRequest.from_dict(data["payload"]) if data.get("payload") else None
+            )
+            self.logger.debug("result: %r", video)
             return video
         except Exception:
             self.logger.exception("Get video error")
             return None
-        
+
     async def get_file_by_id(
         self,
         chat_id: int,
         message_id: int,
-        file_id: str,
+        file_id: int,
     ) -> FileRequest | None:
         """
         Получает файл
@@ -348,20 +350,28 @@ class MessageMixin(ClientProtocol):
             url (str): Ссылка на скачивание файла
         """
         try:
-            self.logger.info(
-                "Getting file_id=%s message_id=%s", file_id, message_id
+            self.logger.info("Getting file_id=%s message_id=%s", file_id, message_id)
+            if self.is_connected and self._socket is not None:
+                payload = GetFilePayload(
+                    chat_id=chat_id, message_id=message_id, file_id=file_id
+                ).model_dump(by_alias=True)
+            else:
+                payload = GetFilePayload(
+                    chat_id=chat_id, message_id=str(message_id), file_id=file_id
+                ).model_dump(by_alias=True)
+            data = await self._send_and_wait(
+                opcode=Opcode.FILE_DOWNLOAD, payload=payload
             )
-            payload = GetFilePayload(
-                chat_id=chat_id,
-                message_id=message_id,
-                file_id=file_id
-            ).model_dump(by_alias=True)
-            data = await self._send_and_wait(opcode=Opcode.FILE_DOWNLOAD, payload=payload)
+
             if error := data.get("payload", {}).get("error"):
                 self.logger.error("Get file error: %s", error)
-            file = FileRequest.from_dict(data["payload"]) if data.get("payload") else None 
+                return
+
+            file = (
+                FileRequest.from_dict(data["payload"]) if data.get("payload") else None
+            )
             self.logger.debug(" result: %r", file)
             return file
         except Exception:
             self.logger.exception("Get video error")
-            return None
+            return None

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/src/pymax/mixins/user.py

@@ -1,5 +1,5 @@
 from pymax.interfaces import ClientProtocol
-from pymax.payloads import FetchContactsPayload
+from pymax.payloads import FetchContactsPayload, SearchByPhonePayload
 from pymax.static import Opcode
 from pymax.types import User
 
@@ -80,3 +80,38 @@ class UserMixin(ClientProtocol):
         except Exception:
             self.logger.exception("Fetch users failed")
             return []
+
+    async def search_by_phone(self, phone: str) -> User | None:
+        """
+        Ищет пользователя по номеру телефона.
+
+        Args:
+            phone (str): Номер телефона.
+
+        Returns:
+            User | None: Объект User или None при ошибке.
+        """
+        try:
+            self.logger.info("Searching user by phone: %s", phone)
+
+            payload = SearchByPhonePayload(phone=phone).model_dump(by_alias=True)
+
+            data = await self._send_and_wait(
+                opcode=Opcode.CONTACT_INFO_BY_PHONE, payload=payload
+            )
+            if error := data.get("payload", {}).get("error"):
+                self.logger.error("Search by phone error: %s", error)
+                return None
+
+            user = (
+                User.from_dict(data["payload"]["contact"])
+                if data.get("payload")
+                else None
+            )
+            if user:
+                self._users[user.id] = user
+                self.logger.debug("Found user by phone: %s", user)
+            return user
+        except Exception:
+            self.logger.exception("Search by phone failed")
+            return None

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/src/pymax/payloads.py

@@ -194,12 +194,18 @@ class NavigationEventPayload(CamelModel):
 class NavigationPayload(CamelModel):
     events: list[NavigationEventPayload]
 
+
 class GetVideoPayload(CamelModel):
     chat_id: int
-    message_id: str
+    message_id: int | str
     video_id: int
 
+
 class GetFilePayload(CamelModel):
     chat_id: int
-    message_id: str
+    message_id: str | int
     file_id: int
+
+
+class SearchByPhonePayload(CamelModel):
+    phone: str

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/src/pymax/static.py

@@ -191,6 +191,7 @@ class AttachType(str, Enum):
     VIDEO = "VIDEO"
     FILE = "FILE"
     STICKER = "STICKER"
+    CONTROL = "CONTROL"
 
 
 class Constants(Enum):

{maxapi_python-1.1.5 → maxapi_python-1.1.8}/src/pymax/types.py

@@ -39,6 +39,32 @@ class Names:
         return self.name
 
 
+class ControlAttach:
+    def __init__(self, type: AttachType, event: str, **kwargs: dict[str, Any]) -> None:
+        self.type = type
+        self.event = event
+        self.extra = kwargs
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> "ControlAttach":
+        data = dict(data)
+        attach_type = AttachType(data.pop("_type"))
+        event = data.pop("event")
+        return cls(
+            type=attach_type,
+            event=event,
+            **data,
+        )
+
+    @override
+    def __repr__(self) -> str:
+        return f"ControlAttach(type={self.type!r}, event={self.event!r}, extra={self.extra!r})"
+
+    @override
+    def __str__(self) -> str:
+        return f"ControlAttach: {self.event}"
+
+
 class PhotoAttach:
     def __init__(
         self,
@@ -181,7 +207,7 @@ class FileRequest:
         return cls(
             unsafe=data["unsafe"],
             url=data["url"],
-    )
+        )
 
 
 class VideoRequest:
@@ -197,15 +223,16 @@ class VideoRequest:
 
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> "VideoRequest":
-
-        listdata = list(data.values()) # Костыль ✅
-
+        # listdata = list(data.values()) # Костыль ✅
+        url = [v for k, v in data.items() if k not in ("EXTERNAL", "cache")][
+            0
+        ]  # Еще больший костыль ✅
         return cls(
             external=data["EXTERNAL"],
             cache=data["cache"],
-            url=listdata[2],
-    )
-        
+            url=url,
+        )
+
 
 class Me:
     def __init__(
@@ -280,7 +307,7 @@ class Message:
         text: str,
         status: MessageStatus | str | None,
         type: MessageType | str,
-        attaches: list[PhotoAttach | VideoAttach | FileAttach],
+        attaches: list[PhotoAttach | VideoAttach | FileAttach | ControlAttach] | None,
     ) -> None:
         self.chat_id = chat_id
         self.sender = sender
@@ -305,6 +332,8 @@ class Message:
                 attaches.append(VideoAttach.from_dict(a))
             elif a["_type"] == AttachType.FILE:
                 attaches.append(FileAttach.from_dict(a))
+            elif a["_type"] == AttachType.CONTROL:
+                attaches.append(ControlAttach.from_dict(a))
         return cls(
             chat_id=data.get("chatId"),
             sender=message.get("sender"),

maxapi_python-1.1.5/examples/example.py

@@ -1,82 +0,0 @@
-import asyncio
-import logging
-
-from pymax import MaxClient, Message, SocketMaxClient
-from pymax.files import Photo
-from pymax.filters import Filter
-from pymax.static import AttachType
-
-phone = "+1234567890"
-
-
-client = MaxClient(phone=phone, work_dir="cache")
-# client = SocketMaxClient(phone=phone, work_dir="cache")
-
-
-async def main() -> None:
-    for chat in client.chats:
-        print(chat.title)
-
-        message = await client.send_message(
-            "Hello from MaxClient!", chat.id, notify=True
-        )
-
-        await asyncio.sleep(5)
-        message = await client.edit_message(
-            chat.id, message.id, "Hello from MaxClient! (edited)"
-        )
-        await asyncio.sleep(5)
-
-        await client.delete_message(chat.id, [message.id], for_me=False)
-
-    for dialog in client.dialogs:
-        print(dialog.last_message.text)
-
-    for channel in client.channels:
-        print(channel.title)
-
-    await client.close()
-
-
-@client.on_message(filter=Filter(chat_id=0))
-async def handle_message(message: Message) -> None:
-    print(str(message.sender) + ": " + message.text)
-
-
-@client.on_start
-async def handle_start() -> None:
-    print("Client started successfully!")
-    history = await client.fetch_history(chat_id=0)
-    if history:
-        for message in history:
-            if message.attaches:
-                for attach in message.attaches:
-                    if attach.type == AttachType.VIDEO:
-                        vid = await client.get_video_by_id(
-                            chat_id=0,
-                            video_id=attach.video_id,
-                            message_id=message.id,
-                        )
-                        print(vid.url)
-                    elif attach.type == AttachType.FILE:
-                        file = await client.get_file_by_id(
-                            chat_id=0,
-                            file_id=attach.file_id,
-                            message_id=message.id,
-                        )
-                        print(file.url)
-    # print(client.me.names[0].first_name)
-    # user = await client.get_user(client.me.id)
-
-    # print(user.names[0].first_name)
-
-    # photo1 = Photo(path="tests/test.jpeg")
-    # photo2 = Photo(path="tests/test.jpg")
-
-    # await client.send_message(
-    #     "Hello with photo!", chat_id=0, photos=[photo1, photo2], notify=True
-    # )
-
-
-if __name__ == "__main__":
-    asyncio.run(client.start())