usps-imis-api 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1febbdb28781a5589ce97b66eb071728aef8b8e81991970854620c9fc128cf54
-  data.tar.gz: cc5aeb7ddab766c885d4bb009b1fa9afcdaa8f71d68b56f2e86861c12f8eda72
+  metadata.gz: 5db9ae9c192ad976e8a08ddaea01218cb36ab043e550108b08582c782cb43705
+  data.tar.gz: 52951b92b37e906ddd9faa2aedc44d3000e541301e8411227220094bb9dc9525
 SHA512:
-  metadata.gz: '09fdb03097ef67813356bf1a4378f53827bcacc3c8115fb9128ce0f2a8dcdceb26aafc3296b8132468860906ac3884965c53b4e47729aa8dc0a964a13346717e'
-  data.tar.gz: 3703f4325f53afde2c9350c4382d0cbfeb4d53489275c866a1041749ba5324d7833c4a3fe14f11e70bcd3a1729981f2b3b3befcd3a603a5ab5703a03ae6a9cc5
+  metadata.gz: b32e24b9550ed06bd3971d0ac9072b3011a4fc59734874bfa8e916b6d8832739f8967318e9ca9fc037e24c9b57d9cbe3f2bb37a3a649af95c24e9b5cc8b74033
+  data.tar.gz: fc1934e11eb736e2b91c48cc9a7806f8645f0a5f9b0be87a2e30b309b57b023289dd007e154ce4ba6fc880876671961823229a45cb1a4897e68cde5cb89e3c31

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    usps-imis-api (0.5.0)
+    usps-imis-api (0.6.0)
 
 GEM
   remote: https://rubygems.org/

data/Readme.md

@@ -82,7 +82,7 @@ To fetch member data, run e.g.:
 ```ruby
 api.imis_id = 31092
 
-data = api.get('ABC_ASC_Individual_Demog')
+data = api.on('ABC_ASC_Individual_Demog').get
 ```
 
 ### PUT Fields
@@ -93,7 +93,7 @@ To update member data, run e.g.:
 api.imis_id = 31092
 
 data = { 'MMS_Updated' => Time.now.strftime('%Y-%m-%dT%H:%M:%S'), 'TotMMS' => new_total }
-update = api.put_fields('ABC_ASC_Individual_Demog', data)
+update = api.on('ABC_ASC_Individual_Demog').put_fields(data)
 ```
 
 This method fetches the current data structure, and filters it down to just what you want to
@@ -106,7 +106,7 @@ To update member data, run e.g.:
 ```ruby
 api.imis_id = 31092
 
-update = api.put('ABC_ASC_Individual_Demog', complete_imis_object)
+update = api.on('ABC_ASC_Individual_Demog').put(complete_imis_object)
 ```
 
 This method requires a complete iMIS data structure.
@@ -116,7 +116,7 @@ This method requires a complete iMIS data structure.
 To create new member data, run e.g.:
 
 ```ruby
-created = api.post('ABC_ASC_Individual_Demog', complete_imis_object)
+created = api.on('ABC_ASC_Individual_Demog').post(complete_imis_object)
 ```
 
 This method requires a complete iMIS data structure.
@@ -128,7 +128,7 @@ To remove member data, run e.g.:
 ```ruby
 api.imis_id = 31092
 
-api.delete('ABC_ASC_Individual_Demog')
+api.on('ABC_ASC_Individual_Demog').delete
 ```
 
 This returns a blank string on success.
@@ -202,9 +202,11 @@ previous value.
 
 ```ruby
 api.with(31092) do
-  # These three requests are identical:
+  # These four requests are identical:
 
-  put('ABC_ASC_Individual_Demog', { 'TotMMS' => 15 })
+  on('ABC_ASC_Individual_Demog') { put('TotMMS' => 15) }
+
+  on('ABC_ASC_Individual_Demog').put('TotMMS' => 15)
 
   mapper.update(mm: 15)
 

