wekon 0.1.0__tar.gz

wekon-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.venv/
+venv/
+dist/
+build/
+*.egg-info/
+.env

wekon-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wekon
+
+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.

wekon-0.1.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.5
+Name: wekon
+Version: 0.1.0
+Summary: Библиотека для ботов Wekon
+Project-URL: Homepage, https://github.com/SpeachGame/wekon_python
+Project-URL: Source, https://github.com/SpeachGame/wekon_python
+Project-URL: Issues, https://github.com/SpeachGame/wekon_python/issues
+Author: Wekon
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,async,bot,bots,wekon
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: Russian
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# wekon
+
+Библиотека для ботов Wekon на Python 3.10+.
+
+## Установка
+
+```bash
+pip install wekon
+```
+
+Пока пакета нет на PyPI, ставьте напрямую с GitHub:
+
+```bash
+pip install "wekon @ git+https://github.com/SpeachGame/wekon_python.git"
+```
+
+## Первый бот
+
+Создайте бота у `@god_bot`, получите ключ и запишите его в переменную `WEKON_BOT_API_KEY`.
+
+```python
+from wekon import Bot
+
+bot = Bot("echo_bot")  # ключ из WEKON_BOT_API_KEY
+
+@bot.command("start")
+def start(msg):
+    msg.reply("Привет! Как вас зовут?", buttons=[("Сайт", "https://wekon.ru")])
+
+@bot.message()
+def echo(msg):
+    msg.reply(msg.text)
+
+bot.run()
+```
+
+Библиотека сама получает и обновляет токен, повторяет запросы при лимитах и сбоях, не шлёт
+дубли при обрыве связи, держит порядок событий внутри чата и отвечает на нажатия кнопок.
+
+Обычные функции работают параллельно по чатам. Для тысяч одновременных пользователей есть
+асинхронный вариант с теми же возможностями: `from wekon.aio import Bot` и `async def`.
+
+## Примеры
+
+- [`examples/game_2048.py`](examples/game_2048.py) — игра: сетка кнопок, размеры, цвета, удержание.
+- [`examples/shop_bot.py`](examples/shop_bot.py) — магазин: карточка, форма, оплата.
+
+## Чистый экран
+
+В личном чате с ботом можно удалять и сообщения человека, например команду или ответ на вопрос:
+
+```python
+@bot.message(state="name")
+def save_name(msg):
+    msg.delete()  # ответ человека исчезает, на экране остаётся только карточка бота
+```
+
+В группе чужие сообщения удаляет только бот с правом модератора, а в подключённом чате двух людей чужие удалять нельзя.
+
+## Файлы от людей
+
+Фото, видео, голосовые, кружки, аудио и документы приходят во вложениях:
+
+```python
+@bot.message(types=["photo", "voice", "document"])
+def save(msg):
+    file = msg.message.file                 # media_type, name, mime_type, size, duration
+    data = msg.download()                   # байты
+    msg.download(path=file.name)            # или сразу на диск
+```
+
+## Адрес
+
+По умолчанию `https://prod.wekon.ru/api/v1`. Другой адрес: `Bot("my_bot", base_url="...")`.
+
+## Диалоги и счета в проде
+
+`MemoryStorage` держит шаги диалогов и связь «заказ — счёт» в памяти: при перезапуске они
+теряются. Для работы в проде передайте свой класс с методами `get(key)` и `set(key, state, data)`:
+`Bot("my_bot", storage=MyStorage())`.
+
+## Оплата
+
+Ключи кассы остаются в вашей программе, на сервер Wekon они не попадают. Варианты на выбор:
+
+1. Готовая касса: `bot.send_payment(chat_id, YooKassa(...), order_id, amount, title)`.
+2. Своя интеграция и заготовка карточки: `send_invoice` и `set_invoice_status`.
+3. Полностью своя оплата: обычные карточки, кнопки и формы.
+
+ЮKassa и CloudPayments написаны по их документации. Т-Банк и Robokassa перед запуском сверьте
+с документацией кассы. Ни одна касса пока не проверена настоящим платежом.
+
+Пример: [`examples/shop_bot.py`](examples/shop_bot.py).

wekon-0.1.0/README.md

