direct_employers 0.0.1

data/.autotest

@@ -0,0 +1 @@
+require 'autotest/bundler'

data/.gitignore

@@ -0,0 +1,41 @@
+!.gitignore
+*.gem
+*.rbc
+*.sw[a-p]
+*.tmproj
+*.tmproject
+*.un~
+*~
+.DS_Store
+.Spotlight-V100
+.Trashes
+._*
+.bundle
+.config
+.directory
+.elc
+.redcar
+.yardoc
+/.emacs.desktop
+/.emacs.desktop.lock
+Desktop.ini
+Gemfile.lock
+Icon?
+InstalledFiles
+Session.vim
+Thumbs.db
+\#*\#
+_yardoc
+auto-save-list
+coverage
+doc/
+lib/bundler/man
+pkg
+pkg/*
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+tmtags
+tramp

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format=nested
+--backtrace

data/.travis.yml

@@ -0,0 +1,8 @@
+rvm:
+  - 1.8.7
+  - 1.9.1
+  - 1.9.2
+  - jruby
+  - rbx
+  - ree
+  - ruby-head

data/.yardopts

@@ -0,0 +1,3 @@
+--markup markdown
+-
+LICENSE.md

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+# Specify your gem's dependencies in direct_employers.gemspec
+gemspec

data/LICENSE.md

@@ -0,0 +1,10 @@
+Copyright (c) 2011, Code for America
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of Code for America nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,75 @@
+# Direct Employers
+
+Ruby wrapper for the Direct Employers API
+
+Installation
+------------
+    gem install direct_employers
+
+Documentation
+-------------
+[http://rdoc.info/gems/direct_employers](http://rdoc.info/gems/direct_employers)
+
+Continuous Integration
+----------------------
+[![Build Status](http://travis-ci.org/codeforamerica/direct_employers.png)](http://travis-ci.org/codeforamerica/direct_employers)
+
+Usage Examples
+--------------
+    require 'direct_employers'
+
+    @client = DirectEmployers.new
+    @client.search({moc: => ""11b}) # Return an array for all matching job listings for MOC of 11b
+    @client.search.query # => "First-Line Supervisors/Managers of Weapons Specialists/Crew Members, Infantry"
+
+
+Contributing
+------------
+In the spirit of [free software](http://www.fsf.org/licensing/essays/free-sw.html), **everyone** is encouraged to help improve this project.
+
+Here are some ways *you* can contribute:
+
+* by using alpha, beta, and prerelease versions
+* by reporting bugs
+* by suggesting new features
+* by writing or editing documentation
+* by writing specifications
+* by writing code (**no patch is too small**: fix typos, add comments, clean up inconsistent whitespace)
+* by refactoring code
+* by resolving [issues](https://github.com/codeforamerica/futures_pipeline/issues)
+* by reviewing patches
+* [financially](https://secure.codeforamerica.org/page/contribute)
+
+Submitting an Issue
+-------------------
+We use the [GitHub issue tracker](https://github.com/codeforamerica/direct_employers/issues)
+to track bugs and features. Before submitting a bug report or feature request,
+check to make sure it hasn't already been submitted. You can indicate support
+for an existing issuse by voting it up. When submitting a bug report, please
+include a [Gist](https://gist.github.com/) that includes a stack trace and any
+details that may be necessary to reproduce the bug, including your gem version,
+Ruby version, and operating system. Ideally, a bug report should include a pull
+request with failing specs.
+
+Submitting a Pull Request
+-------------------------
+1. Fork the project.
+2. Create a topic branch.
+3. Implement your feature or bug fix.
+4. Add documentation for your feature or bug fix.
+5. Run <tt>bundle exec rake doc:yard</tt>. If your changes are not 100% documented, go back to step 4.
+6. Add specs for your feature or bug fix.
+7. Run <tt>bundle exec rake spec</tt>. If your changes are not 100% covered, go back to step 6.
+8. Commit and push your changes.
+9. Submit a pull request. Please do not include changes to the gemspec, version, or history file. (If you want to create your own version for some reason, please do so in a separate commit.)
+
+Credits
+-------
+[Job Central](http://www.jobcentral.com)
+
+Copyright
+---------
+Copyright (c) 2011 Code for America.
+See [LICENSE](https://github.com/codeforamerica/direct_employers/blob/master/LICENSE.md) for details.
+
+[![Code for America Tracker](http://stats.codeforamerica.org/codeforamerica/direct_employers.png)](http://stats.codeforamerica.org/projects/direct_employers)

data/Rakefile

@@ -0,0 +1,18 @@
+#!/usr/bin/env rake
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+task :test => :spec
+
+require 'yard'
+namespace :doc do
+  YARD::Rake::YardocTask.new do |task|
+    task.files   = ['LICENSE.md', 'lib/**/*.rb']
+    task.options = ['--markup', 'markdown']
+  end
+end