data/lib/usps/imis/api.rb

@@ -5,14 +5,12 @@ module Usps
     # The core API wrapper
     #
     class Api
+      include Requests
+
       # Endpoint for (re-)authentication requests
       #
       AUTHENTICATION_PATH = 'Token'
 
-      # Endpoint for general API requests
-      #
-      API_PATH = 'api'
-
       # Endpoint for IQA query requests
       #
       QUERY_PATH = 'api/Query'
@@ -31,6 +29,10 @@ module Usps
       #
       attr_reader :imis_id
 
+      # Whether to lock changes to the selected iMIS ID
+      #
+      attr_reader :lock_imis_id
+
       # A new instance of +Api+
       #
       # @param skip_authentication [bool] Skip authentication on initialization (used for tests)
@@ -46,7 +48,9 @@ module Usps
       # @param id [Integer, String] iMIS ID to select for future requests
       #
       def imis_id=(id)
-        @imis_id = id.to_i.to_s
+        raise Error::ApiError, 'Cannot change iMIS ID while locked' if lock_imis_id
+
+        @imis_id = id&.to_i&.to_s
       end
 
       # Convert a member's certificate number into an iMIS ID number
@@ -56,15 +60,21 @@ module Usps
       # @return [String] Corresponding iMIS ID
       #
       def imis_id_for(certificate)
-        result = query(Imis.configuration.imis_id_query_name, { certificate: })
-        @imis_id = result['Items']['$values'][0]['ID']
-      rescue StandardError
-        raise Error::ApiError, 'Member not found'
+        raise Error::ApiError, 'Cannot change iMIS ID while locked' if lock_imis_id
+
+        begin
+          result = query(Imis.configuration.imis_id_query_name, { certificate: })
+          @imis_id = result['Items']['$values'][0]['ID']
+        rescue StandardError
+          raise Error::ApiError, 'Member not found'
+        end
       end
 
       # Run requests as DSL, with specific iMIS ID only maintained for this scope
       #
-      # This should be used with methods that do not change the value of `imis_id`
+      # While in this block, changes to the value of +imis_id+ are not allowed
+      #
+      # If no block is given, this sets the iMIS ID and returns self.
       #
       # @param id [Integer, String] iMIS ID to select for requests within the block
       #
@@ -76,104 +86,68 @@ module Usps
       def with(id, &)
         old_id = imis_id
         self.imis_id = id
+        return self unless block_given?
+
+        @lock_imis_id = true
         instance_eval(&)
       ensure
-        self.imis_id = old_id
+        if block_given?
+          @lock_imis_id = false
+          self.imis_id = old_id
+        end
       end
 
-      # Get a business object for the current member
+      # Run an IQA Query
       #
-      # @param business_object_name [String] Name of the business object
-      # @param url_id [String] Override the ID param of the URL (e.g. used for Panels)
+      # @param query_name [String] Full path of the query in IQA, e.g. +$/_ABC/Fiander/iMIS_ID+
+      # @query_params [Hash] Conforms to pattern +{ param_name => param_value }+
       #
       # @return [Hash] Response data from the API
       #
-      def get(business_object_name, url_id: nil)
-        uri = uri_for(business_object_name, url_id:)
+      def query(query_name, query_params = {})
+        query_params[:QueryName] = query_name
+        path = "#{QUERY_PATH}?#{query_params.to_query}"
+        uri = URI(File.join(Imis.configuration.hostname, path))
         request = Net::HTTP::Get.new(uri)
         result = submit(uri, authorize(request))
         JSON.parse(result.body)
       end
 
-      # Update only specific fields on a business object for the current member
+      # An instance of +BusinessObject+, using this instance as its parent +Api+
       #
       # @param business_object_name [String] Name of the business object
-      # @param fields [Hash] Conforms to pattern +{ field_key => value }+
       # @param url_id [String] Override the ID param of the URL (e.g. used for Panels)
       #
