cl_linkedin 0.2.3

data/lib/linked_in/profile.rb

@@ -0,0 +1,94 @@
+module LinkedIn
+  class Profile < LinkedIn::Base
+
+    # xml_reader :three_current_positions, :as => [Position]
+
+    PROFILE_FIELDS = %w[id first_name last_name headline industry
+                        current_status current_status_timestamp summary
+                        specialties proposal_comments associations honors
+                        interests picture_url distance num_recommenders public_profile_url twitter_accounts im_accounts]
+
+    PROFILE_FIELDS.each do |f|
+      define_method(f.to_sym) do
+        @doc.xpath("./person/#{f.gsub(/_/,'-')}").text
+      end
+    end
+
+    def birthdate
+      @birthday ||= Birthdate.new(@doc.xpath('./person/date-of-birth'))
+    end
+
+    def location
+      @location ||= Location.new(@doc)
+    end
+
+    def api_standard_profile_request
+      @api_standard ||= ApiStandardProfileRequest.new(@doc.xpath('./person/api-standard-profile-request'))
+    end
+
+    def site_standard_profile_request
+      @doc.xpath('/person/site-standard-profile-request/url').text
+    end
+
+    def relation_to_viewer
+      @doc.xpath('//relation-to-viewer/distance').text
+    end
+
+    def member_url_resources
+      @url_resources ||= UrlResource.new(@doc.xpath('//member-url-resources')).resources
+    end
+
+    def positions
+      @positions ||= Position.new(@doc.xpath('//positions')).positions
+    end
+
+    def educations
+      @educations ||= Education.new(@doc.xpath('//educations')).educations
+    end
+
+    def connections
+      @connections ||= Connections.new(@doc.xpath('//connections')).connections
+    end
+
+    def groups
+      @groups ||= Group.new(@doc.xpath('//member-groups')).groups
+    end
+
+    def recommendations
+      @recommendations ||= Recommendations.new(@doc.xpath('//recommendations-received')).recommendations
+    end
+
+    def current_share
+      @current_share ||= CurrentShare.new(@doc.xpath('//current-share'))
+    end
+
+    def languages
+      @languages ||= Languages.new(@doc.xpath('//languages')).languages
+    end
+
+    def skills
+      @skills ||= Skill.new(@doc.xpath('//skills')).skills
+    end
+
+    def phone_numbers
+      @phone_number ||= PhoneNumber.new(@doc.xpath('//phone-numbers')).phone_numbers
+    end
+
+    def publications
+      @publications ||= Publications.new(@doc.xpath('//publications')).publications
+    end
+
+    def patents
+      @patents ||= Patents.new(@doc.xpath('//patents')).patents
+    end
+    
+    def twitter_accounts
+      @twitter_accounts ||= TwitterAccount.new(@doc.xpath('//twitter-accounts')).twitter_accounts
+    end
+    
+    def im_accounts
+      @im_accounts ||= ImAccount.new(@doc.xpath('//im-accounts')).im_accounts
+    end
+    
+  end
+end

data/lib/linked_in/publications.rb

@@ -0,0 +1,40 @@
+module LinkedIn
+  class Publications < LinkedIn::Base
+
+    def publications
+      @publications ||= @doc.children.inject([]) do |list, publication|
+        list << Resource.new(publication) unless publication.blank?
+        list
+      end
+    end
+
+    class Resource
+      def initialize(publication)
+        @publication = publication
+      end
+
+      %w[id title].each do |f|
+        define_method(f.to_sym) do
+          @publication.xpath("./#{f.gsub(/_/,'-')}").text
+        end
+      end
+
+      def year
+        @year ||= @publication.xpath("./date/year").text.to_i
+      end
+
+      def day
+        @day ||= @publication.xpath("./date/day").text.to_i
+      end
+
+      def month
+        @month ||= @publication.xpath("./date/month").text.to_i
+      end
+
+      def date
+        Date.civil(year, month, day)
+      end
+    end
+
+  end
+end

data/lib/linked_in/recipient.rb

@@ -0,0 +1,7 @@
+module LinkedIn
+  class Recipient
+
+    attr_accessor :person
+
+  end
+end

data/lib/linked_in/recipients.rb

