career_builder 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,22 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+.bundle

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+
+gem "activesupport"
+gem "nokogiri"
+gem "nokogiri-happymapper"
+
+group :test do
+  gem "rspec"
+  gem "webmock"
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Michael Guterl
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,91 @@
+# CareerBuilder
+
+Ruby wrapper for the [CareerBuilder V2 HTTP XML API](http://ws.careerbuilder.com/schemas/).  While the CareerBuilder::Client mimics the interface of the HTTP API, it also provides some convenience methods to make your life easier.
+
+**NOTE** currently only the resume portion of the API is implemented, others are a work in progress.
+
+## Installation
+
+    gem install career_builder
+
+## Usage
+
+    require 'career_builder'
+
+### Authenticate
+
+    client = CareerBuilder.new('your_email', 'your_password')
+    session_token = client.authenticate
+
+### Resume API
+
+http://ws.careerbuilder.com/resumes/resumes.asmx
+
+#### advanced_resume_search
+
+     resumes = client.advanced_resume_search(:keywords => "Ruby",
+                                             :zip_code => "45140",
+                                             :search_radius_in_miles => 50)
+
+#### get_resume
+
+     partial_resume = resumes.first
+     resume = client.get_resume(:resume_id => partial_resume.id)
+
+#### resume_actions_remaining_today
+
+This method requires your AccountDID, I could not find an official way to find this identifier, but I followed these steps:
+
+1. Sign into CareerBuilder with your email / password credentials
+2. Click My CareerBuilder -> My Account Info
+3. Copy the AccountDID URL parameter from your address bar
+
+    client.resume_actions_remaining_today(:account_did => "D7C10Q67ZKG123VCRMC") # => 42
+
+### Resume Convenience Methods / Classes
+
+fetch a lazy collection of resumes, nothing actually happens until you iterate.
+
+    resumes = client.resumes(:keywords => "Ruby",
+                             :zip_code => "45140",
+                             :search_radius_in_miles => 50)
+
+iterate through the resumes, automatically paging through the result set.
+
+    resumes.each do |resume|
+      puts resume.id
+    end
+
+resumes that are fetched from a Resume::LazyCollection are also lazy in the sense that they do not attempt to use the Client#get_resume method until you access one of the attributes that requires using an API credit.
+
+    resume = resumes.first
+
+Client#get_resume is not called when retrieving the id
+
+    resume.id # => "42XXASDFJKLQWERTY"
+
+Client#get_resume(:resume_id => "42XXASDFJKLQWERTY") is called behind the scenes in order to fetch the real email address associated with the resume.
+
+    resume.real_contact_email # => "michael@jordan.com"
+
+## TODO
+
+* More / better specs
+* Implement Application Web Service
+* Implement Job Web Service
+* Implement Accounts Web Service
+* Implement Document Matching Web Service
+
+## Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 Michael Guterl. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "career_builder"
+    gem.summary = %Q{Ruby wrapper for the CareerBuilder V2 API}
+    gem.description = %Q{Ruby wrapper for the CareerBuilder V2 HTTP XML API}
+    gem.email = "mguterl@gmail.com"
+    gem.homepage = "http://github.com/mguterl/career_builder"
+    gem.authors = ["Michael Guterl"]
+    gem.add_development_dependency "rspec", ">= 1.3.0"
+    gem.add_development_dependency "webmock"
+    gem.add_dependency "nokogiri-happymapper"
+    gem.add_dependency "activesupport", "~> 2.3.5"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "career_builder #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/career_builder.gemspec

@@ -0,0 +1,95 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{career_builder}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Guterl"]
+  s.date = %q{2010-06-28}
+  s.description = %q{Ruby wrapper for the CareerBuilder V2 HTTP XML API}
+  s.email = %q{mguterl@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.md"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "Gemfile",
+     "LICENSE",
+     "README.md",
+     "Rakefile",
+     "VERSION",
+     "career_builder.gemspec",
+     "lib/career_builder.rb",
+     "lib/career_builder/api/company.rb",
+     "lib/career_builder/api/interest.rb",
+     "lib/career_builder/api/job_type.rb",
+     "lib/career_builder/api/language.rb",
+     "lib/career_builder/api/location.rb",
+     "lib/career_builder/api/pay.rb",
+     "lib/career_builder/api/resume.rb",
+     "lib/career_builder/api/resume_search.rb",
+     "lib/career_builder/api/resume_search_result.rb",
+     "lib/career_builder/api/school.rb",
+     "lib/career_builder/api/shift_preference.rb",
+     "lib/career_builder/api/word_document.rb",
+     "lib/career_builder/client.rb",
+     "lib/career_builder/errors.rb",
+     "lib/career_builder/request.rb",
+     "lib/career_builder/request/authenticated.rb",
+     "lib/career_builder/requests/advanced_resume_search.rb",
+     "lib/career_builder/requests/authentication.rb",
+     "lib/career_builder/requests/get_resume.rb",
+     "lib/career_builder/requests/resume_actions_remaining_today.rb",
+     "lib/career_builder/resume.rb",
+     "lib/career_builder/resume/lazy_collection.rb",
+     "spec/career_builder/client_spec.rb",
+     "spec/career_builder/resume/lazy_collection_spec.rb",
+     "spec/career_builder/resume_spec.rb",
+     "spec/career_builder_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/support/webmock.rb"
+  ]
+  s.homepage = %q{http://github.com/mguterl/career_builder}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Ruby wrapper for the CareerBuilder V2 API}
+  s.test_files = [
+    "spec/career_builder/client_spec.rb",
+     "spec/career_builder/resume/lazy_collection_spec.rb",
+     "spec/career_builder/resume_spec.rb",
+     "spec/career_builder_spec.rb",
+     "spec/spec_helper.rb",
+     "spec/support/webmock.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.3.0"])
+      s.add_development_dependency(%q<webmock>, [">= 0"])
+      s.add_runtime_dependency(%q<nokogiri-happymapper>, [">= 0"])
+      s.add_runtime_dependency(%q<activesupport>, ["~> 2.3.5"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.3.0"])
+      s.add_dependency(%q<webmock>, [">= 0"])
+      s.add_dependency(%q<nokogiri-happymapper>, [">= 0"])
+      s.add_dependency(%q<activesupport>, ["~> 2.3.5"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.3.0"])
+    s.add_dependency(%q<webmock>, [">= 0"])
+    s.add_dependency(%q<nokogiri-happymapper>, [">= 0"])
+    s.add_dependency(%q<activesupport>, ["~> 2.3.5"])
+  end
+end
+

data/lib/career_builder.rb

@@ -0,0 +1,39 @@
+require "rubygems"
+require "bundler"
+Bundler.setup
+
+require 'net/http'
+require 'nokogiri'
+require 'happymapper'
+require 'active_support/inflector'
+
+if RUBY_VERSION < '1.9'
+  class BasicObject 
+    instance_methods.each do |m| 
+      undef_method(m) if m.to_s !~ /(?:^__|^nil\?$|^send$|^object_id$)/ 
+    end 
+  end
+end
+
+require 'career_builder/errors'
+require 'career_builder/api/resume_search_result'
+require 'career_builder/api/resume_search'
+require 'career_builder/api/company'
+require 'career_builder/api/interest'
+require 'career_builder/api/job_type'
+require 'career_builder/api/language'
+require 'career_builder/api/location'
+require 'career_builder/api/pay'
+require 'career_builder/api/school'
+require 'career_builder/api/shift_preference'
+require 'career_builder/api/word_document'
+require 'career_builder/api/resume'
+require 'career_builder/resume'
+require 'career_builder/resume/lazy_collection'
+require 'career_builder/request'
+require 'career_builder/request/authenticated'
+require 'career_builder/requests/authentication'
+require 'career_builder/requests/advanced_resume_search'
+require 'career_builder/requests/get_resume'
+require 'career_builder/requests/resume_actions_remaining_today'
+require 'career_builder/client'

data/lib/career_builder/api/company.rb

@@ -0,0 +1,17 @@
+module CareerBuilder
+  
+  module API
+
+    class Company
+
+      include HappyMapper
+
+      element :name, String, :tag => "CompanyName"
+      element :job_title, String, :tag => "JobTitle"
+      element :tenure, String, :tag => "Tenure"
+
+    end
+
+  end
+  
+end

data/lib/career_builder/api/interest.rb

@@ -0,0 +1,16 @@
+module CareerBuilder
+  
+  module API
+
+    class Interest
+
+      include HappyMapper
+
+      element :interest, String, :tag => "Interest"
+      element :experience_months, Integer, :tag => "ExperienceMonths"
+
+    end
+
+  end
+  
+end

data/lib/career_builder/api/job_type.rb

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

data/lib/career_builder/api/language.rb

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

data/lib/career_builder/api/location.rb

@@ -0,0 +1,19 @@
+module CareerBuilder
+  
+  module API
+
+    class Location
+
+      include HappyMapper
+
+      element :city, String, :tag => "City"
+      element :state, String, :tag => "State"
+      element :zip_code, String, :tag => "ZipCode"
+      element :country, String, :tag => "Country"
+      element :work_status, String, :tag => "WorkStatus"
+
+    end
+
+  end
+  
+end

data/lib/career_builder/api/pay.rb

@@ -0,0 +1,16 @@
+module CareerBuilder
+  
+  module API
+
+    class Pay
+
+      include HappyMapper
+
+      element :amount, Integer, :tag => "Amount"
+      element :per, String, :tag => "Per"
+
+    end
+
+  end
+  
+end