plate_api 1.2.4 → 1.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 947c12da1663740de9378f1c065f158630eef3a7cccc901b728f523db3777194
-  data.tar.gz: 9c5e26eb8a8e70a7eca3b9511e38e649be72933a52975bcc793d6d79e4268d93
+  metadata.gz: 503eedbe972dc1af57701afbafd35a6ad76e106d86b94ad32093a40d5c63d1da
+  data.tar.gz: 4df9c933309cfe2217882548fa88f525e45852a7356229b3488b7ea8f6759dee
 SHA512:
-  metadata.gz: 7f0e809ce4944a826e2c4ddf3e085e87ceb96e76a7cf96fa9261e24e27da78d3773abea76c93a8e24ee89fb6a9ba28bd8efa9249d5289248a3fd5df2f6796280
-  data.tar.gz: 736048b6087f9c42f0d246d0dc6f5b39d9c09f3dc08957056a47ca2f4c4079c11574691387dace9428fb692c829d7df3c30c41a0880b6b314ba7dfec2896a681
+  metadata.gz: 775b16afb1ea5c15e5203a241bb74509e04a1a573539f498c3a612c91b90b094dfbe8304d2d2158b5fd10d18d0949acbcf1f1cddcffe82edea5cc75aba73bfc8
+  data.tar.gz: 464e4c82997c7d0177f19bc39b351ff77fbb2584aada96aab67e6e5ec4a39ee482130c150f3322f3054309f343c9b80e2e7f169388aede15e6084dada4b6d4fc

data/Dockerfile

@@ -0,0 +1,6 @@
+FROM ruby:2.7
+
+RUN mkdir /plate_api
+WORKDIR /plate_api
+COPY . /plate_api
+RUN bin/setup

data/README.md

@@ -145,6 +145,12 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## Run Specs with Docker
+```bash
+docker build -t plate_api_gem .
+docker run --rm -it plate_api_gem rspec
+```
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/plate_api/object_handler.rb

@@ -7,38 +7,42 @@ module PlateApi
     def initialize(handling_class, api_connector)
       raise ArgumentError, "`handling_class` given for #new is not valid" unless handling_class
       raise ArgumentError, "`api_connector` given for #new is not valid" unless api_connector
+
       @handling_class = handling_class
       @api_connector = api_connector
     end
 
     def find(id)
       raise ArgumentError, "`id` given for #find is not valid" unless id
+
       result = @api_connector.get(resource_path(id))
       if result["data"]
-        return new_object(result["data"])
+        new_object(result["data"])
       else
-        raise Error::Response, result
+        raise ResponseError, result
       end
     end
 
     def update(id, attributes)
       raise ArgumentError, "`id` given for #update is not valid" unless id
-      raise ArgumentError, "`attributes` given for #update is not valid" unless attributes.is_a? Hash
-      result = @api_connector.put(resource_path(id), {"data" => attributes})
+      raise ArgumentError, "`attributes` given for #update is not valid" unless attributes.is_a?(Hash)
+
+      result = @api_connector.put(resource_path(id), { "data" => attributes })
 
       if result["data"]
-        return new_object(result["data"])
+        new_object(result["data"])
       else
-        raise Error::Response, result
+        raise ResponseError, result
       end
     end
 
-    def create(parent, attributes, create_method=:post)
+    def create(parent, attributes, create_method = :post)
       raise ArgumentError, "`parent` given for #create is not valid" unless parent
-      raise ArgumentError, "`attributes` given for #create is not valid" unless attributes.is_a? Hash
+      raise ArgumentError, "`attributes` given for #create is not valid" unless attributes.is_a?(Hash)
+
       parameters = case create_method
       when :post
-        {"data" => attributes}
+        { "data" => attributes }
       when :post_multipart
         attributes
       end
@@ -46,45 +50,70 @@ module PlateApi
       result = @api_connector.send(create_method, collection_path(parent.class, parent.id), parameters)
 
       if result["data"]
-        return new_object(result["data"])
+        new_object(result["data"])
       else
-        raise Error::Response, result
+        raise ResponseError, result
       end
     end
 
     def delete(id)
       raise ArgumentError, "`id` given for #find is not valid" unless id
+
       result = @api_connector.delete(resource_path(id))
       if result["data"]
-        return new_object(result["data"])
+        new_object(result["data"])
       else
-        raise Error::Response, result
+        raise ResponseError, result
       end
     end
 
-    def index(parent_class, parent_id, extra_params={})
+    def index(parent_class, parent_id, extra_params = {}, return_raw = false)
       raise ArgumentError, "`parent_id` given for #index is not valid" unless parent_id
       raise ArgumentError, "`parent_class` given for #index is not valid" unless parent_class
 
       result = @api_connector.get(collection_path(parent_class, parent_id), extra_params)
