Добавить поддержку байтов в файлах, рефактор транспортов и метод read_message

Author: ink-developer

redocs/source/clients.rst

@@ -84,6 +84,19 @@ MaxClient
         limit=50
     )
 
+    # Изменить профиль с загрузкой фото
+    result = await client.change_profile(
+        first_name="Иван",
+        last_name="Петров",
+        description="Привет!",
+        photo=Photo(...)  # Новая фотография профиля
+    )
+
+    # Разрешить группу по ссылке
+    group = await client.resolve_group_by_link(
+        link="https://max.app/g/ABC123"
+    )
+
 Свойства:
 
 .. code-block:: python
@@ -95,6 +108,7 @@ MaxClient
     client.channels             # Список каналов (list[Channel])
     client.phone                # Номер телефона (str)
     client.token                # Токен сессии (str | None)
+    client.contacts             # Список контактов (list[User])
 
 Обработчики событий:
 

redocs/source/conf.py

@@ -6,7 +6,7 @@
 project = "PyMax"
 author = "ink-developer"
 copyright = "2025, ink-developer"
-release = "1.1.21"
+release = "1.2.3"
 
 # -- Path setup ---------------------------------------------------------------
 sys.path.insert(0, os.path.abspath("../../src"))

redocs/source/index.rst

@@ -5,6 +5,7 @@
 .. image:: _static/logo.svg
    :align: center
    :width: 320px
+
 PyMax
 =====
 
@@ -34,13 +35,18 @@ PyMax
    decorators
    examples
    guides
+   release_notes
 
 .. rubric:: Особенности
 
 - Вход по номеру телефона
 - Отправка / редактирование / удаление сообщений
 - Управление чатами, каналами и диалогами
 - Получение истории сообщений
+- Загрузка фотографий профиля
+- Разрешение групп по ссылке
+- Поддержка контактов в сообщениях
+- Управление списком контактов
 
 ---
 

redocs/source/release_notes.rst

@@ -0,0 +1,61 @@
+Release Notes v1.2.3
+====================
+
+Новые функции
+-------------
+
+**Загрузка фотографий профиля**
+    Профиль теперь может быть обновлен с загрузкой новой фотографии через метод ``change_profile()``.
+
+**Разрешение групп по ссылке**
+    Группы теперь могут быть разрешены (получены) прямо по их ссылке через метод ``resolve_group_by_link()``.
+
+**Поддержка контактов в сообщениях**
+    Сообщения теперь поддерживают вложения типа контакта с информацией о контакте (ContactAttach).
+
+**Список контактов клиента**
+    Клиент теперь ведет список всех контактов пользователя через свойство ``client.contacts``.
+
+Новые методы
+------------
+
+MaxClient.resolve_group_by_link(link: str) -> Chat | None
+    Разрешает группу по ссылке. Возвращает объект чата группы или None, если не найдено.
+
+MaxClient.change_profile(first_name, last_name, description, photo)
+    Изменяет информацию профиля текущего пользователя, включая загрузку новой фотографии.
+
+Новые типы
+----------
+
+ContactAttach
+    Представляет контакт в сообщении. Содержит информацию о контакте (ID, имя, фамилия, фото).
+
+Измененные типы
+---------------
+
+Message
+    Теперь поддерживает вложения типа ContactAttach в список attaches.
+
+Names
+    Улучшен для работы с различными форматами имен пользователя.
+
+StickerAttach
+    Улучшено представление стикеров в сообщениях.
+
+Photo
+    Улучшено для работы с фотографиями профиля.
+
+AttachType
+    Добавлено значение CONTACT для контактов.
+
+Новые параметры
+---------------
+
+MaxClient.contacts: list[User]
+    Список контактов текущего пользователя.
+
+Версия
+------
+
+**1.2.3** - выпущена 24 декабря 2025 г.

src/pymax/files.py

@@ -9,7 +9,10 @@
 
 
 class BaseFile(ABC):
-    def __init__(self, url: str | None = None, path: str | None = None) -> None:
+    def __init__(
+        self, raw: bytes | None = None, *, url: str | None = None, path: str | None = None
+    ) -> None:
+        self.raw = raw
         self.url = url
         self.path = path
 
@@ -21,6 +24,9 @@ def __init__(self, url: str | None = None, path: str | None = None) -> None:
 
     @abstractmethod
     async def read(self) -> bytes:
+        if self.raw is not None:
+            return self.raw
+
         if self.url:
             async with (
                 ClientSession() as session,
@@ -45,13 +51,15 @@ class Photo(BaseFile):
         ".bmp",
     }  # FIXME: костыль ✅
 
-    def __init__(self, url: str | None = None, path: str | None = None) -> None:
+    def __init__(
+        self, raw: bytes | None = None, *, url: str | None = None, path: str | None = None
+    ) -> None:
         if path:
             self.file_name = Path(path).name
         elif url:
             self.file_name = Path(url).name
 
-        super().__init__(url, path)
+        super().__init__(raw=raw, url=url, path=path)
 
     def validate_photo(self) -> tuple[str, str] | None:
         if self.path:
@@ -83,7 +91,9 @@ async def read(self) -> bytes:
 
 
 class Video(BaseFile):
-    def __init__(self, url: str | None = None, path: str | None = None) -> None:
+    def __init__(
+        self, raw: bytes | None = None, *, url: str | None = None, path: str | None = None
+    ) -> None:
         self.file_name: str = ""
         if path:
             self.file_name = Path(path).name
@@ -92,15 +102,17 @@ def __init__(self, url: str | None = None, path: str | None = None) -> None:
 
         if not self.file_name:
             raise ValueError("Either url or path must be provided.")
-        super().__init__(url, path)
+        super().__init__(raw=raw, url=url, path=path)
 
     @override
     async def read(self) -> bytes:
         return await super().read()
 
 
 class File(BaseFile):
-    def __init__(self, url: str | None = None, path: str | None = None) -> None:
+    def __init__(
+        self, raw: bytes | None = None, *, url: str | None = None, path: str | None = None
+    ) -> None:
         self.file_name: str = ""
         if path:
             self.file_name = Path(path).name
@@ -110,7 +122,7 @@ def __init__(self, url: str | None = None, path: str | None = None) -> None:
         if not self.file_name:
             raise ValueError("Either url or path must be provided.")
 
-        super().__init__(url, path)
+        super().__init__(raw=raw, url=url, path=path)
 
     @override
     async def read(self) -> bytes: