semvec/pypi-packages huggingface dataset:
aiourlshortener 0.0.3
asynchronous python3 lib to short long url
License: MIT
Keywords: asynchronous url shortener

# 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())
```