cb-api 1.3.6 → 2.0.0

data/lib/cb.rb

@@ -2,117 +2,25 @@ require 'cb/config'
 require 'cb/models/implementations/branding/styles/base'
 require 'cb/models/implementations/branding/styles/css_adapter'
 require 'cb/exceptions'
+require 'cb/convenience'
 
 def require_directory(relative_path)
   Dir[File.dirname(__FILE__) + relative_path].each { |file| require file }
 end
 
-required_paths = %w(/cb/utils/*.rb /cb/clients/*.rb /cb/criteria/*.rb /cb/models/*.rb
-                    /cb/models/**/*.rb /cb/responses/*.rb /cb/responses/**/*.rb)
-required_paths.each { |path| require_directory path }
+%w(/cb/utils/*.rb /cb/clients/**/*.rb /cb/criteria/**/*.rb /cb/models/**.rb
+   /cb/models/**/*.rb /cb/responses/*.rb /cb/responses/**/*.rb).each { |path| require_directory path }
 
 module Cb
-	def self.configure
+  extend Convenience::ClassMethods
+
+  def self.configure
 		yield configuration
 	end
 
   def self.configuration
     @configuration ||= Cb::Config.new
     @configuration.set_default_api_uris
-
-    return @configuration
-  end
-
-  # Convenience methods, in case you're lazy... like me :)
-  ###############################################################
-
-  #Cb::JobApi
-  def self.job
-    Cb::JobApi
-  end
-
-  #Cb::JobSearchCriteria
-  def self.job_search_criteria
-    Cb::JobSearchCriteria.new
-  end
-
-  #Cb::JobDetailsCriteria
-  def self.job_detail_criteria
-    Cb::JobDetailsCriteria.new
-  end
-
-  #Cb::CategoryApi
-  def self.category
-    Cb::CategoryApi
-  end
-
-  #Cb::CompanyApi
-  def self.company
-    Cb::CompanyApi
-  end
-
-  #Cb::EducationApi
-  def self.education_code
-    Cb::EducationApi
-  end
-
-  #Cb::RecommendationApi
-  def self.recommendation
-    Cb::RecommendationApi
-  end
-
-  #Cb::ResumeApi
-  def self.resume
-    Cb::ResumeApi
-  end
-
-  #Cb::ApplicationApi
-  def self.application
-    Cb::ApplicationApi
-  end
-
-  #Cb::ApplicationExternalApi
-  def self.application_external
-    Cb::ApplicationExternalApi
-  end
-
-  #Cb::Utils::Country
-  def self.country
-    Cb::Utils::Country
-  end
-
-  #Cb::UserApi
-  def self.user
-    Cb::UserApi
-  end
-
-  #Cb::JobBrandingApi
-  def self.job_branding
-    Cb::JobBrandingApi
-  end
-
-  #Cb::EmailSubscriptionApi
-  def self.email_subscription
-    Cb::EmailSubscriptionApi
-  end
-
-  #Cb::SavedSearchApi
-  def self.saved_search_api
-    Cb::SavedSearchApi
-  end
-
-  #Cb::TalentNetworkApi
-  def self.talent_network_api
-    Cb::TalentNetworkApi
-  end
-
-  #Cb::AnonSavedSearchApi
-  def self.anon_saved_search_api
-    Cb::AnonSavedSearchApi
-  end
-
-  #Cb::ApiClients::Spot
-  def self.spot
-    Cb::ApiClients::Spot
+    @configuration
   end
 end

data/lib/cb/clients/anon_saved_search.rb

@@ -0,0 +1,42 @@
+module Cb
+  module Clients
+
+    class AnonSavedSearch
+      def create(*args)
+        body = new_model(*args).create_anon_to_xml
+        json = cb_client.cb_post(create_uri, :body => body)
+        Responses::AnonymousSavedSearch::Create.new(json)
+      end
+
+      def delete(*args)
+        body = new_model(*args).delete_anon_to_xml
+        json = cb_client.cb_post(delete_uri, :body => body)
+        Responses::AnonymousSavedSearch::Delete.new(json)
+      end
+
+      private
+
+      def new_model(*args)
+        return args.first if args.respond_to?(:[]) && args.first.is_a?(Models::SavedSearch)
+        Models::SavedSearch.new(extract_args(*args))
+      end
+
+      def extract_args(*args)
+        args.is_a?(Array) && args.count == 1 ? args[0] : args
+      end
+
+      def create_uri
+        Cb.configuration.uri_anon_saved_search_create
+      end
+
+      def delete_uri
+        Cb.configuration.uri_anon_saved_search_delete
+      end
+
+      def cb_client
+        @cb_client ||= Cb.api_client.new
+      end
+    end
+
+  end
+end

data/lib/cb/clients/application.rb

