Contents

= ShortURL 0.8.2

== Summary 
ShortURL is a very simple library to use URL shortening services such as
TinyURL or RubyURL.

== Installation
ShortURL is available as a gem, installation is just like any other gem:
<tt>$ gem install -r shorturl</tt>

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://rubyurl.com
* http://tinyurl.com
* http://snipurl.com
* http://metamark.net
* http://makeashorterlink.com
* http://linktrim.com
* http://shorterlink.com
* http://minilink.org
* http://ln-s.net
* http://fyad.org
* http://d62.net
* http://shiturl.com
* http://littlink.com
* http://clipurl.com
* http://shortify.com
* http://0rz.net
* http://skinnylink.com
* http://shurl.org

== Usage: 

call-seq:
  require "shorturl"
  puts WWW::ShortURL.shorten("http://mypage.com")
  puts WWW::ShortURL.shorten("http://mypage.com", :tinyurl)

The second parameter represents the service you want to use.  See the
documentation for WWW::ShortURL for a complete list

You can use <tt>ShortURL.valid_services</tt> to obtain a
list of the valid services (in case I forget to update the
documentation)

You can also use the small script in bin/ which can be used from the
command line:
call-seq:
  $ shorturl www.google.com
  http://rubyurl.com/fuuUw
  $ shorturl -s tinyurl www.google.com
  http://tinyurl.com/1c2
  $ shorturl -s random www.google.com
  http://linktrim.com/42k


== 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
  
== Author
Vincent Foley

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
shorturl-0.8.2	README