fullcontacter 0.3.2

data/.document

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

data/.gitignore

@@ -0,0 +1,53 @@
+# 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
+
+*.gem

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) 2011 Brandon West, Jai Pandya, Prafulla Kiran
+
+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,36 @@
+FullContact Ruby Gem
+====================
+A Ruby wrapper for the [FullContact API](http://www.fullcontact.com/)
+
+Installation
+------------
+    gem install fullcontacter
+
+Documentation
+-------------
+[http://rdoc.info/gems/fullcontacter](http://rdoc.info/gems/fullcontacter)
+
+Usage Examples
+--------------
+    require "rubygems"
+    require "fullcontact"
+    
+    # This could go in an initializer
+    FullContact.configure do |config|
+      config.api_key = "fullcontact_api_key_goes_here"
+    end
+    
+    # Get information about a email address
+    person = FullContact.lookup_by_email('prafulla.kiran@gmail.com')
+      
+    # Get information about a twitter
+    person2 = FullContact.lookup_by_twitter('prafulla')
+    
+    # Get person's family_name
+    puts person.contact_info.family_name
+
+Copyright
+---------
+Copyright (c) 2012 Brandon West, Jai Pandya, Prafulla Kiran
+
+See [LICENSE](https://github.com/jaipandya/fullcontacter/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.3.2

data/bugs.txt

@@ -0,0 +1,2 @@
+On fullcontact.com documentation page
+snapshots,subscription - action to be used is 'contactList' and not 'contactLists'

data/fullcontact.gemspec

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "fullcontact/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.2.0'
+  s.add_runtime_dependency 'faraday', '~> 0.7.5'
+  s.add_runtime_dependency 'faraday_middleware', '~> 0.8.6'
+  s.add_runtime_dependency 'multi_json', '~> 1.2.0'
+  s.add_runtime_dependency 'multi_xml', '~> 0.4.2'
+  s.add_runtime_dependency 'rash', '~> 0.3.0'
+
+  s.authors = "Brandon West, Jai Pandya, Prafulla Kiran"
+  s.description = %q{A Ruby wrapper for the FullContact API}
+  s.email = ['brawest@gmail.com', 'jaipandya@gmail.com', 'prafulla.kiran@gmail.com']
+
+  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/jaipandya/fullcontacter'
+  s.name = 'fullcontacter'
+  s.require_paths = ['lib']
+  s.required_rubygems_version = Gem::Requirement.new('>= 1.3.6')
+  s.summary = %q{Ruby wrapper for the FullContact API}
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.version = FullContact::VERSION
+end

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/fullcontact_errors.rb

@@ -0,0 +1,33 @@
+module Faraday
+  class Response::FullContactErrors < Response::Middleware
+    def on_complete(env)
+      case env[:status]
+        when 400
+          raise FullContact::BadRequest.new(error_message(env), env[:response_headers])
+        when 401
+          raise FullContact::Unauthorized.new(error_message(env), env[:response_headers])
+        when 403
+          raise FullContact::Forbidden.new(error_message(env), env[:response_headers])
+        when 404
+          raise FullContact::NotFound.new(error_message(env), env[:response_headers])
+        when 422
+          raise FullContact::Invalid.new(error_message(env), env[:response_headers])
+        when 500
+          raise FullContact::InternalServerError.new(error_message(env), env[:response_headers])
+        when 502
+          raise FullContact::BadGateway.new(error_message(env), env[:response_headers])
+        when 503
+          raise FullContact::ServiceUnavailable.new(error_message(env), env[:response_headers])
+      end
+    end
+
+    def error_message(env)
+      "#{env[:method].to_s.upcase} #{env[:url].to_s}: #{env[:status]}"
+    end
+
+    def initialize(app)
+      super
+      @parser = nil
+    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 FullContact::BadRequest.new(error_message(env), env[:response_headers])
+      when 401
+        raise FullContact::Unauthorized.new(error_message(env), env[:response_headers])
+      when 403
+        raise FullContact::Forbidden.new(error_message(env), env[:response_headers])
+      when 404
+        raise FullContact::NotFound.new(error_message(env), env[:response_headers])
+      when 422
+        raise FullContact::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 FullContact::InternalServerError.new(error_message(env, "Internal server error."), env[:response_headers])
+      when 502
+        raise FullContact::BadGateway.new(error_message(env, "FullContact is down or being upgraded."), env[:response_headers])
+      when 503
+        raise FullContact::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://status.fullcontact.cc/ for updates on the status of the FullContact service."
+    end
+  end
+end

data/lib/fullcontact.rb

@@ -0,0 +1,27 @@
+require "faraday"
+require "faraday_middleware"
+require 'fullcontact/error'
+require 'fullcontact/configuration'
+require 'fullcontact/api'
+require 'fullcontact/client'
+
+module FullContact
+  extend Configuration
+
+  # Alias for FullContact::Client.new
+  #
+  # Returns [FullContact::Client]
+  def self.client(options={})
+    FullContact::Client.new(options)
+  end
+
+  # Delegate to FullContact::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/lib/fullcontact/api.rb

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

data/lib/fullcontact/client.rb

@@ -0,0 +1,32 @@
+module FullContact
+  # Wrapper for the FullContact 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 'fullcontact/client/person'
+    require 'fullcontact/client/user'
+    require 'fullcontact/client/contact_list'
+    require 'fullcontact/client/contact'
+    require 'fullcontact/client/snapshot'
+    require 'fullcontact/client/subscription'
+    require 'fullcontact/client/name'
+    require 'fullcontact/client/icon'
+    require 'fullcontact/client/provisioning'
+    require 'fullcontact/client/batch_process'
+
+    alias :api_endpoint :endpoint
+
+    include FullContact::Client::Person
+    include FullContact::Client::User
+    include FullContact::Client::ContactList
+    include FullContact::Client::Contact
+    include FullContact::Client::Snapshot
+    include FullContact::Client::Subscription
+    include FullContact::Client::Name
+    include FullContact::Client::Icon
+    include FullContact::Client::Provisioning
+    include FullContact::Client::BatchProcess
+  end
+end

data/lib/fullcontact/client/batch_process.rb

@@ -0,0 +1,35 @@
+module FullContact
+  class Client
+    module BatchProcess
+      # Public: The Batch Process endpoint allows you to batch several API
+      # requests into a single request to improve performance by eliminating
+      # excess network overhead. This endpoint will proxy requests (up to 20
+      # per batch) on your behalf to any other API endpoint which accepts GET
+      # requests.
+      #
+      # Yields array of URLs to api endpoints
+      #
+      # Example
+      #
+      #   respnose = FullContact.batch do 
+      #     [FullContact.normalize('Mr. John Michael Smith'),
+      #      FullContact.deduce_by_email('johnsmith@gmail.com')]
+      #     end
+      #   'response' contains batch response from the api
+      #
+      # Returns response from different api methods in the batch
+      def batch(options = {})
+        FullContact.configure do |config|
+          config.get_request_url_only = true
+        end
+        batch_method_list = yield
+        FullContact.configure do |config|
+          config.get_request_url_only = false
+        end
+        options[:content_type] = 'application/json'
+        options[:request_body] = {:requests => batch_method_list}.to_json
+        post("batch", options)
+      end
+    end
+  end
+end