A simple URL shortening Python Lib, implementing the most famous shorteners.
You can install pythorteners by pip or cloning/forking the repository and just typing
Installing via pip
pip install pyshorteners
Installing with the cloned/downloaded code
python setup.py install
make test
Create a Shortener instance passing the engine as an argument. Google Shortener is the default engine if no engine param is passed.
api_key
needed on kwargs
from pyshorteners import Shortener
url = 'http://www.google.com'
api_key = 'YOUR_API_KEY'
shortener = Shortener('GoogleShortener', api_key=api_key)
print "My short url is {}".format(shortener.short(url))
### expanding
url = 'http://goo.gl/SsadY'
print "My long url is {}".format(shortener.expand(url))
bitly_api_key
, bitly_api_key
and bitly_api_token
configs needed on
kwargs
from pyshorteners import Shortener
# For Bit.ly you HAVE to provide the login and api key
login = 'MY_LOGIN'
api_key = 'MY_API_KEY'
access_token = 'MY_ACCESS_TOKEN'
url = 'http://www.google.com'
shortener = Shortener('BitlyShortener', bitly_login=login, bitly_api_key=api_key,
bitly_token=access_token)
print "My short url is {}".format(shortener.short(url))
### expanding
url = 'http://bit.ly/AvGsb'
print "My long url is {}".format(shortener.expand(url))
No login or api key needed
from pyshorteners import Shortener
url = 'http://www.google.com'
shortener = Shortener('TinyurlShortener')
print "My short url is {}".format(shortener.short(url))
### expanding
url = 'http://tinyurl.com/ycus76'
print "My long url is {}".format(shortener.expand(url))
uid
and api_key
needed, Banner type
optional (int
or banner
).
No expanding for this shortener
from pyshorteners import Shortener
url = 'http://www.google.com'
shortener = Shortener('AdflyShortener')
print "My short url is {}".format(shortener.short(url, uid=UID,
api_key=API_KEY, type='int'))
No login or api key needed
from pyshorteners import Shortener
url = 'http://www.google.com'
shortener = Shortener('IsgdShortener')
print "My short url is {}".format(shortener.short(url))
### expanding
url = 'http://is.gd/SsaC'
print "My long url is {}".format(shortener.expand(url))
No login or api key needed
from pyshorteners import Shortener
url = 'http://www.google.com'
shortener = Shortener('SentalaShortener')
print "My short url is {}".format(shortener.short(url))
### expanding
url = 'http://senta.la/urubu'
print "My long url is {}".format(shortener.expand(url))
No login or api key needed
from pyshorteners import Shortener
url = 'http://www.google.com'
shortener = Shortener('QrCxShortener')
print "My short url is {}".format(shortener.short(url))
### expanding
url = 'http://qr.cx/XsC'
print "My long url is {}".format(shortener.expand(url))
```
## Readbility Shortener
No login or api key needed
```python
from pyshorteners import Shortener
url = 'http://blog.arc90.com/2010/11/30/silence-is-golden/'
shortener = Shortener('ReadbilityShortener')
print "My short url is {}".format(shortener.short(url))
### expanding
url = 'http://rdd.me/ycus76'
print "My long url is {}".format(shortener.expand(url))
```
## Ow.ly Shortener
`api_key` needed on kwargs
```python
from pyshorteners import Shortener
# For Ow.ly you HAVE to provide the login and api key
api_key = 'MY_API_KEY'
url = 'http://www.google.com'
shortener = Shortener('OwlyShortener',api_key=api_key)
print "My short url is {}".format(shortener.short(url))
### expanding
url = 'http://ow.ly/AvGsb'
print "My long url is {}".format(shortener.expand(url))
```
# Generating QR Code
You can have the QR Code for your url by calling the `qr_code` method
after shortening your url.
```python
from pyshorteners import Shortener
url = 'http://www.google.com'
shortener = Shortener('TinyurlShortener')
shortener.short(url)
print shortener.qrcode()
Output
http://chart.apis.google.com/chart?cht=qr&chl=http://tinyurl.com/1c2&chs=120x120
```
Image:
![](http://chart.apis.google.com/chart?cht=qr&chl=http://tinyurl.com/1c2&chs=120x120)