maxapi-python 1.2.1__tar.gz → 1.2.3__tar.gz

maxapi_python-1.2.3/.github/workflows/tests.yml

@@ -0,0 +1,153 @@
+name: Tests
+
+#on:
+#  push:
+#    branches: [ main, develop ]
+#  pull_request:
+#    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install runtime + test tools
+        run: |
+          python -m pip install --upgrade pip
+          # Устанавливаем package (runtime deps)
+          pip install -e "."
+          # Явно ставим инструменты для тестов/линта, чтобы они были доступны в runner
+          pip install pytest pytest-asyncio pytest-cov pytest-timeout flake8 mypy
+
+      - name: Lint with flake8
+        run: |
+          flake8 src/pymax tests \
+            --count \
+            --select=E9,F63,F7,F82 \
+            --show-source \
+            --statistics
+          flake8 src/pymax tests \
+            --count \
+            --exit-zero \
+            --max-complexity=10 \
+            --max-line-length=79 \
+            --statistics
+        continue-on-error: true
+
+      - name: Type check with mypy
+        run: |
+          mypy src/pymax \
+            --ignore-missing-imports \
+            --no-error-summary
+        continue-on-error: true
+
+      - name: Run unit tests
+        run: |
+          pytest -m "not mockserver" \
+            --cov=src/pymax \
+            --cov-report=xml \
+            --cov-report=term-missing
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage.xml
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false
+
+      - name: Archive pytest cache
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: pytest-cache-${{ matrix.python-version }}
+          path: .pytest_cache/
+          retention-days: 5
+
+  integration-tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository (with submodules)
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install runtime + test tools (integration)
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e "."
+          pip install pytest pytest-asyncio pytest-cov pytest-timeout flake8 mypy
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+
+      - name: Start MockServer
+        run: |
+          git clone https://github.com/fresh-milkshake/gomax-prerelease.git
+          cd gomax-prerelease/mockserver
+          go mod download
+          go run cmd/server/main.go &
+          sleep 3
+
+      - name: Run integration tests
+        run: |
+          pytest -m mockserver -v --tb=short
+        continue-on-error: true
+        env:
+          MOCKSERVER_WS_URL: ws://localhost:8080/
+          MOCKSERVER_HTTP_URL: http://localhost:8080
+
+  code-quality:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install dependencies + quality tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e "."
+          # black/isort/pylint используются только в этом job
+          pip install black isort pylint
+
+      - name: Check code formatting with black
+        run: black --check src/pymax tests
+        continue-on-error: true
+
+      - name: Check import sorting with isort
+        run: isort --check-only src/pymax tests
+        continue-on-error: true

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/.gitignore

@@ -116,7 +116,7 @@ cache/
 # Keep lockfiles and important configs tracked? If you want to track specific lockfiles,
 # remove them from this .gitignore (for example: remove poetry.lock or uv.lock).
 tests2/
-tests/
+tests
 
 
 # Bad dev's requirements

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxapi-python
-Version: 1.2.1
+Version: 1.2.3
 Summary: Python wrapper для API мессенджера Max
 Project-URL: Homepage, https://github.com/ink-developer/PyMax
 Project-URL: Repository, https://github.com/ink-developer/PyMax
@@ -19,6 +19,13 @@ Requires-Dist: msgpack>=1.1.1
 Requires-Dist: qrcode>=8.2
 Requires-Dist: sqlmodel>=0.0.24
 Requires-Dist: websockets>=15.0
+Provides-Extra: test
+Requires-Dist: flake8; extra == 'test'
+Requires-Dist: mypy; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest-timeout>=2.1.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -36,11 +43,6 @@ Description-Content-Type: text/markdown
     <img src="https://img.shields.io/badge/packaging-uv-D7FF64.svg" alt="Packaging">
 </p>
 