data/direct_employers.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/direct_employers/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name        = 'direct_employers'
+  gem.version     = DirectEmployers::VERSION
+  gem.authors     = ["Erik Michaels-Ober", "Ryan Resella"]
+  gem.email       = ['erik@codeforamerica.org', 'ryan@codeforamerica.org']
+  gem.homepage    = 'https://github.com/codeforamerica.org/direct_employers'
+  gem.summary     = gem.description
+  gem.description = %q{Ruby Wrapper for the Direct Employers API}
+
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  gem.require_paths = ['lib']
+
+  gem.add_development_dependency 'ZenTest', '~> 4.5'
+  gem.add_development_dependency 'maruku', '~> 0.6'
+  gem.add_development_dependency 'rake', '~> 0.9'
+  gem.add_development_dependency 'rspec', '~> 2.6'
+  gem.add_development_dependency 'simplecov', '~> 0.4'
+  gem.add_development_dependency 'webmock', '~> 1.6'
+  gem.add_development_dependency 'yard', '~> 0.7'
+  gem.add_runtime_dependency 'faraday', '~> 0.6.1'
+  gem.add_runtime_dependency 'faraday_middleware', '~> 0.6.3'
+  gem.add_runtime_dependency 'hashie', '~> 1.0.0'
+  gem.add_runtime_dependency 'multi_json', '~> 1.0.2'
+  gem.add_runtime_dependency 'multi_xml', '~> 0.2.2'
+  gem.add_runtime_dependency 'rash', '~> 0.3.0'
+end

data/lib/direct_employers.rb

@@ -0,0 +1,17 @@
+require 'direct_employers/client'
+
+module DirectEmployers
+  def self.new
+    DirectEmployers::Client.new
+  end
+
+  # Delegate to DirectEmployers::Client
+  def self.method_missing(method, *args, &block)
+    return super unless new.respond_to?(method)
+    new.send(method, *args, &block)
+  end
+
+  def self.respond_to?(method, include_private=false)
+    new.respond_to?(method, include_private) || super(method, include_private)
+  end
+end

data/lib/direct_employers/client.rb

@@ -0,0 +1,36 @@
+require 'direct_employers/connection'
+require 'direct_employers/request'
+
+module DirectEmployers
+  class Client
+    include DirectEmployers::Connection
+    include DirectEmployers::Request
+
+    # Get a list of all jobs that match the query string parameters
+    #
+    # @param options [Hash] A customizable set of options.
+    # @option options kw [String] Keywords in a standard Boolean format.
+    # @option options oc [String] Occupation from a list of ##.  Must be only Can be used to map to categories if client site uses categories
+    # @option options tm [String] Time range from 1 (for 1 day) upwards, with 0 meaning no time range
+    # @option options ind [String] One of JobCentral’s industry ids, I would suggest using Onets over industries any day
+    # @option options cn [String] Country, US is 100, so if you want to eliminate foreign jobs, include this cn=100
+    # @option options zc [String]  Zipcode or City,State or State (TN or Tennessee) Examples : zc=TN, zc=23454, zc=Nashville%2CTN Default radius is 25 miles, value should be URLEncoded
+    # @option options zc1 and rd1 [String] Same as above, only you can provide a number of miles from this set of numbers for rd1 : 5,10,15,25,50,100,300, value should be URLEncoded Zc1=Indianapolis%2CIN&rd1=50
+    # @option options cname [String]  All or part of a company name, value should be URLEncoded
+    # @option options i [String] Values e or s for employers or staffing firms only
+    # @option options moc [String] Moc code, retrieves a mapped Onet code, which is used to search
+    # @option options rank [String] Further qualifies the mappings for moc
+    # @option options branch [String] Further qualifies the mappings for moc
+    # @option options so [String] One of two values, “relevance”, or “initdate”, Default if nothing is passed is relevance
+    # @option options rs [String] Start row, from 1 to 500
+    # @option options re [String] End row, from 1 to 500
+    # @option options si [String] Search id, as described above
+    # @return [Array<Hashie::Mash>] 
+    # @example
+    #   DirectEmployers.search({:moc => "11b"})
+    def search(options={})
+      get("api.asp", options)
+    end
+
+  end
+end

data/lib/direct_employers/connection.rb

@@ -0,0 +1,17 @@
+require 'faraday_middleware'
+
+module DirectEmployers
+  module Connection
+    private
+
+    def connection
+      Faraday.new(:url => 'http://www.jobcentral.com') do |connection|
+        connection.use Faraday::Request::UrlEncoded
+        connection.use Faraday::Response::RaiseError
+        connection.use Faraday::Response::Rashify
+        connection.use Faraday::Response::ParseXml
+        connection.adapter(Faraday.default_adapter)
+      end
+    end
+  end
+end

data/lib/direct_employers/request.rb

@@ -0,0 +1,16 @@
+module DirectEmployers
+  module Request
+    def get(path, options={})
+      request(:get, path, options)
+    end
+
+    private
+
+    def request(method, path, options)
+      response = connection.send(method) do |request|
+        request.url(path, options)
+      end
+      response.body
+    end
+  end
+end

data/lib/direct_employers/version.rb

@@ -0,0 +1,3 @@
+module DirectEmployers
+  VERSION = "0.0.1"
+end

data/spec/direct_employers/client_spec.rb

@@ -0,0 +1,35 @@
+require 'helper'
+
+describe DirectEmployers::Client do
+  before do
+    @client = DirectEmployers::Client.new
+  end
+
+  describe "#search" do
+    context "with no query parameters" do
+      before do
+        stub_get("api.asp?key=abc123").
+          to_return(:status => 200, :body => fixture("search_to_broad.xml"))
+      end
+
+      it "should return search to broad" do
+        search = @client.search(:key => "abc123")
+        a_get("api.asp?key=abc123").should have_been_made
+        search.api.error.should == "Search Too Broad"
+      end
+    end
+
+    context "with query parameter moc code 11b" do
+      before do
+        stub_get("api.asp?key=abc123&moc=11b").
+          to_return(:status => 200, :body => fixture("11bquery.xml"))
+      end
+
+      it "should return a list of jobs with moc code 11b" do
+        search = @client.search(:key => "abc123", :moc => "11b")
+        a_get("api.asp?key=abc123&moc=11b").should have_been_made
+        search.api.query.should == "First-Line Supervisors/Managers of Weapons Specialists/Crew Members, Infantry"
+      end
+    end
+  end
+end

data/spec/direct_employers_spec.rb

@@ -0,0 +1,9 @@
+require 'helper'
+
+describe DirectEmployers do
+  describe ".new" do
+    it "should return a DirectEmployers::Client" do
+      DirectEmployers.new.should be_a DirectEmployers::Client
+    end
+  end
+end

data/spec/fixtures/11bquery.xml

@@ -0,0 +1 @@
+<api version="1.0"><id>234794927</id><time>6/1/2011 7:59:55 PM</time><error></error><machine>query://desearch4/dejobs</machine><query>First-Line Supervisors/Managers of Weapons Specialists/Crew Members, Infantry</query><recordcount>11</recordcount><startrow>1</startrow><endrow>10</endrow><order>relevance</order><jobs><job><title>Military Service Member</title><url>http://jcnlx.com/d165e04d810246d7b4d25fcb74855631272</url><company>Tennessee Employer</company><location>Union City, TN</location><dateacquired>2010-12-30 8:31 PM</dateacquired></job><job><title>Military Service Member</title><url>http://jcnlx.com/bf5b9903023f4674ab8033559c74b413272</url><company>Tennessee Employer</company><location>Martin, TN</location><dateacquired>2010-12-30 8:31 PM</dateacquired></job><job><title>US ARMY INFANTRY SOLDIER</title><url>http://jcnlx.com/eb9efa09daa14bc6b8a6efc5e75f6af5272</url><company>U.s Army</company><location>Visalia, CA</location><dateacquired>2011-4-21 0:35 AM</dateacquired></job><job><title>U.S. Marine Corps</title><url>http://jcnlx.com/60c916a415794e70aa2fa194487481c8272</url><company>South Dakota Employer</company><location>Huron, SD</location><dateacquired>2011-4-6 10:16 AM</dateacquired></job><job><title>SD Army National Guard Soldier</title><url>http://jcnlx.com/1288724d4c424ccb891ad3d1f108e415272</url><company>South Dakota Employer</company><location>Huron, SD</location><dateacquired>2011-4-6 10:16 AM</dateacquired></job><job><title>Infantry</title><url>http://jcnlx.com/690950d7479d4cdc8258d87cfd77c35f272</url><company>United States Army Recruiting</company><location>South Burlington, VT</location><dateacquired>2011-1-12 11:00 PM</dateacquired></job><job><title>Manager Trainee</title><url>http://jcnlx.com/23ac1681bc7f42a384ab32220df7edb1272</url><company>Belgrade Fixtures</company><location>Belgrade, MN</location><dateacquired>2011-1-7 0:47 AM</dateacquired></job><job><title>Infant Assistant</title><url>http://jcnlx.com/9c4445f6f0be4da59a9ab2e8840a3ce0272</url><company>Little Rascals Child Care</company><location>New Ulm, MN</location><dateacquired>2011-1-7 0:47 AM</dateacquired></job><job><title>AMERICAN SOLDIER</title><url>http://jcnlx.com/08dc0115df4b4136ba5030c5c3b01367272</url><company>Tennessee Employer</company><location>Columbia, TN</location><dateacquired>2011-5-11 9:18 PM</dateacquired></job><job><title>Army Soldier</title><url>http://jcnlx.com/15d15799f7fd4cecb8a345c4842ac488272</url><company>South Dakota Employer</company><location>Huron, SD</location><dateacquired>2011-5-4 10:16 AM</dateacquired></job></jobs></api>

data/spec/fixtures/search_to_broad.xml

@@ -0,0 +1 @@
+<api version="1.0"><error>Search Too Broad</error></api>

data/spec/helper.rb

@@ -0,0 +1,47 @@
+$:.unshift File.expand_path('..', __FILE__)
+$:.unshift File.expand_path('../../lib', __FILE__)
+require 'simplecov'
+SimpleCov.start
+require 'direct_employers'
+require 'rspec'
+require 'webmock/rspec'
+
+def a_delete(path)
+  a_request(:delete, 'http://www.jobcentral.com/' + path)
+end
+
+def a_get(path)
+  a_request(:get, 'http://www.jobcentral.com/' + path)
+end
+
+def a_post(path)
+  a_request(:post, 'http://www.jobcentral.com/' + path)
+end
+
+def a_put(path)
+  a_request(:put, 'http://www.jobcentral.com/' + path)
+end
+
+def stub_delete(path)
+  stub_request(:delete, 'http://www.jobcentral.com/' + path)
+end
+
+def stub_get(path)
+  stub_request(:get, 'http://www.jobcentral.com/' + path)
+end
+
+def stub_post(path)
+  stub_request(:post, 'http://www.jobcentral.com/' + path)
+end
+
+def stub_put(path)
+  stub_request(:put, 'http://www.jobcentral.com/' + path)
+end
+
+def fixture_path
+  File.expand_path('../fixtures', __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end

metadata

@@ -0,0 +1,216 @@
+--- !ruby/object:Gem::Specification
+name: direct_employers
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Erik Michaels-Ober
+- Ryan Resella
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-06-06 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ZenTest
+  requirement: &2156115980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.5'
+  type: :development
+  prerelease: false
+  version_requirements: *2156115980
+- !ruby/object:Gem::Dependency
+  name: maruku
+  requirement: &2156115200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: *2156115200
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2156114720 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: *2156114720
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2156114220 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: *2156114220
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &2156113580 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: *2156113580
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: &2156112780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: *2156112780
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &2156112080 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: *2156112080
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: &2156111320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156111320
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: &2156110600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156110600
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: &2156109720 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156109720
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: &2156108960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156108960
+- !ruby/object:Gem::Dependency
+  name: multi_xml
+  requirement: &2156108160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156108160
+- !ruby/object:Gem::Dependency
+  name: rash
+  requirement: &2156107440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *2156107440
+description: Ruby Wrapper for the Direct Employers API
+email:
+- erik@codeforamerica.org
+- ryan@codeforamerica.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .autotest
+- .gemtest
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- direct_employers.gemspec
+- lib/direct_employers.rb
+- lib/direct_employers/client.rb
+- lib/direct_employers/connection.rb
+- lib/direct_employers/request.rb
+- lib/direct_employers/version.rb
+- spec/direct_employers/client_spec.rb
+- spec/direct_employers_spec.rb
+- spec/fixtures/11bquery.xml
+- spec/fixtures/search_to_broad.xml
+- spec/helper.rb
+homepage: https://github.com/codeforamerica.org/direct_employers
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: ''
+test_files:
+- spec/direct_employers/client_spec.rb
+- spec/direct_employers_spec.rb
+- spec/fixtures/11bquery.xml
+- spec/fixtures/search_to_broad.xml
+- spec/helper.rb