An asynchronous framework for building your own Telegram Bot
Project description
aio-telegram-bot
An asynchronous framework for building your own Telegram Bot over API.
Installation
aio-telegram-bot
requires Python 3.5.3+ and is available on PyPI:
$ pip install aio-telegram-bot
*Compatible with PyPy3.5-6.0.0+
Examples
Polling example
import asyncio import os from aiotelegrambot import Bot, Client, Content, Message from aiotelegrambot.rules import Contains async def hi(message: Message): await message.send_message("Hello!", True) async def run(bot: Bot): await bot.initialize() while True: await asyncio.sleep(1) if __name__ == "__main__": loop = asyncio.get_event_loop() client = Client(os.environ["TELEGRAM_BOT_TOKEN"]) bot = Bot(client) bot.add_handler(hi, content_type=Content.TEXT, rule=Contains("hi")) try: loop.run_until_complete(run(bot)) except KeyboardInterrupt: loop.run_until_complete(bot.close()) loop.run_until_complete(bot.client.close()) finally: loop.close()
Running:
$ export TELEGRAM_BOT_TOKEN=12345678:replace-me-with-real-token
$ python3 polling.py
Webhook example
Example of how to generate ssl certificate:
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout domain_srv.key -out domain_srv.crt
import argparse import json import os import ssl from aiohttp import web from async_generator import async_generator, yield_ from aiotelegrambot import Bot, Client, Content, Handlers, Message from aiotelegrambot.rules import Contains handlers = Handlers() TOKEN = os.environ["TELEGRAM_BOT_TOKEN"] HOST = os.environ["TELEGRAM_BOT_HOST"] PORT = 8443 parser = argparse.ArgumentParser() parser.add_argument("files", metavar="N", type=str, nargs="+") SSL_PUBLIC_KEY, SSL_PRIVATE_KEY = parser.parse_args().files @handlers.add(content_type=Content.TEXT, rule=Contains("hi")) async def hi(message: Message): await message.send_message("Hello!") async def webhook_handle(request): bot = request.app["bot"] data = await request.text() await bot.process_update(json.loads(data)) return web.Response() @async_generator async def init_bot(app: web.Application): bot = Bot(Client(TOKEN), handlers) await bot.initialize(webhook=True) await bot.client.set_webhook("https://{}:{}/{}".format(HOST, PORT, TOKEN), certificate=SSL_PUBLIC_KEY) app["bot"] = bot await yield_() await bot.client.delete_webhook() await bot.close() await bot.client.close() app = web.Application() app.router.add_post("/{}".format(TOKEN), webhook_handle) app.cleanup_ctx.extend([init_bot]) context = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH) context.load_cert_chain(SSL_PUBLIC_KEY, SSL_PRIVATE_KEY) web.run_app(app, host="0.0.0.0", port=PORT, ssl_context=context)
Running:
$ export TELEGRAM_BOT_TOKEN=12345678:replace-me-with-real-token
$ export TELEGRAM_BOT_HOST=real.host.com
$ python3 webhook.py domain_srv.crt domain_srv.key
License
aio-telegram-bot
is offered under the MIT license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size aio_telegram_bot-1.0.0-py3-none-any.whl (11.6 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Filename, size aio-telegram-bot-1.0.0.tar.gz (10.3 kB) | File type Source | Python version None | Upload date | Hashes View |
Close
Hashes for aio_telegram_bot-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56aa78be8cc3dfa574bdf86a5eed8dd486f001c4f6620549fe34432798fe50bb |
|
MD5 | a891cc05aadea82d4cb845a5cef60f23 |
|
BLAKE2-256 | 4fdc8a6b19eef74b089b9c839a07691aa5d4d2b4b261cb93071f81cb226d9ba7 |