taleo 0.1.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3505c96292845b1dda78301ca8e18e574e9d9266e05847e8ecf74cbf2e9c55ca
-  data.tar.gz: 5b8c227d7172c084593b88c8786967227ebccbb0f25aab94d077a530904a0072
+  metadata.gz: a6324fb24d7887a2ce1b64e78be566b5166a0176351a4eb06fcbe9204f5c9bed
+  data.tar.gz: e817de316ddfa86c845c3cc7bb3ce5634851d2beadf541d717554941bb31f5a9
 SHA512:
-  metadata.gz: 8ca8e8a4c7469efe647c30aa99510c50f673f59f950562756ec234752ad3fa59ec0b78f3089963300c136c2382ba8d2b5845289935adca5b7003df2131383de3
-  data.tar.gz: 86d0bad4f16219e2c2c1d969eb6690523f8784d6a771833d2b5e002aac83a36e03148e40fea052c685b4599df97bdf6be4bf92b3c3cbda5d63d6e1ee9c39b113
+  metadata.gz: 14b52d69ffe8a05775e360aa975c3876bcce1176fae2ff3442c9b5c71c8c1be81dd735d092772aa26d4deab2c3bc5ade0b626afb3f7da429cc297712f8421126
+  data.tar.gz: 7dc5324f2c20119468ccbae40962d72ec753ab88dced758e7572ad056f79727789789c6e3485fba0b3bbba61d4ccf650a2a54ff4926765e8cc7dad94ffdf19a3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    taleo (0.1.1)
+    taleo (0.6.0)
       faraday (~> 1.0)
 
 GEM
@@ -14,8 +14,9 @@ GEM
       safe_yaml (~> 1.0.0)
     diff-lcs (1.4.4)
     docile (1.3.2)
-    faraday (1.0.1)
+    faraday (1.1.0)
       multipart-post (>= 1.2, < 3)
+      ruby2_keywords
     hashdiff (1.0.0)
     json (2.3.1)
     multi_json (1.15.0)
@@ -39,6 +40,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-support (3.9.3)
+    ruby2_keywords (0.0.2)
     safe_yaml (1.0.5)
     simplecov (0.17.1)
       docile (~> 1.1)
@@ -72,7 +74,7 @@ DEPENDENCIES
   rspec (~> 3.0)
   simplecov (~> 0.17.1)
   sinatra (~> 2.0)
-  sinatra-contrib
+  sinatra-contrib (~> 2.0)
   taleo!
   webmock (~> 3.6)
   yard

data/README.md

@@ -1,9 +1,17 @@
 # Taleo
 