@@ -0,0 +1,53 @@
+require 'json'
+
+module Cb
+  module Clients
+    class Application
+
+      def self.for_job(job)
+        job.is_a?(Cb::Models::Job) ? did = job.did : did = job
+        my_api = Cb::Utils::Api.new
+        json_hash = my_api.cb_get(Cb.configuration.uri_application, :query => {:JobDID => did})
+
+        if json_hash.has_key?('ResponseBlankApplication')
+          if json_hash['ResponseBlankApplication'].has_key?('BlankApplication')
+            app = Cb::Models::ApplicationSchema.new(json_hash['ResponseBlankApplication']['BlankApplication'])
+          end
+
+          my_api.append_api_responses(app, json_hash['ResponseBlankApplication'])
+        end
+
+        my_api.append_api_responses(app, json_hash)
+      end
+
+      def self.submit_registered_app(app)
+        return send_to_api(Cb.configuration.uri_application_registered, app)
+      end
+
+      def self.submit_app(app)
+        return send_to_api(Cb.configuration.uri_application_submit, app)
+      end
+
+      def self.send_to_api(uri, app)
+        raise Cb::IncomingParamIsWrongTypeException unless app.is_a?(Cb::Models::Application)
+
+        my_api = Cb::Utils::Api.new
+        json_hash = my_api.cb_post("#{uri}?ipath=#{app.ipath}", :body => app.to_xml)
+
+        if json_hash.has_key? 'ResponseApplication'
+          if json_hash['ResponseApplication'].has_key? 'RedirectURL'
+            app.redirect_url = json_hash['ResponseApplication']['RedirectURL']
+          else
+            app.redirect_url = ''
+          end
+
+          my_api.append_api_responses(app, json_hash['ResponseApplication'])
+        else
+          app.redirect_url = ''
+        end
+
+        my_api.append_api_responses(app, json_hash)
+      end
+    end
+  end
+end

data/lib/cb/clients/application_external.rb

@@ -0,0 +1,24 @@
+require 'json'
+
+module Cb
+  module Clients
+    class ApplicationExternal
+
+      def self.submit_app(app)
+        raise Cb::IncomingParamIsWrongTypeException unless app.is_a?(Cb::Models::ApplicationExternal)
+
+        my_api = Cb::Utils::Api.new
+        xml_hash = my_api.cb_post(Cb.configuration.uri_application_external, :body => app.to_xml)
+
+        if xml_hash.has_key? 'ApplyUrl'
+          app.apply_url = xml_hash['ApplyUrl']
+        else
+          app.apply_url = ''
+        end
+
+        my_api.append_api_responses(app, xml_hash)
+      end
+
+    end
+  end
+end

data/lib/cb/clients/category.rb

@@ -0,0 +1,49 @@
+require "json"
+
+module Cb
+  module Clients
+    class Category
+
+      def self.search
+        my_api = Cb::Utils::Api.new
+        json_hash = my_api.cb_get(Cb.configuration.uri_job_category_search)
+        categoryList = []
+
+        if json_hash.has_key?('ResponseCategories')
+          if json_hash['ResponseCategories'].has_key?('Categories')
+            json_hash['ResponseCategories']['Categories']['Category'].each do |cat|
+              categoryList << Models::Category.new(cat)
+            end
+          end
+
+          my_api.append_api_responses(categoryList, json_hash['ResponseCategories'])
+        end
+
+        my_api.append_api_responses(categoryList, json_hash)
+      end
+
+      def self.search_by_host_site(host_site)
+        my_api = Cb::Utils::Api.new
+        json_hash = my_api.cb_get(Cb.configuration.uri_job_category_search, :query => {:CountryCode => host_site})
+        categoryList = []
+
+        if json_hash.has_key?('ResponseCategories')
+          if json_hash['ResponseCategories'].has_key?('Categories')
+            if json_hash['ResponseCategories']['Categories']['Category'].is_a?(Array)
+              json_hash['ResponseCategories']['Categories']['Category'].each do |cat|
+                categoryList << Models::Category.new(cat)
+              end
+            elsif json_hash['ResponseCategories']['Categories']['Category'].is_a?(Hash) && json_hash.length < 2
+              categoryList << Models::Category.new(json_hash['ResponseCategories']['Categories']['Category'])
+            end
+          end
+
+          my_api.append_api_responses(categoryList, json_hash['ResponseCategories'])
+        end
+
+        my_api.append_api_responses(categoryList, json_hash)
+      end
+
+    end
+  end
+end

data/lib/cb/clients/company.rb

@@ -0,0 +1,34 @@
+require 'json'
+
+module Cb
+  module Clients
+    class Company
+
+      def self.find_by_did(did)
+        my_api = Cb::Utils::Api.new
+        json_hash = my_api.cb_get(Cb.configuration.uri_company_find, :query => {:CompanyDID => did, :hostsite=> Cb.configuration.host_site})
+
+        if json_hash.has_key?('Results')
+            if json_hash['Results'].has_key?('CompanyProfileDetail')
+              company = Models::Company.new(json_hash['Results']['CompanyProfileDetail'])
+            end
+            my_api.append_api_responses(company, json_hash['Results'])
+        end
+
+        my_api.append_api_responses(company, json_hash)
+      end
+
+      def self.find_for(obj)
+        if obj.is_a?(String)
+          did = obj
+        elsif obj.is_a?(Cb::Models::Job)
+          did = obj.company_did
+        end
+        did ||= ''
+
+        find_by_did did unless did.empty?
+      end
+
+    end
+  end
+end

