im_contacts 1.2.7

data/test/example_accounts.yml

@@ -0,0 +1,101 @@
+gmail:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+yahoo:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+hotmail:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+aol:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+
+wy163:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+wy126:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+yeah:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+sina_cn:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+sina_com:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"
+sohu:
+  username: <changeme>
+  password: <changeme>
+  contacts:
+    -
+      name: "FirstName1 LastName1"
+      email_address: "firstname1@example.com"
+    -
+      name: "FirstName2 LastName2"
+      email_address: "firstname2@example.com"

data/test/test_helper.rb

@@ -0,0 +1,31 @@
+dir = File.dirname(__FILE__)
+$LOAD_PATH.unshift(dir + "/../lib/")
+require 'test/unit'
+require 'im_contacts'
+require 'yaml'
+
+class ContactImporterTestCase < Test::Unit::TestCase
+  # Add more helper methods to be used by all tests here...
+  def default_test
+    assert true
+  end
+end
+
+class TestAccounts
+  def self.[](type)
+    load[type]
+  end
+
+  def self.load(file = File.dirname(__FILE__) + "/example_accounts.yml")
+    raise "/test/accounts.yml file not found, please create, see /test/example_accounts.yml for information" unless File.exist?(file)
+
+    accounts = {}
+    YAML::load(File.open(file)).each do |type, contents|
+      contacts = contents["contacts"].collect {|contact| [contact["name"], contact["email_address"]]}
+      accounts[type.to_sym] = Account.new(type.to_sym, contents["username"], contents["password"], contacts)
+    end
+    accounts
+  end
+
+  Account = Struct.new :type, :username, :password, :contacts
+end

data/test/test_suite.rb

@@ -0,0 +1,4 @@
+dir = File.dirname(__FILE__)
+Dir["#{dir}/**/*_test.rb"].each do |file|
+  require file
+end

data/test/unit/aol_contact_importer_test.rb

@@ -0,0 +1,39 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/../test_helper"
+require 'contacts'
+
+class AolContactImporterTest < ContactImporterTestCase
+  def setup
+    super
+    @account = TestAccounts[:aol]
+  end
+
+  def test_successful_login
+    Contacts.new(:aol, @account.username, @account.password)
+  end
+
+  def test_importer_fails_with_invalid_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:aol, @account.username, "wrong_password")
+    end
+  end
+
+  def test_importer_fails_with_blank_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:aol, @account.username, "")
+    end
+  end
+
+  def test_importer_fails_with_blank_username
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:aol, "", @account.password)
+    end
+  end
+
+  def test_fetch_contacts
+    contacts = Contacts.new(:aol, @account.username, @account.password).contacts
+    @account.contacts.each do |contact|
+      assert contacts.include?(contact), "Could not find: #{contact.inspect} in #{contacts.inspect}"
+    end
+  end
+end

data/test/unit/gmail_contact_importer_test.rb

@@ -0,0 +1,39 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/../test_helper"
+require 'contacts'
+
+class GmailContactImporterTest < ContactImporterTestCase
+  def setup
+    super
+    @account = TestAccounts[:gmail]
+  end
+
+  def test_successful_login
+    Contacts.new(:gmail, @account.username, @account.password)
+  end
+
+  def test_importer_fails_with_invalid_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:gmail, @account.username, "wrong_password")
+    end
+  end
+
+  def test_importer_fails_with_blank_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:gmail, @account.username, "")
+    end
+  end
+
+  def test_importer_fails_with_blank_username
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:gmail, "", @account.password)
+    end
+  end
+
+  def test_fetch_contacts
+    contacts = Contacts.new(:gmail, @account.username, @account.password).contacts
+    @account.contacts.each do |contact|
+      assert contacts.include?(contact), "Could not find: #{contact.inspect} in #{contacts.inspect}"
+    end
+  end
+end

data/test/unit/hotmail_contact_importer_test.rb

@@ -0,0 +1,41 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/../test_helper"
+require 'contacts'
+
+class HotmailContactImporterTest < ContactImporterTestCase
+  def setup
+    super
+    @account = TestAccounts[:hotmail]
+  end
+
+  def test_successful_login
+    Contacts.new(:hotmail, @account.username, @account.password)
+  end
+
+  def test_importer_fails_with_invalid_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:hotmail, @account.username,"wrong_password")
+    end
+  end
+
+  def test_fetch_contacts
+    contacts = Contacts.new(:hotmail, @account.username, @account.password).contacts
+    @account.contacts.each do |contact|
+      assert contacts.include?(contact), "Could not find: #{contact.inspect} in #{contacts.inspect}"
+    end
+  end
+  
+  def test_importer_fails_with_invalid_msn_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:hotmail, "test@msn.com","wrong_password")
+    end
+  end
+  
+  # Since the hotmail scraper doesn't read names, test email
+  def test_fetch_email
+    contacts = Contacts.new(:hotmail, @account.username, @account.password).contacts
+    @account.contacts.each do |contact|
+      assert contacts.any?{|book_contact| book_contact.last == contact.last }, "Could not find: #{contact.inspect} in #{contacts.inspect}"
+    end
+  end
+end

