goshortener 1.0 → 1.1

data/README.rdoc

@@ -4,6 +4,12 @@ Uses Google URL shortener API service to shorten/expand given URLs.
 
 == Usage
 
+=== Installation
+  gem install goshortener
+
+of if you are using bundler, add the following line to your Gemfile.
+  gem "goshortener"
+
 === Initialize and shorten urls
   go = GoShortener.new
   short_url = go.shorten "http://github.com/luckydev"

data/lib/goshortener.rb

@@ -12,11 +12,17 @@ class GoShortener
   end
 
   def shorten(long_url)
-    if long_url.is_a? String
+    if long_url.is_a?(String)
       request_json = {'longUrl' => long_url}.to_json
-      response = RestClient.post @base_url, request_json, :accept => :json, :content_type => :json
+
+      begin
+        response = RestClient.post @base_url, request_json, :accept => :json, :content_type => :json
+      rescue
+        raise "Please provide a valid url string"
+      end
+
     else
-      raise "Please provide a valid Long url string"
+      raise "Please provide a valid url string"
     end
     response = JSON.parse response
     short_url = response["id"]
@@ -24,11 +30,33 @@ class GoShortener
   end
 
   def lengthen(short_url)
-    if short_url.is_a? String
+    ##
+    # Accepts a short url shortened by http://goo.gl and returns original
+    # long url.
+    # 
+    # Examples:
+    # go = GoShortener.new
+    #
+    # go.lengthen("http://goo.gl/TCZHi")      #=> "http://github.com/luckydev"
+    #
+    # go.lengthen("http://www.goo.gl/TCZHi")  #=> Error
+    # go.lengthen("goo.gl/TCZHi")             #=> Error
+    # go.lengthen("http://goo.gl/")           #=> Error
+    # go.lengthen("http://goo.gl/T")          #=> Error
+    # go.lengthen("http://bit.ly/TCZHi")      #=> Error
+    #
+    ##
+    if short_url.is_a?(String)
       request_params = {:shortUrl => short_url}
-      response = RestClient.get @base_url, :params => request_params
+
+      begin
+        response = RestClient.get @base_url, :params => request_params
+      rescue
+        raise "Please provide a valid goo.gl short url to lengthen"
+      end
+
     else
-      raise "Please provide a valid short url string"
+      raise "Please provide a valid goo.gl short url to lengthen"
     end
     response = JSON.parse response
     long_url = response["longUrl"]

metadata

@@ -2,7 +2,7 @@
 name: goshortener
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: "1.0"
+  version: "1.1"
 platform: ruby
 authors: 
 - lakshmanan
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-05 00:00:00 +05:30
+date: 2011-02-06 00:00:00 +05:30
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency