Archive¶
Архив предыдущих версий.
v1.2.4 (30 декабря 2025)¶
Новые функции¶
- Поддержка различных типов файлов в классах File и Photo
Классы
Photo,FileиVideoтеперь поддерживают работу с байтами, что позволяет загружать файлы из памяти напрямую.- Автоматическая отправка уведомлений о прочтении сообщений
Клиент теперь автоматически отправляет сервису уведомления о получении сообщений для улучшения синхронизации.
- Параметр session_name для управления сессией
Параметр
session_nameпозволяет указать пользовательское имя файла для сохранения сессии.- Получение текущей версии веб-приложения
Новый метод
get_current_web_version()в утилитах для получения текущей версии веб-приложения Max.- Улучшенная генерация User-Agent
Теперь используется библиотека
ua-generatorдля более реалистичной генерации User-Agent строк и параметров устройства.
Новые методы¶
- read_message(chat_id: int, message_id: int) -> ReadState
Отмечает сообщение как прочитанное. Возвращает объект ReadState с информацией о состоянии.
- pymax.utils.MixinsUtils.get_current_web_version() -> str | None
Получает текущую версию веб-приложения Max из источника. Возвращает версию в формате "XX.XX.XX" или None.
Измененные методы¶
- MaxClient.start()
Улучшена логика работы цикла переподключения с использованием
asyncio.Eventдля более чистого завершения. Исправлена обработка состояния при отключении и переподключении.- MaxClient.close()
Упрощена логика закрытия клиента. Теперь использует
asyncio.Eventдля сигнала остановки.
Новые параметры¶
- MaxClient.__init__(session_name: str = "session.db")
Позволяет указать пользовательское имя файла базы данных сессии.
Измененные типы¶
- BaseFile
Теперь поддерживает работу с байтами через параметр
rawво всех подклассах.- Photo
Добавлен параметр
nameдля явного указания имени файла при работе с байтами. Улучшена валидация расширений файлов.- File
Добавлена поддержка работы с байтами через параметр
raw. Улучшена обработка имен файлов.- Video
Добавлена поддержка работы с байтами через параметр
raw. Улучшена работа с видеофайлами.
Исправления и улучшения¶
Добавлена валидация
device_typeдля MaxClient (поддерживает только WEB) и SocketMaxClient (поддерживает ANDROID, IOS, DESKTOP)Улучшена обработка ошибок WebSocket при отключении
Добавлена опция
ua-generatorдля более реалистичной генерации параметров устройстваОбновлена версия приложения до 25.12.14
Улучшена обработка уведомлений о доставке сообщений
Исправлены проблемы с завершением async задач при закрытии клиента
Зависимости¶
- Добавлены новые зависимости:
ua-generator>=2.0.19— для генерации реалистичных User-Agent строк и параметров устройства
v1.2.3 (24 декабря 2025)¶
Новые функции¶
- Загрузка фотографий профиля
Профиль теперь может быть обновлен с загрузкой новой фотографии через метод
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]
Список контактов текущего пользователя.