career_builder 0.1.0

data/lib/career_builder/api/resume.rb

@@ -0,0 +1,67 @@
+module CareerBuilder
+
+  module API
+
+    class Resume
+
+      # Sample response:
+      # http://ws.careerbuilder.com/resumes/resumes.asmx/V2_GetResume_SampleResponse
+
+      include HappyMapper
+
+      tag 'Packet'
+
+      # element :home_location, String, :tag => "HomeLocation"
+      # element :last_update, Date, :tag => "LastUpdate"
+      # element :title, String, :tag => "ResumeTitle"
+      # element :job_title, String, :tag => "JobTitle"
+      # element :recent_employer, String, :tag => "RecentEmployer"
+      # element :recent_job_title, String, :tag => "RecentJobTitle"
+      # element :recent_pay, String, :tag => "RecentPay"
+      # element :user_did, String, :tag => "UserDID"
+      # element :contact_email_md5, String, :tag => "ContactEmailMD5"
+
+      has_one :home_location, Location, :tag => "HomeLocation"
+      has_many :relocations, Location, :tag => "ExtLocation"
+
+      has_one :most_recent_pay, Pay, :tag => "MostRecentPay"
+      has_one :desired_pay, Pay, :tag => "DesiredPay"
+
+      has_many :interests, Interest, :tag => "ExtInterest"
+      has_many :companies, Company, :tag => "ExtCompany"
+      has_many :schools, School, :tag => "ExtSchool"
+      has_many :desired_job_types, JobType, :tag => "DesiredJobTypes"
+      has_many :languages, Language, :tag => "Languages"
+      has_many :desired_shift_preferences, ShiftPreference, :tag => "DesiredShiftPreferences"
+
+      element :timestamp, Time, :tag => "TimeStamp"
+      element :id, String, :tag => "ResumeID"
+      element :title, String, :tag => "ResumeTitle"
+      element :contact_name, String, :tag => "ContactName"
+      element :contact_email, String, :tag => "ContactEmail"
+      element :contact_phone, String, :tag => "ContactPhone"
+      element :max_commute_miles, Integer, :tag => "MaxCommuteMiles"
+      element :travel_preference, String, :tag => "TravelPreference"
+      element :currently_employed, String, :tag => "CurrentlyEmployed"
+      element :most_recent_title, String, :tag => "MostRecentTitle"
+      element :experience_months, Integer, :tag => "ExperienceMonths"
+      element :managed_others, String, :tag => "//ManagedOthers"
+      element :number_managed, Integer, :tag => "//NumberManaged"
+      element :jobs_last_three_years, Integer, :tag => "JobsLastThreeYears"
+      element :last_job_tenure_months, Integer, :tag => "LastJobTenureMonths"
+      element :security_clearance, String, :tag => "SecurityClearance"
+      element :felony_convictions, String, :tag => "FelonyConvictions"
+      element :highest_degree, String, :tag => "HighestDegree"
+      element :certifications, String, :tag => "Certifications"
+      element :motivation_to_change_jobs, String, :tag => "MotivationToChangeJobs"
+      element :employment_type, String, :tag => "EmploymentType"
+      element :last_updated, Time, :tag => "LastUpdated"
+      element :text, String, :tag => "ResumeText"
+      element :military_experience, String, :tag => "MilitaryExperience"
+      element :warning, String, :tag => "Warning"
+
+    end
+
+  end
+
+end

data/lib/career_builder/api/resume_search.rb

@@ -0,0 +1,22 @@
+module CareerBuilder
+
+  module API
+
+    class ResumeSearch
+
+      include HappyMapper
+
+      tag 'Packet'
+
+      has_many :results, ResumeSearchResult
+
+      element :page_number, Integer, :tag => "PageNumber"
+      element :search_time, Time, :tag => "SearchTime"
+      element :hits, Integer, :tag => "Hits"
+      element :max_page, Integer, :tag => "MaxPage"
+
+    end
+
+  end
+
+end

data/lib/career_builder/api/resume_search_result.rb