-      # @return [Hash] Response data from the API
-      #
-      def put_fields(business_object_name, fields, url_id: nil)
-        updated = filter_fields(business_object_name, fields)
-        put(business_object_name, updated, url_id:)
+      def business_object(business_object_name, url_id: nil)
+        BusinessObject.new(self, business_object_name, url_id:)
       end
 
-      # Update a business object for the current member
+      # Run requests as DSL, with specific +BusinessObject+ only maintained for this scope
       #
-      # @param business_object_name [String] Name of the business object
-      # @param body [Hash] Full raw API object data
-      # @param url_id [String] Override the ID param of the URL (e.g. used for Panels)
-      #
-      # @return [Hash] Response data from the API
-      #
-      def put(business_object_name, body, url_id: nil)
-        uri = uri_for(business_object_name, url_id:)
-        request = Net::HTTP::Put.new(uri)
-        request.body = JSON.dump(body)
-        result = submit(uri, authorize(request))
-        JSON.parse(result.body)
-      end
-
-      # Create a business object for the current member
+      # If no block is given, this returns the specified +BusinessObject+.
       #
       # @param business_object_name [String] Name of the business object
-      # @param body [Hash] Full raw API object data
       # @param url_id [String] Override the ID param of the URL (e.g. used for Panels)
       #
-      # @return [Hash] Response data from the API
-      #
-      def post(business_object_name, body, url_id: nil)
-        uri = uri_for(business_object_name, url_id:)
-        request = Net::HTTP::Post.new(uri)
-        request.body = JSON.dump(body)
-        result = submit(uri, authorize(request))
-        JSON.parse(result.body)
-      end
+      def on(business_object_name, url_id: nil, &)
+        object = business_object(business_object_name, url_id:)
+        return object unless block_given?
 
-      # Remove a business object for the current member
-      #
-      # @param business_object_name [String] Name of the business object
-      # @param url_id [String] Override the ID param of the URL (e.g. used for Panels)
-      #
-      # @return [String] Error response body from the API, or empty string on success
-      #
-      def delete(business_object_name, url_id: nil)
-        uri = uri_for(business_object_name, url_id:)
-        request = Net::HTTP::Delete.new(uri)
-        result = submit(uri, authorize(request))
-        result.body
+        result = nil
+        object.tap { |obj| result = obj.instance_eval(&) }
+        result
       end
 
-      # Run an IQA Query
-      #
-      # @param query_name [String] Full path of the query in IQA, e.g. +$/_ABC/Fiander/iMIS_ID+
-      # @query_params [Hash] Conforms to pattern +{ param_name => param_value }+
+      # An instance of +Mapper+, using this instance as its parent +Api+
       #
-      # @return [Hash] Response data from the API
-      #
-      def query(query_name, query_params = {})
-        query_params[:QueryName] = query_name
-        path = "#{QUERY_PATH}?#{query_params.to_query}"
-        uri = URI(File.join(imis_hostname, path))
-        request = Net::HTTP::Get.new(uri)
-        result = submit(uri, authorize(request))
-        JSON.parse(result.body)
+      def mapper
+        @mapper ||= Mapper.new(self)
       end
 
-      # An instance of Mapper, using this instance as its parent +Api+
+      # Convenience alias for updating mapped fields
       #
-      def mapper
-        @mapper ||= Mapper.new(self)
+      def update(data)
+        mapper.update(data)
       end
 
       # Convenience accessor for available Panel objects, each using this instance as its parent
@@ -186,56 +160,16 @@ module Usps
         )
       end
 
-      # Convenience alias for updating mapped fields
-      #
-      def update(data)
-        mapper.update(data)
-      end
-
       # Ruby 3.5 instance variable filter
       #
       def instance_variables_to_inspect = %i[@token_expiration @imis_id]
 
     private
 
