contact-list 0.2.0

data/lib/contact_list.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+
+require 'active_support/core_ext/hash/slice'
+require 'active_support/core_ext/class/inheritable_attributes'
+require 'active_support/core_ext/module/delegation'
+require 'active_support/core_ext/object/blank'
+require 'active_support/inflector'
+
+class Hash
+  alias_method :only,  :slice
+  alias_method :only!, :slice!
+end
+require File.expand_path('../contacts', __FILE__)

data/lib/contacts/contact/facebook.rb

@@ -0,0 +1,11 @@
+class Contacts::Contact::Facebook < Struct.new(:uid, :name)
+  
+  def self.parse hash
+    new hash['id'], hash['name']
+  end
+  
+  def image_url
+    "http://graph.facebook.com/#{uid}/picture"
+  end
+  
+end

data/lib/contacts/contact/google.rb

@@ -0,0 +1,11 @@
+class Contacts::Contact::Google < Struct.new(:email, :name)
+
+  def self.parse xml
+    name = xml.css("title").text
+    email_node = xml.xpath("gd:email").first
+    return nil unless email_node.present?
+    email = email_node['address'] 
+    new(email, name)
+  end
+  
+end

data/lib/contacts/contact/linkedin.rb

@@ -0,0 +1,7 @@
+class Contacts::Contact::Linkedin < Struct.new(:uid, :name, :first_name, :last_name, :image_url)
+  
+  def self.parse hash
+    new hash['id'], "#{hash['firstName']} #{hash['lastName']}", hash['firstName'], hash['lastName'], hash['pictureUrl']
+  end
+  
+end

data/lib/contacts/contact/twitter.rb

@@ -0,0 +1,7 @@
+class Contacts::Contact::Twitter < Struct.new(:uid, :screen_name, :name, :image_url)
+  
+  def self.parse hash
+    new hash['id'].to_s, hash['screen_name'], hash['name'], hash['profile_image_url']
+  end
+  
+end

data/lib/contacts/contact/yahoo.rb

@@ -0,0 +1,17 @@
+class Contacts::Contact::Yahoo < Struct.new(:email, :name)
+
+  def self.parse hash
+    email, name = '', nil
+    hash['fields'].each do |field|
+      case field['type']
+      when 'email'
+        email = field['value']
+      when 'name'
+        name = [field['value']['givenName'], field['value']['familyName']].join(' ') rescue ''
+      end
+    end
+    name ||= email
+    new(email, name) unless email.blank?
+  end
+  
+end

data/lib/contacts/contact.rb

@@ -0,0 +1,9 @@
+module Contacts
+  module Contact
+    autoload :Google,   'contacts/contact/google'
+    autoload :Yahoo,    'contacts/contact/yahoo'
+    autoload :Facebook, 'contacts/contact/facebook'
+    autoload :Twitter,  'contacts/contact/twitter'
+    autoload :Linkedin, 'contacts/contact/linkedin'
+  end
+end

data/lib/contacts/provider/base.rb

@@ -0,0 +1,73 @@
+module Contacts
+  module Provider
+    class Base
+      
+      class_inheritable_accessor :site_url
+      self.site_url = nil
+      delegate :site_url, :to => "self.class"
+
+      class_inheritable_accessor :valid_attributes
+      self.valid_attributes = []          
+      delegate :import_type, :valid_attributes, :to => "self.class"
+
+      def self.set_site_url url
+        self.site_url = url
+      end
+
+      def self.set_valid_attributes *attrs
+        self.valid_attributes = attrs.map!(&:to_sym)
+        attr_accessor *attrs
+      end
+
+      def self.provider_id
+        self.name.demodulize.underscore
+      end
+      
+      def self.all attrs={}
+        new(attrs).contacts
+      end
+      
+      def initialize attrs={}
+        parse_attributes attrs
+      end
+
+      def connect!
+        raise "implement in subclass"
+      end
+
+      def connection
+        @connection ||= connect!
+      end
+
+      def retrieve_contacts!
+        raise "implement in subclass"
+      end
+      
+      def contacts_response
+        @contacts_response ||= retrieve_contacts!
+      end
+
+      def parse_contacts!
+        raise "implement in subclass"    
+      end
+      
+      def contacts
+        @contacts ||= parse_contacts!
+      end
+
+      def parse_attributes attrs = {}
+        self.attributes = attrs.only(*valid_attributes)   
+      end
+
+      def attributes= attrs = {}
+        attrs.each do |attr_name, attr_value|
+          send("#{attr_name}=", attr_value)
+        end
+      end
+
+      def attributes
+        valid_attributes.inject({}) {|result, attr| result.merge attr => send(attr) }
+      end
+    end
+  end      
+end