@@ -0,0 +1,28 @@
+module CareerBuilder
+
+  module API
+
+    class ResumeSearchResult
+
+      include HappyMapper
+
+      tag 'ResumeResultItem_V3'
+
+      element :contact_email, String, :tag => "ContactEmail"
+      element :contact_name, String, :tag => "ContactName"
+      element :home_location, String, :tag => "HomeLocation"
+      element :last_update, Date, :tag => "LastUpdate"
+      element :title, String, :tag => "ResumeTitle"
+      element :job_title, String, :tag => "JobTitle"
+      element :recent_employer, String, :tag => "RecentEmployer"
+      element :recent_job_title, String, :tag => "RecentJobTitle"
+      element :recent_pay, Integer, :tag => "RecentPay"
+      element :id, String, :tag => "ResumeID"
+      element :user_did, String, :tag => "UserDID"
+      element :contact_email_md5, String, :tag => "ContactEmailMD5"
+
+    end
+
+  end
+
+end

data/lib/career_builder/api/school.rb

@@ -0,0 +1,18 @@
+module CareerBuilder
+  
+  module API
+
+    class School
+
+      include HappyMapper
+
+      element :name, String, :tag => "SchoolName"
+      element :major, String, :tag => "Major"
+      element :degree, String, :tag => "Degree"
+      element :graduation_date, String, :tag => "GraduationDate"
+
+    end
+
+  end
+
+end

data/lib/career_builder/api/shift_preference.rb

@@ -0,0 +1,15 @@
+module CareerBuilder
+
+  module API
+
+    class ShiftPreference
+
+      include HappyMapper
+
+      element :text, String, :tag => "string"
+
+    end
+
+  end
+
+end

data/lib/career_builder/api/word_document.rb

@@ -0,0 +1,16 @@
+module CareerBuilder
+  
+  module API
+
+    class WordDocument
+
+      include HappyMapper
+
+      element :filename, String, :tag => "FileName"
+      element :base64_date, String, :tag => "Base64Data"
+
+    end
+
+  end
+  
+end

data/lib/career_builder/client.rb

@@ -0,0 +1,37 @@
+module CareerBuilder
+
+  class Client
+
+    attr_reader :email, :password, :session_token
+
+    def initialize(email, password)
+      @email, @password = email, password
+    end
+
+    def authenticate
+      @session_token = Requests::Authentication.new(self, :email => email, :password => password).perform
+    end
+
+    def authenticated?
+      !session_token.nil?
+    end
+
+    def resumes(options = {})
+      Resume::LazyCollection.new(self, options)
+    end
+
+    def advanced_resume_search(options = {})
+      Requests::AdvancedResumeSearch.new(self, options).perform
+    end
+
+    def get_resume(options = {})
+      Requests::GetResume.new(self, options).perform
+    end
+
+    def resume_actions_remaining_today(options = {})
+      Requests::ResumeActionsRemainingToday.new(self, options).perform
+    end
+
+  end
+
+end

data/lib/career_builder/errors.rb

@@ -0,0 +1,7 @@
+module CareerBuilder
+
+  Error              = Class.new(StandardError)
+  InvalidCredentials = Class.new(Error)
+  OutOfCredits       = Class.new(Error)
+
+end

data/lib/career_builder/request.rb

@@ -0,0 +1,82 @@
+module CareerBuilder
+
+  class Request
+
+    RESUME_SERVICE_ENDPOINT_URL = 'http://ws.careerbuilder.com/resumes/resumes.asmx'
+
+    attr_reader :options, :client
+
+    def initialize(client, options = {})
+      @client, @options = client, options
+    end
+
+    def perform
+      validate_options if defined?(self.class.const_get(:VALID_OPTIONS))
+    end
+
+    private
+
+    def validate_options
+      raise ArgumentError, "Invalid options #{invalid_options}" unless valid_options?
+    end
+
+    def invalid_options
+      (options.keys - self.class.const_get(:VALID_OPTIONS))
+    end
+
+    def valid_options?
+      invalid_options.empty?
+    end
+
+    def session_token
+      client.session_token
+    end
+
+    def parse_terrible_response(response)
+      xml_body = Nokogiri::XML(response.body) # not sure why I have to do it this way
+      inner_xml = xml_body.children.first
+      inner_xml.text
+    end
+
+    CUSTOM_KEY_TRANSFORMS = {
+      :resume_id => "ResumeID",
+      :account_did => "AccountDID"
+    }
+
+    def transform_key(key)
+      if custom_transform = CUSTOM_KEY_TRANSFORMS[key]
+        custom_transform
+      else
+        key.to_s.camelize
+      end
+    end
+
+    def transform_key_value_to_tag(key, value)
+      "<#{transform_key(key)}>#{value}</#{transform_key(key)}>"
+    end
+
+    def transform_options_to_xml(options)
+      elements = []
+
+      # let's make sure SessionToken is always at the top of the request
+      if session_key = options.delete(:session_token)
+        elements << transform_key_value_to_tag(:session_token, session_token)
+      end
+
+      options.sort_by { |k, v| k.to_s }.each do |key, value|
+        elements << transform_key_value_to_tag(key, value)
+      end
+
+      elements.join
+    end
+
+    def perform_request(method, packet_contents)
+      parse_terrible_response Net::HTTP.post_form(URI.parse(RESUME_SERVICE_ENDPOINT_URL + "/#{method}"), 'Packet' => "<Packet>#{packet_contents}</Packet>")
+    rescue Errno::ECONNRESET
+      warn "The connection was reset, retrying"
+      retry
+    end
+
+  end
+
+end

