Metadata-Version: 2.5
Name: screwinboxads
Version: 1.0.3
Summary: Реклама в Telegram-ботах на aiogram 3: вопрос с кнопками, оффер и подтверждение показов
Author: Screw Team
License-Expression: MIT
License-File: LICENSE
Keywords: ads,advertising,aiogram,bot,monetization,sdk,telegram
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Russian
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# screwinboxads

Реклама в Telegram-ботах на aiogram 3.

## Требования

- Python 3.10 или новее
- aiogram 3.13 или новее

## Подключение

**1. Установите пакет** — тем способом, которым ставятся зависимости вашего бота

pip:

```bash
pip install "screwinboxads<2"
```

poetry:

```bash
poetry add "screwinboxads<2"
```

uv:

```bash
uv add "screwinboxads<2"
```

Docker с `requirements.txt` — добавьте в файл строку и пересоберите образ (если образ собирается через poetry или uv, хватит их команды выше):

```
screwinboxads<2
```

**2. В начало файла, где создаётся `Dispatcher`, добавьте импорт**

```python
from screwinboxads import ScrewInboxAds
```

**3. Добавьте сразу после `dp = Dispatcher()`**

```python
ScrewInboxAds(dp, api_key="ключ-бота")   # ключ выдаёт команда Screw Inbox Ads
```

**4. Покажите рекламу в нужном обработчике — в любом файле бота**

```python
from screwinboxads import show_ad

await show_ad(message)   # message — входящее сообщение или нажатие кнопки
```

Готово. Вопрос, оффер и учёт показов SDK делает сам. Нет рекламы или ошибка — бот работает
дальше как обычно.
