rxg_client 0.1.0 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: e7faddbac99675ec4042eb40ac013e70aa005c98
-  data.tar.gz: 36edf972b42b8012e37b6dc04b828952bbe1e074
+SHA256:
+  metadata.gz: 90d8e88c17b0befbe0616dcb6b94762d8fd4a881f73d28b9377acdff25d99861
+  data.tar.gz: 0fd92c212241c0a3bfa4a3edcf248ef88b7ca6ea7a3792a60dc43bd2b4cbd2cd
 SHA512:
-  metadata.gz: b1626b8e2375bb84512059f249caaf7bd3b386be98c18f69ca49378b43a2ebc7aeaae4cfd2d2f092e108a734e74554ac2d2cb9ad3dbdd29707b08efbb14ee8f7
-  data.tar.gz: be0004f6d585196a0f6d61e99001f79cdb020114130b581ccd786f622bcc97396222e59bd5d944d6bfd3d047cbc22124dcf3cfdddce508c8ff59de14fe7edffc
+  metadata.gz: 3e4fdf6070115ec4903ff715f14882116186b55c0c00cf5e1640586cc74473df1603cab7734a0094475e7a1f3b0c8006b37485f2d375a572251cda61376c8f6b
+  data.tar.gz: c19615651a096a6d424443f0de0ae3ac000e0e9585df8b12f645dc7716f68d3a213834f19d64ca37ac26f543c8d4e3362e45d9033bede28fd52f42a819b6b43b

data/lib/rxg_client.rb

@@ -1,37 +1,128 @@
 class RxgClient
-  require 'delegate'
   require 'httparty'
 
   include HTTParty
 
-  attr_accessor :api_key, :hostname, :request_format, :raise_exceptions
+  attr_accessor :api_key, :hostname, :base_uri, :fleet, :request_format,
+    :raise_exceptions, :verify_ssl, :auth_method, :default_timeout, :debug_output
 
   def request_format= (requested_format)
     raise HTTParty::UnsupportedFormat unless [ :json, :xml ].include?(requested_format.to_sym)
     @request_format = requested_format
   end
 
-  def initialize(hostname, api_key, request_format: :json, default_timeout: 5, raise_exceptions: false, verify_ssl: false)
+  # The following options can be configured when initializing the client:
+  #  - default_timeout: the amount of time in seconds to wait for a response.
+  #      default is 5
+  #  - raise_exceptions: true or false.
+  #      default is true
+  #  - verify_ssl: true or false.
+  #      default is true
+  #      If using an IP, must be false.
+  #  - fleet: pass true if authentication should use the 'fleetkey' header
+  #      instead of apikey.
+  #      default is false
+  #  - auth_method: must be one of: :headers, :query
+  #      default is :headers
+  #      If fleet is true, headers will always be used
+  #  - debug: pass a logger or $stdout to have debug_output logged, or nil to disable.
+  #      default is nil
+  #  - base_uri: provide an alternative base_uri, either a full URL or just the
+  #      path to append to the hostname.
+  #      default uses the admin/scaffolds context to access the traditional API
+  def initialize(hostname, api_key, request_format: :json, default_timeout: 5,
+    raise_exceptions: false, verify_ssl: false, fleet: false, debug_output: nil,
+    base_uri: 'admin/scaffolds', auth_method: :headers)
 
     self.api_key = api_key
-    
-    self.request_format = request_format.to_sym
-    self.class.format self.request_format
 
     self.hostname = hostname
-    self.class.base_uri "https://#{self.hostname}/admin/scaffolds"
-    
-    self.class.default_timeout default_timeout
+
+    self.set_base_uri(base_uri)
+
+    self.fleet = fleet
+
+    self.default_timeout = default_timeout
 
     self.raise_exceptions = raise_exceptions
 
-    self.class.default_options.update(verify: verify_ssl)
+    self.verify_ssl = verify_ssl
+
+    self.debug_output = debug_output
+
+    self.request_format = request_format.to_sym
+
+    self.auth_method = auth_method
+
   end
 
-  def auth
-    {api_key: self.api_key}
+
+  # change the active base_uri
+  def set_base_uri(base_uri)
+    if base_uri =~ /^https?:\/\//
+      self.base_uri = base_uri
+    else
+      self.base_uri = "https://#{self.hostname}/#{base_uri.delete_prefix('/')}"
+    end
+  end
+
+  # temporarily change the base_uri for the duration of the provided block, then
+  # change it back to its previous value
+  def with_base_uri(new_base_uri, &blk)
+    if block_given?
+      begin
+        old_uri = self.base_uri
+
+        set_base_uri(new_base_uri)
+
+        blk.call
+      ensure
+        set_base_uri(old_uri)
+      end
+    end
   end
 