data/lib/contacts/provider/facebook.rb

@@ -0,0 +1,13 @@
+require 'multi_json'
+class Contacts::Provider::Facebook < Contacts::Provider::OAuth2
+  set_site_url 'https://graph.facebook.com'
+  
+  def retrieve_contacts!
+    @contacts_response = connection.get("/me/friends")
+  end
+  
+  def parse_contacts!
+    @contacts = MultiJson.decode(contacts_response)['data'].map { |contact| Contacts::Contact::Facebook.parse(contact) }.compact
+  end
+   
+end 

data/lib/contacts/provider/google.rb

@@ -0,0 +1,18 @@
+require 'nokogiri'
+
+class Contacts::Provider::Google < Contacts::Provider::OAuth
+  set_site_url 'https://www.google.com'
+  
+  def retrieve_contacts!
+    @contacts_response = connection.get("/m8/feeds/contacts/#{uid||'default'}/full?max-results=999")
+  end
+  
+  def parse_contacts!
+    if contacts_response.code.to_i == 401
+      raise "Error 401".inspect
+    else
+      @contacts = Nokogiri::XML(contacts_response.body).css("entry").map {|entry| Contacts::Contact::Google.parse(entry)}.compact 
+    end
+  end
+
+end

data/lib/contacts/provider/linkedin.rb

@@ -0,0 +1,13 @@
+require 'multi_json'
+class Contacts::Provider::Linkedin < Contacts::Provider::OAuth
+  set_site_url 'http://api.linkedin.com'
+  
+  def retrieve_contacts!
+    @connections_response = connection.get("/v1/people/~/connections:(first-name,last-name,id,headline,picture-url)")
+  end
+
+  def parse_contacts!
+    MultiJson.decode(contacts_response.body)['values'].map { |contact| Contacts::Contact::Linkedin.parse(contact) }.compact
+  end
+  
+end

data/lib/contacts/provider/oauth.rb

@@ -0,0 +1,18 @@
+require 'oauth'
+
+module Contacts
+  module Provider
+    class OAuth < Contacts::Provider::Base
+      set_valid_attributes :token, :secret, :consumer_key, :consumer_secret, :uid
+      
+      def consumer
+        @consumer ||= ::OAuth::Consumer.new(consumer_key, consumer_secret, :site => site_url)
+      end
+      
+      def connect!
+        ::OAuth::AccessToken.new(consumer, token, secret)
+      end
+      
+    end
+  end      
+end

data/lib/contacts/provider/oauth2.rb

@@ -0,0 +1,18 @@
+require 'oauth2'
+
+module Contacts
+  module Provider
+    class OAuth2 < Contacts::Provider::Base
+      set_valid_attributes :token, :consumer_key, :consumer_secret
+      
+      def client
+        @client ||= ::OAuth2::Client.new(consumer_key, consumer_secret, :site => site_url)
+      end
+      
+      def connect!
+        ::OAuth2::AccessToken.new(client, token)
+      end
+      
+    end
+  end      
+end

data/lib/contacts/provider/twitter.rb

@@ -0,0 +1,33 @@
+require 'multi_json'
+class Contacts::Provider::Twitter < Contacts::Provider::OAuth
+  set_site_url 'http://api.twitter.com'
+  
+  def retrieve_contacts!
+    {:followers_response => followers_response, :following_response => following_response}
+  end
+
+  def parse_contacts!
+    followers & following
+  end
+  
+  def followers_response
+    @followers_response ||= connection.get("/1/statuses/followers.json")
+  end
+
+  def following_response
+    @following_response ||= connection.get("/1/statuses/friends.json")
+  end
+
+  def followers
+    @followers ||= parse_response!(followers_response)
+  end
+  
+  def following
+    @following ||= parse_response!(following_response)
+  end
+  
+  def parse_response! response
+    MultiJson.decode(response.body).map { |contact| Contacts::Contact::Twitter.parse(contact) }.compact
+  end
+  
+end

