shorturl
A Ruby gem that connects to various URL shortening services like RubyURL, moourl, etc.
MIT License
= ShortURL 1.0.0
== Summary ShortURL is a very simple library to use URL shortening services.
== Installation ShortURL is available as a gem, installation is just like any other gem: $ gem install shorturl
You can also download the tar.bz2 archive at http://rubyforge.org/frs/?group_id=732 if you do not want to use the gem.
== Supported services Here is the list of the services supported by ShortURL:
- http://tinyurl.com
- http://shorl.com
- http://snipurl.com
- http://metamark.net
- http://makeashorterlink.com
- http://skinnylink.com
- http://linktrim.com
- http://shorterlink.com
- http://minilink.org
- http://ln-s.net
- http://fyad.org
- http://d62.net
- http://littlink.com
- http://clipurl.com
- http://0rz.net
- http://moourl.com
- http://urltea.com
- http://vurl.me
- http://bit.ly
- http://is.gd
- http://git.io
- http://va.mu
== Usage: call-seq: require "shorturl" puts ShortURL.shorten("http://mypage.com") puts ShortURL.shorten("http://mypage.com", :moourl)
The second parameter represents the service you want to use. These are:
- :tinyurl
- :shorl
- :snipurl
- :metamark
- :makeashorterlink
- :skinnylink
- :linktrim
- :shorterlink
- :minlink
- :lns
- :fyad
- :d62
- :littlink
- :clipurl
- :orz
- :moourl
- :urltea
- :vurl
- :bitly**
You can use ShortURL.valid_services to obtain a list of the valid services (in case I forget to update the documentation)
Bitly**
Their API changed to require an API key.
Two painfree steps to fix this.
- Get yours easily right now from:
http://bitly.com/a/your_api_key
- Save it in ~/.shorturl similar to this YAML template:
--- Start of file ~/.shorturl ---
bitly: username: O_adsfasdfasfasfd key: R_afasdfasdfasdf
--- END of file ~/.shorturl ---
You're done! Have a martini. Cheers.
== Thanks
- Marcel Molina Jr., Devin Mullins for some ideas
- imperator from #ruby-lang (I don't know your real name, sorry) for
helping me with creating and uploading a RubyGem - Daniel Dipaolo for telling me about ln-s.net and fyad.org
== Authors
- Vincent Foley (original developer)
- Robby Russell [email protected]