+
+
+  def default_header
+    @headers ||= begin
+      h = { 'Accept' => "application/#{self.request_format}" }
+      if self.fleet
+        h['fleetkey'] = self.api_key
+      elsif self.auth_method == :headers # compatible with rXg version 11.442 or later
+        h['apikey'] = self.api_key
+      end
+      h
+    end
+  end
+
+  def default_query
+    case self.auth_method
+    when :query
+      { api_key: self.api_key }
+    when :headers
+      { }
+    end
+  end
+
+  %i(post get put patch delete).each do |http_method|
+    define_method(http_method) do |action, **args|
+      action = "/#{action.to_s.delete_prefix('/')}"
+      default_args = {
+        :headers      => self.default_header.merge(args.delete(:headers) || {}),
+        :query        => self.default_query.merge(args.delete(:query) || {}).presence,
+        :base_uri     => self.base_uri,
+        :timeout      => self.default_timeout,
+        :format       => self.request_format,
+        :debug_output => self.debug_output,
+        :verify       => self.verify_ssl
+      }
+      response = self.class.send(http_method, action, **default_args.merge(args))
+      response.success? ? self.parse(response.body) : raise(response.message)
+    end
+  end
+
+
   def parse(body)
     return {success: true} if body == ""
     begin
@@ -40,7 +131,7 @@ class RxgClient
         result = JSON.parse(body)
       when :xml
         result = Hash.from_xml(body)
-      else 
+      else
         raise "Request format should be one of: :json, :xml"
       end
 
@@ -62,32 +153,31 @@ class RxgClient
 
   # create a record in the given table with the attributes provided in new_record
   def create(table, new_record)
-    response = self.class.post("/#{table}/create/index.#{self.request_format}", { body: {record: new_record}.merge(self.auth) })
-    response.success? ? self.parse(response.body) : raise(response.message)
+    self.post("/#{table}/create", body: {record: new_record})
   end
-  
+
   # list all records from the given table
   def list(table)
-    response = self.class.get("/#{table}/index.#{self.request_format}", {body: self.auth})
-    response.success? ? self.parse(response.body) : raise(response.message)
+    self.get("/#{table}")
+  end
+
+  def search(table, search_params)
+    self.post("/#{table}/index", body: search_params)
   end
 
   # return the record from the given table having the given id
   def show(table, id)
-    response = self.class.get("/#{table}/show/#{id}.#{self.request_format}", {body: self.auth})
-    response.success? ? self.parse(response.body) : raise(response.message)
+    self.get("/#{table}/show/#{id}")
   end
 
   # update a record from the given table, having the given id, with the updated attributes provided in updated_record_hash
   def update(table, id, updated_record_hash)
-    response = self.class.post("/#{table}/update/#{id}.#{self.request_format}", {body: {record: updated_record_hash}.merge(self.auth)})
-    response.success? ? self.parse(response.body) : raise(response.message)
+    self.post("/#{table}/update/#{id}", body: {record: updated_record_hash})
   end
 
   # destroy a record from the given table having the given id
   def destroy(table, id)
-    response = self.class.post("/#{table}/destroy/#{id}.#{self.request_format}", {body: self.auth})
-    response.success? ? self.parse(response.body) : raise(response.message)
+    self.post("/#{table}/destroy/#{id}")
   end
 
   def execute(table, request)
@@ -99,8 +189,7 @@ class RxgClient
     #   method_args - A serialized Array or Hash of the argument(s) expected by the method.
     # example method call:
     #   node.execute("shared_credential_groups", {record_id: 7, method_name: "make_login_session", method_args:["192.168.20.111", "00:00:00:00:00:05", "test", 1]})
-    response = self.class.post("/#{table}/execute.#{self.request_format}", {query: self.auth, body: {request: request}})
-    response.success? ? self.parse(response.body) : raise(response.message)
+    self.post("/#{table}/execute", body: {request: request})
   end
 
   private
@@ -122,12 +211,11 @@ class RxgClient
   end
 
   # The listed methods will be rescued from all StandardError exceptions, and the code within
-  # the block will be executed.  
-  rescue_from StandardError, :create, :list, :show, :update, :destroy, :execute do |exception, instance|
+  # the block will be executed.
+  rescue_from StandardError, :create, :list, :show, :update, :destroy, :execute, :search do |exception, instance|
     puts exception.message
 
     raise exception if instance.raise_exceptions
   end
 
-  
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rxg_client
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.1.2
 platform: ruby
 authors:
 - Lannar Dean
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-18 00:00:00.000000000 Z
+date: 2020-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -51,8 +51,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: RXG API Client