data/test/unit/net_ease_contact_importer_test.rb

@@ -0,0 +1,60 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/../test_helper"
+require 'contacts'
+class NetEaseContactImporterTest < ContactImporterTestCase
+  def setup
+    super
+    @wy163 = TestAccounts[:wy163]
+    @wy126 = TestAccounts[:wy126]
+    @yeah = TestAccounts[:yeah]
+    @accounts = [@wy163,@wy126,@yeah]
+  end
+
+  def test_successful_login
+    @accounts.each do |account|
+      Contacts.new(:net_ease, account.username, account.password)
+    end
+  end
+
+  def test_importer_fails_with_invalid_password
+    @accounts.each do |account|
+      assert_raise(Contacts::AuthenticationError) do
+        Contacts.new(:net_ease, account.username, "wrong_password")
+      end
+    end
+  end
+
+  def test_importer_fails_with_blank_password
+    @accounts.each do |account|
+      assert_raise(Contacts::AuthenticationError) do
+        Contacts.new(:net_ease, account.username, "")
+      end
+    end
+  end
+
+  def test_importer_fails_with_blank_username
+    @accounts.each do |account|
+      assert_raise(Contacts::MailServerError) do
+        Contacts.new(:net_ease, "", account.password)
+      end
+    end
+  end
+
+  def test_importer_fails_with_invalid_username
+    @accounts.each do |account|
+      assert_raise(Contacts::MailServerError) do
+        Contacts.new(:net_ease, "error_username", account.password)
+      end
+    end
+  end
+
+  def test_fetch_contacts
+    @accounts.each do |account|
+      contacts = Contacts.new(:net_ease, account.username, account.password).contacts
+      account.contacts.each do |contact|
+        assert contacts.include?(contact), "Could not find: #{contact.inspect} in #{contacts.inspect}"
+      end
+    end
+  end
+
+end

data/test/unit/sina_contact_importer_test.rb

@@ -0,0 +1,59 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/../test_helper"
+require 'contacts'
+class SinaContactImporterTest < ContactImporterTestCase
+  def setup
+    super
+    @sina_cn = TestAccounts[:sina_cn]
+    @sina_com = TestAccounts[:sina_com]
+    @accounts = [@sina_cn,@sina_com]
+  end
+
+  def test_successful_login
+    @accounts.each do |account|
+      Contacts.new(:sina, account.username, account.password)
+    end
+  end
+
+  def test_importer_fails_with_invalid_password
+    @accounts.each do |account|
+      assert_raise(Contacts::AuthenticationError) do
+        Contacts.new(:sina, account.username, "wrong_password")
+      end
+    end
+  end
+
+  def test_importer_fails_with_blank_password
+    @accounts.each do |account|
+      assert_raise(Contacts::AuthenticationError) do
+        Contacts.new(:sina, account.username, "")
+      end
+    end
+  end
+
+  def test_importer_fails_with_blank_username
+    @accounts.each do |account|
+      assert_raise(Contacts::MailServerError) do
+        Contacts.new(:sina, "", account.password)
+      end
+    end
+  end
+
+  def test_importer_fails_with_invalid_username
+    @accounts.each do |account|
+      assert_raise(Contacts::MailServerError) do
+        Contacts.new(:sina, "error_username", account.password)
+      end
+    end
+  end
+
+  def test_fetch_contacts
+    @accounts.each do |account|
+      contacts = Contacts.new(:sina, account.username, account.password).contacts
+      account.contacts.each do |contact|
+        assert contacts.include?(contact), "Could not find: #{contact.inspect} in #{contacts.inspect}"
+      end
+    end
+  end
+
+end

data/test/unit/sohu_contact_importer_test.rb

@@ -0,0 +1,39 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/../test_helper"
+require 'contacts'
+
+class SohuContactImporterTest < ContactImporterTestCase
+  def setup
+    super
+    @account = TestAccounts[:sohu]
+  end
+
+  def test_successful_login
+    Contacts.new(:sohu, @account.username, @account.password)
+  end
+
+  def test_importer_fails_with_invalid_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:sohu, @account.username, "wrong_password")
+    end
+  end
+
+  def test_importer_fails_with_blank_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:sohu, @account.username, "")
+    end
+  end
+
+  def test_importer_fails_with_blank_username
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:sohu, "", @account.password)
+    end
+  end
+
+  def test_fetch_contacts
+    contacts = Contacts.new(:sohu, @account.username, @account.password).contacts
+    @account.contacts.each do |contact|
+      assert contacts.include?(contact), "Could not find: #{contact.inspect} in #{contacts.inspect}"
+    end
+  end
+end

