sovren 0.0.3

data/lib/sovren/publication.rb

@@ -0,0 +1,35 @@
+module Sovren
+  class Publication
+    attr_accessor :type, :title, :role, :publication_date, :journal_or_serial_name, :volume, :issue, :page_number, :abstract, :copyright_date, :copyright_text, :edition, :isbn, :publisher_name, :publisher_location, :event_name, :conference_date, :conference_location, :comments, :number_of_pages
+
+    def self.parse(publications)
+      return Array.new if publications.nil?
+      result = publications.css('Article,Book,ConferencePaper,OtherPublication').collect do |item|
+        c = Publication.new
+        c.type = item.name == "OtherPublication" ? item['type'] : item.name
+        c.title = item.css('Title').text
+        c.role = item.css('Name').first['role'] rescue nil
+        c.publication_date = item.css('PublicationDate').css('YearMonth,Year').first.text rescue nil
+        c.journal_or_serial_name = item.css('JournalOrSerialName').text
+        c.volume = item.css('Volume').text
+        c.issue = item.css('Issue').text
+        c.page_number = item.css('PageNumber').text
+        c.abstract = item.css('Abstract').text
+        c.copyright_date = item.css('Copyright CopyrightDates OriginalDate Year, Copyright CopyrightDates OriginalDate YearMonth').first.text rescue nil
+        c.copyright_text = item.css('Copyright CopyrightText').first.text rescue nil
+        c.edition = item.css('Edition').text
+        c.isbn = item.css('ISBN').text
+        c.publisher_name = item.css('PublisherName').text
+        c.publisher_location = item.css('PublisherLocation').text
+        c.event_name = item.css('EventName').text
+        c.conference_date = Date.parse(item.css('ConferenceDate AnyDate').text) rescue nil
+        c.conference_location = item.css('ConferenceLocation').text
+        c.comments = item.css('Comments').text
+        c.number_of_pages = item.css('NumberOfPages').text.to_i rescue nil
+        c
+      end
+      result
+    end
+  
+  end
+end

data/lib/sovren/reference.rb

@@ -0,0 +1,18 @@
+module Sovren
+  class Reference
+    attr_accessor :name, :title, :email, :phone_number
+
+    def self.parse(references)
+      return Array.new if references.nil?
+      result = references.css('Reference').collect do |item|
+        r = Reference.new
+        r.name = item.css('PersonName FormattedName').text
+        r.title = item.css('PositionTitle').text
+        r.email = item.css('ContactMethod InternetEmailAddress').first.text rescue nil
+        r.phone_number = item.css('ContactMethod Telephone FormattedNumber').first.text rescue nil
+        r
+      end
+      result
+    end
+  end
+end

data/lib/sovren/resume.rb

@@ -0,0 +1,28 @@
+require 'json'
+
+module Sovren
+  class Resume
+    attr_accessor :executive_summary, :objective, :contact_information, :education_history, :employment_history, :certifications, :competencies, :achievements, :associations, :languages, :military_history, :patent_history, :publication_history, :references
+
+    def self.parse(resume)
+      parsed_resume = Nokogiri::XML.parse(resume)
+      resume = self.new
+      resume.executive_summary = parsed_resume.css('ExecutiveSummary').text
+      resume.objective = parsed_resume.css('Objective').text
+      resume.contact_information = ContactInformation.parse(parsed_resume.css('ContactInfo').first)
+      resume.education_history = Education.parse(parsed_resume.css('EducationHistory').first)
+      resume.employment_history = Employment.parse(parsed_resume.css('EmploymentHistory').first)
+      resume.certifications = Certification.parse(parsed_resume.css('LicensesAndCertifications').first)
+      resume.competencies = Competency.parse(parsed_resume.css('Qualifications').first)
+      resume.achievements = Achievement.parse(parsed_resume.css('Achievements').first)
+      resume.associations = Association.parse(parsed_resume.css('Associations').first)
+      resume.languages = Language.parse(parsed_resume.css('Languages').first)
+      resume.military_history = Military.parse(parsed_resume.css('MilitaryHistory').first)
+      resume.patent_history = Patent.parse(parsed_resume.css('PatentHistory').first)
+      resume.publication_history = Publication.parse(parsed_resume.css('PublicationHistory').first)
+      resume.references = Reference.parse(parsed_resume.css('References').first)
+      resume
+    end
+
+  end
+end

