Metadata-Version: 1.1
Name: aiotelegram
Version: 0.1.2
Summary: Tiny asyncio-based telgram api wrapper library
Home-page: https://github.com/pohmelie/aiotelegram
Author: pohmelie
Author-email: multisosnooley@gmail.com
License: WTFPL
Description: aiotelegram
        ===========
        
        Tiny asyncio-based telgram 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
        --------
        
        -  Simple as telegram api is.
        -  Based on `aiohttp`_.
        -  Proxy available (via `aiohttp`_ `ProxyConnector`_).
        -  ``snake_case`` api converted to telegram ``camelCase``.
        -  Polling ``offset`` handled for you via ``get_updates`` method.
        -  Handling timeout between requests automatically (via ``pause``
           keyword-only argument).
        -  Source code is `short and simple`_.
        
        Installation
        ------------
        
        ::
        
            python -m pip install aiotelegram
        
        Usage
        -----
        
        Polling updates
        ~~~~~~~~~~~~~~~
        
        .. code:: python
        
            import aiotelegram
        
        
            async def ...(...):
        
                api = aiotelegram.Api(token)
                while True:
        
                    response = await api.get_updates()
                    if not response["ok"]:
        
                        ...
        
                    else:
        
                        for update in response["result"]:
        
                            ...
        
                    await asyncio.sleep(delay)
        
        Sending message
        ~~~~~~~~~~~~~~~
        
        .. code:: python
        
            async def ...(...):
        
                await api.send_message(
                    chat_id=123456,
                    text="*foobar*",
                    parse_mode="Markdown",
                )
        
        .. _aiotg: https://github.com/szastupov/aiotg
        .. _aiohttp: https://github.com/KeepSafe/aiohttp
        .. _ProxyConnector: http://aiohttp.readthedocs.io/en/stable/client_reference.html#aiohttp.ProxyConnector
        .. _short and simple: https://github.com/pohmelie/aiotelegram/blob/master/aiotelegram.py
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
