reso_transport 1.5.7 → 1.5.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49293478c0827ccb4bdca1bb6c9974900f8c0c16853b247487120a0ed3bb79df
-  data.tar.gz: c9d8c93979377ed18d22a179bae44175961b44e8641eb091930f99542d1e610f
+  metadata.gz: d84554084d4c2159db65df37c4c8fc71d0b19c2ee36d7a61d53f66687ef0efd2
+  data.tar.gz: 8d6dfb63550e4b2cb530f6448c65f5a6b88c28ca05e21c4c840ea74eb4d47731
 SHA512:
-  metadata.gz: 4464fe0a9aa0006f25c5eab29dab8422401ac2ebf435b712e65d5727e43606bb0df4fdf895e5a1d6a1e3e44d4937d19c42389577d28568351832ccae64d55ebb
-  data.tar.gz: 729d643455ddd8e7a827ddc6aea2a8512f93bc65a3e469993da5d2cd5085ecdc5eed4befee4f376cd9986f51a81d363fdeb042a1f8f51e2e51d7230f265c2d7a
+  metadata.gz: 52e67a29c2d0723728f5a168f8eacee86de0ccec979a22512a98fe822f164ee277a3774cef8a2412a60ab35469a4c4268076547714323c8f451592daa898e2cc
+  data.tar.gz: 329115fb2899789885463fb0756213b434b147aaa47babb63cc5be9d6e37b363922d219ca1970a16c6bf1abedba15c01d49ca9e59f673054ab58df6a5ad22d23

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    reso_transport (1.5.5)
+    reso_transport (1.5.10)
       faraday (~> 1.0.1)
 
 GEM
@@ -22,7 +22,7 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (~> 2)
-  byebug
+  byebug (~> 11)
   minitest (~> 5.0)
   minitest-rg (~> 5.0)
   rake (~> 13)

data/README.md

@@ -93,8 +93,13 @@ If the connection requires requesting a new token periodically, it's easy to pro
 
 This will pre-fetch a token from the provided endpoint when the current token is either non-existent or has expired.
 
-The `use_replication_endpoint` flag will append `/replication` to all resource queries if set to `true`. This is required
-by some data sources to query resources beyond 10,000 records.
+The `use_replication_endpoint` flag will append `/replication` to all resource queries if set to `true`. This is required by some data sources to query resources beyond 10,000 records.
+
+When using this feature, you can retrieve the next link by accessing `next_link` after gettings results:
+```
+  results = @client.resources["Property"].query.results
+  next_link = @client.resources["Property"].query.next_link
+```
 
 ### Caching Metadata
 
