ncore 1.2.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ec1bdffa679ca20445f4b48c4f7dd4cfcf6b2076
-  data.tar.gz: 7403cc773dc32014c0b9717fcb8d8fac6c433eb3
+  metadata.gz: 48412aecbd99b296c719895d2bbd4337d509be4e
+  data.tar.gz: f0aae8fdd116df4efa17f2796622de842a2d972a
 SHA512:
-  metadata.gz: 4d98693b19a89b725457faf351417e64d150964a8dfddb17d49535479f7b4410836dd47f6c90da96d2ea18b8073ab172ff9d5e7a2c022f2283caa6c55eb36318
-  data.tar.gz: b187d445f6273acc6b777a0adad97dfaeb41541573c3566f3d7c4d78fcbfe3f3e519df4d90dc9a178676e3e13a33af05d43ef2947b7a75f1de46fdce84be5687
+  metadata.gz: 016a83badb0134a32217d94da2293d9c80f7de47d31cc8ce16a749d695943b6cd35cce140a16c123dc9053d784d0b35c800b2b13afe4faeaeff486c741677d7f
+  data.tar.gz: a71630c646664844ddbf54733978fea894a1aa79dfc915574e8acf88538e0dd1551a9d0052e3ae89df3fa851baf95e18a8f69d94085406f5331e84392fe1e70d

data/CHANGELOG.md

@@ -1,3 +1,22 @@
+#### 2.0.0
+
+- NOTE: This version includes breaking changes.
+- Change params and credentials parsing
+  This changes the signatures for request() and all crud methods:
+    request(method, url, credentials, params, headers)
+      => request(method, url, params: {}, headers: {}, credentials: {})
+    all(), find(), create(), update(), delete(), etc
+      => pass credentials: {} instead of the final api_creds param
+- find(nil) now raises RecordNotFound instead of returning nil
+- Make <:assoc>_id=() writers private; shouldn't have been exposed to begin with.
+- Treat 409 like 422 and add error messages instead of raising an exception.
+- Add default error message for 409,422 if none received.
+- Make MultiJson optional - use it if present, otherwise default to stdlib JSON.
+  If using MultiJson, requires v1.9+.
+- Improve header handling for requests
+- Add #update!(), #delete!()
+- Add AccountInactive exception for 402 errors
+
 #### 1.2.1
 
 - Connection errors should raise NCore::ConnectionError

data/README.md

@@ -3,8 +3,10 @@
 NCore is a Ruby gem designed to help build REST API clients. It is not an API
 client by itself, but provides several useful building blocks to build one.
 
-It relies on `rest-client` for HTTP handling, `multi_json` for JSON parsing
-(and supports only JSON), and `activesupport`.
+It relies on `excon` for HTTP handling and `activesupport`.
+
+If present, uses `multi_json`. Otherwise, the stdlib 'json' is used.
+'multi_json' with an accelerated json gem is recommended.
 
 See `example/` for the beginning of an actual api client.
 

data/lib/ncore/associations.rb

@@ -9,59 +9,74 @@ module NCore
         def #{assoc}(params={})
           return [] unless id
           reload = params.delete :reload
-          if params.empty?
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          cacheable = params.except(:credentials, :request).empty?
+          params.merge! #{key}: id
+          if cacheable
             # only cache unfiltered, default api call
