teamtailor 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9464bec7bd58b5a5b47dc4cd5fd2aa91710f82602f658d4a1981cff33d42bc1
-  data.tar.gz: f1e218de0ce3dd7ebb78ebdd29c44ad2bfb49680b226186a18b5f18e23d2c654
+  metadata.gz: ca640f45eb147f4845e8f8416728ca7037d827c1e4bcb297cb7f02e15182805a
+  data.tar.gz: 89dacf02df2d3e7030ae54a700a7f85e5394930d5e773cc586ba639d4ab176fa
 SHA512:
-  metadata.gz: db6d877077e001925903a29694918110f02c85bdb3e3c10bc80df415bf5f9b0e463e2f606380f9c26f391e49ea0f6cb86416989afe00df4883df335fac947794
-  data.tar.gz: a27532d72dd0cfd872392af29ff3e81665a1fd61ff27f065801f815fc14b2928d72950e5cef3b14e27fd058308faaba2afd5ed1285c4c67ada6826599a841e39
+  metadata.gz: ff38baf2344ed08916fc5f8e46f3a58ba19a7fceb335d8abd73ab8a155a769c36a8ee18ec9d94044ffe0e64a61d357680e5a933791743d4831e5b960e61f1070
+  data.tar.gz: b1cf2365d600ea53d6998faef1ef9d4ac884c63f109b16d91af58b2166e6fce817f316d53c7e026179f0ff16ef14c5695b32f9982548b8464bcc1988c6cf89e3

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+## Unreleased
+
+## v0.2.0 - 2020-03-31
+
+- Add support for accessing relationships on records (`1218aa`)
+- Add support for including relationships when querying the API (`90f25d`)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    teamtailor (0.1.0)
+    teamtailor (0.2.0)
       typhoeus (~> 1.3.1)
 
 GEM

data/lib/teamtailor/client.rb

@@ -10,7 +10,7 @@ module Teamtailor
       @api_version = api_version
     end
 
-    def candidates(page: 1)
+    def candidates(page: 1, include: [])
       Teamtailor::Request.new(
         base_url: base_url,
         api_token: api_token,
@@ -18,12 +18,13 @@ module Teamtailor
         path: '/v1/candidates',
         params: {
           'page[number]' => page,
-          'page[size]' => 30
+          'page[size]' => 30,
+          'include' => include.join(',')
         }
       ).call
     end
 
-    def jobs(page: 1)
+    def jobs(page: 1, include: [])
       Teamtailor::Request.new(
         base_url: base_url,
         api_token: api_token,
@@ -31,12 +32,13 @@ module Teamtailor
         path: '/v1/jobs',
         params: {
           'page[number]' => page,
-          'page[size]' => 30
+          'page[size]' => 30,
+          'include' => include.join(',')
         }
       ).call
     end
 
-    def users(page: 1)
+    def users(page: 1, include: [])
       Teamtailor::Request.new(
         base_url: base_url,
         api_token: api_token,
@@ -44,7 +46,8 @@ module Teamtailor
         path: '/v1/users',
         params: {
           'page[number]' => page,
-          'page[size]' => 30
+          'page[size]' => 30,
+          'include' => include.join(',')
         }
       ).call
     end

data/lib/teamtailor/error.rb

@@ -24,4 +24,6 @@ module Teamtailor
   class JSONError < ClientError; end
 
   class UnknownResponseTypeError < ClientError; end
+
+  class UnloadedRelationError < ClientError; end
 end

data/lib/teamtailor/parser/candidate.rb

@@ -1,31 +1,23 @@
-module Teamtailor
-  class Candidate
-    def initialize(payload)
-      @payload = payload
-    end
+# frozen_string_literal: true
 
+require 'teamtailor/record'
+
+module Teamtailor
+  class Candidate < Record
     def self.deserialize(value)
       new(value)
     end
 
     def serialize
-      payload
+      data
     end
 
     def id
-      payload.dig('id').to_i
+      data.dig('id').to_i
     end
 
     def connected?
-      payload.dig('attributes', 'connected')
+      data.dig('attributes', 'connected')
     end
-
-    def method_missing(m)
-      payload.dig('attributes', m.to_s.gsub('_', '-'))
-    end
-
-    private
-
-    attr_reader :payload
   end
 end

data/lib/teamtailor/parser/job.rb

@@ -1,31 +1,19 @@
-module Teamtailor
-  class Job
-    def initialize(payload)
-      @payload = payload
-    end
+# frozen_string_literal: true
+
+require 'teamtailor/record'
 
+module Teamtailor
+  class Job < Record
     def self.deserialize(value)
       new(value)
     end
 
     def serialize
-      payload
-    end
-
-    def id
-      payload.dig('id').to_i
+      data
     end
 
     def careersite_job_url
-      payload.dig('links', 'careersite-job-url')
-    end
-
-    def method_missing(m)
-      payload.dig('attributes', m.to_s.gsub('_', '-'))
+      data.dig('links', 'careersite-job-url')
     end
-
-    private
-
-    attr_reader :payload
   end
 end