-> [!IMPORTANT]
-> (20.12.25) Из за резкого изменения апи большая часть библиотеки не работает.
-Смотрите [новость](https://t.me/pymax_news/111)
-> 
-> P.s добавил логин по qr в dev/1.2.1
 
 ---
 > ⚠️ **Дисклеймер**
@@ -82,6 +84,41 @@ uv add -U maxapi-python
 
 ## Быстрый старт
 
+### Аутентификация (`device_type`)
+
+> [!IMPORTANT]
+> Параметр `device_type` в `UserAgentPayload` **критически важен** для выбора способа авторизации:
+
+**Вход по номеру телефона (DESKTOP):**
+
+```python
+from pymax import MaxClient
+from pymax.payloads import UserAgentPayload
+
+ua = UserAgentPayload(device_type="DESKTOP", app_version="25.12.13")
+
+client = MaxClient(
+    phone="+79111111111",
+    work_dir="cache",
+    headers=ua,
+)
+```
+
+**Вход через QR-код (WEB)** — токен совместим с веб-версией Max:
+
+```python
+from pymax import MaxClient
+from pymax.payloads import UserAgentPayload
+
+ua = UserAgentPayload(device_type="WEB", app_version="25.12.13")
+
+client = MaxClient(
+    phone="+7911111111",
+    work_dir="cache",
+    headers=ua,
+)
+```
+
 ### Базовый пример использования
 
 ```python

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/README.md

@@ -13,11 +13,6 @@
     <img src="https://img.shields.io/badge/packaging-uv-D7FF64.svg" alt="Packaging">
 </p>
 
-> [!IMPORTANT]
-> (20.12.25) Из за резкого изменения апи большая часть библиотеки не работает.
-Смотрите [новость](https://t.me/pymax_news/111)
-> 
-> P.s добавил логин по qr в dev/1.2.1
 
 ---
 > ⚠️ **Дисклеймер**
@@ -59,6 +54,41 @@ uv add -U maxapi-python
 
 ## Быстрый старт
 
+### Аутентификация (`device_type`)
+
+> [!IMPORTANT]
+> Параметр `device_type` в `UserAgentPayload` **критически важен** для выбора способа авторизации:
+
+**Вход по номеру телефона (DESKTOP):**
+
+```python
+from pymax import MaxClient
+from pymax.payloads import UserAgentPayload
+
+ua = UserAgentPayload(device_type="DESKTOP", app_version="25.12.13")
+
+client = MaxClient(
+    phone="+79111111111",
+    work_dir="cache",
+    headers=ua,
+)
+```
+
+**Вход через QR-код (WEB)** — токен совместим с веб-версией Max:
+
+```python
+from pymax import MaxClient
+from pymax.payloads import UserAgentPayload
+
+ua = UserAgentPayload(device_type="WEB", app_version="25.12.13")
+
+client = MaxClient(
+    phone="+7911111111",
+    work_dir="cache",
+    headers=ua,
+)
+```
+
 ### Базовый пример использования
 
 ```python

maxapi_python-1.2.3/examples/example.py

@@ -0,0 +1,74 @@
+import asyncio
+import datetime
+import logging
+from time import time
+from typing import Any
+
+import pymax
+from pymax import MaxClient, Message, ReactionInfo, SocketMaxClient, filters
+from pymax.files import File, Photo, Video
+from pymax.filters import Filters
+from pymax.payloads import UserAgentPayload
+from pymax.static.enum import AttachType, Opcode
+from pymax.types import Chat
+
+phone = "+79991234567"
+headers = UserAgentPayload(device_type="WEB")
+
+client = MaxClient(
+    phone=phone,
+    work_dir="cache",
+    reconnect=False,
+    logger=None,
+    headers=headers,
+)
+client.logger.setLevel(logging.INFO)
+
+
+@client.on_start
+async def handle_start() -> None:
+    print(f"Client started as {client.me.names[0].first_name}!")
+
+
+@client.on_raw_receive
+async def handle_raw_receive(data: dict[str, Any]) -> None:
+    print(f"Raw data received: {data}")
+
+
+@client.on_reaction_change
+async def handle_reaction_change(
+    message_id: str, chat_id: int, reaction_info: ReactionInfo
+) -> None:
+    print(
+        f"Reaction changed on message {message_id} in chat {chat_id}: "
+        f"Total count: {reaction_info.total_count}, "
+        f"Your reaction: {reaction_info.your_reaction}, "
+        f"Counters: {reaction_info.counters[0].reaction}={reaction_info.counters[0].count}"
+    )
+
+
+@client.on_chat_update
+async def handle_chat_update(chat: Chat) -> None:
+    print(f"Chat updated: {chat.id}, new title: {chat.title}")
+
+
+@client.on_message(Filters.chat(0) & Filters.text("hello"))
+async def handle_message(message: Message) -> None:
+    print(f"New message in chat {message.chat_id} from {message.sender}: {message.text}")
+
+
+@client.on_message_edit()
+async def handle_edited_message(message: Message) -> None:
+    print(f"Edited message in chat {message.chat_id}: {message.text}")
+
+
+@client.on_message_delete()
+async def handle_deleted_message(message: Message) -> None:
+    print(f"Deleted message in chat {message.chat_id}: {message.id}")
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(client.start())
+    except KeyboardInterrupt:
+        print("Client stopped by user")

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "maxapi-python"
-version = "1.2.1"
+version = "1.2.3"
 description = "Python wrapper для API мессенджера Max"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -36,7 +36,25 @@ where = ["src"]
 [tool.setuptools.package-dir]
 "" = "src"
 
+[project.optional-dependencies]
+test = [
+  "pytest>=8.0.0",
+  "pytest-asyncio>=0.24.0",
+  "pytest-cov>=5.0.0",
+  "pytest-timeout>=2.1.0",
+  "flake8",
+  "mypy",
+]
+
 [dependency-groups]
+test = [
+  "pytest>=8.0.0",
+  "pytest-asyncio>=0.24.0",
+  "pytest-cov>=5.0.0",
+  "pytest-timeout>=2.1.0",
+  "flake8",
+  "mypy",
+]
 dev = [
   "furo>=2025.9.25",
   "ghp-import>=2.1.0",
@@ -46,6 +64,10 @@ dev = [
   "pre-commit>=4.3.0",
   "pydocstring>=0.2.1",
   "sphinx>=8.1.3",
+  "pytest>=8.0.0",
+  "pytest-asyncio>=0.24.0",
+  "pytest-cov>=5.0.0",
+  "pytest-timeout>=2.1.0",
 ]
 
 [tool.hatch.build.targets.wheel]
@@ -74,3 +96,33 @@ profile = "black"
 line_length = 79
 multi_line_output = 3
 include_trailing_comma = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short --strict-markers"
+markers = [
+  "asyncio: marker for asyncio tests",
+  "mockserver: marker for MockServer integration tests",
+  "integration: marker for integration tests",
+  "slow: marker for slow tests",
+]
+
+[tool.coverage.run]
+source = ["src/pymax"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+  "pragma: no cover",
+  "def __repr__",
+  "raise AssertionError",
+  "raise NotImplementedError",
+  "if __name__ == .__main__.:",
+  "if TYPE_CHECKING:",
+  "class .*\\bProtocol\\):",
+  "@(abc\\.)?abstractmethod",
+]

maxapi_python-1.2.3/pytest.ini

@@ -0,0 +1,26 @@
+[pytest]
+
+asyncio_mode = auto
+
+testpaths = tests
+
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+
+addopts =
+    -v
+    --tb=short
+    --strict-markers
+    -ra
+    --color=yes
+
+markers =
+    asyncio: асинхронные тесты
+    mockserver: интеграционные тесты с MockServer
+    integration: интеграционные тесты
+    slow: медленные тесты
+    unit: модульные тесты
+    skip_ci: пропустить в CI
+
+timeout = 30

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/redocs/source/clients.rst

@@ -20,6 +20,28 @@ MaxClient
         logger=None,                    # Пользовательский логгер
     )
 
+.. warning::
+
+    Параметр ``device_type`` в ``UserAgentPayload`` **критически важен** для выбора способа авторизации:
+
+    **DESKTOP** — вход по номеру телефона:
+
+    .. code-block:: python
+
+        from pymax.payloads import UserAgentPayload
+
+        ua = UserAgentPayload(device_type="DESKTOP", app_version="25.12.13")
+        client = MaxClient(phone="+79111111111", headers=ua)
+
+    **WEB** — вход через QR-код; токен совместим с веб-версией Max:
+
+    .. code-block:: python
+
+        from pymax.payloads import UserAgentPayload
+
+        ua = UserAgentPayload(device_type="WEB", app_version="25.12.13")
+        client = MaxClient(phone="+79111111111", headers=ua)
+
 Основные методы:
 
 .. code-block:: python

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/src/pymax/core.py

@@ -116,6 +116,7 @@ class MaxClient(ApiMixin, WebSocketMixin, BaseClient):
         self.dialogs: list[Dialog] = []
         self.channels: list[Channel] = []
         self.me: Me | None = None
+        self.contacts: list[User] = []
         self._users: dict[int, User] = {}
 
         self._work_dir: str = work_dir
@@ -295,7 +296,7 @@ class MaxClient(ApiMixin, WebSocketMixin, BaseClient):
                 if self._token is None:
                     await self._login()
 
-                await self._sync()
+                await self._sync(self.user_agent)
 
                 await self._post_login_tasks(sync=False)
 

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/src/pymax/files.py

@@ -46,6 +46,11 @@ class Photo(BaseFile):
     }  # FIXME: костыль ✅
 
     def __init__(self, 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)
 
     def validate_photo(self) -> tuple[str, str] | None:

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/src/pymax/interfaces.py

