README

Path: README
Last Update: Sun Oct 02 14:18:21 EDT 2005

ShortURL 0.8.0

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: $ gem install -r shorturl

You can also download the tar.bz2 archive at 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:

Usage:

call-seq:

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

The second parameter represents the service you want to use. These are:

  • :rubyurl
  • :tinyurl
  • :shorl
  • :snipurl
  • :metamark
  • :makeashorterlink
  • :skinnylink
  • :linktrim
  • :shorterlink
  • :minlink
  • :lns
  • :fyad
  • :d62
  • :shiturl
  • :littlink
  • :clipurl
  • :shortify
  • :orz

You can use ShortURL.valid_services 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
  $

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

[Validate]