zaikio-directory 0.0.5 → 0.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ee582c20c55f62a0b07e24dc51924982c4ed5fb0e8853c92042c1485ff91319
-  data.tar.gz: 8f886aae2708711336ca2a2911beeb8a769680cd821334f7525ce9f01b544f6d
+  metadata.gz: 26d6a02aea4964a306cbb0dbd0a72232aa064e13a5b168b3e1a4f9eab78f4dbe
+  data.tar.gz: 8112dac6c53620e836c39f1c33838ef4a2d059deee71c12292c05a717f836a0e
 SHA512:
-  metadata.gz: 0152acb74f6a20207cc649d4f7e8d0ced6c78d54480ba81411d933146bd6af0b4fb33f4e604b07107ab265c1e7822a110d05d13a947bc454a449b24da26661c4
-  data.tar.gz: f4b338c8f5853fb6b8ef594d2d1b2ef08de1b6b8860d1e31fec189a7a847810e0a8af58f3702cf4f91265c2d31080530e30486fe62a353a42443f0e110527b97
+  metadata.gz: b612f4b4bac78dbed24d840ecbe3ce5eb05ddf2f7105c3a8f1c050eda076d4b793ed886c85d83466b691cebd4aee53dbe0939d31eb2c273dd1a6f8bab825ee9e
+  data.tar.gz: 8c38ce7c669744039a576c91ff9b8e48b90cbd6f5b3e4857d221f34004c9bb06237aaa513b0a47899cc218dc781482c3fd914f82f88bc07558dc84d63bc50ce9

data/README.md

@@ -26,7 +26,7 @@ $ gem install zaikio-directory
 # config/initializers/zaikio_directory.rb
 
 Zaikio::Directory.configure do |config|
-  config.host :production # sandbox or production
+  config.environment = :production # sandbox or production
 end
 ```
 
@@ -106,3 +106,38 @@ Zaikio::Directory.with_token(token) do
   Zaikio::Directory::RevokedAccessToken.create
 end
 ```
+
+### Error Handling
+
+If an unexpected error occurs with an API call (i.e. an error that has no status code `2xx`, `404` or `422`) then a `Zaikio::ConnectionError` is thrown automatically (for `404` there will be a `Zaikio::ResourceNotFound`).
+
+This can be easily caught using the `with_fallback` method. We recommend to always work with fallbacks.
+
+```rb
+Zaikio::Directory.with_token(token) do
+  person = Zaikio::Directory::CurrentPerson
+           .find_with_fallback(Zaikio::Directory::CurrentPerson.new(full_name: "Hello World"))
+
+  person.organizations # Automatically uses empty array as fallback
+end
+
+Zaikio::Directory.with_token(token) do
+  organization = Zaikio::Directory::CurrentOrganization.new
+
+  organization.machines.with_fallback.all
+  organization.machines
+    .with_fallback(Zaikio::Directory::Machine.new(name: 'My Machine'))
+    .find('machine-id')
+
+
+  organization.machines
+    .with_fallback(Zaikio::Directory::Machine.new(name: 'My Machine'))
+    .find('machine-does-not-exist') # => raises Zaikio::ResourceNotFound
+
+  begin
+    organization.machines.create(name: "Machine Name")
+  rescue Zaikio::ConnectionError
+    # Do something
+  end
+end
+```

data/lib/zaikio/directory.rb

@@ -6,13 +6,16 @@ require "zaikio/directory/authorization_middleware"
 require "zaikio/directory/basic_auth_middleware"
 
 # Models
+require "zaikio/error"
 require "zaikio/directory/base"
+require "zaikio/directory/asset"
 require "zaikio/directory/organization_membership"
 require "zaikio/directory/business_relationship"
 require "zaikio/directory/organization"
 require "zaikio/directory/person"
 require "zaikio/directory/machine"
 require "zaikio/directory/software"
+require "zaikio/directory/specialist"
 require "zaikio/directory/site"
 require "zaikio/directory/membership"
 require "zaikio/directory/current_person"
@@ -69,14 +72,15 @@ module Zaikio
 
       private
 
-      def create_token_data(payload)
+      def create_token_data(payload) # rubocop:disable Metrics/AbcSize
         subjects = payload["sub"].split(">")
 
         OpenStruct.new(
           audience: payload["aud"].first,
           on_behalf_of_id: subjects.first.split("/").last,
           subject_id: subjects.last.split("/").last,
-          subject_type: subjects.last.split("/").first
+          subject_type: subjects.last.split("/").first,
+          scopes: payload["scope"]
         )
       end
     end

data/lib/zaikio/directory/asset.rb