@@ -45,6 +45,7 @@ class ClientProtocol(ABC):
         self.phone: str
         self.dialogs: list[Dialog] = []
         self.channels: list[Channel] = []
+        self.contacts: list[User] = []
         self.me: Me | None = None
         self.host: str
         self.port: int

{maxapi_python-1.2.1 → maxapi_python-1.2.3}/src/pymax/mixins/group.py

@@ -95,9 +95,7 @@ class GroupMixin(ClientProtocol):
             operation="add",
         ).model_dump(by_alias=True)
 
-        data = await self._send_and_wait(
-            opcode=Opcode.CHAT_MEMBERS_UPDATE, payload=payload
-        )
+        data = await self._send_and_wait(opcode=Opcode.CHAT_MEMBERS_UPDATE, payload=payload)
 
         if data.get("payload", {}).get("error"):
             MixinsUtils.handle_error(data)
@@ -155,9 +153,7 @@ class GroupMixin(ClientProtocol):
             clean_msg_period=clean_msg_period,
         ).model_dump(by_alias=True)
 
-        data = await self._send_and_wait(
-            opcode=Opcode.CHAT_MEMBERS_UPDATE, payload=payload
-        )
+        data = await self._send_and_wait(opcode=Opcode.CHAT_MEMBERS_UPDATE, payload=payload)
 
         if data.get("payload", {}).get("error"):
             MixinsUtils.handle_error(data)
