google_short_links 0.1.2

data/.document

@@ -0,0 +1,4 @@
+bin/*
+lib/**/*.rb
+LICENSE.txt
+README.rdoc

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.3@google-short-links

data/.travis.yml

@@ -0,0 +1,4 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - ree

data/Gemfile

@@ -0,0 +1,12 @@
+source :rubygems
+
+gem 'httparty'
+gem 'multi_json'
+
+group :development do
+  gem 'jeweler'
+  gem 'rcov'
+  gem 'rdoc'
+  gem 'rspec'
+  gem 'timecop'
+end

data/Gemfile.lock

@@ -0,0 +1,40 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    httparty (0.8.1)
+      multi_json
+      multi_xml
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    json (1.6.1)
+    multi_json (1.0.3)
+    multi_xml (0.4.1)
+    rake (0.9.2.2)
+    rcov (0.9.11)
+    rdoc (3.11)
+      json (~> 1.4)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.7.0)
+    timecop (0.3.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  httparty
+  jeweler
+  multi_json
+  rcov
+  rdoc
+  rspec
+  timecop

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Benjamin Manns
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,40 @@
+= google-short-links
+
+Ruby wrapper for Google Short Links.
+
+== Installation
+
+To install Google Short Links, run
+
+    gem install google-short-links
+
+To load the library, use 
+
+    require 'google_short_links'
+
+Or, with Bundler, add to your Gemfile
+
+    gem 'google-short-links', :require => 'google_short_links'
+
+== Examples
+
+This example creates a new client, creates a hash
+
+   client = GoogleShortLinks::Client.new :server => 'short.example.com', :secret => 'abcdef1234567890', :email => 'ben@example.com'
+   link = client.get_or_create_hash 'http://example.com/parent/child/long_document_name.html', :is_public => true
+   link # => {"status"=>"ok", "url"=>"http://example.com/parent/child/long_document_name.html", "estimated_api_calls_remaining"=>98, "shortcut"=>"abc12", "usage_count"=>0, "owner"=>"ben@example.com", "is_public"=>true, "is_hash"=>true}
+   short_url = "http://short.example.com/#{link['shortcut']}" # => "http://short.example.com/abc12"
+
+== Contributing to google-short-links
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Benjamin Manns. See LICENSE.txt for further details.

data/Rakefile

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+require 'bundler'
+begin
+  Bundler.setup :default, :development
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts 'Run `bundle install` to install missing gems'
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = 'google_short_links'
+  gem.homepage = 'https://github.com/benmanns/google_short_links'
+  gem.license = 'MIT'
+  gem.summary = 'Ruby wrapper for Google Short Links.'
+  gem.description = 'Ruby wrapper for Google Short Links.'
+  gem.email = 'benmanns@gmail.com'
+  gem.authors = 'Benjamin Manns'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new :spec do |spec|
+  spec.pattern = FileList[File.join('spec', '**', '*_spec.rb')]
+end
+
+RSpec::Core::RakeTask.new :rcov do |spec|
+  spec.pattern = File.join('spec', '**', '*_spec.rb')
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+RDoc::Task.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ''
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "google_short_links #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include(File.join('lib', '**', '*.rb'))
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.2

data/google-short-links.gemspec

@@ -0,0 +1,75 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{google-short-links}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Benjamin Manns"]
+  s.date = %q{2011-11-18}
+  s.description = %q{Ruby wrapper for Google Short Links.}
+  s.email = %q{benmanns@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".rvmrc",
+    ".travis.yml",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "google-short-links.gemspec",
+    "lib/google_short_links.rb",
+    "lib/google_short_links/client.rb",
+    "lib/google_short_links/parser.rb",
+    "spec/google_short_links/client_spec.rb",
+    "spec/google_short_links/parser_spec.rb",
+    "spec/google_short_links_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{https://github.com/benmanns/google-short-links}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{Ruby wrapper for Google Short Links.}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+      s.add_runtime_dependency(%q<multi_json>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<timecop>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+      s.add_dependency(%q<multi_json>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<rdoc>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<timecop>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+    s.add_dependency(%q<multi_json>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<rdoc>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<timecop>, [">= 0"])
+  end
+end
+

data/google_short_links.gemspec

@@ -0,0 +1,77 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "google_short_links"
+  s.version = "0.1.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Benjamin Manns"]
+  s.date = "2012-02-24"
+  s.description = "Ruby wrapper for Google Short Links."
+  s.email = "benmanns@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".rvmrc",
+    ".travis.yml",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "google-short-links.gemspec",
+    "google_short_links.gemspec",
+    "lib/google_short_links.rb",
+    "lib/google_short_links/client.rb",
+    "lib/google_short_links/parser.rb",
+    "spec/examples/google_short_links/client_spec.rb",
+    "spec/google_short_links/client_spec.rb",
+    "spec/google_short_links/parser_spec.rb",
+    "spec/google_short_links_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "https://github.com/benmanns/google_short_links"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.15"
+  s.summary = "Ruby wrapper for Google Short Links."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+      s.add_runtime_dependency(%q<multi_json>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<timecop>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+      s.add_dependency(%q<multi_json>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<rdoc>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<timecop>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+    s.add_dependency(%q<multi_json>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<rdoc>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<timecop>, [">= 0"])
+  end
+end
+

data/lib/google_short_links.rb

@@ -0,0 +1,6 @@
+# Holds the client class for Google Short Links.
+# See GoogleShortLinks::Client.
+module GoogleShortLinks
+  autoload :Client, 'google_short_links/client'
+  autoload :Parser, 'google_short_links/parser'
+end

data/lib/google_short_links/client.rb

@@ -0,0 +1,205 @@
+require 'cgi'
+require 'base64'
+require 'digest/sha1'
+require 'openssl'
+require 'uri'
+
+require 'httparty'
+
+# Client for Google Short Links.
+#
+# ==== Examples
+#
+#   client = GoogleShortLinks::Client.new :server => 'short.example.com', :secret => 'abcdef1234567890', :email => 'ben@example.com'
+#   link = client.get_or_create_hash 'http://example.com/parent/child/long_document_name.html', :is_public => true
+#   link # => {"status"=>"ok", "url"=>"http://example.com/parent/child/long_document_name.html", "estimated_api_calls_remaining"=>98, "shortcut"=>"abc12", "usage_count"=>0, "owner"=>"ben@example.com", "is_public"=>true, "is_hash"=>true}
+class GoogleShortLinks::Client
+  include HTTParty
+
+  # The domain name where Google Short Links is hosted.
+  attr_accessor :server
+
+  # Your HMAC-SHA1 secret.
+  attr_accessor :secret
+
+  # The email for the account under which the links will be created.
+  attr_accessor :email
+
+  parser GoogleShortLinks::Parser
+
+  # Initializes a new Client.
+  #
+  # ==== Parameters
+  #
+  # [<tt>options</tt>] Optional Hash containing configuration values.
+  #
+  # ==== Options
+  #
+  # [:server]
+  #   The domain name where Google Short Links is hosted.
+  # [:secret]
+  #   Your HMAC-SHA1 secret.
+  # [:email]
+  #   The email for the account under which the links will be created.
+  def initialize options={}
+    self.server = options[:server]
+    self.secret = options[:secret]
+    self.email = options[:email]
+  end
+
+  # Creates a URL that is used to create a hash.
+  #
+  # ==== Parameters
+  #
+  # [<tt>url</tt>] Required String containing the URL to be shortened.
+  # [<tt>params</tt>] Optional Hash that will add or override GET parameters in the URL.
+  #
+  # ==== Parameters
+  #
+  # [:is_public]
+  #   Boolean for whether or not the short link can be accessed without logging in to Google Apps.
+  #
+  # ==== Examples
+  #
+  #   link_url = client.get_or_create_hash_url 'http://example.com/parent/child/long_document_name.html', :is_public => true
+  #   link_url # => "http://short.example.com/js/get_or_create_hash?is_public=true&oauth_signature_method=HMAC-SHA1&timestamp=1321663459.0&url=http%3A%2F%2Fexample.com%2Fparent%2Fchild%2Flong_document_name.html&user=ben%40example.com&oauth_signature=JElQ0Oq59q%2BOsinYuMzGX%2F8Tn2U%3D"
+  def get_or_create_hash_url url, params={}
+    request_path = request_path(:get_or_create_hash)
+
+    query = params_to_query(base_params.merge(:url => url).merge(params))
+
+    digest_url(request_path, query)
+  end
+
+  # Creates a URL that is used to create a shortlink with a customized shortcut.
+  #
+  # ==== Parameters
+  #
+  # [<tt>url</tt>] Required String containing the URL to be shortened.
+  # [<tt>shortcut</tt>] Required String containing the custom shortcut.
+  # [<tt>params</tt>] Optional Hash that will add or override GET parameters in the URL.
+  #
+  # ==== Parameters
+  #
+  # [:is_public]
+  #   Boolean for whether or not the short link can be accessed without logging in to Google Apps.
+  #
+  # ==== Examples
+  #
+  #   link_url = client.get_or_create_shortlink_url 'http://example.com/parent/child/long_document_name.html', 'example', :is_public => true
+  #   link_url # => "http://short.example.com/js/get_or_create_shortlink?is_public=true&oauth_signature_method=HMAC-SHA1&shortcut=example&timestamp=1321663613.0&url=http%3A%2F%2Fexample.com%2Fparent%2Fchild%2Flong_document_name.html&user=ben%40example.com&oauth_signature=FsOEjCDw3qpz%2B59Pdi4d1Qvv0Os%3D"
+  def get_or_create_shortlink_url url, shortcut, params={}
+    request_path = request_path(:get_or_create_shortlink)
+
+    query = params_to_query(base_params.merge(:url => url, :shortcut => shortcut).merge(params))
+
+    digest_url(request_path, query)
+  end
+
+  # Creates a URL that is used to get details about a link from its shortcut.
+  #
+  # ==== Parameters
+  #
+  # [<tt>shortcut</tt>] Required String containing the URL to be shortened.
+  # [<tt>params</tt>] Optional Hash that will add or override GET parameters in the URL.
+  #
+  # ==== Examples
+  #
+  #   link_url = client.get_details_url 'example'
+  #   link_url # => "http://short.example.com/js/get_details?oauth_signature_method=HMAC-SHA1&shortcut=example&timestamp=1321663629.0&user=ben%40example.com&oauth_signature=p8XqzF0lITupKN3Ta0qu2E8hqBI%3D"
+  def get_details_url shortcut, params={}
+    request_path = request_path(:get_details)
+
+    query = params_to_query(base_params.merge(:shortcut => shortcut).merge(params))
+
+    digest_url(request_path, query)
+  end
+
+  # Shortens a URL.
+  #
+  # ==== Parameters
+  #
+  # [<tt>url</tt>] Required String containing the URL to be shortened.
+  # [<tt>params</tt>] Optional Hash that will add or override GET parameters in the URL.
+  #
+  # ==== Parameters
+  #
+  # [:is_public]
+  #   Boolean for whether or not the short link can be accessed without logging in to Google Apps.
+  #
+  # ==== Examples
+  #
+  #   link = client.get_or_create_hash 'http://example.com/parent/child/long_document_name.html', :is_public => true
+  #   link # => {"status"=>"ok", "url"=>"http://example.com/parent/child/long_document_name.html", "estimated_api_calls_remaining"=>98, "shortcut"=>"abc12", "usage_count"=>0, "owner"=>"ben@example.com", "is_public"=>true, "is_hash"=>true}
+  def get_or_create_hash url, params={}
+    self.class.get(get_or_create_hash_url(url, params)).parsed_response
+  end
+
+  # Creates a shortlink with a customized shortcut.
+  #
+  # ==== Parameters
+  #
+  # [<tt>url</tt>] Required String containing the URL to be shortened.
+  # [<tt>shortcut</tt>] Required String containing the custom shortcut.
+  # [<tt>params</tt>] Optional Hash that will add or override GET parameters in the URL.
+  #
+  # ==== Parameters
+  #
+  # [:is_public]
+  #   Boolean for whether or not the short link can be accessed without logging in to Google Apps.
+  #
+  # ==== Examples
+  #
+  #   link = client.get_or_create_shortlink 'http://example.com/parent/child/long_document_name.html', 'example', :is_public => true
+  #   link # => {"status"=>"ok", "url"=>"http://example.com/parent/child/long_document_name.html", "estimated_api_calls_remaining"=>99, "shortcut"=>"example", "usage_count"=>0, "owner"=>"ben@example.com", "is_public"=>true, "is_hash"=>false}
+  def get_or_create_shortlink url, shortcut, params={}
+    self.class.get(get_or_create_shortlink_url(url, shortcut, params)).parsed_response
+  end
+
+  # Gets details about a link from its shortcut.
+  #
+  # ==== Parameters
+  #
+  # [<tt>shortcut</tt>] Required String containing the URL to be shortened.
+  # [<tt>params</tt>] Optional Hash that will add or override GET parameters in the URL.
+  #
+  # ==== Examples
+  #
+  #   link = client.get_details 'example'
+  #   link # => {"status"=>"ok", "url"=>"http://example.com/parent/child/long_document_name.html", "estimated_api_calls_remaining"=>100, "shortcut"=>"example", "usage_count"=>0, "owner"=>"ben@example.com", "is_public"=>true, "is_hash"=>false}
+  def get_details shortcut, params={}
+    self.class.get(get_details_url(shortcut, params)).parsed_response
+  end
+
+  protected
+
+  def request_path action #:nodoc:
+    "http://#{server}/js/#{action}"
+  end
+
+  def base_params #:nodoc:
+    {
+      :oauth_signature_method => 'HMAC-SHA1',
+      :timestamp => Time.now.to_i.to_f,
+      :user => email,
+    }
+  end
+
+  def params_to_query params #:nodoc:
+    params.to_a.sort_by { |param| param.to_s }.map { |(key, value)| "#{CGI.escape(key.to_s)}=#{CGI.escape(value.to_s)}" }.join('&')
+  end
+
+  def digest request_path, query #:nodoc:
+    content = "GET&#{CGI.escape(request_path)}&#{CGI.escape(query)}"
+
+    digest = OpenSSL::Digest::Digest.new('sha1')
+    digest_raw = OpenSSL::HMAC.digest(digest, secret, content)
+    CGI.escape(Base64.encode64(digest_raw).chomp)
+  end
+
+  def digest_url request_path, query #:nodoc:
+    request_uri = URI.parse(request_path)
+    request_uri.query = "#{query}&oauth_signature=#{digest(request_path, query)}"
+    request_uri.to_s
+  end
+end

data/lib/google_short_links/parser.rb

@@ -0,0 +1,14 @@
+require 'httparty'
+require 'multi_json'
+
+# Parses the JSON that Google Short Links returns.
+class GoogleShortLinks::Parser < HTTParty::Parser
+  # Google returns the JSON response as a text/html mime type.
+  # This class only supports JSON currently.
+  SupportedFormats = { 'text/html' => :json }
+
+  # Decodes JSON into a hash.
+  def json
+    MultiJson.decode(body)
+  end
+end

data/spec/examples/google_short_links/client_spec.rb

@@ -0,0 +1,70 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'spec_helper'))
+
+describe GoogleShortLinks::Client do
+  if ENV['GOOGLE_SHORT_LINKS_SERVER'] && ENV['GOOGLE_SHORT_LINKS_SECRET'] && ENV['GOOGLE_SHORT_LINKS_EMAIL']
+    let(:client) { GoogleShortLinks::Client.new(:server => ENV['GOOGLE_SHORT_LINKS_SERVER'], :secret => ENV['GOOGLE_SHORT_LINKS_SECRET'], :email => ENV['GOOGLE_SHORT_LINKS_EMAIL']) }
+
+    specify 'creating a hash' do
+      require 'securerandom'
+      url = "http://www.example.org/#{SecureRandom.uuid}"
+
+      response = client.get_or_create_hash(url)
+      response = client.get_or_create_hash(url) if response['status'] == 'not found'
+
+      response.should include 'url' => url
+      response.should have_key 'shortcut'
+      response.should include 'owner' => ENV['GOOGLE_SHORT_LINKS_EMAIL']
+      response.should include 'is_public' => false
+      response.should include 'is_hash' => true
+
+      shortcut = response['shortcut']
+
+      response = client.get_or_create_hash(url)
+
+      response.should include 'url' => url
+      response.should include 'shortcut' => shortcut
+      response.should include 'owner' => ENV['GOOGLE_SHORT_LINKS_EMAIL']
+      response.should include 'is_public' => false
+      response.should include 'is_hash' => true
+
+      response = client.get_details(shortcut)
+
+      response.should include 'url' => url
+      response.should include 'shortcut' => shortcut
+      response.should include 'owner' => ENV['GOOGLE_SHORT_LINKS_EMAIL']
+      response.should include 'is_public' => false
+      response.should include 'is_hash' => true
+    end
+
+    specify 'creating a shortcut' do
+      require 'securerandom'
+      url = "http://www.example.org/#{SecureRandom.uuid}"
+      shortcut = SecureRandom.uuid
+
+      response = client.get_or_create_shortlink(url, shortcut)
+      response = client.get_or_create_shortlink(url, shortcut) if response['status'] == 'not found'
+
+      response.should include 'url' => url
+      response.should include 'shortcut' => shortcut
+      response.should include 'owner' => ENV['GOOGLE_SHORT_LINKS_EMAIL']
+      response.should include 'is_public' => false
+      response.should include 'is_hash' => false
+
+      response = client.get_or_create_shortlink(url, shortcut)
+
+      response.should include 'url' => url
+      response.should include 'shortcut' => shortcut
+      response.should include 'owner' => ENV['GOOGLE_SHORT_LINKS_EMAIL']
+      response.should include 'is_public' => false
+      response.should include 'is_hash' => false
+
+      response = client.get_details(shortcut)
+
+      response.should include 'url' => url
+      response.should include 'shortcut' => shortcut
+      response.should include 'owner' => ENV['GOOGLE_SHORT_LINKS_EMAIL']
+      response.should include 'is_public' => false
+      response.should include 'is_hash' => false
+    end
+  end
+end

data/spec/google_short_links/client_spec.rb

@@ -0,0 +1,287 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe GoogleShortLinks::Client do
+  subject { GoogleShortLinks::Client }
+
+  it { should <= HTTParty }
+
+  describe '#initialize' do
+    subject { GoogleShortLinks::Client.new @params }
+
+    context 'with options { :server => "a", :secret => "b", :email => "c" }' do
+      before :each do
+        @params = { :server => 'a', :secret => 'b', :email => 'c' }
+      end
+
+      it 'sets server to a' do
+        subject.server.should == 'a'
+      end
+
+      it 'sets secret to b' do
+        subject.secret.should == 'b'
+      end
+
+      it 'sets email to c' do
+        subject.email.should == 'c'
+      end
+    end
+
+    context 'with options { :email => "c" }' do
+      before :each do
+        @params = { :email => 'c' }
+      end
+
+      it 'leaves server nil' do
+        subject.server.should be_nil
+      end
+
+      it 'leaves secret nil' do
+        subject.secret.should be_nil
+      end
+
+      it 'sets email to c' do
+        subject.email.should == 'c'
+      end
+    end
+
+    context 'with options {}' do
+      before :each do
+        @params = {}
+      end
+
+      it 'leaves server nil' do
+        subject.server.should be_nil
+      end
+
+      it 'leaves secret nil' do
+        subject.secret.should be_nil
+      end
+
+      it 'leaves email nil' do
+        subject.email.should be_nil
+      end
+    end
+  end
+
+  describe '#get_or_create_hash_url' do
+    subject { GoogleShortLinks::Client.new(@options).get_or_create_hash_url(@url, @params) }
+
+    context 'at 2011-11-17 13:04:15 -0500' do
+      before :each do
+        @now = Time.at(1321553055)
+        Timecop.freeze(@now)
+      end
+
+      after :each do
+        Timecop.return
+      end
+
+      context 'with server a, secret b, and email c' do
+        before :each do
+          @options = { :server => 'a', :secret => 'b', :email => 'c' }
+        end
+
+        context 'with url d' do
+          before :each do
+            @url = 'd'
+          end
+
+          context 'with empty params' do
+            before :each do
+              @params = {}
+            end
+
+            it 'should return a url with host a, path get_or_create_hash, signature method HMAC-SHA1, a current timestamp, url d, and user c, that is signed' do
+              subject.should == "http://a/js/get_or_create_hash?oauth_signature_method=HMAC-SHA1&timestamp=#{Time.now.to_f}&url=d&user=c&oauth_signature=H8ugo%2B8%2FHLIORPo9LjntVSClZXY%3D"
+            end
+          end
+
+          context 'with params oauth_signature_method HMAC-MD5, blah 123' do
+            before :each do
+              @params = { :oauth_signature_method => 'HMAC-MD5', :blah => 123 }
+            end
+
+            it 'should return a url with host a, path get_or_create_hash, signature method HMAC-MD5, a current timestamp, url d, user c, and extra parameter blah 123, that is signed' do
+              subject.should == "http://a/js/get_or_create_hash?blah=123&oauth_signature_method=HMAC-MD5&timestamp=#{Time.now.to_f}&url=d&user=c&oauth_signature=SHidraLOaaGtSP08qTXITZRk4nk%3D"
+            end
+          end
+        end
+      end
+    end
+  end
+
+  describe '#get_or_create_shortlink_url' do
+    subject { GoogleShortLinks::Client.new(@options).get_or_create_shortlink_url(@url, @shortcut, @params) }
+
+    context 'at 2011-11-17 13:04:15 -0500' do
+      before :each do
+        @now = Time.at(1321553055)
+        Timecop.freeze(@now)
+      end
+
+      after :each do
+        Timecop.return
+      end
+
+      context 'with server a, secret b, and email c' do
+        before :each do
+          @options = { :server => 'a', :secret => 'b', :email => 'c' }
+        end
+
+        context 'with url d' do
+          before :each do
+            @url = 'd'
+          end
+
+          context 'with a shortcut e' do
+            before :each do
+              @shortcut = 'e'
+            end
+
+            context 'with empty params' do
+              before :each do
+                @params = {}
+              end
+
+              it 'should return a url with host a, path get_or_create_shortlink, signature method HMAC-SHA1, shortcut e, a current timestamp, url d, and user c, that is signed' do
+                subject.should == "http://a/js/get_or_create_shortlink?oauth_signature_method=HMAC-SHA1&shortcut=e&timestamp=#{Time.now.to_f}&url=d&user=c&oauth_signature=Hf23Wj%2FoHARH4oyqy7FCgzUQrSk%3D"
+              end
+            end
+
+            context 'with params oauth_signature_method HMAC-MD5, blah 123' do
+              before :each do
+                @params = { :oauth_signature_method => 'HMAC-MD5', :blah => 123 }
+              end
+
+              it 'should return a url with host a, path get_or_create_shortlink, signature method HMAC-MD5, shortcut e, a current timestamp, url d, user c, and extra parameter blah 123, that is signed' do
+                subject.should == "http://a/js/get_or_create_shortlink?blah=123&oauth_signature_method=HMAC-MD5&shortcut=e&timestamp=#{Time.now.to_f}&url=d&user=c&oauth_signature=bdfkqZPbuqsKqalwou08oImutV0%3D"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+
+  describe '#get_details_url' do
+    subject { GoogleShortLinks::Client.new(@options).get_details_url(@shortcut, @params) }
+
+    context 'at 2011-11-17 13:04:15 -0500' do
+      before :each do
+        @now = Time.at(1321553055)
+        Timecop.freeze(@now)
+      end
+
+      after :each do
+        Timecop.return
+      end
+
+      context 'with server a, secret b, and email c' do
+        before :each do
+          @options = { :server => 'a', :secret => 'b', :email => 'c' }
+        end
+
+        context 'with a shortcut e' do
+          before :each do
+            @shortcut = 'e'
+          end
+
+          context 'with empty params' do
+            before :each do
+              @params = {}
+            end
+
+            it 'should return a url with host a, path get_details, signature method HMAC-SHA1, shortcut e, a current timestamp, and user c, that is signed' do
+              subject.should == "http://a/js/get_details?oauth_signature_method=HMAC-SHA1&shortcut=e&timestamp=#{Time.now.to_f}&user=c&oauth_signature=4uyxm8VBpvqEjoorn9Z60OhNsr8%3D"
+            end
+          end
+
+          context 'with params oauth_signature_method HMAC-MD5, blah 123' do
+            before :each do
+              @params = { :oauth_signature_method => 'HMAC-MD5', :blah => 123 }
+            end
+
+            it 'should return a url with host a, path get_details, signature method HMAC-MD5, shortcut e, a current timestamp, user c, and extra parameter blah 123, that is signed' do
+              subject.should == "http://a/js/get_details?blah=123&oauth_signature_method=HMAC-MD5&shortcut=e&timestamp=#{Time.now.to_f}&user=c&oauth_signature=iXvjBSxA87X45ShYk4JRb7W%2BcOw%3D"
+            end
+          end
+        end
+      end
+    end
+  end
+
+  describe '#get_or_create_hash' do
+    let(:client) { GoogleShortLinks::Client.new }
+
+    subject { client.get_or_create_hash(nil) }
+
+    context 'with get_or_create_hash_url returning http://www.example.org/' do
+      before :each do
+        client.stub!(:get_or_create_hash_url).and_return('http://www.example.org/')
+      end
+
+      it 'should call get with http://www.example.org/' do
+        GoogleShortLinks::Client.should_receive(:get).with('http://www.example.org/').and_return(mock(:parsed_response => nil))
+        subject
+      end
+
+      context 'when get returns a parsed response { "a" => "b" }' do
+        before :each do
+          GoogleShortLinks::Client.stub!(:get).with('http://www.example.org/').and_return(mock(:parsed_response => { 'a' => 'b'}))
+        end
+
+        it { should == { 'a' => 'b' } }
+      end
+    end
+  end
+
+  describe '#get_or_create_shortlink' do
+    let(:client) { GoogleShortLinks::Client.new }
+
+    subject { client.get_or_create_shortlink(nil, nil) }
+
+    context 'with get_or_create_shortlink_url returning http://www.example.org/' do
+      before :each do
+        client.stub!(:get_or_create_shortlink_url).and_return('http://www.example.org/')
+      end
+
+      it 'should call get with http://www.example.org/' do
+        GoogleShortLinks::Client.should_receive(:get).with('http://www.example.org/').and_return(mock(:parsed_response => nil))
+        subject
+      end
+
+      context 'when get returns a parsed response { "a" => "b" }' do
+        before :each do
+          GoogleShortLinks::Client.stub!(:get).with('http://www.example.org/').and_return(mock(:parsed_response => { 'a' => 'b'}))
+        end
+
+        it { should == { 'a' => 'b' } }
+      end
+    end
+  end
+
+  describe '#get_details' do
+    let(:client) { GoogleShortLinks::Client.new }
+
+    subject { client.get_details(nil) }
+
+    context 'with get_details_url returning http://www.example.org/' do
+      before :each do
+        client.stub!(:get_details_url).and_return('http://www.example.org/')
+      end
+
+      it 'should call get with http://www.example.org/' do
+        GoogleShortLinks::Client.should_receive(:get).with('http://www.example.org/').and_return(mock(:parsed_response => nil))
+        subject
+      end
+
+      context 'when get returns a parsed response { "a" => "b" }' do
+        before :each do
+          GoogleShortLinks::Client.stub!(:get).with('http://www.example.org/').and_return(mock(:parsed_response => { 'a' => 'b'}))
+        end
+
+        it { should == { 'a' => 'b' } }
+      end
+    end
+  end
+end

data/spec/google_short_links/parser_spec.rb

@@ -0,0 +1,27 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe GoogleShortLinks::Parser do
+  subject { GoogleShortLinks::Parser }
+
+  it { should <= HTTParty::Parser }
+
+  it('should support format :json') { should be_supports_format :json }
+
+  describe '#call' do
+    subject { GoogleShortLinks::Parser.call @body, @format }
+
+    context 'with a format of :json' do
+      before :each do
+        @format = :json
+      end
+
+      context 'with an body of {"a":"b"}' do
+        before :each do
+          @body = '{"a":"b"}'
+        end
+
+        it { should == {'a' => 'b'} }
+      end
+    end
+  end
+end

data/spec/google_short_links_spec.rb

@@ -0,0 +1,4 @@
+require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
+
+describe GoogleShortLinks do
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'google_short_links'
+
+require 'timecop'
+
+Dir[File.join(File.dirname(__FILE__), 'support', '**', '*.rb')].each { |f| require f }
+
+RSpec.configure do |config|
+end

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: google_short_links
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+  prerelease: 
+platform: ruby
+authors:
+- Benjamin Manns
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: &8478620 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *8478620
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: &8487320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *8487320
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &8481700 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *8481700
+- !ruby/object:Gem::Dependency
+  name: rcov
+  requirement: &8496100 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *8496100
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: &8494500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *8494500
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &8490100 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *8490100
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: &8503320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *8503320
+description: Ruby wrapper for Google Short Links.
+email: benmanns@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- .rvmrc
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- google-short-links.gemspec
+- google_short_links.gemspec
+- lib/google_short_links.rb
+- lib/google_short_links/client.rb
+- lib/google_short_links/parser.rb
+- spec/examples/google_short_links/client_spec.rb
+- spec/google_short_links/client_spec.rb
+- spec/google_short_links/parser_spec.rb
+- spec/google_short_links_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/benmanns/google_short_links
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2353519240381542062
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for Google Short Links.
+test_files: []