Merge pull request #23 from grnhse/theshanx-master

Add methods to retrieve offers for an application (#22)

CHANGES.md

@@ -2,6 +2,12 @@
 
 This project follows [semantic versioning](http://semver.org/).  This changelog follows suggestions from [keepachangelog.com](http://keepachangelog.com/).
 
+## Version 2.5.0
+Released 2016-05-31.  Contributed by [@theshanx](https://github.com/theshanx).  Thanks!  :)
+
+#### Added
+- Added methods for retrieving offers for an application: `current_offer_for_application` and `offers_for_application`
+
 ## Version 2.4.0
 Released 2016-04-20.  Contributed by [@mariochavez](https://github.com/mariochavez) -- thank you!
 

README.md

@@ -183,6 +183,8 @@ Methods for which an `id` is **required**:
 * `activity_feed` *(requires a candidate ID)*
 * `scorecards` *(requires an application ID)*
 * `scheduled_interviews` *(requires an application ID)*
+* `offers_for_application` *(requires an application ID)*
+* `current_offer_for_application` *(requires an application ID)*
 * `stages` *(requires a job ID)*
 * `job_post` *(requires a job ID)*
 * `create_candidate_note` *(requires a candidate ID)*

lib/greenhouse_io/api/client.rb

@@ -44,6 +44,14 @@ def applications(id = nil, options = {})
       get_from_harvest_api "/applications#{path_id(id)}", options
     end
 
+    def offers_for_application(id, options = {})
+      get_from_harvest_api "/applications/#{id}/offers", options
+    end
+
+    def current_offer_for_application(id, options = {})
+      get_from_harvest_api "/applications/#{id}/offers/current_offer", options
+    end
+
     def scorecards(id, options = {})
       get_from_harvest_api "/applications/#{id}/scorecards", options
     end

lib/greenhouse_io/version.rb

@@ -1,3 +1,3 @@
 module GreenhouseIo
-  VERSION = "2.4.0"
+  VERSION = "2.5.0"
 end

spec/greenhouse_io/api/client_spec.rb

@@ -634,5 +634,46 @@
         end
       end
     end
+
+    describe "#offers_for_application" do
+      before do
+        VCR.use_cassette('client/offers_for_application') do
+          @offers = @client.offers_for_application(123)
+        end
+      end
+
+      it "returns a response" do
+        expect(@offers).to_not be_nil
+      end
+
+      it "returns an array of offers" do
+        expect(@offers).to be_an_instance_of(Array)
+
+        return unless @offers.size > 0
+        expect(@offers.first).to have_key(:application_id)
+        expect(@offers.first).to have_key(:version)
+        expect(@offers.first).to have_key(:status)
+      end
+    end
+
+    describe "#current_offer_for_application" do
+      before do
+        VCR.use_cassette('client/current_offer_for_application') do
+          @offer = @client.current_offer_for_application(123)
+        end
+      end
+
+      it "returns a response" do
+        expect(@offer).to_not be_nil
+      end
+
+      it "returns an offer object" do
+        expect(@offer).to be_an_instance_of(Hash)
+        expect(@offer[:id]).to be_a(Integer).and be > 0
+        expect(@offer[:created_at]).to be_a(String)
+        expect(@offer[:version]).to be_a(Integer).and be > 0
+        expect(@offer[:status]).to be_a(String)
+      end
+    end
   end
 end