data/lib/contacts/provider/yahoo.rb

@@ -0,0 +1,13 @@
+require 'multi_json'
+class Contacts::Provider::Yahoo < Contacts::Provider::OAuth
+  set_site_url 'http://social.yahooapis.com'
+  
+  def retrieve_contacts!
+    @contacts_response = connection.get("/v1/user/me/contacts?format=json")
+  end
+  
+  def parse_contacts!
+    @contacts = ((MultiJson.decode(contacts_response.body)['contacts']||{})['contact']||[]).map { |contact| Contacts::Contact::Yahoo.parse(contact) }.compact
+  end
+
+end

data/lib/contacts/provider.rb

@@ -0,0 +1,21 @@
+module Contacts
+  module Provider
+    autoload :Base,     'contacts/provider/base'
+    autoload :OAuth,    'contacts/provider/oauth'
+    autoload :Google,   'contacts/provider/google'
+    autoload :Yahoo,    'contacts/provider/yahoo'
+    autoload :Twitter,  'contacts/provider/twitter'
+    autoload :OAuth2,   'contacts/provider/oauth2'
+    autoload :Facebook, 'contacts/provider/facebook'
+    autoload :Linkedin, 'contacts/provider/linkedin'
+    
+    def self.all
+      [Google, Yahoo, Twitter, Facebook, Linkedin]
+    end
+    
+    def self.find provider_id
+      all.find { |provider| provider.provider_id == provider_id.to_s }
+    end
+    
+  end
+end

data/lib/contacts.rb

@@ -0,0 +1,14 @@
+module Contacts
+  autoload :Provider, 'contacts/provider'
+  autoload :Contact,  'contacts/contact'
+  
+  def self.[] provider_id
+    Provider.find(provider_id.to_s) || error_with!(provider_id)
+  end
+
+  private
+
+  def self.error_with! provider_id
+    raise("Invalid provider_id #{provider_id.to_s.inspect}, available provider_id; #{Provider.all.map(&:provider_id).join(', ')}")
+  end
+end

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: contact-list
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+  prerelease: 
+platform: ruby
+authors:
+- Alex Neill
+- Tom Warner
+- Paul Bowsher
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: contact-list
+  requirement: &70198657387760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70198657387760
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70198657387140 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: *70198657387140
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70198657386660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: *70198657386660
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70198657386040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: *70198657386040
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70198657385400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: *70198657385400
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: &70198657384880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70198657384880
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: &70198657384340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: *70198657384340
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &70198657383640 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70198657383640
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: &70198657383040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.5
+  type: :runtime
+  prerelease: false
+  version_requirements: *70198657383040
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: &70198657382440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70198657382440
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70198657381900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: *70198657381900
+description: Find contacts from multiple providers
+email:
+- alex@rawnet.com
+- tom@rawnet.com
+- paul.bowsher@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README
+files:
+- lib/contact_list.rb
+- lib/contacts.rb
+- lib/contacts/contact.rb
+- lib/contacts/contact/facebook.rb
+- lib/contacts/contact/google.rb
+- lib/contacts/contact/linkedin.rb
+- lib/contacts/contact/twitter.rb
+- lib/contacts/contact/yahoo.rb
+- lib/contacts/provider.rb
+- lib/contacts/provider/base.rb
+- lib/contacts/provider/facebook.rb
+- lib/contacts/provider/google.rb
+- lib/contacts/provider/linkedin.rb
+- lib/contacts/provider/oauth.rb
+- lib/contacts/provider/oauth2.rb
+- lib/contacts/provider/twitter.rb
+- lib/contacts/provider/yahoo.rb
+- README
+homepage: 
+licenses: []
+post_install_message: 
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Find contacts from multiple providers
+test_files: []