data/lib/cb/clients/education.rb

@@ -0,0 +1,28 @@
+require 'json'
+
+module Cb
+  module Clients
+    class Education
+
+      def self.get_for(country)
+        Cb::Utils::Country.is_valid? country ? country : 'US'
+        my_api = Cb::Utils::Api.new
+        json_hash = my_api.cb_get(Cb.configuration.uri_education_code, :query => {:countrycode => country})
+
+        codes = []
+        if json_hash.has_key?('ResponseEducationCodes')
+          if json_hash['ResponseEducationCodes'].has_key?('EducationCodes') &&
+             json_hash['ResponseEducationCodes']['EducationCodes'].has_key?('Education')
+              json_hash['ResponseEducationCodes']['EducationCodes']['Education'].each do | education |
+                codes << Cb::Models::Education.new(education)
+              end
+          end
+          my_api.append_api_responses(codes, json_hash['ResponseEducationCodes'])
+        end
+
+        my_api.append_api_responses(codes, json_hash)
+      end
+
+    end
+  end
+end

data/lib/cb/clients/email_subscription.rb

@@ -0,0 +1,55 @@
+require 'json'
+
+module Cb
+  module Clients
+    class EmailSubscription
+
+      def self.retrieve_by_did(did, host_site = '')
+        my_api = Cb::Utils::Api.new
+        json_hash = my_api.cb_get(Cb.configuration.uri_subscription_retrieve, :query => {:ExternalID => did, :Hostsite => host_site})
+
+        if json_hash.has_key?('SubscriptionValues') && !json_hash['SubscriptionValues'].nil?
+          subscription = Models::EmailSubscription.new(json_hash['SubscriptionValues'])
+          my_api.append_api_responses(subscription, json_hash['SubscriptionValues'])
+        end
+        my_api.append_api_responses(subscription, json_hash)
+      end
+
+      def self.modify_subscription ext_id, host_site, career_resources, product_sponsor_info, applicant_survey_invites, job_recs, unsubscribe_all
+        if unsubscribe_all && unsubscribe_all != 'false'
+          career_resources = product_sponsor_info = applicant_survey_invites = job_recs = false.to_s
+        end
+
+        career_resources = career_resources.nil? ? 'false' : career_resources
+        product_sponsor_info = product_sponsor_info.nil? ? 'false' : product_sponsor_info
+        applicant_survey_invites = applicant_survey_invites.nil? ? 'false' : applicant_survey_invites
+        job_recs = job_recs.nil? ? 'false' : job_recs
+        unsubscribe_all = unsubscribe_all.nil? ? 'false' : unsubscribe_all
+
+        my_api = Cb::Utils::Api.new
+
+        xml_body = "<Request>"
+        xml_body += "<DeveloperKey>" + Cb.configuration.dev_key.to_s + "</DeveloperKey>"
+        xml_body += "<ExternalID>" + ext_id.to_s + "</ExternalID>"
+        xml_body += "<Hostsite>" + host_site.to_s + "</Hostsite>"
+        xml_body += "<CareerResources>" + career_resources.to_s + "</CareerResources>"
+        xml_body += "<ProductSponsorInfo>" + product_sponsor_info.to_s + "</ProductSponsorInfo>"
+        xml_body += "<ApplicantSurveyInvites>" + applicant_survey_invites.to_s + "</ApplicantSurveyInvites>"
+        xml_body += "<JobRecs>" + job_recs.to_s + "</JobRecs>"
+        xml_body += "<UnsubscribeAll>" + unsubscribe_all.to_s + "</UnsubscribeAll>"
+        xml_body += "</Request>"
+
+
+        json_hash = my_api.cb_post(Cb.configuration.uri_subscription_modify,
+                                    :body => xml_body)
+
+        if json_hash.has_key?('SubscriptionValues') && !json_hash['SubscriptionValues'].nil?
+          subscription = Models::EmailSubscription.new(json_hash['SubscriptionValues'])
+          my_api.append_api_responses(subscription, json_hash['SubscriptionValues'])
+        end
+        my_api.append_api_responses(subscription, json_hash)
+      end
+
+    end
+  end
+end

data/lib/cb/clients/employee_types.rb

@@ -0,0 +1,31 @@
+module Cb
+  module Clients
+
+    class EmployeeTypes
+      def search
+        json = cb_client.cb_get(endpoint)
+        new_response_object(json)
+      end
+
+      def search_by_hostsite(host_site)
+        json = cb_client.cb_get(endpoint, :query => { :CountryCode => host_site })
+        new_response_object(json)
+      end
+
+      private
+
+      def cb_client
+        @client ||= Cb.api_client.new
+      end
+
+      def endpoint
+        Cb.configuration.uri_employee_types
+      end
+
+      def new_response_object(json_response)
+        Responses::EmployeeTypes::Search.new(json_response)
+      end
+    end
+
+  end
+end