data/lib/teamtailor/parser/user.rb

@@ -1,27 +1,19 @@
-module Teamtailor
-  class User
-    def initialize(payload)
-      @payload = payload
-    end
+# frozen_string_literal: true
 
+require 'teamtailor/record'
+
+module Teamtailor
+  class User < Record
     def self.deserialize(value)
       new(value)
     end
 
     def serialize
-      payload
+      data
     end
 
     def id
-      payload.dig('id').to_i
+      data.dig('id').to_i
     end
-
-    def method_missing(m)
-      payload.dig('attributes', m.to_s.gsub('_', '-'))
-    end
-
-    private
-
-    attr_reader :payload
   end
 end

data/lib/teamtailor/parser.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'teamtailor/relationship'
 require 'teamtailor/parser/candidate'
 require 'teamtailor/parser/job'
 require 'teamtailor/parser/user'
@@ -13,12 +14,12 @@ module Teamtailor
     def parse
       data.map do |record|
         case record&.dig('type')
-        when 'candidates' then Teamtailor::Candidate.new(record)
-        when 'jobs' then Teamtailor::Job.new(record)
-        when 'users' then Teamtailor::User.new(record)
+        when 'candidates' then Teamtailor::Candidate.new(record, included)
+        when 'jobs' then Teamtailor::Job.new(record, included)
+        when 'users' then Teamtailor::User.new(record, included)
 
         else
-          raise Teamtailor::UnknownResponseTypeError.new(record&.dig('type'))
+          raise Teamtailor::UnknownResponseTypeError, record&.dig('type')
         end
       end
     end
@@ -34,5 +35,9 @@ module Teamtailor
     def data
       [payload&.dig('data')].flatten
     end
+
+    def included
+      payload&.dig('included')
+    end
   end
 end

data/lib/teamtailor/record.rb

@@ -0,0 +1,30 @@
+module Teamtailor
+  class Record
+    def initialize(data, included = {})
+      @data = data
+      @included = included
+    end
+
+    def method_missing(m)
+      if m == :id
+        data.dig('id').to_i
+      elsif relationship_keys.include?(m.to_s.gsub('_', '-'))
+        build_relationship(m.to_s.gsub('_', '-'))
+      else
+        data.dig('attributes', m.to_s.gsub('_', '-'))
+      end
+    end
+
+    private
+
+    attr_reader :data, :included
+
+    def build_relationship(name)
+      Teamtailor::Relationship.new(name, data.dig('relationships'), included)
+    end
+
+    def relationship_keys
+      data.dig('relationships')&.keys || {}
+    end
+  end
+end

data/lib/teamtailor/relationship.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Teamtailor
+  class Relationship
+    def initialize(relation_name, relationships = {}, included = {})
+      @relation_name = relation_name
+      @relationships = relationships
+      @included = included
+    end
+
+    def loaded?
+      !record_id.nil?
+    end
+
+    def record
+      raise Teamtailor::UnloadedRelationError unless loaded?
+
+      record_json = included.find do |k|
+        k['id'] == record_id && k['type'] == record_type
+      end
+
+      Teamtailor::Parser.parse({ 'data' => record_json }).first
+    end
+
+    private
+
+    def record_id
+      relationships&.dig(relation_name, 'data', 'id')
+    end
+
+    def record_type
+      relationships&.dig(relation_name, 'data', 'type')
+    end
+
+    attr_reader :relation_name, :relationships, :included
+  end
+end

data/lib/teamtailor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Teamtailor
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

data/teamtailor.gemspec

@@ -14,8 +14,8 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
 
   spec.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://github.com/bzf/teamtailor-gem'
-  spec.metadata['changelog_uri'] = 'https://github.com/bzf/teamtailor-gem/master/CHANGELOG.md'
+  spec.metadata['source_code_uri'] = 'https://github.com/bzf/teamtailor-rb'
+  spec.metadata['changelog_uri'] = 'https://github.com/bzf/teamtailor-rb/master/CHANGELOG.md'
 
   spec.add_development_dependency 'rspec', '~> 3.2'
   spec.add_dependency 'typhoeus', '~> 1.3.1'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: teamtailor
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - André Ligné
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-03-27 00:00:00.000000000 Z
+date: 2020-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -48,6 +48,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -63,6 +64,8 @@ files:
 - lib/teamtailor/parser/candidate.rb
 - lib/teamtailor/parser/job.rb
 - lib/teamtailor/parser/user.rb
+- lib/teamtailor/record.rb
+- lib/teamtailor/relationship.rb
 - lib/teamtailor/request.rb
 - lib/teamtailor/version.rb
 - teamtailor.gemspec
@@ -71,8 +74,8 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/bzf/teamtailor-gem
-  source_code_uri: https://github.com/bzf/teamtailor-gem
-  changelog_uri: https://github.com/bzf/teamtailor-gem/master/CHANGELOG.md
+  source_code_uri: https://github.com/bzf/teamtailor-rb
+  changelog_uri: https://github.com/bzf/teamtailor-rb/master/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths: