efleming/sovren

A ruby library used for parsing resumes using the Sovren resume parser.

Sovren

A simple ruby gem that parses a resume using the sovren resume parser and returns the resume back as a ruby object.

Installation

Add this line to your application's Gemfile:

gem 'sovren'

And then execute:

$ bundle

Or install it yourself as:

$ gem install sovren

Usage Example

1. Create a client

   client = Sovren::Client.new(endpoint: "http://services.resumeparsing.com/ParsingService.asmx?wsdl", account_id: "your sovren account id", service_key: "your sovren service key")

2. Parse a resume

   resume = client.parse(File.read('/path/to/your/file/resume.doc'))

Contributing

The testing could use some more coverage for other hr-xml use cases. I also haven't added any of the sovren specific fields returned but those could be added if you need them.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

sovren's Issues

I am unable to start a rails server with the gem installed :undefined method `to_sym' for nil:NilClass

I started a new rails app my Gem file as below:
source 'http://rubygems.org'
ruby '1.9.3'

ruby-gemset=railstutorial_rails_4_0

gem 'rails', '4.0.0'
gem 'bcrypt-ruby', '3.0.1'
gem 'pg', '0.15.1'
gem 'sovren'

I am unsure why i get this error
/Users/xxx/.rvm/gems/ruby-1.9.3-p392@global/gems/bundler-1.3.5/lib/bundler/runtime.rb:56:in block in require': undefined methodto_sym' for nil:NilClass (NoMethodError)

What could be the issue?

Current gem release (0.0.5) causes exceptions when SOVREN_ENV is undefined

When requiring the sovren gem, if the environment variable 'SOVREN_ENV' is undefined, it causes exceptions.

`block in require': undefined method `to_sym' for nil:NilClass (NoMethodError)

The offending line is in lib/sovren.rb#1:

Bundler.require(:default,ENV["SOVREN_ENV"]) if defined?(Bundler)

Update to latest API

I'll make a pull request for this as I get a little time, but working on the current version of the Sovren API I had to use my own client class to make the API calls. The classes in this library for parsing still worked great on the response, so it's just the client that needs updating.