@@ -0,0 +1,18 @@
+module LinkedIn
+  class Recipients
+
+    attr_accessor :recipients
+
+    def to_xml
+      self.to_xml_nodes(Nokogiri.XML('<root/>', nil, 'UTF-8')).to_xml
+    end
+    
+    def to_xml_nodes(doc)
+      recipients.inject(Nokogiri::XML::NodeSet.new(doc)) do |nodes, recipient|
+        node = Nokogiri::XML::DocumentFragment.new(doc, '<recipient><person/></recipient>')
+        node.at_css('person')['path'] = recipient.person.path
+        nodes << node
+      end
+    end
+  end
+end

data/lib/linked_in/recommendations.rb

@@ -0,0 +1,30 @@
+module LinkedIn
+
+  class Recommendations < LinkedIn::Base
+
+    def recommendations
+      @recommendations ||= @doc.children.inject([]) do |list, recommendation|
+        list << Recommendation.new(recommendation) unless recommendation.blank?
+        list
+      end
+    end
+
+    class Recommendation
+      def initialize(recommendation)
+        @recommendation = recommendation
+      end
+
+      %w[id recommendation_type recommendation_text].each do |f|
+        define_method(f.to_sym) do
+          @recommendation.xpath("./#{f.gsub(/_/,'-')}").text
+        end
+      end
+
+      def recommender
+        @recommender ||= ShortProfile.new(@recommendation.xpath('./recommender'))
+      end
+    end
+
+  end
+
+end

data/lib/linked_in/request_helpers.rb

@@ -0,0 +1,78 @@
+module LinkedIn
+
+  module RequestHelpers
+
+    def get(path, options={})
+      path = "/v1#{path}"
+      response = access_token.get(path, options)
+      raise_errors(response)
+      response.body
+    end
+
+    def post(path, body='', options={})
+      path = "/v1#{path}"
+      default_options = { 'Content-Type' => 'application/xml' }
+      response = access_token.post(path, body, default_options.merge(options))
+      raise_errors(response)
+      response
+    end
+
+    def put(path, body, options={})
+      path = "/v1#{path}"
+      response = access_token.put(path, body, options)
+      raise_errors(response)
+      response
+    end
+
+    def delete(path, options={})
+      path = "/v1#{path}"
+      response = access_token.delete(path, options)
+      raise_errors(response)
+      response
+    end
+
+    private
+
+      def raise_errors(response)
+        # Even if the XML answer contains the HTTP status code, LinkedIn also sets this code
+        # in the HTTP answer (thankfully).
+        if response.code.to_i >= 400
+          data = LinkedIn::Error.from_xml(response.body)
+          message = "(#{response.code}): #{data.message} - #{data.code}"
+
+          case response.code.to_i
+          when 400
+            raise BadRequest.new(data), message
+          when 401
+            raise Unauthorized.new(data), message
+          when 403
+            raise Forbidden.new(data), message
+          when 404
+            raise NotFound.new(data), message
+          when 500
+            raise InformLinkedIn, "LinkedIn had an internal error. Please let them know in the forum. #{message}"
+          when 502..503
+            raise Unavailable, message
+          end
+        end
+      end
+
+      def to_query(options)
+        query_string = options.inject([]) do |collection, opt|
+          collection << "#{opt[0]}=#{opt[1]}"
+          collection
+        end * '&'
+        URI.escape(query_string)
+      end
+
+      def to_uri(path, options)
+        uri = URI.parse(path)
+
+        if options && options != {}
+          uri.query = to_query(options)
+        end
+        uri.to_s
+      end
+  end
+
+end

data/lib/linked_in/short_profile.rb

@@ -0,0 +1,13 @@
+module LinkedIn
+
+  class ShortProfile < LinkedIn::Base
+
+    %w[id first_name last_name].each do |f|
+      define_method(f.to_sym) do
+        @doc.xpath("./#{f.gsub(/_/,'-')}").text
+      end
+    end
+
+  end
+
+end

data/lib/linked_in/skill.rb

@@ -0,0 +1,33 @@
+module LinkedIn
+  class Skill < LinkedIn::Base
+
+    def skills
+      @array ||= begin
+        @array = []
+        @doc.children.each do |skill|
+          @array << Resource.new(skill) unless skill.blank?
+        end
+        @array
+      end
+    end
+
+    class Resource
+
+      def initialize(skill)
+        @skill = skill
+      end
+
+      def name
+        @skill.xpath("./skill/name").text
+      end
+      
+      %w[id].each do |f| #proficiency level to come? http://developer.linkedin.com/community/apis/blog/2011/01/04/new-profile-fields-are-here
+        define_method(f.to_sym) do
+          @skill.xpath("./#{f.gsub(/_/,'-')}").text
+        end
+      end
+      
+    end # resource class
+
+  end # skill class
+end

