aioscam 0.1.1__tar.gz

aioscam-0.1.1/LICENSE

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

aioscam-0.1.1/PKG-INFO

@@ -0,0 +1,249 @@
+Metadata-Version: 2.4
+Name: aioscam
+Version: 0.1.1
+Summary: Async framework for Max messenger bots (aiogram-style)
+Author: AioScam Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/aioscam/aioscam
+Project-URL: Documentation, https://aioscam.readthedocs.io/
+Project-URL: Repository, https://github.com/aioscam/aioscam
+Project-URL: Bug Tracker, https://github.com/aioscam/aioscam/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Communications :: Chat
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: magic-filter>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100.0; extra == "fastapi"
+Requires-Dist: uvicorn>=0.23.0; extra == "fastapi"
+Provides-Extra: litestar
+Requires-Dist: litestar>=2.0.0; extra == "litestar"
+Requires-Dist: uvicorn>=0.23.0; extra == "litestar"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: coverage>=7.0.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
+Provides-Extra: all
+Requires-Dist: aioscam[dev,docs,fastapi,litestar]; extra == "all"
+Dynamic: license-file
+
+# AioScam
+
+Async Python framework for building Max messenger bots, inspired by aiogram architecture.
+
+## Version
+
+**v0.1.1** — Production Ready
+
+## Features
+
+- 🚀 **Fully async** - Built on `asyncio` and `aiohttp`
+- 🎯 **aiogram-style API** - Familiar decorators and patterns
+- 🔄 **Router system** - Modular bot architecture with nesting support
+- 🎭 **Magic Filters** - Declarative event filtering (`F.text`, `F.callback.payload`)
+- 🔧 **Middleware** - Request/response processing pipeline
+- 📦 **FSM** - Built-in finite state machine with MemoryStorage
+- 🛡️ **StateGuard** - Blocks unauthorized commands/callbacks during active FSM states
+- 📱 **Contact & Location** - Inline buttons for requesting phone number and geolocation
+- 🗑️ **Message Management** - Delete sent messages
+- 🌐 **Webhook support** - aiohttp, FastAPI, Litestar
+- 📡 **Polling mode** - Long-polling with exponential backoff
+- 🔒 **Security** - Webhook secret token, circular router detection, race condition prevention
+- 📦 **Python 3.9-3.12** - Wide version support
+
+## Installation
+
+### TestPyPI (Testing)
+
+```bash
+pip install --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/ aioscam
+```
+
+> ⚠️ Test version on TestPyPI. For production, install from source.
+
+### Basic installation
+
+```bash
+pip install aioscam
+
+# With FastAPI webhook support
+pip install aioscam[fastapi]
+
+# With Litestar webhook support
+pip install aioscam[litestar]
+
+# Development mode
+pip install aioscam[dev]
+```
+
+### PyPI Status
+
+- **TestPyPI**: ✅ Published ([test.pypi.org/project/aioscam/](https://test.pypi.org/project/aioscam/))
+- **PyPI**: 🟡 Planned
+
+### From source
+
+```bash
+git clone https://github.com/aioscam/aioscam.git
+cd aioscam
+pip install -e .
+```
+
+## Quick Start
+
+### Echo Bot (Polling mode)
+
+```python
+import asyncio
+from aioscam import Bot, Dispatcher, Router
+from aioscam.filters import Command, F
+
+dp = Dispatcher()
+router = Router()
+
+@router.message_created(Command("start"))
+async def cmd_start(event):
+    await event.message.answer("Привет! Я эхо-бот. Напиши мне что-нибудь!")
+
+@router.message_created()
+async def echo_message(event):
+    await event.message.answer(event.message.body.text)
+
+dp.include_router(router)
+
+async def main():
+    bot = Bot()  # Token from MAX_BOT_TOKEN env
+    await dp.start_polling(bot)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### With Magic Filters
+
+```python
+@router.message_created(F.message.body.text.func(lambda t: "привет" in t.lower()))
+async def handle_hello(event):
+    await event.message.answer("Привет! Как дела?")
+```
+
+### FSM Example
+
+```python
+from aioscam.fsm import State, StatesGroup
+
+class MyState(StatesGroup):
+    waiting_name = State()
+    waiting_age = State()
+
+@router.message_created(Command("register"))
+async def cmd_register(event, state):
+    await state.set_state(MyState.waiting_name)
+    await event.message.answer("Введите имя:")
+
+@router.message_created(MyState.waiting_name)
+async def process_name(event, state):
+    await state.update_data(name=event.message.body.text)
+    await state.set_state(MyState.waiting_age)
+    await event.message.answer("Введите возраст:")
+```
+
+### Webhook mode (aiohttp)
+
+```python
+async def main():
+    bot = Bot()
+    await dp.handle_webhook(bot=bot, host="0.0.0.0", port=8080)
+```
+
+## API Coverage
+
+### Implemented Methods (35/35 core methods)
+
+| Category | Methods |
+|----------|---------|
+| **Bot Info** | `get_me`, `get_me_from_chat`, `change_info` |
+| **Messages** | `send_message`, `edit_message`, `delete_message`, `get_message`, `get_messages`, `pin_message`, `delete_pin_message`, `get_pin_message` |
+| **Callbacks/Actions** | `send_callback`, `send_action` |
+| **Chats** | `get_chats`, `get_chat_by_id`, `get_chat_by_link`, `edit_chat`, `delete_chat`, `add_chat_members`, `remove_member_chat`, `add_list_admin_chat`, `remove_admin`, `get_chat_members`, `get_chat_member`, `get_list_admin_chat`, `delete_me_from_chat` |
+| **Updates** | `get_updates`, `get_last_marker` |
+| **Webhooks** | `subscribe_webhook`, `unsubscribe_webhook`, `delete_webhook`, `get_subscriptions` |
+| **Media** | `get_upload_url`, `upload_attachment`, `get_video` |
+
+### Event Types (14 types)
+
+`message_created`, `message_callback`, `message_edited`, `message_removed`, `bot_started`, `bot_stopped`, `bot_added`, `bot_removed`, `chat_title_changed`, `dialog_cleared`, `dialog_muted`, `dialog_unmuted`, `user_added`, `user_removed`
+
+### Button Types (8 implemented)
+
+`CallbackButton`, `LinkButton`, `ChatButton`, `MessageButton`, `ClipboardButton`, `OpenAppButton`, `RequestContactButton`, `RequestGeoLocationButton`
+
+### Sender Actions (9 types)
+
+`typing`, `upload_photo`, `record_video`, `upload_video`, `record_audio`, `upload_audio`, `upload_document`, `finding_location`, `choosing_sticker`
+
+## Project Structure
+
+```
+aioscam/
+├── bot/              # Bot client (35 API methods)
+├── client/           # HTTP client (aiohttp wrapper)
+├── dispatcher/       # Dispatcher, Router, EventContext, StateGuard
+├── enums/            # 12 enumeration files
+├── exceptions/       # 12 exception classes
+├── filters/          # BaseFilter, Command, Text, State, Magic Filters
+├── fsm/              # State, StatesGroup, MemoryStorage, Scene
+├── handler/          # MessageHandler, CallbackHandler, EventHandler
+├── methods/          # API method wrappers
+├── middleware/       # BaseMiddleware, MiddlewareManager
+├── types/            # Pydantic models (User, Chat, Message, etc.)
+├── utils/            # KeyboardBuilder, formatting, deep_linking
+└── webhook/          # aiohttp webhook handler
+```
+
+## Configuration
+
+Create `.env` file:
+
+```env
+MAX_BOT_TOKEN=your_token_here
+AIOSCAM_ENV=prod  # debug, test, prod
+```
+
+## Testing
+
+```bash
+# Run tests
+python -m pytest tests/ -v
+
+# Core tests (74/74 passing)
+python -m pytest tests/ -v --ignore=tests/test_integration.py
+```
+
+## Documentation
+
+Full documentation available at: [https://aioscam.readthedocs.io/](https://aioscam.readthedocs.io/)
+
+## License
+
+MIT License

aioscam-0.1.1/README.md

@@ -0,0 +1,201 @@
+# AioScam
+
+Async Python framework for building Max messenger bots, inspired by aiogram architecture.
+
+## Version
+
+**v0.1.1** — Production Ready
+
+## Features
+
+- 🚀 **Fully async** - Built on `asyncio` and `aiohttp`
+- 🎯 **aiogram-style API** - Familiar decorators and patterns
+- 🔄 **Router system** - Modular bot architecture with nesting support
+- 🎭 **Magic Filters** - Declarative event filtering (`F.text`, `F.callback.payload`)
+- 🔧 **Middleware** - Request/response processing pipeline
+- 📦 **FSM** - Built-in finite state machine with MemoryStorage
+- 🛡️ **StateGuard** - Blocks unauthorized commands/callbacks during active FSM states
+- 📱 **Contact & Location** - Inline buttons for requesting phone number and geolocation
+- 🗑️ **Message Management** - Delete sent messages
+- 🌐 **Webhook support** - aiohttp, FastAPI, Litestar
+- 📡 **Polling mode** - Long-polling with exponential backoff
+- 🔒 **Security** - Webhook secret token, circular router detection, race condition prevention
+- 📦 **Python 3.9-3.12** - Wide version support
+
+## Installation
+
+### TestPyPI (Testing)
+
+```bash
+pip install --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/ aioscam
+```
+
+> ⚠️ Test version on TestPyPI. For production, install from source.
+
+### Basic installation
+
+```bash
+pip install aioscam
+
+# With FastAPI webhook support
+pip install aioscam[fastapi]
+
+# With Litestar webhook support
+pip install aioscam[litestar]
+
+# Development mode
+pip install aioscam[dev]
+```
+
+### PyPI Status
+
+- **TestPyPI**: ✅ Published ([test.pypi.org/project/aioscam/](https://test.pypi.org/project/aioscam/))
+- **PyPI**: 🟡 Planned
+
+### From source
+
+```bash
+git clone https://github.com/aioscam/aioscam.git
+cd aioscam
+pip install -e .
+```
+
+## Quick Start
+
+### Echo Bot (Polling mode)
+
+```python
+import asyncio
+from aioscam import Bot, Dispatcher, Router
+from aioscam.filters import Command, F
+
+dp = Dispatcher()
+router = Router()
+
+@router.message_created(Command("start"))
+async def cmd_start(event):
+    await event.message.answer("Привет! Я эхо-бот. Напиши мне что-нибудь!")
+
+@router.message_created()
+async def echo_message(event):
+    await event.message.answer(event.message.body.text)
+
+dp.include_router(router)
+
+async def main():
+    bot = Bot()  # Token from MAX_BOT_TOKEN env
+    await dp.start_polling(bot)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### With Magic Filters
+
+```python
+@router.message_created(F.message.body.text.func(lambda t: "привет" in t.lower()))
+async def handle_hello(event):
+    await event.message.answer("Привет! Как дела?")
+```
+
+### FSM Example
+
+```python
+from aioscam.fsm import State, StatesGroup
+
+class MyState(StatesGroup):
+    waiting_name = State()
+    waiting_age = State()
+
+@router.message_created(Command("register"))
+async def cmd_register(event, state):
+    await state.set_state(MyState.waiting_name)
+    await event.message.answer("Введите имя:")
+
+@router.message_created(MyState.waiting_name)
+async def process_name(event, state):
+    await state.update_data(name=event.message.body.text)
+    await state.set_state(MyState.waiting_age)
+    await event.message.answer("Введите возраст:")
+```
+
+### Webhook mode (aiohttp)
+
+```python
+async def main():
+    bot = Bot()
+    await dp.handle_webhook(bot=bot, host="0.0.0.0", port=8080)
+```
+
+## API Coverage
+
+### Implemented Methods (35/35 core methods)
+
+| Category | Methods |
+|----------|---------|
+| **Bot Info** | `get_me`, `get_me_from_chat`, `change_info` |
+| **Messages** | `send_message`, `edit_message`, `delete_message`, `get_message`, `get_messages`, `pin_message`, `delete_pin_message`, `get_pin_message` |
+| **Callbacks/Actions** | `send_callback`, `send_action` |
+| **Chats** | `get_chats`, `get_chat_by_id`, `get_chat_by_link`, `edit_chat`, `delete_chat`, `add_chat_members`, `remove_member_chat`, `add_list_admin_chat`, `remove_admin`, `get_chat_members`, `get_chat_member`, `get_list_admin_chat`, `delete_me_from_chat` |
+| **Updates** | `get_updates`, `get_last_marker` |
+| **Webhooks** | `subscribe_webhook`, `unsubscribe_webhook`, `delete_webhook`, `get_subscriptions` |
+| **Media** | `get_upload_url`, `upload_attachment`, `get_video` |
+
+### Event Types (14 types)
+
+`message_created`, `message_callback`, `message_edited`, `message_removed`, `bot_started`, `bot_stopped`, `bot_added`, `bot_removed`, `chat_title_changed`, `dialog_cleared`, `dialog_muted`, `dialog_unmuted`, `user_added`, `user_removed`
+
+### Button Types (8 implemented)
+
+`CallbackButton`, `LinkButton`, `ChatButton`, `MessageButton`, `ClipboardButton`, `OpenAppButton`, `RequestContactButton`, `RequestGeoLocationButton`
+
+### Sender Actions (9 types)
+
+`typing`, `upload_photo`, `record_video`, `upload_video`, `record_audio`, `upload_audio`, `upload_document`, `finding_location`, `choosing_sticker`
+
+## Project Structure
+
+```
+aioscam/
+├── bot/              # Bot client (35 API methods)
+├── client/           # HTTP client (aiohttp wrapper)
+├── dispatcher/       # Dispatcher, Router, EventContext, StateGuard
+├── enums/            # 12 enumeration files
+├── exceptions/       # 12 exception classes
+├── filters/          # BaseFilter, Command, Text, State, Magic Filters
+├── fsm/              # State, StatesGroup, MemoryStorage, Scene
+├── handler/          # MessageHandler, CallbackHandler, EventHandler
+├── methods/          # API method wrappers
+├── middleware/       # BaseMiddleware, MiddlewareManager
+├── types/            # Pydantic models (User, Chat, Message, etc.)
+├── utils/            # KeyboardBuilder, formatting, deep_linking
+└── webhook/          # aiohttp webhook handler
+```
+
+## Configuration
+
+Create `.env` file:
+
+```env
+MAX_BOT_TOKEN=your_token_here
+AIOSCAM_ENV=prod  # debug, test, prod
+```
+
+## Testing
+
+```bash
+# Run tests
+python -m pytest tests/ -v
+
+# Core tests (74/74 passing)
+python -m pytest tests/ -v --ignore=tests/test_integration.py
+```
+
+## Documentation
+
+Full documentation available at: [https://aioscam.readthedocs.io/](https://aioscam.readthedocs.io/)
+
+## License
+
+MIT License

aioscam-0.1.1/aioscam/__init__.py

@@ -0,0 +1,23 @@
+"""
+AioScam - Async framework for Max messenger bots (aiogram-style)
+"""
+
+__version__ = "0.1.1"
+__author__ = "AioScam Contributors"
+
+from aioscam.bot import Bot
+from aioscam.dispatcher import Dispatcher, Router
+from aioscam.filters import Command, F, StateFilter
+from aioscam.config import Config, get_config, EnvMode
+
+__all__ = [
+    "Bot",
+    "Dispatcher",
+    "Router",
+    "Command",
+    "F",
+    "StateFilter",
+    "Config",
+    "get_config",
+    "EnvMode",
+]

aioscam-0.1.1/aioscam/bot/__init__.py

@@ -0,0 +1,9 @@
+"""
+Bot module
+"""
+
+from aioscam.bot.bot import Bot
+
+__all__ = [
+    "Bot",
+]