maxbridge-client 0.2.0__tar.gz

maxbridge_client-0.2.0/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+Все заметные изменения в этом проекте будут документироваться в этом файле.
+
+Формат основан на [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-03-14
+
+### Добавлено
+- Интерактивное меню в test_cli.py для работы с чатами
+- Метод `get_chat_messages()` для получения сообщений чата
+- Подробная документация API в `docs/API.md`
+- Примеры использования в `examples/`
+- Файл CONTRIBUTING.md для контрибьюторов
+- Кэширование пользователей при логине
+- Правильное отображение названий чатов
+
+### Изменено
+- Улучшена обработка ошибок
+- Обновлена структура документации
+- Улучшен README.md
+
+### Исправлено
+- Исправлен импорт в test_cli.py
+- Убрано тестовое сообщение из основного скрипта
+
+## [0.1.0] - 2026-03-14
+
+### Добавлено
+- Базовый WebSocket клиент для MAX API
+- Авторизация по токену и SMS
+- Отправка текстовых сообщений
+- Управление чатами и пользователями
+- Загрузка и скачивание файлов
+- Модели данных (User, Chat, Message)
+- Система исключений
+- Асинхронный контекстный менеджер
+- Базовая документация
+
+### Технические детали
+- WebSocket соединение к `wss://ws-api.oneme.ru/websocket`
+- JSON-RPC 2.0 протокол с кастомными полями
+- Автоматическое keepalive
+- Кэширование данных
+- Обработка переподключений

maxbridge_client-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,150 @@
+# Contributing to VK Max Client
+
+Спасибо за интерес к проекту! Вот как вы можете помочь развитию библиотеки.
+
+## 🚀 Быстрый старт
+
+1. Форкните репозиторий
+2. Создайте ветку для вашей фичи: `git checkout -b feature/amazing-feature`
+3. Установите зависимости: `./venv/bin/pip install -r requirements.txt`
+4. Внесите изменения
+5. Протестируйте: `./venv/bin/python test_cli.py`
+6. Создайте коммит: `git commit -m 'Add amazing feature'`
+7. Отправьте в ваш форк: `git push origin feature/amazing-feature`
+8. Создайте Pull Request
+
+## 📝 Стиль кода
+
+### Python стиль
+- Используйте `black` для форматирования
+- Следуйте PEP 8
+- Добавляйте типизацию (type hints)
+- Документируйте функции docstrings
+
+### Структура кода
+```
+maxbridge/
+├── client.py          # Основной клиент
+├── models.py          # Модели данных
+├── exceptions.py      # Исключения
+├── functions/         # API функции
+│   ├── __init__.py
+│   ├── messages.py    # Функции сообщений
+│   ├── users.py       # Функции пользователей
+│   └── ...
+└── __init__.py
+```
+
+## 🧪 Тестирование
+
+### Запуск тестов
+```bash
+./venv/bin/python test_cli.py
+```
+
+### Добавление новых тестов
+- Создавайте тесты в `tests/` директории
+- Используйте `pytest` для запуска
+- Тестируйте как успешные, так и ошибочные сценарии
+
+## 🔍 Отладка API
+
+### Анализ трафика
+1. Используйте Wireshark или аналог для захвата WebSocket трафика
+2. Анализируйте JSON пакеты
+3. Определяйте opcode для новых функций
+
+### Логирование
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+## 📚 Добавление новой функциональности
+
+### 1. Исследование
+- Изучите официальное приложение MAX
+- Найдите нужную функцию в UI
+- Захватите сетевой трафик
+
+### 2. Реализация
+```python
+# functions/new_feature.py
+async def new_function(client: MaxClient, param: str) -> dict:
+    """Description of the function"""
+    return await client.invoke_method(
+        opcode=NEW_OPCODE,
+        payload={"param": param}
+    )
+```
+
+### 3. Документация
+- Добавьте docstring
+- Обновите `docs/API.md`
+- Добавьте пример в `examples/`
+
+### 4. Тестирование
+- Протестируйте все сценарии
+- Проверьте обработку ошибок
+- Убедитесь в совместимости
+
+## 🐛 Сообщение об ошибках
+
+### Шаблон issue
+```
+**Описание проблемы:**
+Краткое описание
+
+**Шаги воспроизведения:**
+1. Шаг 1
+2. Шаг 2
+3. Шаг 3
+
+**Ожидаемое поведение:**
+Что должно происходить
+
+**Фактическое поведение:**
+Что происходит на самом деле
+
+**Скриншоты/логи:**
+Приложите если возможно
+
+**Среда:**
+- OS: [Windows/Linux/Mac]
+- Python: [версия]
+- Версия библиотеки: [версия]
+```
+
+## 📋 Соглашение о коммитах
+
+```
+feat: add new message reactions
+fix: handle connection timeout
+docs: update API documentation
+style: format code with black
+refactor: simplify message parsing
+test: add tests for file upload
+```
+
+## 🎯 Roadmap
+
+### Краткосрочные цели
+- [ ] Полная поддержка всех типов сообщений
+- [ ] Поддержка групповых звонков
+- [ ] Кэширование файлов
+- [ ] Поддержка stickers
+
+### Долгосрочные цели
+- [ ] Синхронный API wrapper
+- [ ] CLI инструмент
+- [ ] GUI приложение
+- [ ] Поддержка других платформ
+
+## 📞 Контакты
+
+- Issues: [GitHub Issues](https://github.com/username/max-bridge/issues)
+- Discussions: [GitHub Discussions](https://github.com/username/max-bridge/discussions)
+
+## 📄 Лицензия
+
+Все контрибуции принимаются под лицензией MIT.

maxbridge_client-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MaxBridge contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

maxbridge_client-0.2.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include CHANGELOG.md
+include CONTRIBUTING.md
+include LICENSE
+include requirements.txt
+recursive-include docs *.md
+recursive-include examples *.py
+global-exclude *.pyc
+global-exclude __pycache__
+global-exclude .git*

maxbridge_client-0.2.0/PKG-INFO

@@ -0,0 +1,299 @@
+Metadata-Version: 2.4
+Name: maxbridge-client
+Version: 0.2.0
+Summary: Асинхронная Python библиотека для MAX API
+Home-page: https://github.com/username/max-bridge
+Author: VK Max Client Team
+Author-email: 
+Maintainer: VK Max Client Team
+License: MIT License
+        
+        Copyright (c) 2026 MaxBridge contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Homepage, https://github.com/username/max-bridge
+Project-URL: Documentation, https://github.com/username/max-bridge/docs/
+Project-URL: Repository, https://github.com/username/max-bridge
+Project-URL: Bug Reports, https://github.com/username/max-bridge/issues
+Project-URL: Source, https://github.com/username/max-bridge
+Keywords: vk,max,messenger,api,websocket,async
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# MaxBridge
+
+[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Asyncio](https://img.shields.io/badge/Asyncio-Supported-green.svg)](https://docs.python.org/3/library/asyncio.html)
+
+Асинхронная Python библиотека для взаимодействия с API мессенджера MAX через WebSocket соединение.
+
+## Описание
+
+MaxBridge предоставляет удобный интерфейс для работы с мессенджером MAX, позволяя отправлять и получать сообщения, управлять чатами, пользователями и файлами в асинхронном режиме.
+
+## 🚀 Быстрый старт
+
+```python
+import asyncio
+from maxbridge import MaxClient
+
+async def main():
+    async with MaxClient() as client:
+        # Авторизация по токену
+        await client.login_by_token("ваш_токен")
+
+        # Получение списка чатов
+        chats = client.get_cached_chats()
+        print(f"Найдено чатов: {len(chats)}")
+
+asyncio.run(main())
+```
+
+## 📦 Установка
+
+```bash
+# Установка из PyPI (предполагается, что пакет опубликован)
+pip install maxbridge
+
+# Или из исходников
+git clone <repository-url>
+cd max-bridge
+pip install -e .
+```
+
+## 🔐 Авторизация
+
+### По токену
+
+**Важно:** Для авторизации необходимо получить токен доступа из веб-версии MAX.
+
+#### Как получить токен:
+
+1. Откройте https://web.max.ru в браузере
+2. Авторизуйтесь в вашем аккаунте
+3. Откройте DevTools (F12) → Application → Local Storage → https://web.max.ru
+4. Найдите ключ `token` и скопируйте его значение
+
+```python
+async with MaxClient() as client:
+    await client.login_by_token("ваш_длинный_токен")
+```
+
+**Примечание:** Токен является конфиденциальной информацией. Храните его securely.
+
+## 💬 Работа с чатами
+
+### Получение списка чатов
+
+```python
+chats = client.get_cached_chats()
+for chat_id, chat_info in chats.items():
+    print(f"ID: {chat_id}, Тип: {chat_info['type']}, Название: {chat_info.get('title', 'Диалог')}")
+```
+
+### Получение сообщений чата
+
+```python
+messages = await client.get_chat_messages(chat_id=123456, count=50, offset=0)
+if "payload" in messages and "messages" in messages["payload"]:
+    for msg_id, msg in messages["payload"]["messages"].items():
+        print(f"{msg['sender']}: {msg['text']}")
+```
+
+## 📨 Отправка сообщений
+
+```python
+from maxbridge.functions import messages
+
+# Текстовое сообщение
+await messages.send_message(client, chat_id=123456, text="Привет!")
+
+# С фото
+await messages.send_photo(client, chat_id=123456, image_path="photo.jpg", caption="Фото")
+
+# Реплай
+await messages.reply_message(client, chat_id=123456, text="Ответ", reply_to_message_id="msg_id")
+```
+
+## 👥 Управление пользователями
+
+```python
+from maxbridge.functions import users
+
+# Информация о пользователях
+user_info = await users.resolve_users(client, user_ids=[12345, 67890])
+
+# Добавить в контакты
+await users.add_to_contacts(client, user_id=12345)
+```
+
+## 📁 Работа с файлами
+
+```python
+from maxbridge.functions import messages, uploads
+
+# Отправка файла
+await messages.send_file(client, chat_id=123456, file_path="document.pdf", caption="Документ")
+
+# Скачивание файла
+download_url = await uploads.download_file(
+    client, chat_id=123456, message_id="msg_id", file_id=789
+)
+```
+
+## 📺 Работа с медиа
+
+```python
+# Скачивание видео
+video_url = await uploads.download_video(
+    client, chat_id=123456, message_id="msg_id", video_id=101112
+)
+```
+
+## 👥 Группы и каналы
+
+```python
+from maxbridge.functions import groups, channels
+
+# Создание группы
+await groups.create_group(client, "Название группы", participant_ids=[123, 456])
+
+# Присоединение к каналу
+await channels.join_channel(client, "username_канала")
+
+# Информация о канале
+channel_info = await channels.resolve_channel_username(client, "username")
+```
+
+## 🛠️ Обработка ошибок
+
+```python
+from maxbridge.exceptions import APIError, ConnectionError
+
+try:
+    await client.login_by_token("токен")
+except APIError as e:
+    print(f"Ошибка API {e.error_code}: {e.message}")
+except ConnectionError:
+    print("Ошибка подключения")
+```
+
+## 📊 Модели данных
+
+```python
+from maxbridge.models import User, Chat, Message
+
+# Примеры
+user = User(id=123, name="Имя", username="username")
+chat = Chat(id=456, title="Название", type="DIALOG")
+message = Message(id="msg_id", chat_id=456, user_id=123, text="Текст")
+```
+
+## 🔧 Продвинутые возможности
+
+### Обработка событий в реальном времени
+
+```python
+def event_handler(client, packet):
+    if packet.get("opcode") == 64:  # Новое сообщение
+        print("Новое сообщение!")
+
+client.set_packet_callback(event_handler)
+```
+
+### Кастомные настройки
+
+```python
+# Профиль
+profile = client.profile
+
+# Кэшированные пользователи
+users = client.get_cached_users()
+```
+
+## 📚 Документация
+
+- [API Reference](docs/API.md)
+- [Примеры](examples/)
+- [Contributing](CONTRIBUTING.md)
+- [Changelog](CHANGELOG.md)
+
+## 🏗️ Структура проекта
+
+```
+maxbridge/
+├── __init__.py
+├── client.py          # WebSocket клиент
+├── models.py          # Модели данных
+├── exceptions.py      # Исключения
+├── packet.py          # Обработка пакетов
+└── functions/         # API функции
+    ├── __init__.py
+    ├── messages.py    # Сообщения
+    ├── users.py       # Пользователи
+    ├── groups.py      # Группы
+    ├── channels.py    # Каналы
+    ├── profile.py     # Профиль
+    └── uploads.py     # Загрузки
+
+docs/                  # Документация
+examples/              # Примеры
+```
+
+## ⚠️ Важные замечания
+
+- Все методы асинхронные — используйте `await`
+- Рекомендуется `async with MaxClient() as client:`
+- Токены имеют срок действия
+- Соблюдайте лимиты API
+
+## 🐛 Отладка
+
+```python
+import logging
+logging.basicConfig(level=logging.INFO)
+```
+
+## 📄 Лицензия
+
+MIT License