data/lib/linked_in/to_xml_helpers.rb

@@ -0,0 +1,53 @@
+module LinkedIn
+  module ToXmlHelpers
+
+    private
+
+    def status_to_xml(status)
+      doc = Nokogiri.XML('<current-status/>', nil, 'UTF-8')
+      doc.root.content = status
+      doc.to_xml
+    end
+
+    def message_to_xml(message)
+      doc = Nokogiri.XML('')
+      doc.encoding = 'UTF-8'
+      doc.root = message.to_xml_node(doc)
+      doc.to_xml
+    end
+
+    def share_to_xml(options={})
+      doc = Nokogiri.XML('<share><comment/><content><title/><submitted-url/><submitted-image-url/></content><visibility><code/></visibility></share>')
+      doc.encoding = 'UTF-8'
+
+      {:comment => 'comment', :title => 'title', :url => 'submitted-url', :image_url => 'submitted-image-url'}.each do |key, name|
+        doc.at_css(name).content = options[key] if options[key]
+      end
+
+      doc.at_css('visibility > code').content = options[:visibility] || options[:visability] # backward-compatible typo fix
+      doc.to_xml
+    end
+
+    def comment_to_xml(comment)
+      doc = Nokogiri.XML('<update-comment><comment/><update-comment/>')
+      doc.encoding = 'UTF-8'
+      doc.at_css('comment').content = comment
+      doc.to_xml
+    end
+
+    def is_liked_to_xml(is_liked)
+      doc = Nokogiri.XML('<is-liked/>')
+      doc.encoding = 'UTF-8'
+      doc.at_css('is-liked').content = is_liked
+      doc.to_xml
+    end
+
+    def network_update_to_xml(message)
+      doc = Nokogiri::XML('<activity locale="en_US"><content-type>linkedin-html</content-type><body/></activity>')
+      doc.encoding = 'UTF-8'
+      doc.at_css('body').content = message
+      doc.to_xml
+    end
+
+  end
+end

data/lib/linked_in/twitter_account.rb

@@ -0,0 +1,28 @@
+module LinkedIn
+  class TwitterAccount < LinkedIn::Base
+
+    def twitter_accounts
+      @twitter_accounts ||= @doc.children.inject([]) do |list, twitter_account|
+        list << Resource.new(twitter_account) unless twitter_account.blank?
+        list
+      end
+    end
+
+    class Resource
+
+      def initialize(twitter_account)
+        @twitter_account = twitter_account
+      end
+
+      def name
+        @twitter_account.xpath("./provider-account-name").text
+      end
+      
+      def id
+        @twitter_account.xpath("./provider-account-id").text
+      end
+      
+    end # resource class
+
+  end # skill class
+end

data/lib/linked_in/update.rb

@@ -0,0 +1,23 @@
+module LinkedIn
+  class Update < LinkedIn::Base
+
+    %w[update_key update_type is_commentable?].each do |f|
+      define_method(f.to_sym) do
+        @doc.xpath("./update/#{f.gsub(/_/,'-').gsub(/\?$/,"")}").text
+      end
+    end
+
+    def timestamp
+      @doc.xpath('./update/timestamp').text.to_i
+    end
+
+    def profile
+      Profile.new(Nokogiri::XML(@doc.xpath('./update/update-content/person').to_xml))
+    end
+
+    def likes
+      Likes.new(Nokogiri::XML(@doc.xpath('./update/likes').to_xml)).likes
+    end
+
+  end
+end

data/lib/linked_in/url_resource.rb

@@ -0,0 +1,26 @@
+module LinkedIn
+  class UrlResource < LinkedIn::Base
+
+    def resources
+      @resources ||= @doc.children.inject([]) do |list, url|
+        list << Resource.new(url) unless url.blank?
+        list
+      end
+    end
+
+    class Resource
+
+      def initialize(member_url)
+        @member_url = member_url
+      end
+
+      %w[url name].each do |f|
+        define_method(f.to_sym) do
+          @member_url.xpath("./#{f.gsub(/_/,'-')}").text
+        end
+      end
+
+    end # resource class
+
+  end
+end