@@ -0,0 +1,55 @@
+module Zaikio
+  module Directory
+    module Asset
+      extend ActiveSupport::Concern
+
+      included do
+        # Callbacks
+        after_create :make_organization_owner
+      end
+
+      def make_organization_owner
+        if Zaikio::Directory.current_token_data.subject_type == "Organization"
+          self.class.request(:post,
+                             "#{collection_name}/#{id}/#{singular_name}_ownership")
+        else
+          org_path = "person/organizations/#{organization_id}"
+          self.class.request(:post,
+                             "#{org_path}/#{collection_name}/#{id}/#{singular_name}_ownership")
+        end
+      end
+
+      def destroy
+        if Zaikio::Directory.current_token_data.subject_type == "Organization"
+          self.class.request(:delete,
+                             "#{collection_name}/#{id}/#{singular_name}_ownership")
+        else
+          org_path = "person/organizations/#{owner_id || organization_id}"
+          self.class.request(:delete,
+                             "#{org_path}/#{collection_name}/#{id}/#{singular_name}_ownership")
+        end
+      end
+
+      def specification
+        prefix = if Zaikio::Directory.current_token_data.subject_type == "Person"
+                   "person/organizations/#{owner_id || organization_id}/"
+                 else
+                   ""
+                 end
+        self.class.request(:get,
+                           "#{prefix}#{collection_name}/#{id}/#{singular_name}_specification")
+            &.body&.dig("data")
+      end
+
+      private
+
+      def collection_name
+        self.class.name.demodulize.underscore.pluralize
+      end
+
+      def singular_name
+        self.class.name.demodulize.underscore
+      end
+    end
+  end
+end

data/lib/zaikio/directory/authorization_middleware.rb

@@ -9,7 +9,7 @@ module Zaikio
       end
 
       def self.token(token = nil)
-        @token = token || @token
+        @token ||= token
       end
 
       def call(request_env)

data/lib/zaikio/directory/basic_auth_middleware.rb

@@ -9,7 +9,7 @@ module Zaikio
       end
 
       def self.credentials(credentials = nil)
-        @credentials = credentials || @credentials
+        @credentials ||= credentials
       end
 
       def call(request_env)

data/lib/zaikio/directory/current_organization.rb

@@ -9,24 +9,34 @@ module Zaikio
         all.find_one
       end
 
+      def self.find_with_fallback(fallback)
+        all.with_fallback(fallback).find_one
+      end
+
       # Associations
       has_many :memberships,             class_name: "Zaikio::Directory::Membership",
-                                         uri: "organization/memberships"
+                                         uri: "organization/memberships(/:id)"
       has_many :business_relationships,  class_name: "Zaikio::Directory::BusinessRelationship",
-                                         uri: "organization/business_relationships"
+                                         uri: "organization/business_relationships(/:id)"
       has_many :software,                class_name: "Zaikio::Directory::Software",
-                                         uri: "software"
+                                         uri: "software(/:id)"
       has_many :machines,                class_name: "Zaikio::Directory::Machine",
-                                         uri: "machines"
+                                         uri: "machines(/:id)"
+      has_many :specialists,             class_name: "Zaikio::Directory::Specialist",
+                                         uri: "specialists(/:id)"
       has_many :sites,                   class_name: "Zaikio::Directory::Site",
-                                         uri: "sites"
+                                         uri: "sites(/:id)"
 
       def fetch
         self.attributes = get
       end
 
+      def reload
+        self.attributes = self.class.find.attributes
+      end
+
       def members
-        memberships.map(&:person)
+        memberships.with_fallback.map(&:person)
       end
     end
   end

data/lib/zaikio/directory/current_person.rb

@@ -9,6 +9,10 @@ module Zaikio
         all.find_one
       end
 
+      def self.find_with_fallback(fallback)
+        all.with_fallback(fallback).find_one
+      end
+
       # Associations
       has_many :organization_memberships, class_name: "Zaikio::Directory::OrganizationMembership",
                                           uri: nil
@@ -18,7 +22,7 @@ module Zaikio
       end
 
       def organizations
-        organization_memberships.map(&:organization)
+        organization_memberships.with_fallback.map(&:organization)
       end
 
       def admin_organizations

data/lib/zaikio/directory/json_parser.rb

@@ -3,13 +3,33 @@ require "multi_json"
 module Zaikio
   module Directory
     class JSONParser < Faraday::Response::Middleware
-      def parse(body)
+      def on_complete(env)
+        connection_error(env) unless /^(2\d\d)|422|404$/.match?(env.status.to_s)
+
+        raise Spyke::ResourceNotFound if env.status.to_s == "404"
+
+        env.body = parse_body(env.body)
+      end
+
+      def connection_error(env)
+        Zaikio::Directory.configuration.logger
+                         .error("Zaikio::Directory Status Code #{env.status}, #{env.body}")
+        raise Spyke::ConnectionError, "Status Code #{env.status}, #{env.body}"
+      end
+
+      def parse_body(body)
         json = MultiJson.load(body, symbolize_keys: true)
         {
           data: json,
           metadata: {},
           errors: json.is_a?(Hash) ? json[:errors] : {}
         }
+      rescue MultiJson::ParseError
+        {
+          data: {},
+          metadata: {},
+          errors: {}
+        }
       end
     end
   end