@@ -0,0 +1,93 @@
+# wekon
+
+Библиотека для ботов Wekon на Python 3.10+.
+
+## Установка
+
+```bash
+pip install wekon
+```
+
+Пока пакета нет на PyPI, ставьте напрямую с GitHub:
+
+```bash
+pip install "wekon @ git+https://github.com/SpeachGame/wekon_python.git"
+```
+
+## Первый бот
+
+Создайте бота у `@god_bot`, получите ключ и запишите его в переменную `WEKON_BOT_API_KEY`.
+
+```python
+from wekon import Bot
+
+bot = Bot("echo_bot")  # ключ из WEKON_BOT_API_KEY
+
+@bot.command("start")
+def start(msg):
+    msg.reply("Привет! Как вас зовут?", buttons=[("Сайт", "https://wekon.ru")])
+
+@bot.message()
+def echo(msg):
+    msg.reply(msg.text)
+
+bot.run()
+```
+
+Библиотека сама получает и обновляет токен, повторяет запросы при лимитах и сбоях, не шлёт
+дубли при обрыве связи, держит порядок событий внутри чата и отвечает на нажатия кнопок.
+
+Обычные функции работают параллельно по чатам. Для тысяч одновременных пользователей есть
+асинхронный вариант с теми же возможностями: `from wekon.aio import Bot` и `async def`.
+
+## Примеры
+
+- [`examples/game_2048.py`](examples/game_2048.py) — игра: сетка кнопок, размеры, цвета, удержание.
+- [`examples/shop_bot.py`](examples/shop_bot.py) — магазин: карточка, форма, оплата.
+
+## Чистый экран
+
+В личном чате с ботом можно удалять и сообщения человека, например команду или ответ на вопрос:
+
+```python
+@bot.message(state="name")
+def save_name(msg):
+    msg.delete()  # ответ человека исчезает, на экране остаётся только карточка бота
+```
+
+В группе чужие сообщения удаляет только бот с правом модератора, а в подключённом чате двух людей чужие удалять нельзя.
+
+## Файлы от людей
+
+Фото, видео, голосовые, кружки, аудио и документы приходят во вложениях:
+
+```python
+@bot.message(types=["photo", "voice", "document"])
+def save(msg):
+    file = msg.message.file                 # media_type, name, mime_type, size, duration
+    data = msg.download()                   # байты
+    msg.download(path=file.name)            # или сразу на диск
+```
+
+## Адрес
+
+По умолчанию `https://prod.wekon.ru/api/v1`. Другой адрес: `Bot("my_bot", base_url="...")`.
+
+## Диалоги и счета в проде
+
+`MemoryStorage` держит шаги диалогов и связь «заказ — счёт» в памяти: при перезапуске они
+теряются. Для работы в проде передайте свой класс с методами `get(key)` и `set(key, state, data)`:
+`Bot("my_bot", storage=MyStorage())`.
+
+## Оплата
+
+Ключи кассы остаются в вашей программе, на сервер Wekon они не попадают. Варианты на выбор:
+
+1. Готовая касса: `bot.send_payment(chat_id, YooKassa(...), order_id, amount, title)`.
+2. Своя интеграция и заготовка карточки: `send_invoice` и `set_invoice_status`.
+3. Полностью своя оплата: обычные карточки, кнопки и формы.
+
+ЮKassa и CloudPayments написаны по их документации. Т-Банк и Robokassa перед запуском сверьте
+с документацией кассы. Ни одна касса пока не проверена настоящим платежом.
+
+Пример: [`examples/shop_bot.py`](examples/shop_bot.py).

wekon-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "wekon"
+version = "0.1.0"
+description = "Библиотека для ботов Wekon"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Wekon" }]
+keywords = ["wekon", "bot", "bots", "api", "async"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Natural Language :: Russian",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://github.com/SpeachGame/wekon_python"
+Source = "https://github.com/SpeachGame/wekon_python"
+Issues = "https://github.com/SpeachGame/wekon_python/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-asyncio>=0.23"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["wekon"]
+
+[tool.hatch.build.targets.sdist]
+include = ["wekon", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"

wekon-0.1.0/wekon/__init__.py

@@ -0,0 +1,20 @@
+"""wekon — библиотека для ботов Wekon."""
+from . import inline, payments
+from .bot import Context, MemoryStorage
+from .cards import Card, Form, cell, gap, item, mark, option, stat, step, tag
+from .client import Client, bind, check_login
+from .errors import (AuthError, BadRequest, Conflict, Forbidden, NetworkError, NotFound, NotSupported,
+                     RateLimited, ServerError, WekonError)
+from .keyboards import (ForceReply, Keyboard, RemoveKeyboard, ReplyKeyboard, button, copy_button, form_button,
+                        inline_button, login_button, url_button)
+from .simple import Bot
+from .types import Attachment, CallbackQuery, Chat, InlineQuery, Message, Sent, Update, User
+
+__version__ = "0.1.0"
+__all__ = [
+    "Bot", "Client", "Context", "MemoryStorage", "Card", "Form", "Keyboard", "ReplyKeyboard", "RemoveKeyboard", "ForceReply",
+    "button", "url_button", "copy_button", "form_button", "inline_button", "login_button", "cell", "gap", "item", "mark", "option",
+    "stat", "step", "tag", "bind", "check_login", "inline", "payments", "WekonError", "AuthError", "BadRequest", "Conflict", "Forbidden",
+    "NetworkError", "NotFound", "NotSupported", "RateLimited", "ServerError", "Attachment", "CallbackQuery", "Chat", "InlineQuery",
+    "Message", "Sent", "Update", "User",
+]

wekon-0.1.0/wekon/aio.py

@@ -0,0 +1,5 @@
+"""Асинхронный бот для тех, кому нужен ``async def``: ``from wekon.aio import Bot``."""
+from .bot import Bot, Context, MemoryStorage
+from .client import Client
+
+__all__ = ["Bot", "Client", "Context", "MemoryStorage"]