Metadata-Version: 1.1
Name: aiourlshortener
Version: 0.0.3
Summary: asynchronous python3 lib to short long url
Home-page: https://github.com/blikenoother/aiourlshortener
Author: Chirag Patel
Author-email: b.like.no.other@gmail.com
License: MIT
Description: # aiourlshortener
        
        aiourlshortener is a [asyncio](https://pypi.python.org/pypi/asyncio) python3 compatible library for URL shorting using [Googl](https://goo.gl/), [Bitly](https://bitly.com/) API
        
        # Installing
        
        ```
        pip3 install aiourlshortener
        ```
        
        # Requirements
        * [asyncio](https://pypi.python.org/pypi/asyncio) or Python 3.4+
        * [aiohttp](https://pypi.python.org/pypi/aiohttp)
        
        # Usage
        
        Create a Shortener instance passing the engine as an argument.
        
        ## Goo.gl Shortener
        
        `api_key` required
        
        ```python
        import asyncio
        from asyncio import coroutine
        from aiourlshortener import Shortener
        
        @coroutine
        def main():
            shortener = Shortener('Google', api_key='API_KEY')
            url = 'https://github.com/blikenoother/aiourlshortener'
            # short
            short_url = yield from shortener.short(url)
            print('short url: {}'.format(short_url))
            # expand
            long_url = yield from shortener.expand(short_url)
            print('long url: {}'.format(long_url))
        
        if __name__ == '__main__':
            loop = asyncio.get_event_loop()
            loop.run_until_complete(main())
        
        ```
        
        ## Bit.ly Shortener
        
        `access_token` required
        
        ```python
        import asyncio
        from asyncio import coroutine
        from aiourlshortener import Shortener
        
        @coroutine
        def main():
            shortener = Shortener('Bitly', access_token='ACCESS_TOKEN')
            url = 'https://github.com/blikenoother/aiourlshortener'
            # short
            short_url = yield from shortener.short(url)
            print('short url: {}'.format(short_url))
            # expand
            long_url = yield from shortener.expand(short_url)
            print('long url: {}'.format(long_url))
        
        if __name__ == '__main__':
            loop = asyncio.get_event_loop()
            loop.run_until_complete(main())
        ```
Keywords: asynchronous url shortener
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
