plate_api 1.2.2 → 1.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 251666f577ba0ea7439b6dfa90acfe15e9ac7724a827a8133f4eaf092124d109
-  data.tar.gz: a4e9c0676b64b4e324826864045cd09ba1b3e5ef68d4f6ed1b58821b136f54dd
+  metadata.gz: 5a9a0f07279f06d55f0e73486c1c1f11773064ec4d51f6b249283ce5d7aa1fe0
+  data.tar.gz: 2632add211ddacaa8c3a2ffaeccb1059e5d60720e6e06aa364a7a056cff7031e
 SHA512:
-  metadata.gz: a691fd2429453636ebb4f0c4fbe3aa1498a2550374f5eb220ba25135dc3580d95a4e34f074e4c948b6e5a326505c0a82e17fe928b2a0ac05d0cbb1556c307879
-  data.tar.gz: '09a484411bf28eb37862f11b514ae3e43385b904bad989fa448cb5174ef1b3ea2793c4289186d9b4b0de5eceb37a249fbcebc15d5ac885499eda6e309040b65f'
+  metadata.gz: '03780afac4ad36ba817bcfc34798e32822d1e09debda817eed1b9769bb1dc47aeb6a81bd3455c30327e9b6b2185db4c488bfdfc0bafff181432a6059c40669e6'
+  data.tar.gz: 81d8e3e9a20f96f70b8688d90238d6ba0b7f7aa63b708184f2e796123bde4c3e8a1f4f96a339ae3bd22e90e1475cc93073cd0f5e0b8eb8a2041250495f44fe92

data/Dockerfile

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

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    plate_api (1.2.2)
+    plate_api (1.2.5)
       faraday (~> 1.0.1)
+      mime-types (~> 3.3.1)
 
 GEM
   remote: https://rubygems.org/
@@ -29,6 +30,9 @@ GEM
     hashdiff (1.0.1)
     i18n (1.8.2)
       concurrent-ruby (~> 1.0)
+    mime-types (3.3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2021.1115)
     minitest (5.14.1)
     multipart-post (2.1.1)
     public_suffix (4.0.5)

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 -v $(pwd):/plate_api -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/post_multipart_request.rb

@@ -18,7 +18,16 @@ module PlateApi
     end
 
     def mime_type(full_path)
-      IO.popen(["file", "--brief", "--mime-type", full_path], in: :close, err: :close) { |io| io.read.chomp }
+      begin
+        IO.popen(["file", "--brief", "--mime-type", full_path], in: :close, err: :close) { |io| io.read.chomp }
+      rescue SystemCallError
+        # determine mime_type based on extension as a fallback, in case `file` is not installed on the client machine
+        mime_type_fallback(full_path)
+      end
+    end
+
+    def mime_type_fallback(full_path)
+      MIME::Types.type_for(full_path).first.content_type
     end
 
     def map_parameters(parameters)
@@ -26,7 +35,7 @@ module PlateApi
         val = parameters[key]
         if val.is_a? File
           full_path = File.expand_path(val)
-          mime_type = self.mime_type(full_path)
+          mime_type = mime_type(full_path)
           parameters[key] = Faraday::UploadIO.new(full_path, mime_type)
         end
       end

data/lib/plate_api/request.rb

@@ -1,22 +1,22 @@
 require "faraday"
 # require 'faraday_middleware'
-require 'time'
+require "time"
 require "base64"
 require "openssl"
 require "json"
-
+require "mime-types"
 
 module PlateApi
   class Request
     DefaultApiBaseEndpoint = "https://www.startwithplate.com/api/v2"
     HttpAdapter = Faraday.default_adapter
 
-    def initialize(public_key, secret, method, path, custom_server=nil)
+    def initialize(public_key, secret, method, path, custom_server = nil)
       base_api_endpoint = custom_server ? custom_server : DefaultApiBaseEndpoint
 
-      @connection = ::Faraday.new(url: base_api_endpoint) do |faraday|
+      @connection = ::Faraday.new(url: base_api_endpoint, request: { timeout: 900 }) do |faraday|
         extra_builder_options(faraday)
-        faraday.adapter     HttpAdapter
+        faraday.adapter HttpAdapter
       end
 
       @public_key = public_key
@@ -25,20 +25,20 @@ module PlateApi
       @path = strip_path(path)
     end
 
-    def execute(response_type=:raw)
+    def execute(response_type = :raw)
       response = @connection.send(@method.downcase) do |request|
         request.url url_path
-        request.headers['Date'] = request_date
-        request.headers['Authorization'] = calculate_signature
+        request.headers["Date"] = request_date
+        request.headers["Authorization"] = calculate_signature
         extra_request_options(request)
       end
 
       return case response_type
-      when :raw
-        return response.body
-      when :json
-        return JSON.parse(response.body)
-      end
+             when :raw
+               return response.body
+             when :json
+               return JSON.parse(response.body)
+             end
     end
 
     def request_date
@@ -72,7 +72,7 @@ module PlateApi
     end
 
     def strip_path(path)
-      path.gsub(/^\/|\/$/, '')
+      path.gsub(/^\/|\/$/, "")
     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.2"
+  VERSION = "1.2.7"
 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

data/plate_api.gemspec

@@ -32,6 +32,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "faraday", "~> 1.0.1"
+  spec.add_dependency "mime-types", "~> 3.3.1"
   # spec.add_dependency "faraday_middleware", "~> 0.13.1"
   # spec.add_dependency "mimemagic", "~> 0.3.10"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: plate_api
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.2.7
 platform: ruby
 authors:
 - David Kortleven
@@ -25,6 +25,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -151,6 +165,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- Dockerfile
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -161,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
@@ -182,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