fullcontacter 0.3.2

data/spec/fixtures/stats_by_given_name.json

@@ -0,0 +1,57 @@
+{
+  "status": 200,
+  "name": {
+    "value": "John",
+    "given": {
+      "count": 3499150,
+      "rank": 3,
+      "male": {
+        "count": 3484136,
+        "likelihood": 0.996,
+        "rank": 3,
+        "frequencyRatio": "0.026305137",
+        "age": {
+          "densityCurve": {
+            "mode": {
+              "count": 77174,
+              "modeAge": 
+              [
+                47
+              ]
+            },
+            "meanAge": 51.2,
+            "quartiles": {
+              "q1": 35.3,
+              "q2": 50.5,
+              "q3": 62.9
+            }
+          }
+        }
+      },
+      "female": {
+        "count": 15015,
+        "likelihood": 0.004,
+        "rank": 928,
+        "frequencyRatio": "0.00011386",
+        "age": {
+          "densityCurve": {
+            "mode": {
+              "count": 297,
+              "modeAge": 
+              [
+                43
+              ]
+            },
+            "meanAge": 48.5,
+            "quartiles": {
+              "q1": 34.8,
+              "q2": 49.4,
+              "q3": 69.4
+            }
+          }
+        }
+      }
+    }
+  },
+  "region": "USA"
+}

data/spec/fixtures/stats_by_name.json

@@ -0,0 +1,64 @@
+{
+  "status": 200,
+  "name": {
+    "value": "John",
+    "given": {
+      "likelihood": 0.992,
+      "count": 3499150,
+      "rank": 3,
+      "male": {
+        "count": 3484136,
+        "likelihood": 0.996,
+        "rank": 3,
+        "frequencyRatio": "0.026305137",
+        "age": {
+          "densityCurve": {
+            "mode": {
+              "count": 77174,
+              "modeAge": 
+              [
+                47
+              ]
+            },
+            "meanAge": 51.2,
+            "quartiles": {
+              "q1": 35.3,
+              "q2": 50.5,
+              "q3": 62.9
+            }
+          }
+        }
+      },
+      "female": {
+        "count": 15015,
+        "likelihood": 0.004,
+        "rank": 928,
+        "frequencyRatio": "0.00011386",
+        "age": {
+          "densityCurve": {
+            "mode": {
+              "count": 297,
+              "modeAge": 
+              [
+                43
+              ]
+            },
+            "meanAge": 48.5,
+            "quartiles": {
+              "q1": 34.8,
+              "q2": 49.4,
+              "q3": 69.4
+            }
+          }
+        }
+      }
+    },
+    "family": {
+      "likelihood": 0.008,
+      "count": 27643,
+      "rank": 1161,
+      "frequencyRatio": "0.00011417"
+    }
+  },
+  "region": "USA"
+}

data/spec/fixtures/update_contact.json

@@ -0,0 +1,9 @@
+{
+  "results":  [
+     {
+      "contactId": "jzZrFNsv5s",
+      "eTag": "fffffec9d69df08ded1d2009fc32d0a397820a5482306589e6c09b05"
+    }
+  ],
+  "status": 200
+}

data/spec/fullcontact/api_spec.rb