data/lib/sovren/version.rb

@@ -0,0 +1,3 @@
+module Sovren
+  VERSION = "0.0.3"
+end

data/sovren.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'sovren/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "sovren"
+  spec.version       = Sovren::VERSION
+  spec.authors       = ["Eric Fleming"]
+  spec.email         = ["efleming@gmail.com"]
+  spec.description   = "This is a gem used for parsing resumes using the Sovren resume parser service."
+  spec.summary       = "This is a gem used for parsing resumes using the Sovren resume parser service."
+  spec.homepage      = "http://github.com/efleming/sovren"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 1.9.2'
+
+  spec.add_dependency "savon", "~> 2.2.0"
+  spec.add_dependency "httpclient", "~> 2.3.3"
+  spec.add_dependency "nokogiri", "~> 1.5.9"
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+
+  spec.requirements << "Access to a sovren resume parser server."
+end

data/spec/sovren/achievement_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Sovren::Achievement do
+  use_natural_assertions
+
+  context ".parse" do
+    context "a full resume" do
+      Given(:raw_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/achievements.xml')) }
+      Given(:xml) { Nokogiri::XML.parse(raw_xml) }
+
+      When(:result) { Sovren::Achievement.parse(xml) }
+
+      Then { result.length == 1 }
+      Then { result.first.description == "Awarded Medal of Merit by the Royal Society of Forensics, 2005" }
+    end
+
+    context "no achievements" do
+      When(:result) { Sovren::Achievement.parse(nil) }
+
+      Then { result == Array.new }
+    end
+  end
+
+end

data/spec/sovren/association_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Sovren::Association do
+  use_natural_assertions
+
+  context ".parse" do
+    context "a full resume" do
+      Given(:raw_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/associations.xml')) }
+      Given(:xml) { Nokogiri::XML.parse(raw_xml) }
+
+      When(:result) { Sovren::Association.parse(xml) }
+
+      Then { result.length == 1 }
+      Then { result.first.name == "Association of Retired Military Document Examiners" }
+      Then { result.first.role == "Member" }
+    end
+
+    context "no associations" do
+      When(:result) { Sovren::Association.parse(nil) }
+
+      Then { result == Array.new }
+    end
+  end
+
+end

data/spec/sovren/certification_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Sovren::Certification do
+  use_natural_assertions
+
+  context ".parse" do
+    context "a full resume" do
+      Given(:raw_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/certifications.xml')) }
+      Given(:xml) { Nokogiri::XML.parse(raw_xml) }
+
+      When(:result) { Sovren::Certification.parse(xml) }
+
+      Then { result.length == 4 }
+      Then { result[2].name == "Sun Secure Global Desktop (Tarantella) System Administration" }
+      Then { result[2].description == "certification" }
+      Then { result[2].effective_date == Date.new(2001,9,1) }
+    end
+
+    context "no competencies" do
+      When(:result) { Sovren::Certification.parse(nil) }
+
+      Then { result == Array.new }
+    end
+  end
+
+end

data/spec/sovren/client_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Sovren::Client do
+  Given(:sovren_client) { Sovren::Client.new(endpoint: "foo1", username: "foo2", password: "foo3") }
+
+  context 'init' do
+    Then { sovren_client.should_not be_nil }
+  end
+
+  context '.config' do
+    Then { sovren_client.should respond_to :endpoint }
+    Then { sovren_client.endpoint == "foo1" }
+    Then { sovren_client.should respond_to :username }
+    Then { sovren_client.username == "foo2" }
+    Then { sovren_client.should respond_to :password }
+    Then { sovren_client.password == "foo3" }
+  end
+
+  describe 'parsing' do
+    Given(:sovren_client) { Sovren::Client.new(endpoint: "http://www.foo.com/") }
+    Given(:resume) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/ResumeSample.doc')) }
+
+    context ".parse", vcr: {cassette_name: 'parsed_resume'} do
+      When(:result) { sovren_client.parse(resume) }
+      Then { result.class.should == Sovren::Resume }
+    end
+  end
+end

data/spec/sovren/competency_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Sovren::Competency do
+  use_natural_assertions
+
+  context ".parse" do
+    context "a full resume" do
+      Given(:raw_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/competencies.xml')) }
+      Given(:xml) { Nokogiri::XML.parse(raw_xml) }
+
+      When(:result) { Sovren::Competency.parse(xml) }
+
+      Then { result.length == 50 }
+      Then { result.first.name == "MARKETING" }
+      Then { result.first.months == 158 }
+      Then { result.first.last_used_date == Date.new(2013,4,29) }
+    end
+
+    context "no competencies" do
+      When(:result) { Sovren::Competency.parse(nil) }
+
+      Then { result == Array.new }
+    end
+  end
+
+end

data/spec/sovren/contact_information_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+
+describe Sovren::ContactInformation do
+  use_natural_assertions
+
+  Given(:contact_information) { Sovren::ContactInformation.new }
+
+  Then { contact_information.should respond_to :first_name }
+  Then { contact_information.should respond_to :middle_name }
+  Then { contact_information.should respond_to :last_name }
+  Then { contact_information.should respond_to :generation }
+
+  Then { contact_information.should respond_to :address_line_1 }
+  Then { contact_information.should respond_to :address_line_2 }
+  Then { contact_information.should respond_to :city }
+  Then { contact_information.should respond_to :state }
+  Then { contact_information.should respond_to :country }
+  Then { contact_information.should respond_to :postal_code }
+
+  Then { contact_information.should respond_to :home_phone }
+  Then { contact_information.should respond_to :mobile_phone }
+
+  Then { contact_information.should respond_to :email }
+  Then { contact_information.should respond_to :website }
+
+  context ".parse" do
+    context "a full resume" do
+      Given(:raw_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/contact_information.xml')) }
+      Given(:xml) { Nokogiri::XML.parse(raw_xml) }
+
+      When(:result) { Sovren::ContactInformation.parse(xml) }
+
+      Then { result.first_name == "John" }
+      Then { result.middle_name == "F." }
+      Then { result.last_name == "Adams" }
+      Then { result.generation == "III" }
+      Then { result.aristocratic_title == "Duke" }
+      Then { result.form_of_address == "Mr." }
+      Then { result.qualification == "M.D." }
+
+      Then { result.address_line_1 == "930 Via Mil Cumbres" }
+      Then { result.address_line_2 == "Unit 119" }
+      Then { result.city == "Solana Beach" }
+      Then { result.state == "CA" }
+      Then { result.postal_code == "92075" }
+      Then { result.country == "US" }
+
+      Then { result.home_phone == "(858) 555-1000" }
+      Then { result.mobile_phone == "(858) 555-1001" }
+
+      Then { result.website == "http://www.linkedin.com/in/johnadams" }
+      Then { result.email == "johnadams@yamoo.com" }
+    end  
+    
+    context "a sparse resume" do
+      Given(:raw_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/contact_information_sparse.xml')) }
+      Given(:xml) { Nokogiri::XML.parse(raw_xml) }
+
+      When(:result) { Sovren::ContactInformation.parse(xml) }
+
+      Then { result.first_name == "John" }
+      Then { result.last_name == "Adams" }
+      Then { result.email == "johnadams@yamoo.com" }
+    end  
+
+    context "no contact info" do
+      When(:result) { Sovren::ContactInformation.parse(nil) }
+
+      Then { result == Array.new }
+    end  
+  end
+
+end

data/spec/sovren/education_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe Sovren::Education do
+  use_natural_assertions
+
+  context ".graduated?" do
+    When(:education) {Sovren::Education.new}
+    Then { education.graduated? == false }
+  end
+
+  context ".parse" do
+      context "a full list of experience" do
+        Given(:raw_education_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/education.xml')) }
+        Given(:education_xml) { Nokogiri::XML.parse(raw_education_xml) }
+
+        When(:result) { Sovren::Education.parse(education_xml) }
+
+        Then { result.length == 2 }
+        Then { result.first.school_name == "California State University" }
+        Then { result.first.city == "Chico"}
+        Then { result.first.state == "CA"}
+        Then { result.first.country == "US"}
+        Then { result.first.major == "Business Administration" }
+        Then { result.first.minor == "" }
+        Then { result.first.degree_type == "bachelors" }
+        Then { result.first.degree_name == "B.S." }
+        Then { result.first.gpa == 3.66 }
+        Then { result.first.gpa_out_of == 4.00 }
+        Then { result.first.start_date == Date.new(1996,1,1) }
+        Then { result.first.end_date == Date.new(1999,1,1) }
+        Then { result.first.graduated == true }
+        Then { result.first.graduated? == true }
+      end
+      
+      context "very little experience information" do
+        Given(:raw_education_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/education_sparse.xml')) }
+        Given(:education_xml) { Nokogiri::XML.parse(raw_education_xml) }
+
+        When(:result) { Sovren::Education.parse(education_xml) }
+
+        Then { result.length == 1 }
+        Then { result.first.school_name == "California State University" }
+        Then { result.first.degree_type == "bachelors" }
+        Then { result.first.degree_name == "B.S." }
+      end
+  end
+
+end

data/spec/sovren/employment_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe Sovren::Employment do
+  use_natural_assertions
+
+  context ".current_employer?" do
+    When(:employment) {Sovren::Employment.new}
+    Then { employment.current_employer? == false }
+  end
+
+  context ".parse" do
+    context "a full resume" do
+      Given(:raw_employment_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/employment.xml')) }
+      Given(:employment_xml) { Nokogiri::XML.parse(raw_employment_xml) }
+
+      When(:result) { Sovren::Employment.parse(employment_xml) }
+
+      Then { result.length == 4 }
+      Then { result.first.employer == "Technical Difference" }
+      Then { result.first.division == nil }
+      Then { result.first.title == "Director of Web Applications Development" }
+      Then { result.first.city == "Encinitas"}
+      Then { result.first.state == "CA"}
+      Then { result.first.country == "US"}
+      Then { result.first.description.length == 694 }
+      Then { result.first.start_date == Date.new(2004,10,01) }
+      Then { result.first.end_date == nil }
+      Then { result.first.current_employer == true }
+      Then { result.first.current_employer? == true }
+    end
+    
+    context "a sparse resume" do
+      Given(:raw_employment_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/employment_sparse.xml')) }
+      Given(:employment_xml) { Nokogiri::XML.parse(raw_employment_xml) }
+
+      When(:result) { Sovren::Employment.parse(employment_xml) }
+
+      Then { result.length == 1 }
+      Then { result.first.employer == "Technical Difference" }
+      Then { result.first.title == "Director of Web Applications Development" }
+      Then { result.first.current_employer? == false }
+    end
+  end
+
+end

data/spec/sovren/language_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe Sovren::Language do
+  use_natural_assertions
+
+  context ".parse" do
+    context "a full resume" do
+      Given(:raw_xml) { File.read(File.expand_path(File.dirname(__FILE__) + '/../support/languages.xml')) }
+      Given(:xml) { Nokogiri::XML.parse(raw_xml) }
+
+      When(:result) { Sovren::Language.parse(xml) }
+
+      Then { result.length == 3 }
+      Then { result.first.language_code == "ps" }
+      Then { result.first.read? == true }
+      Then { result.first.speak? == true }
+      Then { result.first.write? == true }
+    end
+
+    context "no languages" do
+      When(:result) { Sovren::Language.parse(nil) }
+
+      Then { result == Array.new }
+    end
+  end
+
+end