Simple and lightweight library based on aiogram for creating telegram mailings
Project description
Aiogram Broadcaster
A simple and straightforward broadcasting implementation for aiogram
Installaiton
$ pip install aiogram-broadcaster
Examples
Few steps before getting started...
- First, you should obtain token for your bot from BotFather and make sure you started a conversation with the bot.
- Obtain your user id from JSON Dump Bot in order to test out broadcaster.
Note: These and even more examples can found in examples/
directory
Base usage
from aiogram_broadcaster import TextBroadcaster
import asyncio
async def main():
# Initialize a text broadcaster (you can directly pass a token)
broadcaster = TextBroadcaster('USERS IDS HERE', 'hello!', bot_token='BOT TOKEN HERE')
# Run the broadcaster and close it afterwards
try:
await broadcaster.run()
finally:
await broadcaster.close_bot()
if __name__ == '__main__':
asyncio.run(main())
Embed a broadcaster in a message handler
from aiogram import Bot, Dispatcher, types
from aiogram_broadcaster import MessageBroadcaster
import asyncio
async def message_handler(msg: types.Message):
"""
The broadcaster will flood to a user whenever it receives a message
"""
users = [msg.from_user.id] * 5 # Your users list
await MessageBroadcaster(users, msg).run() # Run the broadcaster
async def main():
# Initialize a bot and a dispatcher
bot = Bot(token='BOT TOKEN HERE')
dp = Dispatcher(bot=bot)
# Register a message handler
dp.register_message_handler(message_handler, content_types=types.ContentTypes.ANY)
# Run the bot and close it afterwards
try:
await dp.start_polling()
finally:
await bot.session.close()
if __name__ == '__main__':
asyncio.run(main())
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
Close
Hashes for aiogram_broadcaster-0.0.7.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 739ab68abc39576084c2150d5c577c4f00dded238406f2238e440451da352ec6 |
|
MD5 | ae0c00990c05fe69c735b7cd1487c46e |
|
BLAKE2b-256 | 84b10a711063da845116d437eef2ddabdf16e1f5b96c93a3ff53760fef92a96c |
Close
Hashes for aiogram_broadcaster-0.0.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e372fc5560fd286bd78e45e96bd5ea212dd5171a84ca3fe2fc81c0f2d5d42775 |
|
MD5 | 619efe90496e861824edc7f72f200d11 |
|
BLAKE2b-256 | cdee30a0e617bf4fa258b2485bdfe1ed57c23f5a0374da09e87064cd4c2b0e43 |