@@ -293,6 +289,33 @@ class GroupMixin(ClientProtocol):
 
         return chat
 
+    async def resolve_group_by_link(self, link: str) -> Chat | None:
+        """
+        Разрешает группу по ссылке
+
+        Args:
+            link (str): Ссылка на группу.
+
+        Returns:
+            Chat | None: Объект чата группы или None, если не найдено.
+        """
+        proceed_link = self._process_chat_join_link(link)
+        if proceed_link is None:
+            raise ValueError("Invalid group link")
+
+        data = await self._send_and_wait(
+            opcode=Opcode.LINK_INFO,
+            payload={
+                "link": proceed_link,
+            },
+        )
+
+        if data.get("payload", {}).get("error"):
+            MixinsUtils.handle_error(data)
+
+        chat = Chat.from_dict(data["payload"].get("chat", {}))
+        return chat
+
     async def rework_invite_link(self, chat_id: int) -> Chat:
         """
         Пересоздает ссылку для приглашения в группу
@@ -329,14 +352,10 @@ class GroupMixin(ClientProtocol):
             chat_id for chat_id in chat_ids if await self._get_chat(chat_id) is None
         ]
         if missed_chat_ids:
-            payload = GetChatInfoPayload(chat_ids=missed_chat_ids).model_dump(
-                by_alias=True
-            )
+            payload = GetChatInfoPayload(chat_ids=missed_chat_ids).model_dump(by_alias=True)
         else:
             chats: list[Chat] = [
-                chat
-                for chat_id in chat_ids
-                if (chat := await self._get_chat(chat_id)) is not None
+                chat for chat_id in chat_ids if (chat := await self._get_chat(chat_id)) is not None
             ]
             return chats