-      def client(uri)
-        Net::HTTP.new(uri.host, uri.port).tap do |http|
-          http.use_ssl = true
-          http.verify_mode = OpenSSL::SSL::VERIFY_PEER
-        end
-      end
-
-      def imis_hostname
-        Imis.configuration.hostname
-      end
-
-      # Authorize a request prior to submitting
-      #
-      # If the current token is missing/expired, request a new one
-      #
-      def authorize(request)
-        authenticate if token_expiration < Time.now
-        request.tap { |r| r.add_field('Authorization', "Bearer #{token}") }
-      end
-
-      # Construct a business object API endpoint address
-      #
-      def uri_for(business_object_name, url_id: nil)
-        url_id ||= imis_id
-        url_id = CGI.escape(url_id)
-        URI(File.join(imis_hostname, "#{API_PATH}/#{business_object_name}/#{url_id}"))
-      end
-
-      def submit(uri, request)
-        client(uri).request(request).tap do |result|
-          raise Error::ResponseError.from(result) unless result.is_a?(Net::HTTPSuccess)
-        end
-      end
-
       # Authenticate to the iMIS API, and store the access token and expiration time
       #
       def authenticate
-        uri = URI(File.join(imis_hostname, AUTHENTICATION_PATH))
+        uri = URI(File.join(Imis.configuration.hostname, AUTHENTICATION_PATH))
         req = Net::HTTP::Post.new(uri)
         authentication_data = {
           grant_type: 'password',
@@ -249,33 +183,6 @@ module Usps
         @token = json['access_token']
         @token_expiration = Time.parse(json['.expires'])
       end
-
-      # Manually assemble the matching data structure, with fields in the correct order
-      #
-      def filter_fields(business_object_name, fields)
-        existing = get(business_object_name)
-
-        JSON.parse(JSON.dump(existing)).tap do |updated|
-          # The first property is always the iMIS ID again
-          updated['Properties']['$values'] = [existing['Properties']['$values'][0]]
-
-          # Iterate through all existing fields
-          existing['Properties']['$values'].each do |value|
-            next unless fields.keys.include?(value['Name'])
-
-            # Strings are not wrapped in the type definition structure
-            new_value = fields[value['Name']]
-            if new_value.is_a?(String)
-              value['Value'] = new_value
-            else
-              value['Value']['$value'] = new_value
-            end
-
-            # Add the completed field with the updated value
-            updated['Properties']['$values'] << value
-          end
-        end
-      end
     end
   end
 end

data/lib/usps/imis/business_object.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    # DEV
+    class BusinessObject
+      include Requests
+
+      # Endpoint for general API requests
+      #
+      API_PATH = 'api'
+
+      # The parent +Api+ object
+      #
+      attr_reader :api
+
+      # Name of the iMIS Business Object
+      #
+      attr_reader :business_object_name
+
+      # Override ID param of the URL (e.g. used for Panels)
+      #
+      attr_reader :url_id
+
+      # A new instance of +BusinessObject+
+      #
+      def initialize(api, business_object_name, url_id: nil)
+        @api = api
+        @business_object_name = business_object_name
+        @url_id = url_id
+      end
+
+      # Get a business object for the current member
+      #
+      # @return [Hash] Response data from the API
+      #
+      def get
+        request = Net::HTTP::Get.new(uri)
+        result = submit(uri, authorize(request))
+        JSON.parse(result.body)
+      end
+
+      # Update only specific fields on a business object for the current member
+      #
+      # @param fields [Hash] Conforms to pattern +{ field_key => value }+
+      #
+      # @return [Hash] Response data from the API
+      #
+      def put_fields(fields)
+        updated = filter_fields(fields)
+        put(updated)
+      end
+
+      # Update a business object for the current member
+      #
+      # @param body [Hash] Full raw API object data
+      #
+      # @return [Hash] Response data from the API
+      #
+      def put(body)
+        request = Net::HTTP::Put.new(uri)
+        request.body = JSON.dump(body)
+        result = submit(uri, authorize(request))
+        JSON.parse(result.body)
+      end
+
+      # Create a business object for the current member
+      #
+      # @param body [Hash] Full raw API object data
+      #
+      # @return [Hash] Response data from the API
+      #
+      def post(body)
+        request = Net::HTTP::Post.new(uri)
+        request.body = JSON.dump(body)
+        result = submit(uri, authorize(request))
+        JSON.parse(result.body)
+      end
+
+      # Remove a business object for the current member
+      #
+      # @return [String] Error response body from the API, or empty string on success
+      #
+      def delete
+        request = Net::HTTP::Delete.new(uri)
+        result = submit(uri, authorize(request))
+        result.body
+      end
+
+    private
+
+      def token = api.token
+      def token_expiration = api.token_expiration
+
+      # Construct a business object API endpoint address
+      #
+      def uri
+        id_for_url = url_id ? CGI.escape(url_id) : api.imis_id
+        full_path = "#{API_PATH}/#{business_object_name}/#{id_for_url}"
+        URI(File.join(Imis.configuration.hostname, full_path))
+      end
+
+      # Manually assemble the matching data structure, with fields in the correct order
+      #
+      def filter_fields(fields)
+        existing = get
+
+        JSON.parse(JSON.dump(existing)).tap do |updated|
+          # The first property is always the iMIS ID again
+          updated['Properties']['$values'] = [existing['Properties']['$values'][0]]
+
+          # Iterate through all existing fields
+          existing['Properties']['$values'].each do |value|
+            next unless fields.keys.include?(value['Name'])
+
+            # Strings are not wrapped in the type definition structure
+            new_value = fields[value['Name']]
+            if new_value.is_a?(String)
+              value['Value'] = new_value
+            else
+              value['Value']['$value'] = new_value
+            end
+
+            # Add the completed field with the updated value
+            updated['Properties']['$values'] << value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/usps/imis/mapper.rb

@@ -47,7 +47,7 @@ module Usps
         end
 
         updates.map do |business_object_name, field_updates|
-          api.put_fields(business_object_name, field_updates)
+          api.business_object(business_object_name).put_fields(field_updates)
         end
       end
 

data/lib/usps/imis/panel/base_panel.rb

@@ -20,7 +20,7 @@ module Usps
         # @param ordinal [Integer] The ordinal identifier for the desired object
         #
         def get(ordinal)
-          api.get(business_object, url_id: "~#{api.imis_id}|#{ordinal}")
+          api.business_object(business_object, url_id: "~#{api.imis_id}|#{ordinal}").get
         end
 
         # Create a new object in the Panel
@@ -28,7 +28,7 @@ module Usps
         # @param data [Hash] The record data for the desired object
         #
         def create(data)
-          api.post(business_object, payload(data), url_id: '')
+          api.business_object(business_object, url_id: '').post(payload(data))
         end
 
         # Update an existing object in the Panel
@@ -37,7 +37,9 @@ module Usps
         #                    +ordinal+ identifier
         #
         def update(data)
-          api.put(business_object, payload(data), url_id: "~#{api.imis_id}|#{data[:ordinal]}")
+          api
+            .business_object(business_object, url_id: "~#{api.imis_id}|#{data[:ordinal]}")
+            .put(payload(data))
         end
 
         # Remove a specific object from the Panel
@@ -45,7 +47,7 @@ module Usps
         # @param ordinal [Integer] The ordinal identifier for the desired object
         #
         def destroy(ordinal)
-          api.delete(business_object, url_id: "~#{api.imis_id}|#{ordinal}")
+          api.business_object(business_object, url_id: "~#{api.imis_id}|#{ordinal}").delete
         end
 
       private

data/lib/usps/imis/requests.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    module Requests
+    private
+
+      def client(uri)
+        Net::HTTP.new(uri.host, uri.port).tap do |http|
+          http.use_ssl = true
+          http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+        end
+      end
+
+      # Authorize a request prior to submitting
+      #
+      # If the current token is missing/expired, request a new one
+      #
+      def authorize(request)
+        authenticate if token_expiration < Time.now
+        request.tap { |r| r.add_field('Authorization', "Bearer #{token}") }
+      end
+
+      def submit(uri, request)
+        client(uri).request(request).tap do |result|
+          raise Error::ResponseError.from(result) unless result.is_a?(Net::HTTPSuccess)
+        end
+      end
+    end
+  end
+end

data/lib/usps/imis/version.rb

@@ -2,6 +2,6 @@
 
 module Usps
   module Imis
-    VERSION = '0.5.0'
+    VERSION = '0.6.0'
   end
 end

data/lib/usps/imis.rb

@@ -16,6 +16,8 @@ require_relative 'imis/config'
 require_relative 'imis/error/api_error'
 require_relative 'imis/error/mapper_error'
 require_relative 'imis/error/response_error'
+require_relative 'imis/requests'
+require_relative 'imis/business_object'
 require_relative 'imis/api'
 require_relative 'imis/mapper'
 require_relative 'imis/panel/base_panel'

data/spec/lib/usps/imis/api_spec.rb

@@ -41,7 +41,9 @@ describe Usps::Imis::Api do
     before { api.imis_id = 31092 }
 
     it 'sends an update' do
-      expect(api.put_fields('ABC_ASC_Individual_Demog', { 'TotMMS' => 15 })).to be_a(Hash)
+      expect(api.business_object('ABC_ASC_Individual_Demog').put_fields('TotMMS' => 15)).to(
+        be_a(Hash)
+      )
     end
 
     context 'when receiving a response error' do
@@ -61,8 +63,8 @@ describe Usps::Imis::Api do
       end
 
       it 'wraps the error' do
-        expect { api.put_fields('ABC_ASC_Individual_Demog', { 'TotMMS' => 15 }) }.to raise_error(
-          Usps::Imis::Error::ApiError, warning_text
+        expect { api.business_object('ABC_ASC_Individual_Demog').put_fields('TotMMS' => 15) }.to(
+          raise_error(Usps::Imis::Error::ApiError, warning_text)
         )
       end
     end
@@ -71,7 +73,7 @@ describe Usps::Imis::Api do
   describe '#with' do
     it 'sends an update from put' do
       expect(
-        api.with(31092) { put_fields('ABC_ASC_Individual_Demog', { 'TotMMS' => 15 }) }
+        api.with(31092) { business_object('ABC_ASC_Individual_Demog').put_fields('TotMMS' => 15) }
       ).to be_a(Hash)
     end
 
@@ -82,6 +84,51 @@ describe Usps::Imis::Api do
     it 'uses a panel correctly' do
       expect(api.with(6374) { panels.vsc.get(1433) }).to be_a(Hash)
     end
+
+    it 'blocks calling imis_id=' do
+      expect do
+        api.with(31092) { self.imis_id = 31092 }
+      end.to raise_error(Usps::Imis::Error::ApiError, 'Cannot change iMIS ID while locked')
+    end
+
+    it 'blocks calling imis_id_for' do
+      expect do
+        api.with(31092) { imis_id_for('E231625') }
+      end.to raise_error(Usps::Imis::Error::ApiError, 'Cannot change iMIS ID while locked')
+    end
+  end
+
+  describe '#on' do
+    it 'returns a BusinessObject without a block' do
+      expect(api.on('ABC_ASC_Individual_Demog')).to be_a(Usps::Imis::BusinessObject)
+    end
+
+    it 'sends an update from put', :aggregate_failures do
+      result = api.with(31092) do
+        on('ABC_ASC_Individual_Demog') { put_fields({ 'TotMMS' => 15 }) }
+      end
+
+      expect(result).to be_a(Hash)
+      expect(api.imis_id).to be_nil
+    end
+
+    it 'chains .with().on() to a single block', :aggregate_failures do
+      result = api.with(31092).on('ABC_ASC_Individual_Demog') do
+        put_fields({ 'TotMMS' => 15 })
+      end
+
+      expect(result).to be_a(Hash)
+      expect(api.imis_id).to eq('31092')
+    end
+
+    it 'nests on and with', :aggregate_failures do
+      result = api.on('ABC_ASC_Individual_Demog') do |object|
+        api.with(31092) { object.put_fields({ 'TotMMS' => 15 }) }
+      end
+
+      expect(result).to be_a(Hash)
+      expect(api.imis_id).to be_nil
+    end
   end
 
   describe '#inspect' do
@@ -108,36 +155,4 @@ describe Usps::Imis::Api do
       expect(api).to have_received(:authenticate)
     end
   end
-
-  describe '#filter_fields' do
-    let(:expected) do
-      {
-        'Properties' => {
-          '$values' => [
-            { 'Name' => 'Stub iMIS ID', 'Value' => { '$value' => '31092' } },
-            { 'Name' => 'Stub Integer', 'Value' => { '$value' => 43 } },
-            { 'Name' => 'Stub String', 'Value' => 'other' }
-          ]
-        }
-      }
-    end
-
-    before do
-      allow(api).to receive(:get).and_return({
-        'Properties' => {
-          '$values' => [
-            { 'Name' => 'Stub iMIS ID', 'Value' => { '$value' => '31092' } },
-            { 'Name' => 'Stub Integer', 'Value' => { '$value' => 42 } },
-            { 'Name' => 'Stub String', 'Value' => 'something' }
-          ]
-        }
-      })
-    end
-
-    it 'formats fields correctly' do
-      updated = api.send(:filter_fields, 'Stub', { 'Stub Integer' => 43, 'Stub String' => 'other' })
-
-      expect(updated).to eq(expected)
-    end
-  end
 end

data/spec/lib/usps/imis/business_object_spec.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Usps::Imis::BusinessObject do
+  let(:business_object) { described_class.new(api, 'Stub') }
+  let(:api) { Usps::Imis::Api.new }
+
+  describe '#filter_fields' do
+    let(:expected) do
+      {
+        'Properties' => {
+          '$values' => [
+            { 'Name' => 'Stub iMIS ID', 'Value' => { '$value' => '31092' } },
+            { 'Name' => 'Stub Integer', 'Value' => { '$value' => 43 } },
+            { 'Name' => 'Stub String', 'Value' => 'other' }
+          ]
+        }
+      }
+    end
+
+    before do
+      allow(business_object).to receive(:get).and_return({
+        'Properties' => {
+          '$values' => [
+            { 'Name' => 'Stub iMIS ID', 'Value' => { '$value' => '31092' } },
+            { 'Name' => 'Stub Integer', 'Value' => { '$value' => 42 } },
+            { 'Name' => 'Stub String', 'Value' => 'something' }
+          ]
+        }
+      })
+    end
+
+    it 'formats fields correctly' do
+      updated = business_object.send(:filter_fields, 'Stub Integer' => 43, 'Stub String' => 'other')
+
+      expect(updated).to eq(expected)
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: usps-imis-api
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Julian Fiander
@@ -30,6 +30,7 @@ files:
 - lib/ext/hash.rb
 - lib/usps/imis.rb
 - lib/usps/imis/api.rb
+- lib/usps/imis/business_object.rb
 - lib/usps/imis/config.rb
 - lib/usps/imis/error/api_error.rb
 - lib/usps/imis/error/mapper_error.rb
@@ -38,8 +39,10 @@ files:
 - lib/usps/imis/panel/base_panel.rb
 - lib/usps/imis/panel/education.rb
 - lib/usps/imis/panel/vsc.rb
+- lib/usps/imis/requests.rb
 - lib/usps/imis/version.rb
 - spec/lib/usps/imis/api_spec.rb
+- spec/lib/usps/imis/business_object_spec.rb
 - spec/lib/usps/imis/config_spec.rb
 - spec/lib/usps/imis/error/api_error_spec.rb
 - spec/lib/usps/imis/error/response_error_spec.rb