aiomax2 0.1.0a2__tar.gz

aiomax2-0.1.0a2/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,41 @@
+name: Сообщить об ошибке
+description: Воспроизводимая ошибка в aiomax2
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: Не публикуйте MAX token, webhook secret или персональные данные.
+  - type: input
+    id: version
+    attributes:
+      label: Версия aiomax2
+      placeholder: 0.1.0a1
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Версия Python
+      placeholder: 3.12.7
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Шаги воспроизведения
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Ожидаемое поведение
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Фактическое поведение и traceback
+    validations:
+      required: true
+

aiomax2-0.1.0a2/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,24 @@
+name: Предложить улучшение
+description: Новый API, DX или документационное улучшение
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: use_case
+    attributes:
+      label: Сценарий использования
+      description: Какую задачу разработчика решает предложение?
+    validations:
+      required: true
+  - type: textarea
+    id: max_source
+    attributes:
+      label: Источник MAX API
+      description: Ссылка на официальную документацию или OpenAPI, если применимо.
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Предлагаемый API
+    validations:
+      required: true
+

aiomax2-0.1.0a2/.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## Что изменено
+
+Опишите изменение и его пользовательский эффект.
+
+## Источник MAX API
+
+Добавьте ссылку на официальную документацию/OpenAPI или укажите, что изменение
+не затрагивает API MAX.
+
+## Проверка
+
+- [ ] `python -m ruff format --check .`
+- [ ] `python -m ruff check .`
+- [ ] `python -m mypy src/aiomax2`
+- [ ] `python -m pytest`
+- [ ] Документация и примеры соответствуют реальному public API
+- [ ] В изменениях нет tokens, secrets и пользовательских данных

aiomax2-0.1.0a2/.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - run: python -m pip install -e ".[dev]"
+      - run: python -m ruff format --check .
+      - run: python -m ruff check .
+      - run: python -m mypy src/aiomax2
+      - run: python -m pytest
+

aiomax2-0.1.0a2/.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "src/**"
+      - "mkdocs.yml"
+      - "pyproject.toml"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+      - run: python -m pip install -e ".[docs]"
+      - run: python -m mkdocs build --strict
+      - name: Upload GitHub Pages artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

aiomax2-0.1.0a2/.gitignore

@@ -0,0 +1,61 @@
+# Python bytecode and caches
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Build and packaging artifacts
+build/
+dist/
+.eggs/
+*.egg
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Tests and coverage artifacts (the tests/ source directory is tracked)
+.pytest_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+.tox/
+.nox/
+
+# Linters and type checkers
+.mypy_cache/
+.ruff_cache/
+.pytype/
+.pyre/
+
+# Documentation builds
+site/
+.mkdocs_cache/
+
+# Local configuration and secrets
+.env
+.env.*
+!.env.example
+*.key
+*.p12
+*.pfx
+
+# Logs and temporary files
+*.log
+*.tmp
+*.swp
+*~
+
+# IDEs and editors
+.idea/
+.vscode/
+.fleet/
+*.code-workspace
+
+# Operating system files
+.DS_Store
+Thumbs.db
+Desktop.ini

