Running aiogram in neighbor container, sending messages to telegram via redis
Project description
django-redis-aiogram
django-redis-aiogram
provides a quick way to install aiogram
in a container adjacent to django
, allowing you to use your own router and loop. Also Allows you to send messages through redis
.
Supported Python and Django releases
Current release of django-redis-aiogram
is 1.0.5, and it supports Python 3.8+ and Django 4.2+.
Installation
The easiest and recommended way to install django-redis-aiogram
is from PyPI
pip install django-redis-aiogram
You need to add telegram_bot
to INSTALLED_APPS
in your projects settings.py
.
# settings.py
INSTALLED_APPS = (
...
'telegram_bot',
...
)
Also, you need to specify the minimum settings:
# settings.py
TELEGRAM_BOT = {
'REDIS_URL': REDIS_URL,
'TOKEN': TELEGRAM_BOT_TOKEN
}
Next, add a separate container to your docker-compose.yml. (optional, if you want to use routers and handlers)
# docker-compose.yml
services:
...
telegram_bot:
container_name: telegram_bot
restart: always
command: python manage.py start_tgbot
build:
context: ./
Example Usage
To send a message, use the following code:
# test.py
from aiogram import types, F
from telegram_bot import bot
# sending a message directly
bot.send_raw(chat_id=CHAT_ID, text=TEXT)
bot.send_raw('send_photo', chat_id=CHAT_ID, caption=TEXT, photo=URL)
# sending a message via redis
bot.send_redis(chat_id=CHAT_ID, text=TEXT)
bot.send_redis('send_photo', chat_id=CHAT_ID, caption=TEXT, photo=URL)
# markup example
markup = types.InlineKeyboardMarkup(inline_keyboard=[
[types.InlineKeyboardButton(
text='best project ever',
web_app=types.WebAppInfo(url='https://pypi.org/project/django-redis-aiogram')
)]
])
bot.send_raw(chat_id=CHAT_ID, text=TEXT, reply_markup=markup)
bot.send_redis(chat_id=CHAT_ID, text=TEXT, reply_markup=markup)
If you need to use handlers, create file tg_router.py
(by default) in your app, use the following code:
from aiogram import types, F
from telegram_bot import bot
@bot.message(F.text.startswith('/start'))
async def start_handler(message: types.Message) -> None:
await message.answer('hi')
@bot.message()
async def simple_handler(message: types.Message) -> None:
await message.reply(message.text)
You can use all handler types like in aiogram.
Settings
You can override settings:
# settings.py
TELEGRAM_BOT = {
{
# event expiration time in redis
'REDIS_EXP_TIME': 5,
# redis key for handling expired event
'REDIS_EXP_KEY': 'TELEGRAM_BOT_EXP',
# redis key for collecting messages
'REDIS_MESSAGES_KEY': 'TELEGRAM_BOT_MESSAGE',
# name of the module to find
'MODULE_NAME': 'tg_router',
# telegram bot token
'TOKEN': TELEGRAM_BOT_TOKEN,
# url for redis connection
'REDIS_URL': REDIS_URL
}
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-redis-aiogram-1.0.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e90d458e680dba50b4017dd66c5e9f43fa3bae7a9c6f11676b4c77e4a0d0c4dc |
|
MD5 | 5ed375fa5bf902b1c97d88bc188b992b |
|
BLAKE2b-256 | 35f5b434b06cba500a245427fc824ad74a4fa7e206e07ba27a740271d17bddb8 |
Hashes for django_redis_aiogram-1.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 074e4cd814f85ac7efce60bb081b59a56a852df49a367331b56572b1b9e2073e |
|
MD5 | 39925e7953fafeb853d9019ae39f52f8 |
|
BLAKE2b-256 | 339f5aaf6f53b5e4bbe61bae4017580a9b258439d48903413c2e55a2e039015c |