rainmaker 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.gitignore

@@ -0,0 +1,51 @@
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+#*.swp
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc
+
+.idea/
+*.lock

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format=nested
+--backtrace

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2010 John Nunemaker, Wynn Netherland, Erik Michaels-Ober, Steve Richert
+
+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.md

@@ -0,0 +1,32 @@
+Rainmaker Ruby Gem
+====================
+A Ruby wrapper for the [Rainmaker API](http://api.rainmaker.cc) 
+
+Installation
+------------
+    gem install rainmaker
+
+Documentation
+-------------
+[http://rdoc.info/gems/rainmaker](http://rdoc.info/gems/rainmaker)
+
+Usage Examples
+--------------
+    require "rubygems"
+    require "rainmaker"
+
+	# This could go in an initializer
+	Rainmaker.configure do |config|
+		config.api_key = "rainmaker_api_key_goes_here"
+	end
+	
+    # Get information about an email address
+    person = Rainmaker.person("brawest@gmail.com")
+
+	# Get person's family_name
+	puts person.contact_info.family_name
+
+Copyright
+---------
+Copyright (c) 2010 Brandon West
+See [LICENSE](https://github.com/brandonmwest/twitter/blob/master/LICENSE.md) for details.

data/Rakefile

@@ -0,0 +1,25 @@
+#!/usr/bin/env rake
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :test => :spec
+task :default => :spec
+
+namespace :doc do
+  require 'yard'
+  YARD::Rake::YardocTask.new do |task|
+    task.files   = ['HISTORY.md', 'LICENSE.md', 'lib/**/*.rb']
+    task.options = [
+      '--protected',
+      '--output-dir', 'doc',
+      '--tag', 'format:Supported formats',
+      '--tag', 'authenticated:Requires Authentication',
+      '--tag', 'rate_limited:Rate Limited',
+      '--markup', 'markdown',
+    ]
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/faraday/request/gateway.rb

@@ -0,0 +1,18 @@
+require 'faraday'
+
+# @private
+module Faraday
+  # @private
+  class Request::Gateway < Faraday::Middleware
+    def call(env)
+      url = env[:url].dup
+      url.host = @gateway
+      env[:url] = url
+      @app.call(env)
+    end
+
+    def initialize(app, gateway)
+      @app, @gateway = app, gateway
+    end
+  end
+end

data/lib/faraday/response/raise_http_4xx.rb

@@ -0,0 +1,45 @@
+require 'faraday'
+
+# @private
+module Faraday
+  # @private
+  class Response::RaiseHttp4xx < Response::Middleware
+    def on_complete(env)
+      case env[:status].to_i
+      when 400
+        raise Rainmaker::BadRequest.new(error_message(env), env[:response_headers])
+      when 401
+        raise Rainmaker::Unauthorized.new(error_message(env), env[:response_headers])
+      when 403
+        raise Rainmaker::Forbidden.new(error_message(env), env[:response_headers])
+      when 404
+        raise Rainmaker::NotFound.new(error_message(env), env[:response_headers])
+      when 422
+        raise Rainmaker::Invalid.new(error_message(env), env[:response_headers])
+    end
+
+
+	end
+
+	private
+
+	def error_message(env)
+      "#{env[:method].to_s.upcase} #{env[:url].to_s}: #{env[:status]}#{error_body(env[:body])}"
+    end
+
+    def error_body(body)
+      if body.nil?
+        nil
+      elsif body['error']
+        ": #{body['error']}"
+      elsif body['errors']
+        first = Array(body['errors']).first
+        if first.kind_of? Hash
+          ": #{first['message'].chomp}"
+        else
+          ": #{first.chomp}"
+        end
+      end
+    end
+  end
+end

data/lib/faraday/response/raise_http_5xx.rb

@@ -0,0 +1,24 @@
+require 'faraday'
+
+# @private
+module Faraday
+  # @private
+  class Response::RaiseHttp5xx < Response::Middleware
+    def on_complete(env)
+      case env[:status].to_i
+      when 500
+        raise Rainmaker::InternalServerError.new(error_message(env, "Internal server error."), env[:response_headers])
+      when 502
+        raise Rainmaker::BadGateway.new(error_message(env, "Rainmaker is down or being upgraded."), env[:response_headers])
+      when 503
+        raise Rainmaker::ServiceUnavailable.new(error_message(env, "Service unavailable."), env[:response_headers])
+      end
+    end
+
+    private
+
+    def error_message(env, body=nil)
+      "#{env[:method].to_s.upcase} #{env[:url].to_s}: #{[env[:status].to_s + ':', body].compact.join(' ')} Check http://api.rainmaker.cc/ for updates on the status of the Rainmaker service."
+    end
+  end
+end

data/lib/rainmaker/api.rb

@@ -0,0 +1,21 @@
+require 'rainmaker/connection'
+require 'rainmaker/request'
+
+module Rainmaker
+  # @private
+  class API
+    # @private
+    attr_accessor *Configuration::VALID_OPTIONS_KEYS
+
+    # Creates a new API
+    def initialize(options={})
+      options = Rainmaker.options.merge(options)
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+    include Connection
+    include Request
+  end
+end

data/lib/rainmaker/client/person.rb

@@ -0,0 +1,12 @@
+module Rainmaker
+  class Client
+    module Person
+      # Returns extended information for a given email
+      #
+       def person(email)
+        response = get('person', :email => email)
+        format.to_s.downcase == 'xml' ? response['person'] : response
+      end
+  	end
+  end
+end

data/lib/rainmaker/client.rb

@@ -0,0 +1,14 @@
+module Rainmaker
+  # Wrapper for the Rainmaker REST API
+
+  class Client < API
+    # Require client method modules after initializing the Client class in
+    # order to avoid a superclass mismatch error, allowing those modules to be
+    # Client-namespaced.
+    require 'rainmaker/client/person'
+
+    alias :api_endpoint :endpoint
+
+    include Rainmaker::Client::Person
+  end
+end

data/lib/rainmaker/configuration.rb

@@ -0,0 +1,80 @@
+require 'faraday'
+
+module Rainmaker
+  # Defines constants and methods related to configuration
+  module Configuration
+    # An array of valid keys in the options hash when configuring a {Rainmaker::API}
+    VALID_OPTIONS_KEYS = [
+      :adapter,
+      :api_key,
+      :endpoint,
+      :format,
+      :gateway,
+      :proxy,
+      :user_agent].freeze
+
+    # An array of valid request/response formats
+    #
+    # @note Not all methods support the XML format.
+    VALID_FORMATS = [
+      :json,
+      :xml].freeze
+
+    # The adapter that will be used to connect if none is set
+    #
+    # @note The default faraday adapter is Net::HTTP.
+    DEFAULT_ADAPTER = Faraday.default_adapter
+
+    # By default, don't set an application key
+    DEFAULT_API_KEY = nil
+
+    # The endpoint that will be used to connect if none is set
+    #
+    DEFAULT_ENDPOINT = 'http://api.rainmaker.cc/v1/'.freeze
+
+    # The response format appended to the path and sent in the 'Accept' header if none is set
+    #
+    # @note JSON is preferred over XML because it is more concise and faster to parse.
+    DEFAULT_FORMAT = :json
+
+     # By default, don't use a proxy server
+    DEFAULT_PROXY = nil
+
+    # The user agent that will be sent to the API endpoint if none is set
+    DEFAULT_USER_AGENT = "Rainmaker Ruby Gem".freeze
+
+    DEFAULT_GATEWAY = nil
+
+    # @private
+    attr_accessor *VALID_OPTIONS_KEYS
+
+    # When this module is extended, set all configuration options to their default values
+    def self.extended(base)
+      base.reset
+    end
+
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+    end
+
+    # Create a hash of options and their values
+    def options
+      options = {}
+      VALID_OPTIONS_KEYS.each{|k| options[k] = send(k) }
+      options
+    end
+
+    # Reset all configuration options to defaults
+    def reset
+      self.adapter            = DEFAULT_ADAPTER
+      self.api_key      	  = DEFAULT_API_KEY
+      self.endpoint           = DEFAULT_ENDPOINT
+      self.format             = DEFAULT_FORMAT
+      self.proxy              = DEFAULT_PROXY
+      self.user_agent         = DEFAULT_USER_AGENT
+      self.gateway            = DEFAULT_GATEWAY
+      self
+    end
+  end
+end

data/lib/rainmaker/connection.rb

@@ -0,0 +1,38 @@
+require 'faraday_middleware'
+require 'faraday/request/gateway'
+require 'faraday/response/raise_http_4xx'
+require 'faraday/response/raise_http_5xx'
+
+module Rainmaker
+  # @private
+  module Connection
+    private
+
+    def connection(raw=false)
+      options = {
+        :headers => {'Accept' => "application/#{format}", 'User-Agent' => user_agent},
+        :proxy => proxy,
+        :ssl => {:verify => false},
+        :url => api_endpoint,
+      }
+
+      Faraday.new(options) do |builder|
+        builder.use Faraday::Request::Multipart
+        builder.use Faraday::Request::UrlEncoded
+        builder.use Faraday::Request::Gateway, gateway if gateway
+        builder.use Faraday::Response::RaiseHttp4xx
+        builder.use Faraday::Response::Rashify unless raw
+        unless raw
+          case format.to_s.downcase
+          when 'json'
+            builder.use Faraday::Response::ParseJson
+          when 'xml'
+            builder.use Faraday::Response::ParseXml
+          end
+        end
+        builder.use Faraday::Response::RaiseHttp5xx
+        builder.adapter(adapter)
+      end
+    end
+  end
+end

data/lib/rainmaker/error.rb

@@ -0,0 +1,39 @@
+module Rainmaker
+  # Custom error class for rescuing from all Rainmaker errors
+  class Error < StandardError
+    attr_reader :http_headers
+
+    def initialize(message, http_headers)
+      @http_headers = Hash[http_headers]
+      super message
+    end
+
+    def retry_after
+      [(ratelimit_reset - Time.now).ceil, 0].max
+    end
+  end
+
+  # Raised when Rainmaker returns the HTTP status code 400
+  class BadRequest < Error; end
+
+  # Raised when Rainmaker returns the HTTP status code 401
+  class Unauthorized < Error; end
+
+  # Raised when Rainmaker returns the HTTP status code 403
+  class Forbidden < Error; end
+
+  # Raised when Rainmaker returns the HTTP status code 404
+  class NotFound < Error; end
+
+  # Raised when Rainmaker returns the HTTP status code 422
+  class Invalid < Error; end
+
+  # Raised when Rainmaker returns the HTTP status code 500
+  class InternalServerError < Error; end
+
+  # Raised when Rainmaker returns the HTTP status code 502
+  class BadGateway < Error; end
+
+  # Raised when Rainmaker returns the HTTP status code 503
+  class ServiceUnavailable < Error; end
+end

data/lib/rainmaker/request.rb

@@ -0,0 +1,24 @@
+module Rainmaker
+  # Defines HTTP request methods
+  module Request
+    # Perform an HTTP GET request
+    def get(path, options={}, raw=false)
+      request(:get, path, options, raw)
+    end
+
+    private
+
+    # Perform an HTTP request
+    def request(method, path, options, raw=false)
+		options[:apiKey] = Rainmaker.options[:api_key]
+      	response = connection(raw).send(method) do |request|
+        request.url(formatted_path(path), options)
+      end
+      raw ? response : response.body
+    end
+
+    def formatted_path(path)
+      [path, format].compact.join('.')
+    end
+  end
+end

data/lib/rainmaker/version.rb

@@ -0,0 +1,3 @@
+module Rainmaker
+	VERSION = "0.0.1"
+end

data/lib/rainmaker.rb

@@ -0,0 +1,27 @@
+require "faraday"
+require "faraday_middleware"
+require 'rainmaker/error'
+require 'rainmaker/configuration'
+require 'rainmaker/api'
+require 'rainmaker/client'
+
+module Rainmaker
+  extend Configuration
+
+  # Alias for Rainmaker::Client.new
+  #
+  # @return [Rainmaker::Client]
+  def self.client(options={})
+    Rainmaker::Client.new(options)
+  end
+
+  # Delegate to Rainmaker::Client
+  def self.method_missing(method, *args, &block)
+    return super unless client.respond_to?(method)
+    client.send(method, *args, &block)
+  end
+
+  def self.respond_to?(method, include_private = false)
+    client.respond_to?(method, include_private) || super(method, include_private)
+  end
+end

data/rainmaker.gemspec

@@ -0,0 +1,40 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "rainmaker/version"
+
+Gem::Specification.new do |s|
+  s.add_development_dependency 'maruku', '~> 0.6'
+  s.add_development_dependency 'nokogiri', '~> 1.4'
+  s.add_development_dependency 'rake', '~> 0.9'
+  s.add_development_dependency 'rspec', '~> 2.6'
+  s.add_development_dependency 'simplecov', '~> 0.4'
+  s.add_development_dependency 'webmock', '~> 1.6'
+  s.add_development_dependency 'yard', '~> 0.7'
+  s.add_runtime_dependency 'hashie', '~> 1.0.0'
+  s.add_runtime_dependency 'faraday', '~> 0.6.1'
+  s.add_runtime_dependency 'faraday_middleware', '~> 0.6.3'
+  s.add_runtime_dependency 'multi_json', '~> 1.0.0'
+  s.add_runtime_dependency 'multi_xml', '~> 0.2.0'
+  s.add_runtime_dependency 'rash', '~> 0.3.0'
+
+  s.author = "Brandon West"
+  s.description = %q{A Ruby wrapper for the Rainmaker API}
+  s.email = ['brawest@gmail.com']
+
+  s.post_install_message = '
+-------------------------------------------------------------
+Follow me on Twitter! http://twitter.com/brandonmwest
+-------------------------------------------------------------
+
+'
+
+  s.executables = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  s.files = `git ls-files`.split("\n")
+  s.homepage = 'https://github.com/brandonmwest/rainmaker'
+  s.name = 'rainmaker'
+  s.require_paths = ['lib']
+  s.required_rubygems_version = Gem::Requirement.new('>= 1.3.6')
+  s.summary = %q{Ruby wrapper for the Rainmaker API}
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.version = Rainmaker::VERSION
+end

data/spec/faraday/response_spec.rb

@@ -0,0 +1,56 @@
+require 'helper'
+require 'faraday'
+require 'rainmaker'
+
+describe Faraday::Response do
+  before do
+	Rainmaker.configure do |config|
+		config.api_key = "api_key"
+	end
+    @client = Rainmaker::Client.new
+  end
+
+  {
+    400 => Rainmaker::BadRequest,
+    401 => Rainmaker::Unauthorized,
+    403 => Rainmaker::Forbidden,
+    404 => Rainmaker::NotFound,
+    422 => Rainmaker::Invalid,
+    500 => Rainmaker::InternalServerError,
+    502 => Rainmaker::BadGateway,
+    503 => Rainmaker::ServiceUnavailable,
+  }.each do |status, exception|
+    if (status >= 500)
+      context "when HTTP status is #{status}" do
+        before do
+          stub_get('person.json').
+            with(:query => {:apiKey => "api_key", :email => 'brawest@gmail.com'}).
+            to_return(:status => status)
+        end
+
+        it "should raise #{exception.name} error" do
+          lambda do
+            @client.person( 'brawest@gmail.com')
+          end.should raise_error(exception)
+        end
+      end
+    else
+      [nil, "error", "errors"].each do |body|
+        context "when HTTP status is #{status} and body is #{body||='nil'}" do
+          before do
+            body_message = '{"'+body+'":"test"}' unless body.nil?
+         	stub_get('person.json').
+				with(:query => {:apiKey => "api_key", :email => 'brawest@gmail.com'}).
+               to_return(:status => status, :body => body_message)
+          end
+
+          it "should raise #{exception.name} error" do
+            lambda do
+             @client.person( 'brawest@gmail.com')
+            end.should raise_error(exception)
+          end
+        end
+      end
+    end
+  end
+end

data/spec/fixtures/person.json

@@ -0,0 +1,48 @@
+
+{
+  "status": 200,
+  "photos": 
+  [
+    {
+      "url": "http://a0.twimg.com/profile_images/1084241539/steps_normal.jpg",
+      "type": "twitter"
+    },
+    {
+      "isPrimary": false,
+      "type": "gravatar",
+      "url": "https://secure.gravatar.com/avatar/b2f65d319b253da9cf92635d8eac808b"
+    },
+    {
+      "message": "More Data Available - 3rd party credentials required - contact api@rainmaker.cc for more information."
+    }
+  ],
+  "contactInfo": {
+    "familyName": "West",
+    "givenName": "Brandon",
+    "fullName": "Brandon West"
+  },
+  "demographics": {
+    "age": {
+      "message": "More Data Available - 3rd party credentials required - contact api@rainmaker.cc for more information."
+    },
+    "locationGeneral": "Littleton, Colorado",
+    "gender": {
+      "message": "More Data Available - 3rd party credentials required - contact api@rainmaker.cc for more information."
+    }
+  },
+  "socialProfiles": 
+  [
+    {
+      "url": "http://twitter.com/brandonmwest",
+      "id": "16517063",
+      "type": "twitter",
+      "username": "brandonmwest"
+    },
+    {
+      "message": "More Data Available - 3rd party credentials required - contact api@rainmaker.cc for more information."
+    },
+    {
+      "message": "More Data Available - 3rd party credentials required - contact api@rainmaker.cc for more information."
+    }
+  ]
+}

data/spec/helper.rb

@@ -0,0 +1,22 @@
+require 'rspec'
+require 'webmock/rspec'
+require 'simplecov'
+
+SimpleCov.start
+
+
+def a_get(path)
+  a_request(:get, Rainmaker.endpoint + path)
+end
+
+def stub_get(path)
+  stub_request(:get, Rainmaker.endpoint + path)
+end
+
+def fixture_path
+  File.expand_path("../fixtures", __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end

data/spec/rainmaker_spec.rb

@@ -0,0 +1,110 @@
+require 'helper'
+
+describe Rainmaker do
+  after do
+    Rainmaker.reset
+  end
+
+  context "when delegating to a client" do
+
+    before do
+		Rainmaker.configure do |config|
+			config.api_key = "api_key"
+		end
+
+		stub_get("person.json").
+		  with(:query => {:apiKey => "api_key", :email => "brawest@gmail.com"}).
+		  to_return(:body => fixture("person.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+
+    end
+
+    it "should get the correct resource" do
+      Rainmaker.person("brawest@gmail.com")
+      a_get("person.json")
+	  .with(:query => {:apiKey => "api_key", :email => "brawest@gmail.com"})
+	  .should have_been_made
+    end
+
+    it "should return the same results as a client" do
+      Rainmaker.person("brawest@gmail.com").should == Rainmaker::Client.new.person("brawest@gmail.com")
+    end
+
+  end
+
+  describe '.respond_to?' do
+    it 'takes an optional include private argument' do
+      Rainmaker.respond_to?(:client, true).should be_true
+    end
+  end
+
+  describe ".client" do
+    it "should be a Rainmaker::Client" do
+      Rainmaker.client.should be_a Rainmaker::Client
+    end
+  end
+
+  describe ".adapter" do
+    it "should return the default adapter" do
+      Rainmaker.adapter.should == Rainmaker::Configuration::DEFAULT_ADAPTER
+    end
+  end
+
+  describe ".adapter=" do
+    it "should set the adapter" do
+      Rainmaker.adapter = :typhoeus
+      Rainmaker.adapter.should == :typhoeus
+    end
+  end
+
+  describe ".endpoint" do
+    it "should return the default endpoint" do
+      Rainmaker.endpoint.should == Rainmaker::Configuration::DEFAULT_ENDPOINT
+    end
+  end
+
+  describe ".endpoint=" do
+    it "should set the endpoint" do
+      Rainmaker.endpoint = 'http://tumblr.com/'
+      Rainmaker.endpoint.should == 'http://tumblr.com/'
+    end
+  end
+
+  describe ".format" do
+    it "should return the default format" do
+      Rainmaker.format.should == Rainmaker::Configuration::DEFAULT_FORMAT
+    end
+  end
+
+  describe ".format=" do
+    it "should set the format" do
+      Rainmaker.format = 'xml'
+      Rainmaker.format.should == 'xml'
+    end
+  end
+
+  describe ".user_agent" do
+    it "should return the default user agent" do
+      Rainmaker.user_agent.should == Rainmaker::Configuration::DEFAULT_USER_AGENT
+    end
+  end
+
+  describe ".user_agent=" do
+    it "should set the user_agent" do
+      Rainmaker.user_agent = 'Custom User Agent'
+      Rainmaker.user_agent.should == 'Custom User Agent'
+    end
+  end
+
+  describe ".configure" do
+
+    Rainmaker::Configuration::VALID_OPTIONS_KEYS.each do |key|
+
+      it "should set the #{key}" do
+        Rainmaker.configure do |config|
+          config.send("#{key}=", key)
+          Rainmaker.send(key).should == key
+        end
+      end
+    end
+  end
+end

data/spec/ruby_rainmaker/api_spec.rb

@@ -0,0 +1,65 @@
+require 'helper'
+
+describe Rainmaker::API do
+  before do
+    @keys = Rainmaker::Configuration::VALID_OPTIONS_KEYS
+  end
+
+  context "with module configuration" do
+     before do
+      Rainmaker.configure do |config|
+        @keys.each do |key|
+          config.send("#{key}=", key)
+        end
+      end
+    end
+
+    after do
+      Rainmaker.reset
+    end
+
+    it "should inherit module configuration" do
+      api = Rainmaker::API.new
+      @keys.each do |key|
+        api.send(key).should == key
+      end
+    end
+
+    context "with class configuration" do
+
+      before do
+        @configuration = {
+          :api_key => 'api_key',
+          :adapter => :typhoeus,
+          :endpoint => 'http://tumblr.com/',
+          :gateway => 'apigee-1111.apigee.com',
+          :format => :xml,
+          :proxy => 'http://erik:sekret@proxy.example.com:8080',
+          :user_agent => 'Custom User Agent',
+        }
+      end
+
+      context "during initialization"
+
+        it "should override module configuration" do
+          api = Rainmaker::API.new(@configuration)
+          @keys.each do |key|
+            api.send(key).should == @configuration[key]
+          end
+        end
+
+      context "after initilization" do
+
+        it "should override module configuration after initialization" do
+          api = Rainmaker::API.new
+          @configuration.each do |key, value|
+            api.send("#{key}=", value)
+          end
+          @keys.each do |key|
+            api.send(key).should == @configuration[key]
+          end
+        end
+      end
+    end
+  end
+end

data/spec/ruby_rainmaker/client/person_spec.rb

@@ -0,0 +1,12 @@
+require 'helper'
+
+describe Rainmaker::Client do
+  Rainmaker::Configuration::VALID_FORMATS.each do |format|
+    context ".new(:format => '#{format}')" do
+      before do
+        @client = Rainmaker::Client.new(:format => format, :api_key => 'api_key')
+      end
+
+      end
+    end
+  end

data/spec/ruby_rainmaker/client_spec.rb

@@ -0,0 +1,10 @@
+require 'helper'
+
+describe Rainmaker::Client do
+  it "should connect using the endpoint configuration" do
+    client = Rainmaker::Client.new
+    endpoint = URI.parse(client.api_endpoint)
+    connection = client.send(:connection).build_url(nil).to_s
+    connection.should == endpoint.to_s
+  end
+end

metadata

@@ -0,0 +1,250 @@
+--- !ruby/object:Gem::Specification
+name: rainmaker
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Brandon West
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-05-31 00:00:00.000000000 -06:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: maruku
+  requirement: &11140308 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: *11140308
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &11140008 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: *11140008
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &11139732 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: *11139732
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &11139456 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: *11139456
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &11139180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: *11139180
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: &11138904 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: *11138904
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &11138628 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: *11138628
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: &11138352 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *11138352
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: &11138076 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *11138076
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: &11137800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *11137800
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: &11137524 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *11137524
+- !ruby/object:Gem::Dependency
+  name: multi_xml
+  requirement: &11137248 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *11137248
+- !ruby/object:Gem::Dependency
+  name: rash
+  requirement: &11136972 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *11136972
+description: A Ruby wrapper for the Rainmaker API
+email:
+- brawest@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .document
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- VERSION
+- lib/faraday/request/gateway.rb
+- lib/faraday/response/raise_http_4xx.rb
+- lib/faraday/response/raise_http_5xx.rb
+- lib/rainmaker.rb
+- lib/rainmaker/api.rb
+- lib/rainmaker/client.rb
+- lib/rainmaker/client/person.rb
+- lib/rainmaker/configuration.rb
+- lib/rainmaker/connection.rb
+- lib/rainmaker/error.rb
+- lib/rainmaker/request.rb
+- lib/rainmaker/version.rb
+- rainmaker.gemspec
+- spec/faraday/response_spec.rb
+- spec/fixtures/person.json
+- spec/helper.rb
+- spec/rainmaker_spec.rb
+- spec/ruby_rainmaker/api_spec.rb
+- spec/ruby_rainmaker/client/person_spec.rb
+- spec/ruby_rainmaker/client_spec.rb
+- vendor/cache/addressable-2.2.6.gem
+- vendor/cache/crack-0.1.8.gem
+- vendor/cache/diff-lcs-1.1.2.gem
+- vendor/cache/faraday-0.6.1.gem
+- vendor/cache/faraday_middleware-0.6.3.gem
+- vendor/cache/hashie-1.0.0.gem
+- vendor/cache/maruku-0.6.0.gem
+- vendor/cache/multi_json-1.0.3.gem
+- vendor/cache/multi_xml-0.2.2.gem
+- vendor/cache/multipart-post-1.1.2.gem
+- vendor/cache/nokogiri-1.4.4.1-x86-mingw32.gem
+- vendor/cache/rack-1.3.0.gem
+- vendor/cache/rake-0.9.0.gem
+- vendor/cache/rash-0.3.0.gem
+- vendor/cache/rspec-2.6.0.gem
+- vendor/cache/rspec-core-2.6.3.gem
+- vendor/cache/rspec-expectations-2.6.0.gem
+- vendor/cache/rspec-mocks-2.6.0.gem
+- vendor/cache/simplecov-0.4.2.gem
+- vendor/cache/simplecov-html-0.4.5.gem
+- vendor/cache/syntax-1.0.0.gem
+- vendor/cache/webmock-1.6.4.gem
+- vendor/cache/yard-0.7.1.gem
+has_rdoc: true
+homepage: https://github.com/brandonmwest/rainmaker
+licenses: []
+post_install_message: ! '
+
+  -------------------------------------------------------------
+
+  Follow me on Twitter! http://twitter.com/brandonmwest
+
+  -------------------------------------------------------------
+
+
+'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for the Rainmaker API
+test_files: []