aiomax2-0.1.0a2/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+Все заметные изменения проекта документируются в этом файле. Формат основан
+на [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/), версии следуют
+Semantic Versioning с pre-release суффиксами.
+
+## [Unreleased]
+
+## [0.1.0a2] - 2026-10-06
+
+### Изменено
+
+- target rate limiter распространён на отправку, редактирование и удаление
+  сообщений, а также callback answers;
+- shortcuts передают `chat_id`/`user_id` в low-level методы;
+- token гарантированно добавляется к API requests с custom `ClientSession`;
+- внешние upload requests изолированы от headers API session;
+- проверяющий `SSLContext` принудительно применяется к каждому API request,
+  включая requests через custom session с небезопасным connector;
+- custom `SSLContext` без проверки hostname или сертификата отклоняется;
+- единый per-target limiter документирован как консервативная клиентская
+  политика, а process-local и multi-worker ограничения описаны явно;
+- FastAPI и Uvicorn включены в стандартную установку, optional extra удалён;
+- Webhook configuration упрощена до public base URL и локального route path;
+- lifespan annotations обновлены с `AsyncIterator` на `AsyncGenerator`;
+- пользовательская документация и примеры переведены на русский язык;
+- добавлен удобный `reply_markup` поверх настоящего MAX keyboard attachment;
+- HTML и MAX Markdown оформлены как документированный public API через
+  `TextFormat` без неподдерживаемого `MARKDOWN_V2`;
+- `attachment.not.ready` обрабатывается отдельным bounded retry только при
+  отправке/изменении сообщения с attachment;
+- исправлена ASCII-валидация `open_app` payload;
+- documentation notification-only callback уточнена с учётом необходимости
+  live verification;
+- каждый attachment retry теперь повторно учитывается per-target limiter;
+- уточнено, что `reply_markup=None` не удаляет клавиатуру, а `attachments=[]`
+  удаляет все вложения;
+- добавлен явный небезопасный режим `verify_ssl=False` с
+  `InsecureTLSWarning`, безопасный default сохранён;
+- расширено руководство по сертификатам Минцифры и добавлен официальный
+  источник: https://www.gosuslugi.ru/landing/tls.
+
+### Добавлено
+
+- конкурентные и cancellation tests rate limiter;
+- tests для нескольких targets, 30 concurrent requests и повторных `429`;
+- transport tests для TLS override, custom sessions, upload authorization и
+  исчерпания повторов после `429`;
+- полное руководство по Webhook, Long Polling, FSM, middleware и rate limits;
+- пример выбора Polling или Webhook через `MAX_MODE` для одной кодовой базы;
+- MkDocs configuration, официальный GitHub Pages workflow и community files;
+- `InlineKeyboardBuilder` для всех семи актуальных MAX button types;
+- typed `answer_callback_result()` для сохранения diagnostic message при
+  `success=false` без изменения совместимого `answer_callback() -> bool`;
+- keyboard/formatting examples, TLS troubleshooting и расширенные tests для
+  callback serialization, keyboard limits и attachment readiness.
+
+## [0.1.0a1] - 2026-10-05
+
+### Добавлено
+
+- первый alpha-релиз `Bot`, `Dispatcher`, `Router`, filters, FSM и Webhook;
+- типизированные модели MAX OpenAPI `0.0.33`;
+- aiohttp transport, TLS validation, retries и базовые rate limits;
+- unit и mock-server integration tests.

aiomax2-0.1.0a2/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Участие в разработке
+
+Спасибо за интерес к aiomax2.
+
+`aiomax2` следует актуальной документации и OpenAPI-схеме MAX.
+Архитектура и developer experience могут использовать знакомые подходы из
+aiogram 3.x, но модели, методы, события и ограничения MAX всегда остаются
+источником истины.
+
+## Локальная настройка
+
+```bash
+git clone https://github.com/CandyCrimsie/aiomax2.git
+cd aiomax2
+
+python -m venv .venv
+python -m pip install -e ".[dev]"
+```
+
+## Перед pull request
+
+```bash
+python -m ruff format --check .
+python -m ruff check .
+python -m mypy src/aiomax2
+python -m pytest
+python -m mkdocs build --strict
+```
+
+Для изменения endpoint, модели или события приложите ссылку на официальную
+документацию MAX или строку актуальной OpenAPI-схемы.
+
+Исторические реализации и сторонние библиотеки можно использовать только как
+источник идей, но не как источник истины для поведения MAX API.
+
+Новый публичный API должен иметь typing, тесты и русскоязычный пример или
+документацию.
+
+Не добавляйте секреты, реальные токены и приватные webhook URLs в fixtures,
+examples или документацию.

aiomax2-0.1.0a2/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026-present CandyCrimsie and 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.
+