@@ -278,6 +283,19 @@ When querying for an enumeration value, you can provide either the system name,
   #=> {"$top"=>1, "$filter"=>"StandardStatus eq 'ActiveUnderContract'"}
 ```
 
+### Troubleshooting
+
+In the event there are connection issues, the following errors are raised:
+
+* `ResoTransport::NoResponse` - The server did not respond to the request
+* `ResoTransport::RequestError` - The server responded with a status code outside the 200 range
+* `ResoTransport::ResponseError` - The server responded with errors in the body
+* `ResoTransport::AccessDenied` - Check your authentication details
+* `ResoTransport::LocalizationRequired` - Provide one of the required localizations through the `localization` method
+* `ResoTransport::EncodeError` - No match was found for one or more of the properties
+
+The Faraday Request hash is attached to the error for `NoResponse`, `RequestError`, `ResponseError`, and `AccessDenied`.  A Faraday Response is attached on `RequestError`, `ResponseError`, and `AccessDenied`.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/reso_transport/authentication/fetch_token_auth.rb

@@ -19,6 +19,7 @@ module ResoTransport
         @endpoint      = options.fetch(:endpoint)
         @username      = options.fetch(:username, nil)
         @password      = options.fetch(:password, nil)
+        @request       = nil
       end
 
       def connection
@@ -31,13 +32,10 @@ module ResoTransport
       end
 
       def authenticate
-        response = connection.post nil, auth_params
+        response = connection.post(nil, auth_params { |req| @request = req })
         json = JSON.parse response.body
 
-        unless response.success?
-          message = "#{response.reason_phrase}: #{json['error'] || response.body}"
-          raise ResoTransport::AccessDenied, response: response, message: message
-        end
+        raise AccessDenied.new(request, response, 'token') unless response.success?
 
         Access.new({
           access_token: json.fetch('access_token'),
@@ -46,6 +44,12 @@ module ResoTransport
         })
       end
 
+      def request
+        return @request.to_h if @request.respond_to? :to_h
+
+        {}
+      end
+
       private
 
       def auth_params

data/lib/reso_transport/authentication/middleware.rb

@@ -18,10 +18,11 @@ module ResoTransport
           authorize_request(request_env)
 
           @app.call(request_env).on_complete do |response_env|
-            raise_if_unauthorized(response_env)
+            raise_if_unauthorized(request_env, response_env)
           end
         rescue ResoTransport::AccessDenied
-          raise if retries == 0
+          raise if retries.zero?
+
           @auth.reset
           retries -= 1
           retry
@@ -38,8 +39,8 @@ module ResoTransport
         )
       end
 
-      def raise_if_unauthorized(response_env)
-        raise ResoTransport::AccessDenied if response_env[:status] == 401
+      def raise_if_unauthorized(request_env, response_env)
+        raise ResoTransport::AccessDenied.new(request_env.to_h, response_env) if response_env[:status] == 401
       end
     end
   end

data/lib/reso_transport/base_metadata.rb

@@ -46,16 +46,19 @@ module ResoTransport
     end
 
     def raw
-      if response.success?
-        response.body
-      else
-        puts response.body
-        raise "Error getting #{classname}!"
-      end
+      return response.body if response.success?
+
+      raise RequestError.new(request, response, classname)
     end
 
     def response
       raise 'Must implement response method'
     end
+
+    def request
+      return @request.to_h if @request.respond_to? :to_h
+
+      {}
+    end
   end
 end

data/lib/reso_transport/datasystem.rb

@@ -16,7 +16,10 @@ module ResoTransport
     def response
       @response ||= client.connection.get('DataSystem') do |req|
         req.headers['Accept'] = 'application/json'
+        @request = req
       end
+    rescue Faraday::ConnectionFailed
+      raise NoResponse.new(request, nil, 'DataSystem')
     end
   end
 end

data/lib/reso_transport/errors.rb

@@ -0,0 +1,69 @@
+module ResoTransport
+  class ResourceError < StandardError
+    attr_reader :resource
+
+    def initialize(resource)
+      @resource = resource
+      super message
+    end
+
+    def resource_name
+      return resource.name if resource.respond_to?(:name)
+
+      resource || 'unknown'
+    end
+
+    def message
+      "Request error for #{resource_name}"
+    end
+  end
+
+  class EncodeError < ResourceError
+    def initialize(resource, property)
+      @property = property
+      super resource
+    end
+
+    def message
+      "Property #{@property} not found for #{resource_name}"
+    end
+  end
+
+  class LocalizationRequired < ResourceError
+    def message
+      "Localization required for #{resource_name}"
+    end
+  end
+
+  class RequestError < ResourceError
+    attr_reader :request, :response
+
+    def initialize(request, response, resource = nil)
+      @response = response.respond_to?(:to_hash) ? response.to_hash : response
+      @request = request
+      super resource
+    end
+
+    def message
+      "Received #{response[:status]} for #{resource_name}"
+    end
+  end
+
+  class NoResponse < RequestError
+    def message
+      "No response for #{resource_name}"
+    end
+  end
+
+  class ResponseError < RequestError
+    def message
+      "Request succeeded for #{resource_name} with response errors"
+    end
+  end
+
+  class AccessDenied < RequestError
+    def message
+      "Access denied: #{response.reason_phrase}"
+    end
+  end
+end

data/lib/reso_transport/metadata.rb

@@ -23,7 +23,10 @@ module ResoTransport
     def response
       @response ||= client.connection.get('$metadata') do |req|
         req.headers['Accept'] = MIME_TYPES[client.vendor.fetch(:metadata_format, :xml).to_sym]
+        @request = req
       end
+    rescue Faraday::ConnectionFailed
+      raise NoResponse.new(request, nil, '$metadata')
     end
   end
 end

data/lib/reso_transport/query.rb

@@ -43,6 +43,11 @@ module ResoTransport
       self
     end
 
+    def page(token)
+      options[:next] = token
+      self
+    end
+
     def select(*fields)
       os = options.fetch(:select, '').split(',')
       options[:select] = (os + Array(fields)).uniq.join(',')
@@ -58,41 +63,37 @@ module ResoTransport
     end
 
     def count
-      p compile_params
       limit(1).include_count
-      resp = resource.get(compile_params)
-      parsed_body = JSON.parse(resp.body)
-      parsed_body.fetch('@odata.count', 0)
+      parsed = handle_response response
+      parsed.fetch('@odata.count', 0)
     end
 
     def results
-      resp = execute
+      parsed = handle_response response
 
-      if resp[:success]
-        resp[:results]
-      else
-        puts resp[:meta]
-        raise 'Request Failed'
-      end
+      @next_link = parsed.fetch('@odata.nextLink', nil)
+      results = Array(parsed.delete('value'))
+      resource.parse(results)
     end
 
-    def execute
-      resp = resource.get(compile_params)
-      if resp.success?
-        parsed_body = JSON.parse(resp.body)
-        results = Array(parsed_body.delete('value'))
-
-        {
-          success: resp.success? && !parsed_body.key?('error'),
-          meta: parsed_body,
-          results: resource.parse(results)
-        }
-      else
-        {
-          success: false,
-          meta: resp.body
-        }
-      end
+    # Can only be accessed after results call
+    def next_link
+      @next_link
+    end
+
+    def response
+      resource.get(compile_params)
+    rescue Faraday::ConnectionFailed
+      raise NoResponse.new(resource.request, nil, resource)
+    end
+
+    def handle_response(response)
+      raise RequestError.new(resource.request, response, resource) unless response.success?
+
+      parsed = JSON.parse(response.body)
+      raise ResponseError.new(resource.request, response, resource) if parsed.key?('error')
+
+      parsed
     end
 
     def new_query_context(context)
@@ -149,7 +150,7 @@ module ResoTransport
 
     def encode_value(key, val)
       field = resource.property(key.to_s)
-      raise "Couldn't find property #{key} for #{resource.name}" if field.nil?
+      raise EncodeError.new(resource, key) if field.nil?
 
       field.encode(val)
     end

data/lib/reso_transport/resource.rb

@@ -39,13 +39,14 @@ module ResoTransport
     def get(params)
       client.connection.get(url, params) do |req|
         req.headers['Accept'] = 'application/json'
+        @request = req
       end
     end
 
     def url
       return local['ResourcePath'].gsub(%r{^/}, '') if local
 
-      raise 'Localization required' if localizations.any? && local.nil?
+      raise LocalizationRequired, self if localizations.any? && local.nil?
 
       return "#{name}/replication" if client.use_replication_endpoint
 
@@ -64,5 +65,11 @@ module ResoTransport
     def inspect
       to_s
     end
+
+    def request
+      return @request.to_h if @request.respond_to? :to_h
+
+      {}
+    end
   end
 end

data/lib/reso_transport/version.rb

@@ -1,3 +1,3 @@
 module ResoTransport
-  VERSION = '1.5.7'.freeze
+  VERSION = '1.5.12'.freeze
 end

data/lib/reso_transport.rb

@@ -21,13 +21,11 @@ require 'reso_transport/entity_type'
 require 'reso_transport/enum'
 require 'reso_transport/property'
 require 'reso_transport/query'
+require 'reso_transport/errors'
 
 Faraday::Utils.default_space_encoding = '%20'
 
 module ResoTransport
-  class Error < StandardError; end
-
-  class AccessDenied < StandardError; end
   ODATA_TIME_FORMAT = '%Y-%m-%dT%H:%M:%SZ'.freeze
 
   class << self

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: reso_transport
 version: !ruby/object:Gem::Version
-  version: 1.5.7
+  version: 1.5.12
 platform: ruby
 authors:
 - Jon Druse
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-05-18 00:00:00.000000000 Z
+date: 2021-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -144,6 +144,7 @@ files:
 - lib/reso_transport/entity_set.rb
 - lib/reso_transport/entity_type.rb
 - lib/reso_transport/enum.rb
+- lib/reso_transport/errors.rb
 - lib/reso_transport/metadata.rb
 - lib/reso_transport/metadata_cache.rb
 - lib/reso_transport/metadata_parser.rb