siotelegram

Sans io telegram api with couple io backends


License
WTFPL
Install
pip install siotelegram==0.2.0

Documentation

Sans io implementation of telegram api

Tiny telegram bot-api wrapper library.

Reasons

  • aiotg is framework, not library and have no proxy support.
  • Raw api calls translation is better for understanding and will not break if telegram api will be changed.
  • snake_case

Features

  • support both, sync and async ways to deal with io.
  • Simple as telegram api is.
  • snake_case api converted to telegram camelCase.
  • Polling offset handled for you via get_updates method.
  • Handling timeout between requests automatically (via delay keyword-only argument).
  • Use any io backend you want.

Implementation

Sans io implementation based on generators for simplifying flow and holding state. siotelegram have io backends based on:

  • requests
  • aiohttp
  • httpx

Installation

  • sync:
    • python -m pip install siotelegram[requests]
  • async:
    • python -m pip install siotelegram[aiohttp]
    • python -m pip install siotelegram[httpx]

Examples

Common

import asyncio

import siotelegram


TOKEN = "token"


def requests_example():
    api = siotelegram.RequestsTelegramApi(TOKEN, timeout=10)
    response = api.get_updates()
    print(response)


async def aiohttp_example():
    async with siotelegram.AioHTTPTelegramApi(TOKEN, timeout=10) as api:
        response = await api.get_updates()
        print(response)


if __name__ == "__main__":
    import time
    # requests
    requests_example()
    time.sleep(1)
    # aiohttp
    asyncio.run(aiohttp_example())

Send files

import siotelegram
api = siotelegram.RequestsTelegramApi(TOKEN, timeout=10)
name = "capybara.jpg"
api.send_photo(chat_id=chat_id, caption="Hellow world!", files_=dict(photo=open(, "rb")))

# or from in-memory bytes
import pathlib
import io
data = pathlib.Path(name).read_bytes()
f = io.BytesIO(data)
f.name = name
api.send_photo(chat_id=chat_id, caption="Hellow world!", files_=dict(photo=f))