data/lib/career_builder/request/authenticated.rb

@@ -0,0 +1,23 @@
+module CareerBuilder
+
+  class Request::Authenticated < Request
+
+    def perform
+      super
+      require_authentication
+      options.merge!(:session_token => session_token) unless options.has_key?(:session_token)
+    end
+
+    private
+
+    def require_authentication
+      if !client.authenticated?
+        unless client.authenticate
+          raise InvalidCredentials
+        end
+      end
+    end
+
+  end
+
+end

data/lib/career_builder/requests/advanced_resume_search.rb

@@ -0,0 +1,41 @@
+module CareerBuilder
+
+  module Requests
+
+    class AdvancedResumeSearch < Request::Authenticated
+
+      # List of valid options available at:
+      # http://ws.careerbuilder.com/resumes/resumes.asmx/V2_AdvancedResumeSearch_ValidFields
+      #
+      VALID_OPTIONS = [:keywords, :search_pattern, :job_categories,
+                       :city, :state, :zip_code, :country,
+                       :search_radius_in_miles, :relocation_filter,
+                       :freshness_in_days, :employment_type,
+                       :minimum_experience,
+                       :minimum_travel_requirement, :minimum_degree,
+                       :compensation_type, :minimum_salary,
+                       :maximum_salary,
+                       :exclude_resumes_with_no_salary,
+                       :languages_spoken, :currently_employed,
+                       :management_experience,
+                       :minimum_employees_managed, :maximum_commute,
+                       :security_clearance, :work_status,
+                       :exclude_ivr_resumes, :order_by, :page_number,
+                       :rows_per_page, :cust_acct_code, :custom_xml,
+                       :military_experience, :niche_inclusion,
+                       :lemmatize, :job_title, :company, :school,
+                       :rsadid, :cb_minimum_experience,
+                       :cb_maximum_experience].freeze
+
+      def perform
+        super
+        response = perform_request("V2_AdvancedResumeSearch", transform_options_to_xml(options))
+
+        API::ResumeSearch.parse(response)
+      end
+
+    end
+
+  end
+
+end

data/lib/career_builder/requests/authentication.rb

@@ -0,0 +1,25 @@
+module CareerBuilder
+
+  module Requests
+
+    class Authentication < Request
+
+      def perform
+        response = perform_request("BeginSessionV2", "<Email>#{options[:email]}</Email><Password>#{options[:password]}</Password>")
+        packet = Nokogiri::XML(response)
+
+        if session_token = packet.search("//SessionToken")
+          session_token_text = session_token.text
+          if session_token_text == "Invalid"
+            return nil
+          else
+            return session_token_text
+          end
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/career_builder/requests/get_resume.rb

@@ -0,0 +1,24 @@
+module CareerBuilder
+
+  module Requests
+
+    class GetResume < Request::Authenticated
+
+      VALID_OPTIONS = [:resume_id, :cust_acct_code, :get_word_doc_if_available].freeze
+
+      def perform
+        super
+        response = perform_request("V2_GetResume", transform_options_to_xml(options))
+
+        if response =~ /ResumeID/ # valid response
+          API::Resume.parse(response, :single => true)
+        else
+          raise OutOfCredits
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/career_builder/requests/resume_actions_remaining_today.rb

@@ -0,0 +1,21 @@
+module CareerBuilder
+
+  module Requests
+
+    class ResumeActionsRemainingToday < Request::Authenticated
+
+      VALID_OPTIONS = [:account_did]
+
+      def perform
+        super
+        response = perform_request("V2_ResumeActionsRemainingToday", transform_options_to_xml(options))
+
+        doc = Nokogiri::XML(response)
+        doc.xpath("//Packet").text.to_i
+      end
+
+    end
+
+  end
+
+end