dev/2.1.0

.github/workflows/publish.yml

@@ -9,22 +9,52 @@ permissions:
   contents: read
 
 jobs:
+  release-checks:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          python-version: "3.10"
+          enable-cache: true
+
+      - name: Check lint
+        run: uv run ruff check src tests
+
+      - name: Check formatting
+        run: uv run ruff format --check src tests
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Build docs
+        run: uv run sphinx-build -b html docs /tmp/pymax-docs
+
   release-build:
     runs-on: ubuntu-latest
+    needs: release-checks
 
     steps:
       - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
 
       - name: Set up uv
         uses: astral-sh/setup-uv@v4
         with:
           python-version: "3.10"
+          enable-cache: true
 
       - name: Build release distributions
         run: uv build
 
       - name: Check distributions
-        run: uvx twine check dist/*
+        run: uv run twine check dist/*
 
       - name: Upload distributions
         uses: actions/upload-artifact@v4

.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: local
+    hooks:
+      - id: ruff-check
+        name: ruff check
+        entry: uv run ruff check --fix
+        language: system
+        types_or: [python, pyi]
+
+      - id: ruff-format
+        name: ruff format
+        entry: uv run ruff format
+        language: system
+        types_or: [python, pyi]

README.md

@@ -153,6 +153,9 @@ client.include_router(router)
 
 ```bash
 uv sync --all-groups
+uv run pre-commit install
+uv run pre-commit run --all-files
+uv run pytest
 uv run python -c "import pymax; print(pymax.__all__)"
 uv run sphinx-build -b html docs docs/_build/html
 ```

docs/index.rst

@@ -18,6 +18,12 @@ PyMax - асинхронная Python-библиотека для Max API. Он
 минимальный рабочий пример с авторизацией, обработчиком сообщений и запуском
 клиента.
 
+.. toctree::
+   :maxdepth: 1
+   :caption: Новости
+
+   release-2-1-0
+
 .. toctree::
    :maxdepth: 2
    :caption: Руководство

docs/release-2-1-0.rst

@@ -0,0 +1,43 @@
+PyMax 2.1.0
+===========
+
+Изменения относительно ``2.0.1``.
+
+Добавлено
+---------
+
+* Заявки на вступление в группы и каналы: ``get_join_requests()``,
+  ``confirm_join_request()`` /
+  ``confirm_join_requests()`` и отклонить их через ``decline_join_request()`` /
+  ``decline_join_requests()``.
+* Доменные типы ``Member`` и ``Presence`` для заявок.
+* 2FA: ``check_2fa()`` и ``change_password()``.
+* QR-вход: ``authorize_qr_login(qr_link)``.
+* Web app-боты: ``get_bot_init_data(bot_id, chat_id, start_param=None)``.
+
+Исправлено
+----------
+
+* TCP-заголовок приведен к схеме Max: ``ver:1``, ``cmd:1``, ``seq:2``,
+  ``opcode:2``, ``len/cof:4``. ``seq`` больше не падает после ``255``.
+* Upload фото, видео и файлов использует ``ExtraConfig.proxy`` для HTTP-отправки
+  на upload URL.
+* ``MaxApiError.title`` и ``MaxApiError.localized_message`` могут быть ``None``.
+
+Изменилось
+----------
+
+* ``check_2fa()`` возвращает ``False``, если профиль еще не загружен или сервер
+  не прислал ``profile_options``.
+* При заданном ``ExtraConfig.proxy`` upload-запросы тоже идут через proxy.
+  Proxy должен выдерживать большие HTTP POST-запросы.
+* ``Capability`` разделен на ``ProfileOptions`` и ``TwoFactorAction``.
+* ``ApiFacade`` получил ``bots``-сервис.
+
+Миграция
+--------
+
+* Код на ``Client`` и ``WebClient`` обычно менять не нужно.
+* Импорт ``pymax.api.auth.enums.Capability`` замените на ``TwoFactorAction`` или
+  ``ProfileOptions``.
+* Если код ждал строку в ``MaxApiError.title``, теперь нужно учитывать ``None``.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "maxapi-python"
-version = "2.0.1"
+version = "2.1.0"
 description = "Python wrapper для API мессенджера Max"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -89,37 +89,39 @@ dev = [
   {include-group = "docs"},
   {include-group = "test"},
   "build>=1.2.0",
+  "pre-commit>=4.0.0",
   "twine>=5.0.0",
   "pyright>=1.1.390",
-  "black>=24.0.0",
-  "isort>=5.13.0",
-  "flake8>=7.0.0",
+  "ruff>=0.8.0",
 ]
 
 [tool.pyright]
 venv = ".venv"
 venvPath = "."
 
-[tool.black]
+[tool.ruff]
 line-length = 79
-target-version = ["py310"]
+target-version = "py310"
 
-[tool.flake8]
-max-line-length = 79
-max-complexity = 10
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/pymax/**/__init__.py" = ["F401", "F403"]
+"tests/**" = ["F401"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "auto"
 
 [tool.mypy]
 python_version = "3.10"
 warn_return_any = true
 warn_unused_configs = true
 plugins = ["pydantic.mypy"]
 
-[tool.isort]
-profile = "black"
-line_length = 79
-multi_line_output = 3
-include_trailing_comma = true
-
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 testpaths = ["tests"]

src/pymax/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.0.1"
+__version__ = "2.1.0"
 
 
 from .auth import (

src/pymax/api/auth/enums.py

@@ -8,10 +8,21 @@ class AuthType(str, Enum):
     RESEND = "RESEND"
 
 
-class Capability(int, Enum):
-    DEFAULT = 0  # В душе не чаю что это такое но при первой установке 2фа там 0 3 4 так что пусть будет дефолт
+class ProfileOptions(int, Enum):
+    """Битовые/числовые признаки профиля, связанные с 2FA."""
+
     ESIA_VERIFIED_FLAG = 1
     SECOND_FACTOR_PASSWORD_ENABLED = 2
     SECOND_FACTOR_HAS_EMAIL = 3
     SECOND_FACTOR_HAS_HINT = 4
+
+
+class TwoFactorAction(int, Enum):
+    """Действия 2FA, передаваемые в expectedCapabilities."""
+
+    SET_PASSWORD = 0
+    UPDATE_PASSWORD = 1
+    RESTORE_PASSWORD = 2
+    HINT = 3
+    EMAIL = 4
     REMOVE_2FA = 5

src/pymax/api/auth/payloads.py

@@ -1,10 +1,10 @@
-from pydantic import Field, field_serializer
+from pydantic import Field
 
 from pymax.api.models import CamelModel
 from pymax.api.session.payloads import MobileUserAgentPayload
 from pymax.types.domain.sync import DEFAULT_CONFIG_HASH, ConfigHash, SyncState
 
-from .enums import AuthType, Capability
+from .enums import AuthType, TwoFactorAction
 
 
 class RequestCodePayload(CamelModel):
@@ -115,15 +115,19 @@ class SetHintPayload(CamelModel):
 
 
 class SetTwoFactorPayload(CamelModel):
-    expected_capabilities: list[Capability]
+    expected_capabilities: list[TwoFactorAction]
     track_id: str
     password: str
     hint: str | None = None
 
 
 class RemoveTwoFactorPayload(CamelModel):
     track_id: str
-    remove2fa: bool = True
-    expected_capabilities: list[Capability] = Field(
-        default_factory=lambda: [Capability.REMOVE_2FA]
+    remove2fa: bool = Field(default=True, alias="remove2fa")
+    expected_capabilities: list[TwoFactorAction] = Field(
+        default_factory=lambda: [TwoFactorAction.REMOVE_2FA]
     )
+
+
+class ApproveQrLoginPayload(CamelModel):
+    qr_link: str