@@ -0,0 +1,68 @@
+require 'helper'
+
+describe FullContact::API do
+  before do
+    @keys = FullContact::Configuration::VALID_OPTIONS_KEYS
+  end
+
+  context "with module configuration" do
+     before do
+      FullContact.configure do |config|
+        @keys.each do |key|
+          config.send("#{key}=", key)
+        end
+      end
+    end
+
+    after do
+      FullContact.reset
+    end
+
+    it "should inherit module configuration" do
+      api = FullContact::API.new
+      @keys.each do |key|
+        api.send(key).should == key
+      end
+    end
+
+    context "with class configuration" do
+
+      before do
+        @configuration = {
+          :access_token => '23234e23',
+          :account_key => 'account key',
+          :adapter => :typhoeus,
+          :api_key => 'api_key',
+          :endpoint => 'http://tumblr.com/',
+          :gateway => 'apigee-1111.apigee.com',
+          :get_request_url_only => false,
+          :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 = FullContact::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 = FullContact::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/fullcontact/client/contact_list_spec.rb

@@ -0,0 +1,89 @@
+require 'helper'
+require 'fullcontact'
+
+describe FullContact::Client::ContactList do
+
+  before do
+    FullContact.configure do |config|
+      config.api_key = "api_key"
+    end
+    @client = FullContact::Client.new
+  end
+
+  describe "#create_contact_list" do
+    before do
+      stub_post("contactLists.json").
+        with(:query => { :apiKey => "api_key" }).
+        to_return(:body => fixture("create_contact_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should send a post to contactLists" do
+      @client.create_contact_list
+      a_post("contactLists.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#delete_contact_list" do
+    before do
+      stub_delete("contactLists/12345.json").
+        with(:query => { :apiKey => "api_key"}).
+        to_return(:body => fixture("delete_contact_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "should send a delete to contactLists" do
+      @client.delete_contact_list("12345")
+      a_delete("contactLists/12345.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#get_contact_lists" do
+    before do
+      stub_get("contactLists.json").
+        with(:query => { :apiKey => "api_key"}).
+        to_return(:body => fixture("get_contact_lists.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "should get the list of contact lists" do
+      @client.get_contact_lists
+      a_get("contactLists.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#get_contacts_in_a_list" do
+    before do
+      stub_get("contactLists/12345.json").
+        with(:query => { :apiKey => "api_key"}).
+        to_return(:body => fixture("get_contacts_in_a_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "should get the contacts in a list" do
+      @client.get_contacts_in_a_list(12345)
+      a_get("contactLists/12345.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#queue_contact_list_for_enrichment" do
+    before do
+      stub_post("contactLists/12345/queue.json").
+        with(:query => { :apiKey => "api_key"}).
+        to_return(:body => fixture("queue_contact_list_for_enrichment.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "should queue the contact list for enrichment" do
+      @client.queue_contact_list_for_enrichment("12345")
+      a_post("contactLists/12345/queue.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#clear_contact_list" do
+    before do
+      stub_post("contactLists/12345/clear.json").
+        with(:query => { :apiKey => "api_key"}).
+        to_return(:body => fixture("clear_contact_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "should clear the contacts in a list" do
+      @client.clear_contact_list("12345")
+      a_post("contactLists/12345/clear.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+end

data/spec/fullcontact/client/contact_spec.rb

@@ -0,0 +1,108 @@
+require 'helper'
+require 'fullcontact'
+
+describe FullContact::Client::Contact do
+
+  before do
+    FullContact.configure do |config|
+      config.api_key = "api_key"
+    end
+    @client = FullContact::Client.new
+  end
+
+  # describe "#update_contact" do
+  #   before do
+  #     stub_post("contactLists/12345.json").
+  #       with(:query => { :apiKey => "api_key", :request_body => "", :content_type => "application/json") }, :headers => {'Accept'=>'application/json', 'Content-Length'=>'0', 'Content-Type'=>'application/json', 'User-Agent'=>'FullContact Ruby Gem'}).
+  #       to_return(:body => fixture("update_contact.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+  #   end
+  #   it "should send a post to contactLists" do
+  #     @client.update_contact("12345", {:contact_data => {}})
+  #     a_post("contactLists/12345.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+  #   end
+  # end
+
+  describe "#get_contact" do
+    before do
+      stub_get("contactLists/12345/54321.json").
+        with(:query => { :apiKey => "api_key" }).
+        to_return(:body => fixture("get_contact.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get the contact" do
+      @client.get_contact("12345", "54321")
+      a_get("contactLists/12345/54321.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#delete_contact" do
+    before do
+      stub_delete("contactLists/12345/54321.json").
+        with(:query => { :apiKey => "api_key" }).
+        to_return(:body => fixture("delete_contact.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should delete the contact" do
+      @client.delete_contact("12345", "54321")
+      a_delete("contactLists/12345/54321.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#has_enriched_updates?" do
+    before do
+      stub_get("contactLists/12345/54321/hasUpdates.json").
+        with(:query => { :apiKey => "api_key" }).
+        to_return(:body => fixture("has_enriched_updates.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should make a get to find whether or not there are enriched updates" do
+      @client.has_enriched_updates?("12345", "54321")
+      a_get("contactLists/12345/54321/hasUpdates.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#get_updates" do
+    before do
+      stub_get("contactLists/12345/54321/updates.json").
+        with(:query => { :apiKey => "api_key" }).
+        to_return(:body => fixture("get_updates.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get the latest updates" do
+      @client.get_updates("12345", "54321")
+      a_get("contactLists/12345/54321/updates.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#get_enriched_contact" do
+    before do
+      stub_get("contactLists/12345/54321/enriched.json").
+        with(:query => { :apiKey => "api_key" }).
+        to_return(:body => fixture("get_enriched_contact.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get the enriched contact" do
+      @client.get_enriched_contact("12345", "54321")
+      a_get("contactLists/12345/54321/enriched.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#save_enriched_contact" do
+    before do
+      stub_post("contactLists/12345/54321/enriched.json").
+        with(:query => { :apiKey => "api_key" }).
+        to_return(:body => fixture("save_enriched_contact.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should save the enriched contact" do
+      @client.save_enriched_contact("12345", "54321")
+      a_post("contactLists/12345/54321/enriched.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+
+  describe "#contact_history" do
+    before do
+      stub_get("contactLists/12345/54321/history.json").
+        with(:query => { :apiKey => "api_key" }).
+        to_return(:body => fixture("contact_history.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get the contact history" do
+      @client.contact_history("12345", "54321")
+      a_get("contactLists/12345/54321/history.json").with(:query => { :apiKey => "api_key" }).should have_been_made
+    end
+  end
+end

data/spec/fullcontact/client/icon_spec.rb

@@ -0,0 +1,24 @@
+require 'helper'
+require 'fullcontact'
+
+describe FullContact::Client::Name do
+
+  before do
+    FullContact.configure do |config|
+      config.api_key = "api_key"
+    end
+    @client = FullContact::Client.new
+  end
+
+  describe "#get_social_icon_url" do
+    before do
+      stub_get("icon/facebook/32/default").
+        with(:query => { :apiKey => "api_key"}).
+        to_return(:status => [302, "Moved Temporarily"])
+    end
+    it "should get an icon url with 302 redirect" do
+      @client.get_social_icon_url('facebook','32','default')
+      a_get("icon/facebook/32/default").with(:query => { :apiKey => "api_key"}).should have_been_made
+    end
+  end
+end

data/spec/fullcontact/client/name_spec.rb

@@ -0,0 +1,121 @@
+require 'helper'
+require 'fullcontact'
+
+describe FullContact::Client::Name do
+
+  before do
+    FullContact.configure do |config|
+      config.api_key = "api_key"
+    end
+    @client = FullContact::Client.new
+  end
+
+  describe "#normalize" do
+    before do
+      stub_get("name/normalizer.json").
+        with(:query => { :apiKey => "api_key", :q => "John Smith" }).
+        to_return(:body => fixture("normalize.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get normalized name" do
+      @client.normalize('John Smith')
+      a_get("name/normalizer.json").with(:query => { :apiKey => "api_key", :q => "John Smith" }).should have_been_made
+    end
+  end
+  
+  describe "#deduce_by_email" do
+    before do
+      stub_get("name/deducer.json").
+        with(:query => { :apiKey => "api_key", :email => "johnsmith@gmail.com" }).
+        to_return(:body => fixture("deduce_by_email.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get deduced name" do
+      @client.deduce_by_email('johnsmith@gmail.com')
+      a_get("name/deducer.json").with(:query => { :apiKey => "api_key", :email => "johnsmith@gmail.com" }).should have_been_made
+    end
+  end
+  
+  describe "#deduce_by_username" do
+    before do
+      stub_get("name/deducer.json").
+        with(:query => { :apiKey => "api_key", :username => "johnsmith" }).
+        to_return(:body => fixture("deduce_by_username.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get deduced name" do
+      @client.deduce_by_username('johnsmith')
+      a_get("name/deducer.json").with(:query => { :apiKey => "api_key", :username => "johnsmith" }).should have_been_made
+    end
+  end
+  
+  describe "#similarity" do
+    before do
+      stub_get("name/similarity.json").
+        with(:query => { :apiKey => "api_key", :q1 => "john", :q2 => "john smith" }).
+        to_return(:body => fixture("similarity.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get similarity" do
+      @client.similarity('john', 'john smith')
+      a_get("name/similarity.json").with(:query => { :apiKey => "api_key", :q1 => "john", :q2 => "john smith" }).should have_been_made
+    end
+  end
+  
+  describe "#stats_by_name" do
+    before do
+      stub_get("name/stats.json").
+        with(:query => { :apiKey => "api_key", :name => "john" }).
+        to_return(:body => fixture("stats_by_name.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get stats" do
+      @client.stats_by_name('john')
+      a_get("name/stats.json").with(:query => { :apiKey => "api_key", :name => "john" }).should have_been_made
+    end
+  end
+  
+  describe "#stats_by_given_name" do
+    before do
+      stub_get("name/stats.json").
+        with(:query => { :apiKey => "api_key", :givenName => "john" }).
+        to_return(:body => fixture("stats_by_given_name.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get stats" do
+      @client.stats_by_given_name('john')
+      a_get("name/stats.json").with(:query => { :apiKey => "api_key", :givenName => "john" }).should have_been_made
+    end
+  end
+  
+  describe "#stats_by_family_name" do
+    before do
+      stub_get("name/stats.json").
+        with(:query => { :apiKey => "api_key", :familyName => "smith" }).
+        to_return(:body => fixture("stats_by_family_name.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get stats" do
+      @client.stats_by_family_name('smith')
+      a_get("name/stats.json").with(:query => { :apiKey => "api_key", :familyName => "smith" }).should have_been_made
+    end
+  end
+  
+  describe "#stats_by_given_and_family_name" do
+    before do
+      stub_get("name/stats.json").
+        with(:query => { :apiKey => "api_key", :givenName => 'john', :familyName => "smith" }).
+        to_return(:body => fixture("stats_by_given_and_family_name.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get stats" do
+      @client.stats_by_given_and_family_name('john','smith')
+      a_get("name/stats.json").with(:query => { :apiKey => "api_key", :givenName => 'john', :familyName => "smith" }).should have_been_made
+    end
+  end
+  
+  describe "#parse" do
+    before do
+      stub_get("name/parser.json").
+        with(:query => { :apiKey => "api_key", :q => 'Smith John' }).
+        to_return(:body => fixture("parse.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "should get parsed name" do
+      @client.parse('Smith John')
+      a_get("name/parser.json").with(:query => { :apiKey => "api_key", :q => 'Smith John' }).should have_been_made
+    end
+  end
+  
+end