data/lib/zaikio/directory/machine.rb

@@ -1,29 +1,10 @@
 module Zaikio
   module Directory
     class Machine < Base
+      include Asset
+
       uri "machines(/:id)"
       include_root_in_json :machine
-
-      # Callbacks
-      after_create :make_organization_owner
-
-      def make_organization_owner
-        if Zaikio::Directory.current_token_data.subject_type == "Organization"
-          self.class.request(:post, "machines/#{id}/machine_ownership")
-        else
-          org_path = "person/organizations/#{organization_id}"
-          self.class.request(:post, "#{org_path}/machines/#{id}/machine_ownership")
-        end
-      end
-
-      def destroy
-        if Zaikio::Directory.current_token_data.subject_type == "Organization"
-          self.class.request(:delete, "machines/#{id}/machine_ownership")
-        else
-          org_path = "person/organizations/#{owner_id || organization_id}"
-          self.class.request(:delete, "#{org_path}/machines/#{id}/machine_ownership")
-        end
-      end
     end
   end
 end

data/lib/zaikio/directory/organization.rb

@@ -12,6 +12,8 @@ module Zaikio
                                          uri: "person/organizations/:organization_id/software"
       has_many :machines,                class_name: "Zaikio::Directory::Machine",
                                          uri: "person/organizations/:organization_id/machines"
+      has_many :specialists,             class_name: "Zaikio::Directory::Specialist",
+                                         uri: "person/organizations/:organization_id/specialists"
       has_many :sites,                   class_name: "Zaikio::Directory::Site",
                                          uri: "person/organizations/:organization_id/sites"
     end

data/lib/zaikio/directory/software.rb

@@ -1,28 +1,15 @@
 module Zaikio
   module Directory
     class Software < Base
+      include Asset
+
       uri "software(/:id)"
       include_root_in_json :software
 
-      # Callbacks
-      after_create :make_organization_owner
-
-      def make_organization_owner
-        if Zaikio::Directory.current_token_data.subject_type == "Organization"
-          self.class.request(:post, "software/#{id}/software_ownership")
-        else
-          org_path = "person/organizations/#{organization_id}"
-          self.class.request(:post, "#{org_path}/software/#{id}/software_ownership")
-        end
-      end
+      private
 
-      def destroy
-        if Zaikio::Directory.current_token_data.subject_type == "Organization"
-          self.class.request(:delete, "software/#{id}/software_ownership")
-        else
-          org_path = "person/organizations/#{owner_id || organization_id}"
-          self.class.request(:delete, "#{org_path}/software/#{id}/software_ownership")
-        end
+      def collection_name
+        "software"
       end
     end
   end

data/lib/zaikio/directory/specialist.rb

@@ -0,0 +1,10 @@
+module Zaikio
+  module Directory
+    class Specialist < Base
+      include Asset
+
+      uri "specialists(/:id)"
+      include_root_in_json :specialist
+    end
+  end
+end

data/lib/zaikio/directory/version.rb

@@ -1,5 +1,5 @@
 module Zaikio
   module Directory
-    VERSION = "0.0.5".freeze
+    VERSION = "0.0.10".freeze
   end
 end

data/lib/zaikio/error.rb

@@ -0,0 +1,16 @@
+module Zaikio
+  class Error < StandardError; end
+  class ConnectionError < Zaikio::Error; end
+  class ResourceNotFound < Zaikio::Error; end
+end
+
+module Spyke
+  instance_eval do
+    # avoid warning: already initialized constant
+    remove_const("ConnectionError")
+    remove_const("ResourceNotFound")
+  end
+
+  ConnectionError = Class.new Zaikio::ConnectionError
+  ResourceNotFound = Class.new Zaikio::ResourceNotFound
+end

metadata

@@ -1,14 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: zaikio-directory
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.10
 platform: ruby
 authors:
-- Zaikio GmbH
+- crispymtn
+- Jalyna Schröder
+- Martin Spickermann
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-08 00:00:00.000000000 Z
+date: 2020-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
@@ -68,7 +70,9 @@ dependencies:
         version: 5.3.4
 description: Ruby API Client for Zaikio's Directory
 email:
+- op@crispymtn.com
 - js@crispymtn.com
+- spickermann@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -77,6 +81,7 @@ files:
 - README.md
 - Rakefile
 - lib/zaikio/directory.rb
+- lib/zaikio/directory/asset.rb
 - lib/zaikio/directory/authorization_middleware.rb
 - lib/zaikio/directory/base.rb
 - lib/zaikio/directory/basic_auth_middleware.rb
@@ -95,7 +100,9 @@ files:
 - lib/zaikio/directory/role.rb
 - lib/zaikio/directory/site.rb
 - lib/zaikio/directory/software.rb
+- lib/zaikio/directory/specialist.rb
 - lib/zaikio/directory/version.rb
+- lib/zaikio/error.rb
 homepage: https://www.zaikio.com/
 licenses:
 - MIT