maxapi-python 1.1.7__tar.gz → 1.1.9__tar.gz

maxapi_python-1.1.9/.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.9/.github/ISSUE_TEMPLATE/feature_request.md

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

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

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

maxapi_python-1.1.9/.github/pull_request_template.md

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

{maxapi_python-1.1.7 → maxapi_python-1.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxapi-python
-Version: 1.1.7
+Version: 1.1.9
 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.7 → maxapi_python-1.1.9}/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.7 → maxapi_python-1.1.9}/examples/example.py

@@ -21,27 +21,35 @@ async def handle_message(message: Message) -> None:
 @client.on_start
 async def handle_start() -> None:
     print("Client started successfully!")
+    sessions = await client.get_sessions()
+    for session in sessions:
+        print(session.client)
     # 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.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)
+    #         if message.link:
+    #             print(message.link.chat_id)
+    #             print(message.link.message.text)
+    # 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)
 

{maxapi_python-1.1.7 → maxapi_python-1.1.9}/pyproject.toml

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

{maxapi_python-1.1.7 → maxapi_python-1.1.9}/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.7 → maxapi_python-1.1.9}/src/pymax/mixins/user.py

@@ -1,7 +1,7 @@
 from pymax.interfaces import ClientProtocol
 from pymax.payloads import FetchContactsPayload, SearchByPhonePayload
 from pymax.static import Opcode
-from pymax.types import User
+from pymax.types import Session, User
 
 
 class UserMixin(ClientProtocol):
@@ -115,3 +115,19 @@ class UserMixin(ClientProtocol):
         except Exception:
             self.logger.exception("Search by phone failed")
             return None
+
+    async def get_sessions(self) -> list[Session] | None:
+        try:
+            self.logger.info("Fetching sessions")
+
+            data = await self._send_and_wait(opcode=Opcode.SESSIONS_INFO, payload={})
+
+            if error := data.get("payload", {}).get("error"):
+                self.logger.error("Fetching sessions error: %s", error)
+                return None
+
+            return [Session.from_dict(s) for s in data["payload"].get("sessions", [])]
+
+        except Exception:
+            self.logger.exception("Fetching sessions failed")
+            return None

{maxapi_python-1.1.7 → maxapi_python-1.1.9}/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.7 → maxapi_python-1.1.9}/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,
@@ -268,6 +294,29 @@ class Element:
         return f"{self.type}({self.length})"
 
 
+class MessageLink:
+    def __init__(self, chat_id: int, message: "Message", type: str) -> None:
+        self.chat_id = chat_id
+        self.message = message
+        self.type = type
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> "MessageLink":
+        return cls(
+            chat_id=data["chatId"],
+            message=Message.from_dict(data["message"]),
+            type=data["type"],
+        )
+
+    @override
+    def __repr__(self) -> str:
+        return f"MessageLink(chat_id={self.chat_id!r}, message={self.message!r}, type={self.type!r})"
+
+    @override
+    def __str__(self) -> str:
+        return f"MessageLink: {self.chat_id}/{self.message.id}"
+
+
 class Message:
     def __init__(
         self,
@@ -278,10 +327,11 @@ class Message:
         options: int | None,
         id: int,
         time: int,
+        link: MessageLink | None,
         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
@@ -293,6 +343,7 @@ class Message:
         self.type = type
         self.attaches = attaches
         self.status = status
+        self.link = link
         self.reactionInfo = reaction_info
 
     @classmethod
@@ -306,6 +357,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"),
@@ -317,6 +370,9 @@ class Message:
             type=message["type"],
             attaches=attaches,
             status=message.get("status"),
+            link=MessageLink.from_dict(message.get("link"))
+            if message.get("link")
+            else None,
             reaction_info=message.get("reactionInfo"),
         )
 
@@ -614,3 +670,40 @@ class Attach:  # УБРАТЬ ГАДА!!! или нет...
     @override
     def __str__(self) -> str:
         return f"Attach: {self.type}"
+
+
+class Session:
+    def __init__(
+        self,
+        client: str,
+        info: str,
+        location: str,
+        time: int,
+        current: bool | None = None,
+    ) -> None:
+        self.client = client
+        self.info = info
+        self.location = location
+        self.time = time
+        self.current = current if current is not None else False
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> "Session":
+        return cls(
+            client=data["client"],
+            info=data["info"],
+            location=data["location"],
+            time=data["time"],
+            current=data.get("current"),
+        )
+
+    @override
+    def __repr__(self) -> str:
+        return (
+            f"Session(client={self.client!r}, info={self.info!r}, "
+            f"location={self.location!r}, time={self.time!r}, current={self.current!r})"
+        )
+
+    @override
+    def __str__(self) -> str:
+        return f"Session: {self.client} from {self.location} at {self.time} (current={self.current})"