-[![Maintainability](https://api.codeclimate.com/v1/badges/18630172a2dc24e7ace1/maintainability)](https://codeclimate.com/github/paulholden2/taleo/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/18630172a2dc24e7ace1/test_coverage)](https://codeclimate.com/github/paulholden2/taleo/test_coverage)
+[![Gem Version](https://badge.fury.io/rb/taleo.svg)](https://badge.fury.io/rb/taleo) [![Build Status](https://travis-ci.org/paulholden2/taleo.svg?branch=master)](https://travis-ci.org/paulholden2/taleo) [![Inline docs](http://inch-ci.org/github/paulholden2/taleo.svg?branch=master)](http://inch-ci.org/github/paulholden2/taleo) [![Maintainability](https://api.codeclimate.com/v1/badges/18630172a2dc24e7ace1/maintainability)](https://codeclimate.com/github/paulholden2/taleo/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/18630172a2dc24e7ace1/test_coverage)](https://codeclimate.com/github/paulholden2/taleo/test_coverage)
 
 A library for using the Taleo REST API.
 
+**Note**: A Nov 2020 change to the Taleo API requires at least one search
+criteria be passed to employee searches (performed by `client#employees` to
+retrieve paged results). Versions prior to 0.6 do not support passing search
+parameters, and as such you should not use them if you need to utilize
+employee searches. See the Taleo REST API guide
+[here](https://www.oracle.com/technical-resources/documentation/taleobusiness.html)
+for more information.
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/lib/taleo/client.rb

@@ -9,7 +9,7 @@ require 'taleo/employee'
 module Taleo
   # Base object for executing queries and wrapping HTTP requests.
   class Client
-    attr_reader :org_code, :username, :password, :service_url
+    attr_reader :org_code, :username, :password, :service_url, :auth_token
 
     def initialize(org_code, username, password, service_url)
       @org_code = org_code
@@ -34,14 +34,16 @@ module Taleo
       Activity.new(show('activity', id), self)
     end
 
-    def employees
-      cursor('employee', Employee)
+    def employees(start = 1, limit = 10, params: {})
+      raise ArgumentError, "At least one query parameter is required " \
+                           "for employee search" if params.keys.size.zero?
+      cursor('employee', Employee, start, limit, params: params)
     end
 
-    def cursor(resource, klass, start = 1, limit = 10)
+    def cursor(resource, klass, start = 1, limit = 10, params: {})
       res = connection.get do |req|
         req.url "object/#{resource}/search"
-        req.params.merge!({
+        req.params.merge!(params).merge!({
           'start' => start,
           'limit' => limit
         })
@@ -49,7 +51,8 @@ module Taleo
       data = JSON.parse(res.body)
       pagination = data.dig('response', 'pagination')
       results = data.dig('response', 'searchResults')
-      Cursor.new(pagination, results, resource, klass, self)
+      cursor = Cursor.new(pagination, results, resource, klass, self)
+      cursor.self_page
     end
 
     def show(resource, id)
@@ -120,11 +123,5 @@ module Taleo
       @api_url = data.dig('response', 'URL')
       @api_url
     end
-
-    private
-
-    def auth_token
-      @auth_token
-    end
   end
 end

data/lib/taleo/cursor.rb

@@ -27,6 +27,18 @@ module Taleo
       pagination.key?('previous')
     end
 
+    def has_self?
+      pagination.key?('self')
+    end
+
+    def self_page
+      res = client.connection.get do |req|
+        req.url pagination.fetch('self')
+      end
+
+      new_cursor(res)
+    end
+
     def next_page
       raise Taleo::Error.new('No further results') unless has_next?
 

data/lib/taleo/employee.rb

@@ -3,6 +3,7 @@
 require 'taleo/resource'
 require 'taleo/candidate'
 require 'taleo/packet'
+require 'taleo/location'
 
 module Taleo
   # Stub for Packet resource class
@@ -13,7 +14,40 @@ module Taleo
       data.fetch('employeeId')
     end
 
+    def first_name
+      data.fetch('firstName')
+    end
+
+    def last_name
+      data.fetch('lastName')
+    end
+
+    def location_id
+      data.fetch('location')
+    end
+
+    def ssn
+      data.fetch('ssn')
+    end
+
     has_one :candidate, Candidate
+    has_one :location, Location
     has_many :packets, Packet, singular: 'packet', plural: 'activityPackets'
+    has_many :attachments, Attachment, singular: 'attachment', through: 'attachment'
+
+    # Override since employee relationship URLs will not include an
+    # attachments URL
+    def has_attachments?
+      true
+    end
+
+    # Annoying hack since the employee resource relationship URLs hash
+    # doesn't include an attachments link, even if there are attachments.
+    def relationship_urls
+      urls = super
+      urls.merge({
+        'attachment' => urls.fetch('historylog').gsub(/historylog$/, 'attachment')
+      })
+    end
   end
 end

data/lib/taleo/location.rb

@@ -0,0 +1,13 @@
+require 'taleo/resource'
+
+module Taleo
+  class Location < Resource
+    def id
+      data.fetch('id')
+    end
+
+    def name
+      data.fetch('locationName')
+    end
+  end
+end

data/lib/taleo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Taleo
-  VERSION = '0.1.1'
+  VERSION = '0.6.0'
 end

data/taleo.gemspec

@@ -34,7 +34,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'faraday', '~> 1.0'
 
   spec.add_development_dependency 'sinatra', '~> 2.0'
-  spec.add_development_dependency 'sinatra-contrib'
+  spec.add_development_dependency 'sinatra-contrib', '~> 2.0'
   spec.add_development_dependency 'webmock', '~> 3.6'
   spec.add_development_dependency 'yard'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: taleo
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.6.0
 platform: ruby
 authors:
 - Paul Holden
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-10-22 00:00:00.000000000 Z
+date: 2020-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -42,16 +42,16 @@ dependencies:
   name: sinatra-contrib
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -105,6 +105,7 @@ files:
 - lib/taleo/client.rb
 - lib/taleo/cursor.rb
 - lib/taleo/employee.rb
+- lib/taleo/location.rb
 - lib/taleo/packet.rb
 - lib/taleo/resource.rb
 - lib/taleo/version.rb