-            @attribs[:#{assoc}] = (!reload && @attribs[:#{assoc}]) || #{klass}.all({#{key}: id}, api_creds)
+            @attribs[:#{assoc}] = (!reload && @attribs[:#{assoc}]) || #{klass}.all(params)
           else
-            #{klass}.all(params.merge(#{key}: id), api_creds)
+            #{klass}.all(params)
           end
         end
       M1
       class_eval <<-M2, __FILE__, __LINE__+1
         def find_#{assoc.singularize}(aid, params={})
           raise UnsavedObjectError unless id
-          #{klass}.find(aid, {#{key}: id}.reverse_merge(params), api_creds)
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          params.merge! #{key}: id
+          #{klass}.find(aid, params)
         end
       M2
       # will always return the object; check .errors? or .valid? to see how it went
       class_eval <<-M3, __FILE__, __LINE__+1
         def create_#{assoc.singularize}(params={})
           raise UnsavedObjectError unless id
-          #{klass}.create(params.merge(#{key}: id), api_creds)
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          params.merge! #{key}: id
+          #{klass}.create(params)
         end
       M3
       # will always return the object; check .errors? or .valid? to see how it went
       class_eval <<-M4, __FILE__, __LINE__+1
         def update_#{assoc.singularize}(aid, params={})
-          obj = find_#{assoc.singularize}(aid)
-          obj.update(params)
-          obj
+          raise UnsavedObjectError unless id
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          params.merge! #{key}: id
+          #{klass}.update(aid, params)
         end
       M4
       class_eval <<-M5, __FILE__, __LINE__+1
         def create_#{assoc.singularize}!(params={})
           raise UnsavedObjectError unless id
-          #{klass}.create!(params.merge(#{key}: id), api_creds)
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          params.merge! #{key}: id
+          #{klass}.create!(params)
         end
       M5
       class_eval <<-M6, __FILE__, __LINE__+1
         def update_#{assoc.singularize}!(aid, params={})
-          obj = find_#{assoc.singularize}(aid)
-          obj.save!(params)
+          raise UnsavedObjectError unless id
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          params.merge! #{key}: id
+          #{klass}.update!(aid, params)
         end
       M6
       # will always return the object; check .errors? or .valid? to see how it went
       class_eval <<-M7, __FILE__, __LINE__+1
         def delete_#{assoc.singularize}(aid, params={})
-          obj = find_#{assoc.singularize}(aid)
-          obj.delete(params)
-          obj
+          raise UnsavedObjectError unless id
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          params.merge! #{key}: id
+          #{klass}.delete(aid, params)
         end
       M7
       class_eval <<-M8, __FILE__, __LINE__+1
         def delete_#{assoc.singularize}!(aid, params={})
           raise UnsavedObjectError unless id
-          #{klass}.delete!(aid, {#{key}: id}.reverse_merge(params), api_creds)
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          params.merge! #{key}: id
+          #{klass}.delete!(aid, params)
         end
       M8
     end
@@ -73,11 +88,12 @@ module NCore
         attr :#{assoc}_id
         def #{assoc}(params={})
           return nil unless #{assoc}_id
-          if params.empty?
+          params = parse_request_params(params).reverse_merge credentials: api_creds
+          if params.except(:credentials, :request).empty?
             # only cache unfiltered, default api call
-            @attribs[:#{assoc}] ||= #{klass}.find(#{assoc}_id, {}, api_creds)
+            @attribs[:#{assoc}] ||= #{klass}.find(#{assoc}_id, params)
           else
-            #{klass}.find(#{assoc}_id, params, api_creds)
+            #{klass}.find(#{assoc}_id, params)
           end
         end
       M1
@@ -86,6 +102,7 @@ module NCore
           @attribs[:#{assoc}] = nil unless @attribs[:#{assoc}_id] == v
           @attribs[:#{assoc}_id] = v
         end
+        private :#{assoc}_id=
       M2
     end
 

data/lib/ncore/attributes.rb

@@ -51,6 +51,28 @@ module NCore
           AD
         end
       end
+
+      def parse_request_params(params={}, opts={})
+        params = params.with_indifferent_access
+        req = params.delete(:request)
+        creds = params.delete(:credentials)
+        if opts[:json_root]
+          if params.key?(opts[:json_root])
+            o = params
+          else
+            o = {opts[:json_root] => params}.with_indifferent_access
+          end
+        else
+          o = params
+        end
+        o[:request] = req if req
+        o[:credentials] = creds if creds
+        o
+      end
+    end
+
+    def parse_request_params(params, opts={})
+      self.class.parse_request_params(params, opts)
     end
 
 

data/lib/ncore/client.rb

@@ -1,10 +1,19 @@
+require 'json'
+
 module NCore
   module Client
     extend ActiveSupport::Concern
 
     module ClassMethods
 
-      def request(method, url, request_credentials, params={}, headers={})
+      # opts - {params: {}, headers: {}, credentials: {}}
+      #   unknown keys assumed to be :params if :params is missing
+      def request(method, url, opts={})
+        opts = opts.with_indifferent_access
+        request_credentials = opts.delete 'credentials'
+        headers = opts.delete('headers') || {}
+        params = opts['params'] || opts
+
         request_credentials ||= retrieve_credentials
         request_credentials = parse_credentials(request_credentials)
 
@@ -21,7 +30,11 @@ module NCore
           path += qs
           payload = nil
         else
-          payload = MultiJson.encode params
+          if defined? MultiJson
+            payload = MultiJson.encode params
+          else
+            payload = JSON.generate params
+          end
         end
 
         rest_opts = {
@@ -65,8 +78,8 @@ module NCore
         h = {}
         [default_headers, auth_headers(req_credentials), headers].each do |set|
           set.each do |k,v|
-            k = k.to_s.titlecase.gsub(/ /,'-')
-            h[k] = v
+            k = k.to_s.tr('_','-').gsub(%r{(^|-)\w}){$&.upcase}
+            h[k] = v.respond_to?(:call) ? v.call : v
           end
         end
         h
@@ -199,11 +212,13 @@ module NCore
         case response.status
         when 401 # API auth valid; API call itself is an auth-related call and failed
           raise parent::AuthenticationFailed
+        when 402
+          raise parent::AccountInactive, "Account inactive; login to portal to check account status."
         when 403 # API auth failed or insufficient permissions
           raise parent::AccessDenied, "Access denied; check your API credentials and permissions."
         when 404
           raise parent::RecordNotFound
-        when 422
+        when 409, 422
           # pass through
         when 429
           raise parent::RateLimited
@@ -216,16 +231,24 @@ module NCore
       end
 
       def parse_response(response)
-        if [202, 204].include?(response.status) && response.body.blank?
-          return {data: {}, errors: {}, metadata: {}}
-        end
-      
-        begin
-          json = MultiJson.load(response.body||'', symbolize_keys: false) || {}
-          json = json.with_indifferent_access
-        rescue MultiJson::DecodeError, MultiJson::LoadError
-          raise parent::Error, "Unable to parse API response; HTTP status: #{response.status}; body: #{response.body.inspect}"
+        if response.body.blank?
+          json = {}
+        else
+          if defined? MultiJson
+            begin
+              json = MultiJson.load(response.body, symbolize_keys: false) || {}
+            rescue MultiJson::ParseError
+              raise parent::Error, "Unable to parse API response; HTTP status: #{response.status}; body: #{response.body.inspect}"
+            end
+          else
+            begin
+              json = JSON.parse(response.body, symbolize_names: false) || {}
+            rescue JSON::ParserError
+              raise parent::Error, "Unable to parse API response; HTTP status: #{response.status}; body: #{response.body.inspect}"
+            end
+          end
         end
+        json = json.with_indifferent_access
         errors = json.delete(:errors) || []
         if errors.any?
           errors = errors.values.flatten
@@ -239,6 +262,9 @@ module NCore
             metadata = nil
           end
         end
+        if [409, 422].include?(response.status) && errors.empty?
+          errors.push 'Validation error'
+        end
         {data: json, errors: errors, metadata: metadata}
       end
 
@@ -283,11 +309,15 @@ DBG
 
       def debug_response(response)
         return unless logger.debug?
-        json = MultiJson.load(response.body||'', symbolize_keys: false) rescue response.body
+        if defined? MultiJson
+          json = MultiJson.load(response.body||'', symbolize_keys: false) rescue response.body
+        else
+          json = JSON.parse(response.body||'', symbolize_names: false) rescue response.body
+        end
         logger << <<-DBG
 RESPONSE:
   #{response.headers['Status']} | #{response.headers['Content-Type']} | #{response.body.size} bytes
-  #{response.headers.except('Status', 'Connection', 'Content-Type', 'X-Request-Id').map{|h,d| "#{h}: #{d}"}.join("\n  ")}
+  #{response.headers.except('Status', 'Connection', 'Content-Type').map{|h,d| "#{h}: #{d}"}.join("\n  ")}
   #{json.pretty_inspect.split("\n").join("\n  ")}
 #{'-=- '*18}
 DBG

data/lib/ncore/exceptions.rb

@@ -7,6 +7,7 @@ module NCore
         class Error < StandardError ; end
 
         class AccessDenied < Error ; end
+        class AccountInactive < Error ; end
         class AuthenticationFailed < Error ; end
         class ConnectionError < Error ; end
         class RateLimited < Error ; end

data/lib/ncore/methods/all.rb

@@ -3,8 +3,9 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def all(params={}, api_creds=nil)
-        parsed, creds = request(:get, url, api_creds, params)
+      def all(params={})
+        params = parse_request_params(params)
+        parsed, creds = request(:get, url, params)
         if parsed[:errors].any?
           raise parent::QueryError, parsed[:errors]
         end
@@ -20,9 +21,9 @@ module NCore
         end
       end
 
-      def first(params={}, api_creds=nil)
+      def first(params={})
         params = params.with_indifferent_access.merge(max_results: 1)
-        all(params, api_creds).first
+        all(params).first
       end
     end
 

data/lib/ncore/methods/build.rb

@@ -3,8 +3,9 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def build(params={}, api_creds=nil)
-        parsed, creds = request(:get, url+'/new', api_creds, params)
+      def build(params={})
+        params = parse_request_params(params)
+        parsed, creds = request(:get, url+'/new', params)
         if parsed[:errors].any?
           raise parent::QueryError, parsed[:errors]
         end

data/lib/ncore/methods/count.rb

@@ -3,8 +3,9 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def count(params={}, api_creds=nil)
-        parsed, _ = request(:get, "#{url}/count", api_creds, params)
+      def count(params={})
+        params = parse_request_params(params)
+        parsed, _ = request(:get, "#{url}/count", params)
         parsed[:data][:count]
       end
     end

data/lib/ncore/methods/create.rb

@@ -3,28 +3,29 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def create!(attribs={}, api_creds=nil)
-        obj = create(attribs, api_creds)
-        if obj.errors.any?
+      def create!(attribs={})
+        obj = create(attribs)
+        if obj.errors?
           raise parent::RecordInvalid, obj
         end
         obj
       end
 
       # always returns a new object; check .errors? or .valid? to see how it went
-      def create(attribs={}, api_creds=nil)
-        params = {json_root => attribs}
-        parsed, creds = request(:post, url, api_creds, params)
-        new(attribs, creds).send(:load, parsed)
+      def create(attribs={})
+        params = parse_request_params(attribs)
+        obj = new({}, params[:credentials])
+        obj.send :create, params
+        obj
       end
     end
 
     private
 
     def create(attribs={})
-      params = {json_root => attribs}
-      parsed, @api_creds = request(:post, self.class.url, api_creds, params)
-      load(data: attribs) if parsed[:errors].any?
+      params = parse_request_params(attribs, json_root: json_root).reverse_merge credentials: api_creds
+      parsed, @api_creds = request(:post, self.class.url, params)
+      load(data: params[json_root]) if parsed[:errors].any?
       load(parsed)
       errors.empty? ? self : false
     end

data/lib/ncore/methods/delete.rb

@@ -3,24 +3,34 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def delete!(id, params={}, api_creds=nil)
-        obj = new({id: id}, api_creds)
-        obj.delete(params) || raise(parent::RecordInvalid, obj)
+      def delete!(id, params={})
+        obj = delete(id, attribs)
+        if obj.errors?
+          raise parent::RecordInvalid, obj
+        end
+        obj
       end
 
       # always returns a new object; check .errors? or .valid? to see how it went
-      def delete(id, params={}, api_creds=nil)
-        obj = new({id: id}, api_creds)
+      def delete(id, params={})
+        raise(parent::RecordNotFound, "Cannot delete id=nil") if id.blank?
+        params = parse_request_params(params)
+        obj = new({id: id}, params[:credentials])
         obj.delete(params)
         obj
       end
     end
 
     def delete(params={})
-      parsed, @api_creds = request(:delete, url, api_creds, params)
+      params = parse_request_params(params).reverse_merge credentials: api_creds
+      parsed, @api_creds = request(:delete, url, params)
       load(parsed)
       errors.empty? ? self : false
     end
 
+    def delete!(params={})
+      delete(params) || raise(self.class.parent::RecordInvalid, self)
+    end
+
   end
 end

data/lib/ncore/methods/delete_single.rb

@@ -3,17 +3,23 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def delete(params={}, api_creds=nil)
-        obj = new({}, api_creds)
+      def delete(params={})
+        params = parse_request_params(params)
+        obj = new({}, params[:credentials])
         obj.delete(params) || raise(parent::RecordInvalid, obj)
       end
     end
 
     def delete(params={})
-      parsed, @api_creds = request(:delete, url, api_creds, params)
+      params = parse_request_params(params).reverse_merge credentials: api_creds
+      parsed, @api_creds = request(:delete, url, params)
       load(parsed)
       errors.empty? ? self : false
     end
 
+    def delete!(params={})
+      delete(params) || raise(self.class.parent::RecordInvalid, self)
+    end
+
   end
 end

data/lib/ncore/methods/find.rb

@@ -3,13 +3,15 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def find(id, params={}, api_creds=nil)
-        o = new({id: id}, api_creds)
+      def find(id, params={})
+        raise(parent::RecordNotFound, "Cannot find id=nil") if id.blank?
+        params = parse_request_params(params)
+        o = new({id: id}, params[:credentials])
         o.reload(params)
       end
 
-      def retrieve(id, params={}, api_creds=nil)
-        find id, params, api_creds
+      def retrieve(id, params={})
+        find id, params
       rescue parent::RecordNotFound
         false
       end
@@ -17,7 +19,8 @@ module NCore
 
     def reload(find_params={})
       return if id.blank?
-      parsed, @api_creds = request(:get, url, api_creds, find_params)
+      params = parse_request_params(find_params).reverse_merge credentials: api_creds
+      parsed, @api_creds = request(:get, url, params)
       @attribs = {}.with_indifferent_access
       load(parsed)
     end

data/lib/ncore/methods/find_single.rb

@@ -3,16 +3,17 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def find(params={}, api_creds=nil)
-        parsed, creds = request(:get, url, api_creds, params)
+      def find(params={})
+        params = parse_request_params(params)
+        parsed, creds = request(:get, url, params)
         if parsed[:errors].any?
           raise parent::QueryError, parsed[:errors]
         end
         new(parsed, creds)
       end
 
-      def retrieve(params={}, api_creds=nil)
-        find params, api_creds
+      def retrieve(params={})
+        find params
       rescue parent::RecordNotFound
         false
       end
@@ -25,7 +26,8 @@ module NCore
     private
 
     def reload(find_params={})
-      parsed, @api_creds = request(:get, url, api_creds, find_params)
+      params = parse_request_params(find_params).reverse_merge credentials: api_creds
+      parsed, @api_creds = request(:get, url, params)
       @attribs = {}.with_indifferent_access
       load(parsed)
     end

data/lib/ncore/methods/update.rb

@@ -3,29 +3,35 @@ module NCore
     extend ActiveSupport::Concern
 
     module ClassMethods
-      def update!(id, attribs, api_creds=nil)
-        obj = new({id: id}, api_creds)
-        obj.save!(attribs)
+      def update!(id, attribs)
+        obj = update(id, attribs)
+        if obj.errors?
+          raise parent::RecordInvalid, obj
+        end
+        obj
       end
 
       # always returns a new object; check .errors? or .valid? to see how it went
-      def update(id, attribs, api_creds=nil)
-        obj = new({id: id}, api_creds)
-        obj.save(attribs)
+      def update(id, attribs)
+        raise(parent::RecordNotFound, "Cannot update id=nil") if id.blank?
+        params = parse_request_params(attribs)
+        obj = new({id: id}, params[:credentials])
+        obj.update params
         obj
       end
     end
 
-
-    private
-
     def update(attribs={})
-      params = {json_root => attribs}
-      parsed, @api_creds = request(:put, url, api_creds, params)
-      load(data: attribs) if parsed[:errors].any?
+      params = parse_request_params(attribs, json_root: json_root).reverse_merge credentials: api_creds
+      parsed, @api_creds = request(:put, url, params)
+      load(data: params[json_root]) if parsed[:errors].any?
       load(parsed)
       errors.empty? ? self : false
     end
 
+    def update!(params={})
+      update(params) || raise(self.class.parent::RecordInvalid, self)
+    end
+
   end
 end

data/lib/ncore/version.rb

@@ -1,3 +1,3 @@
 module NCore
-  VERSION = '1.2.1'
+  VERSION = '2.0.0'
 end

data/ncore.gemspec

@@ -6,7 +6,7 @@ require 'ncore/version'
 Gem::Specification.new do |spec|
   spec.name          = "ncore"
   spec.version       = NCore::VERSION
-  spec.authors       = ["thomas morgan"]
+  spec.authors       = ["Notioneer Team"]
   spec.email         = ["hello@notioneer.com"]
   spec.description   = %q{NCore - Ruby gem useful for building REST API clients}
   spec.summary       = %q{NCore - Gem for building REST API clients}
@@ -18,9 +18,8 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency 'activesupport', '>= 3.2', '< 5.0'
+  spec.add_dependency 'activesupport', '>= 3.2', '< 5.1'
   spec.add_dependency 'excon', '~> 0.32'
-  spec.add_dependency 'multi_json', '~> 1.7'
 
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ncore
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 2.0.0
 platform: ruby
 authors:
-- thomas morgan
+- Notioneer Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-22 00:00:00.000000000 Z
+date: 2016-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -19,7 +19,7 @@ dependencies:
         version: '3.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.1'
 - !ruby/object:Gem::Dependency
   name: excon
   requirement: !ruby/object:Gem::Requirement
@@ -44,20 +44,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.32'
-- !ruby/object:Gem::Dependency
-  name: multi_json
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -152,7 +138,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.3
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: NCore - Gem for building REST API clients