data/test/unit/test_accounts_test.rb

@@ -0,0 +1,23 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/../test_helper"
+
+class TestAccountsTest < ContactImporterTestCase
+  def test_test_accounts_loads_data_from_example_accounts_file
+    account = TestAccounts.load(File.dirname(__FILE__) + "/../example_accounts.yml")[:gmail]
+    
+    assert_equal :gmail, account.type
+    assert_equal "<changeme>", account.username
+    assert_equal "<changeme>", account.password
+    assert_equal [["FirstName1 LastName1", "firstname1@example.com"], ["FirstName2 LastName2", "firstname2@example.com"]], account.contacts
+  end
+  
+  def test_test_accounts_blows_up_if_file_doesnt_exist
+    assert_raise(RuntimeError) do
+      TestAccounts.load("file_that_does_not_exist.yml")
+    end
+  end
+  
+  def test_we_can_load_from_account_file
+    assert_not_nil TestAccounts[:gmail].username
+  end
+end

data/test/unit/yahoo_csv_contact_importer_test.rb

@@ -0,0 +1,35 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/../test_helper"
+require 'contacts'
+
+class YahooContactImporterTest < ContactImporterTestCase
+  def setup
+    super
+    @account = TestAccounts[:yahoo]
+  end
+
+  def test_a_successful_login
+    Contacts.new(:yahoo, @account.username, @account.password)
+  end
+
+  def test_importer_fails_with_invalid_password
+    assert_raise(Contacts::AuthenticationError) do
+      Contacts.new(:yahoo, @account.username, "wrong_password")
+    end
+    # run the "successful" login test to ensure we reset yahoo's failed login lockout counter
+    # See http://www.pivotaltracker.com/story/show/138210
+    # yahoo needs some time to unset the failed login state, apparently... 
+    # ...1 sec and 5 secs still failed sporadically
+    sleep 10
+    assert_nothing_raised do
+      Contacts.new(:yahoo, @account.username, @account.password)
+    end
+  end
+
+  def test_a_fetch_contacts
+    contacts = Contacts.new(:yahoo, @account.username, @account.password).contacts
+    @account.contacts.each do |contact|
+      assert contacts.include?(contact), "Could not find: #{contact.inspect} in #{contacts.inspect}"
+    end
+  end
+end

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification 
+name: im_contacts
+version: !ruby/object:Gem::Version 
+  hash: 17
+  prerelease: 
+  segments: 
+  - 1
+  - 2
+  - 7
+  version: 1.2.7
+platform: ruby
+authors: 
+- Mike Liang
+autorequire: contacts
+bindir: bin
+cert_chain: []
+
+date: 2011-11-30 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 0
+        - 4
+        - 1
+        version: 0.4.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: gdata19
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 103
+        segments: 
+        - 0
+        - 1
+        - 9
+        - 2
+        version: 0.1.9.2
+  type: :runtime
+  version_requirements: *id002
+description: "   A universal interface to grab contact list information from various providers including Yahoo, AOL, Gmail, Hotmail, 126, 163, Yeah, Sohu, Sina and Plaxo.It is extended from contacts gem.\n"
+email: 
+- liangwenke.com@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/contacts/aol.rb
+- lib/contacts/base.rb
+- lib/contacts/gmail.rb
+- lib/contacts/hash_ext.rb
+- lib/contacts/hotmail.rb
+- lib/contacts/json_picker.rb
+- lib/contacts/net_ease.rb
+- lib/contacts/plaxo.rb
+- lib/contacts/sina.rb
+- lib/contacts/sohu.rb
+- lib/contacts/yahoo.rb
+- lib/im_contacts.rb
+- test/example_accounts.yml
+- test/test_helper.rb
+- test/test_suite.rb
+- test/unit/aol_contact_importer_test.rb
+- test/unit/gmail_contact_importer_test.rb
+- test/unit/hotmail_contact_importer_test.rb
+- test/unit/net_ease_contact_importer_test.rb
+- test/unit/sina_contact_importer_test.rb
+- test/unit/sohu_contact_importer_test.rb
+- test/unit/test_accounts_test.rb
+- test/unit/yahoo_csv_contact_importer_test.rb
+- LICENSE
+- Rakefile
+- README
+- examples/grab_contacts.rb
+homepage: http://github.com/liangwenke/im_contacts
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- A json parser, the gdata ruby gem
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A universal interface to grab contact list information from various providers including Yahoo, AOL, Gmail, Hotmail, 126, 163, Yeah, Sohu, Sina and Plaxo.It is extended from contacts gem.
+test_files: []
+