-      if result["data"]
-        return result["data"].map{|x| new_object(x)}
-      else
-        raise Error::Response, result
+      raise ResponseError, result unless result["data"]
+      return result if return_raw
+
+      result["data"].map { |x| new_object(x) }
+    end
+
+    def index_block(parent_class, parent_id, extra_params = {}, &block)
+      extra_params[:page] = extra_params.delete("page") if extra_params["page"]
+      extra_params[:page] = 1 unless extra_params[:page]
+
+      pagination = index_block_iteration(parent_class, parent_id, extra_params, &block)
+      return unless pagination
+
+      while pagination["page"] < pagination["total_pages"]
+        extra_params.merge!(page: (pagination["page"] + 1))
+        pagination = index_block_iteration(parent_class, parent_id, extra_params, &block)
+        break unless pagination
       end
     end
 
     def index_total_count(parent)
       result = @api_connector.get(collection_path(parent.class, parent.id), per_page: 1)
       if result["meta"]
-        return result["meta"]["pagination"]["total_records"]
+        result["meta"]["pagination"]["total_records"]
       else
-        raise Error::Response, result
+        raise ResponseError, result
       end
     end
 
     private
 
+    def index_block_iteration(parent_class, parent_id, params)
+      result = index(parent_class, parent_id, params, true)
+      objects = result["data"].map { |x| new_object(x) }
+      meta = result["meta"]
+      yield(objects, meta)
+
+      # Returns pagination metadata so it can be used to
+      # iterate through the pages.
+      meta["pagination"] if meta
+    end
+
     # Construct a new object of @handling_class, given a succesful api_response
     def new_object(api_response)
       @handling_class.new(
@@ -99,15 +128,15 @@ module PlateApi
       "#{@handling_class.api_name}/#{id}"
     end
 
-    def collection_path(parent_class=nil, parent_id=nil)
-      if (parent_class != nil) ^ (parent_id != nil)
+    def collection_path(parent_class = nil, parent_id = nil)
+      if (!parent_class.nil?) ^ (!parent_id.nil?)
         raise ArgumentError, "An invalid combination `parent_class` and `parent_id` is given. Provide both or none."
       end
 
       if parent_class
         "#{parent_class.api_name}/#{parent_id}/#{@handling_class.api_name}"
       else
-        "#{@handling_class.api_name}"
+        @handling_class.api_name.to_s
       end
     end
   end

data/lib/plate_api/plate_object/base.rb

@@ -6,7 +6,7 @@ module PlateApi::PlateObject
     HasOneRelations = {}
     HasManyRelations = {}
 
-    def initialize(id, attributes, relations, object_handler=nil)
+    def initialize(id, attributes, relations, object_handler = nil)
       @id = id
       @object_handler = object_handler
       initialize_state(attributes, relations)
@@ -17,24 +17,27 @@ module PlateApi::PlateObject
     end
 
     def reload
-      raise ArgumentError.new("No object_handler is set.") unless @object_handler
+      raise ArgumentError, "No object_handler is set." unless @object_handler
+
       reinitialize(@object_handler.find(@id))
-      return self
+      self
     end
 
     def update(attributes)
-      raise ArgumentError.new("Input `attributes` is not a Hash") unless attributes.is_a? Hash
-      raise ArgumentError.new("No object_handler is attached to this object") unless @object_handler
+      raise ArgumentError, "Input `attributes` is not a Hash" unless attributes.is_a?(Hash)
+      raise ArgumentError, "No object_handler is attached to this object" unless @object_handler
+
       if new_object = @object_handler.update(@id, attributes)
         reinitialize(new_object)
       else
-        raise ArgumentError.new("The update was unsuccesful.")
+        raise ArgumentError, "The update was unsuccesful."
       end
-      return self
+      self
     end
 
     def delete
-      raise ArgumentError.new("No object_handler is attached to this object") unless @object_handler
+      raise ArgumentError, "No object_handler is attached to this object" unless @object_handler
+
       @object_handler.delete(@id)
     end
 
@@ -46,18 +49,25 @@ module PlateApi::PlateObject
       to_s
     end
 
-    def method_missing(m, *args, &block)
-      if attributes[m.to_s]
-        return attributes[m.to_s]
-      elsif attributes["content"] && attributes["content"][m.to_s]
-        return attributes["content"][m.to_s]["value"]
+    def method_missing(method_name, *args, &block)
+      if attributes[method_name.to_s]
+        attributes[method_name.to_s]
+      elsif attributes["content"] && attributes["content"][method_name.to_s]
+        attributes["content"][method_name.to_s]["value"]
       else
         super
       end
     end
 
+    def respond_to_missing?(method_name, include_private = false)
+      return true if attributes[method_name.to_s]
+      return true if attributes["content"] && attributes["content"][method_name.to_s]
+
+      super
+    end
+
     def ==(other)
-      return other.id == @id && other.class == self.class
+      other.id == @id && other.class == self.class
     end
 
     private
@@ -72,56 +82,68 @@ module PlateApi::PlateObject
       @relations = relations
     end
 
-    def self.has_one(name, klass)
-      HasOneRelations[self.name] ||= {}
-      self.attr_accessor "#{name}_id"
-      HasOneRelations[self.name][name.to_s] = klass
-      define_has_one_method(name, klass)
-    end
+    def set_relation_ids(relations_attributes)
+      HasOneRelations[self.class.name] ||= {}
 
-    def self.define_has_one_method(name, klass)
-      define_method(name.to_s) do
-        id = self.send("#{name}_id")
-        return nil unless id
-        @object_handler.api_connector.handler(Object.const_get(klass)).find(id)
+      return unless relations_attributes
+
+      self.class::HasOneRelations[self.class.name].keys.each do |relation_name|
+        val = relations_attributes["#{relation_name}_id"]
+        if val
+          send("#{relation_name}_id=", val)
+        end
       end
     end
 
-    def self.has_many(plural_name, singular_name, klass, define_create_method=false)
-      HasManyRelations[self.name] ||= {}
-      HasManyRelations[self.name][plural_name.to_s] = klass
-      define_has_many_methods(plural_name, klass)
-      define_create_method(singular_name, klass) if define_create_method
-    end
+    class << self
+      private
 
-    def self.define_has_many_methods(plural_name, klass)
-      define_method(plural_name.to_s) do |params={}|
-        @object_handler.api_connector.handler(
-          Object.const_get(klass)
-        ).index(self.class, @id, params)
+      def has_one(name, klass)
+        HasOneRelations[self.name] ||= {}
+        attr_accessor("#{name}_id")
+        HasOneRelations[self.name][name.to_s] = klass
+        define_has_one_method(name, klass)
       end
 
-      define_method("#{plural_name}_total_count") do
-        @object_handler.api_connector.handler(
-          Object.const_get(klass)
-        ).index_total_count(self)
+      def define_has_one_method(name, klass)
+        define_method(name.to_s) do
+          id = send("#{name}_id")
+          return nil unless id
+
+          @object_handler.api_connector.handler(Object.const_get(klass)).find(id)
+        end
       end
-    end
 
-    def self.define_create_method(singular_name, klass)
-      define_method("create_#{singular_name}") do |create_attributes|
-        @object_handler.api_connector.handler(Object.const_get(klass)).create(self, create_attributes)
+      def has_many(plural_name, singular_name, klass, define_create_method = false)
+        HasManyRelations[name] ||= {}
+        HasManyRelations[name][plural_name.to_s] = klass
+        define_has_many_methods(plural_name, klass)
+        define_create_method(singular_name, klass) if define_create_method
       end
-    end
 
-    def set_relation_ids(relations_attributes)
-      HasOneRelations[self.class.name] ||= {}
+      def define_has_many_methods(plural_name, klass)
+        define_method(plural_name.to_s) do |params = {}|
+          @object_handler.api_connector.handler(
+            Object.const_get(klass)
+          ).index(self.class, @id, params)
+        end
 
-      return unless relations_attributes
-      self.class::HasOneRelations[self.class.name].keys.each do |relation_name|
-        val = relations_attributes["#{relation_name}_id"]
-        if val
-          send("#{relation_name}_id=", val)
+        define_method("#{plural_name}_total_count") do
+          @object_handler.api_connector.handler(
+            Object.const_get(klass)
+          ).index_total_count(self)
+        end
+
+        define_method("all_#{plural_name}") do |params = {}, &block|
+          @object_handler.api_connector.handler(
+            Object.const_get(klass)
+          ).index_block(self.class, @id, params, &block)
+        end
+      end
+
+      def define_create_method(singular_name, klass)
+        define_method("create_#{singular_name}") do |create_attributes|
+          @object_handler.api_connector.handler(Object.const_get(klass)).create(self, create_attributes)
         end
       end
     end

data/lib/plate_api/response_error.rb

@@ -0,0 +1,5 @@
+module PlateApi
+  class ResponseError < StandardError
+
+  end
+end

data/lib/plate_api/version.rb

@@ -1,3 +1,3 @@
 module PlateApi
-  VERSION = "1.2.4"
+  VERSION = "1.2.5"
 end

data/lib/plate_api.rb

@@ -9,7 +9,7 @@ require "plate_api/delete_request"
 require "plate_api/post_request"
 require "plate_api/post_multipart_request"
 require "plate_api/put_request"
-require "plate_api/error"
+require "plate_api/response_error"
 
 
 module PlateApi

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: plate_api
 version: !ruby/object:Gem::Version
-  version: 1.2.4
+  version: 1.2.5
 platform: ruby
 authors:
 - David Kortleven
@@ -165,6 +165,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- Dockerfile
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -175,7 +176,6 @@ files:
 - lib/plate_api.rb
 - lib/plate_api/connector.rb
 - lib/plate_api/delete_request.rb
-- lib/plate_api/error.rb
 - lib/plate_api/get_request.rb
 - lib/plate_api/object_handler.rb
 - lib/plate_api/plate_object/attachment.rb
@@ -196,6 +196,7 @@ files:
 - lib/plate_api/post_request.rb
 - lib/plate_api/put_request.rb
 - lib/plate_api/request.rb
+- lib/plate_api/response_error.rb
 - lib/plate_api/version.rb
 - plate_api.gemspec
 homepage: 

data/lib/plate_api/error.rb

@@ -1,5 +0,0 @@
-module Error
-  class Response < StandardError
-
-  end
-end