linkedin 0.1.7 → 0.2.1

data/lib/linked_in/position.rb

@@ -1,15 +1,46 @@
 module LinkedIn
-  class Position
-    include ROXML
-    xml_convention {|val| val.gsub("_","-") }
-    xml_reader :id
-    xml_reader :title
-    xml_reader :summary
-    xml_reader :start_year, :from => "start-date/year", :as => Integer
-    xml_reader :start_month, :from => "start-date/month", :as => Integer
-    xml_reader :end_year, :from => "end-date/year", :as => Integer
-    xml_reader :end_month, :from => "end-date/month", :as => Integer
-    xml_reader :is_current
-    xml_reader :company, :as => Company
-  end
-end
+  class Position < LinkedIn::Base
+
+    def positions
+      @positions ||= @doc.children.inject([]) do |list, position|
+        list << Resource.new(position) unless position.blank?
+        list
+      end
+    end
+
+    class Resource
+
+      def initialize(position)
+        @position = position
+      end
+
+      %w[id title summary is_current].each do |f|
+        define_method(f.to_sym) do
+          @position.xpath("./#{f.gsub(/_/,'-')}").text
+        end
+      end
+
+      def start_month
+        @position.xpath('./start-date/month').text.to_i
+      end
+
+      def start_year
+        @position.xpath('./start-date/year').text.to_i
+      end
+
+      def end_month
+        @position.xpath('./end-date/month').text.to_i
+      end
+
+      def end_year
+        @position.xpath('./end-date/year').text.to_i
+      end
+
+      def company
+        @company ||= Company.new(@position.xpath('./company'))
+      end
+
+    end # resource
+
+  end # class
+end # module

data/lib/linked_in/profile.rb

@@ -1,32 +1,85 @@
 module LinkedIn
-  class Profile
-    include ROXML
-    xml_convention {|val| val.gsub("_","-") }
-    xml_reader :id
-    xml_reader :first_name
-    xml_reader :last_name
-    xml_reader :headline
-    xml_reader :location, :as => Location
-    xml_reader :industry
-    xml_reader :distance, :as => Integer
-    xml_reader :relation_to_viewer, :as => {:key => :name, :value => :content}
-    xml_reader :num_recommenders, :as => Integer
-    xml_reader :current_status
-    xml_reader :current_status_timestamp
-    xml_reader :connections, :as => [Profile], :from => "connections/person"
-    xml_reader :summary
-    xml_reader :specialties
-    xml_reader :proposal_comments
-    xml_reader :associations
-    xml_reader :honors
-    xml_reader :interests
-    xml_reader :positions, :as => [Position]
-    xml_reader :education, :as => [Education]
-    xml_reader :three_current_positions, :as => [Position]
-    xml_reader :member_url_resources, :as => [UrlResource], :from => 'member-url-resources/member-url'
-    xml_reader :api_standard_profile_request
-    xml_reader :site_standard_profile_request, :as => ApiStandardProfileRequest
-    xml_reader :picture_url
+  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]
+
+    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('//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
   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,76 @@
+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).
+        case response.code.to_i
+        when 400
+          data = LinkedIn::Error.from_xml(response.body)
+          raise RateLimitExceeded.new(data), "(#{response.code}): #{response.message} - #{data.code if data}"
+        when 401
+          data = LinkedIn::Error.from_xml(response.body)
+          raise Unauthorized.new(data), "(#{response.code}): #{response.message} - #{data.code if data}"
+        when 403
+          data = LinkedIn::Error.from_xml(response.body)
+          raise General.new(data), "(#{response.code}): #{response.message} - #{data.code if data}"
+        when 404
+          raise NotFound, "(#{response.code}): #{response.message}"
+        when 500
+          raise InformLinkedIn, "LinkedIn had an internal error. Please let them know in the forum. (#{response.code}): #{response.message}"
+        when 502..503
+          raise Unavailable, "(#{response.code}): #{response.message}"
+        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