usps-imis-api 1.0.0.pre.rc.4 → 1.0.0.pre.rc.7

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

@@ -6,29 +6,63 @@ 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
-      {
+  before do
+    allow(business_object).to receive(:raw_object).and_return(
+      Usps::Imis::Data[
         'Properties' => {
           '$values' => [
-            { 'Name' => 'Stub iMIS ID', 'Value' => { '$value' => '31092' } },
-            { 'Name' => 'Stub Integer', 'Value' => { '$value' => 43 } },
-            { 'Name' => 'Stub String', 'Value' => 'other' }
+            { 'Name' => 'ID', 'Value' => { '$value' => '31092' } },
+            { 'Name' => 'Stub Integer', 'Value' => { '$value' => 42 } },
+            { 'Name' => 'Stub String', 'Value' => 'something' }
           ]
         }
-      }
+      ]
+    )
+  end
+
+  describe '#get' do
+    it 'returns multiple values' do
+      expect(business_object.get('Stub String', 'Stub Integer')).to eq(['something', 42])
+    end
+
+    describe 'delegation to get_fields' do
+      before { allow(business_object).to receive(:get_fields).with('Stub String', 'Stub Integer') }
+
+      it 'delegates to get_fields' do
+        business_object.get('Stub String', 'Stub Integer')
+
+        expect(business_object).to have_received(:get_fields).with('Stub String', 'Stub Integer')
+      end
     end
+  end
 
-    before do
-      allow(business_object).to receive(:get).and_return({
+  describe '#get_field' do
+    it 'returns a string value' do
+      expect(business_object.get_field('Stub String')).to eq('something')
+    end
+
+    it 'returns an integer value' do
+      expect(business_object.get_field('Stub Integer')).to eq(42)
+    end
+  end
+
+  describe '#get_fields' do
+    it 'returns multiple values' do
+      expect(business_object.get_fields('Stub String', 'Stub Integer')).to eq(['something', 42])
+    end
+  end
+
+  describe '#filter_fields' do
+    let(:expected) do
+      {
         'Properties' => {
           '$values' => [
-            { 'Name' => 'Stub iMIS ID', 'Value' => { '$value' => '31092' } },
-            { 'Name' => 'Stub Integer', 'Value' => { '$value' => 42 } },
-            { 'Name' => 'Stub String', 'Value' => 'something' }
+            { 'Name' => 'ID', 'Value' => { '$value' => '31092' } },
+            { 'Name' => 'Stub Integer', 'Value' => { '$value' => 43 } },
+            { 'Name' => 'Stub String', 'Value' => 'other' }
           ]
         }
-      })
+      }
     end
 
     it 'formats fields correctly' do

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

@@ -5,10 +5,36 @@ require 'spec_helper'
 describe Usps::Imis::Config do
   let(:config) { described_class.new }
 
-  it 'sets values on initialize' do
-    config = described_class.new { |c| c.environment = 'test' }
+  describe 'environment' do
+    subject { config.environment }
 
-    expect(config.environment).to eq('test')
+    let(:config) { described_class.new }
+
+    context 'when not specified' do
+      it { is_expected.to be_development }
+    end
+
+    context 'when specified' do
+      before { config.environment = 'something' }
+
+      it { is_expected.to be_something }
+    end
+
+    context 'when specified on initialize' do
+      subject { config.environment }
+
+      let(:config) do
+        described_class.new { it.environment = 'test' }
+      end
+
+      it { is_expected.to be_test }
+    end
+
+    context 'when in Rails' do
+      before { stub_const('Rails', Struct.new(:env).new(ActiveSupport::StringInquirer.new('qa'))) }
+
+      it { is_expected.to be_qa }
+    end
   end
 
   describe '#hostname' do
@@ -25,7 +51,7 @@ describe Usps::Imis::Config do
 
       it 'raises an error' do
         expect { config.hostname }.to raise_error(
-          Usps::Imis::Error::ApiError, 'Unexpected API environment: nothing'
+          Usps::Imis::Errors::ConfigError, 'Unexpected API environment: nothing'
         )
       end
     end

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

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Usps::Imis::Data do
+  let(:data) do
+    described_class[
+      'EntityTypeName' => 'ABC_ASC_Individual_Demog',
+      'Properties' => {
+        '$values' => [
+          { 'Name' => 'ID', 'Value' => { '$value' => '31092' } },
+          { 'Name' => 'Stub Integer', 'Value' => { '$value' => 42 } },
+          { 'Name' => 'Stub String', 'Value' => 'something' }
+        ]
+      }
+    ]
+  end
+
+  describe 'missing property' do
+    it 'returns nil for missing properties' do
+      expect(data['Not Found']).to be_nil
+    end
+  end
+
+  describe '#properties' do
+    it 'iterates over the properties, excluding IDs' do
+      expect(data.properties.map { |field, value| "#{field}: #{value}" }).to eq(
+        ['Stub Integer: 42', 'Stub String: something']
+      )
+    end
+
+    it 'iterates over the properties, including IDs' do
+      expect(data.properties(include_ids: true).map { |field, value| "#{field}: #{value}" }).to eq(
+        ['ID: 31092', 'Stub Integer: 42', 'Stub String: something']
+      )
+    end
+  end
+
+  describe '#inspect' do
+    it 'generates the correct inspect string' do
+      expect(data.inspect).to eq('#<Usps::Imis::Data entity="ABC_ASC_Individual_Demog" imis_id=31092>')
+    end
+
+    context 'with data from a Panel' do
+      let(:data) do
+        described_class[
+          'EntityTypeName' => 'ABC_ASC_Individual_Demog',
+          'Properties' => {
+            '$values' => [
+              { 'Name' => 'ID', 'Value' => { '$value' => '31092' } },
+              { 'Name' => 'Ordinal', 'Value' => { '$value' => '99' } },
+              { 'Name' => 'Stub Integer', 'Value' => { '$value' => 42 } },
+              { 'Name' => 'Stub String', 'Value' => 'something' }
+            ]
+          }
+        ]
+      end
+
+      it 'generates the correct inspect string with an ordinal' do
+        expect(data.inspect).to eq(
+          '#<Usps::Imis::Data entity="ABC_ASC_Individual_Demog" imis_id=31092 ordinal=99>'
+        )
+      end
+    end
+  end
+end

data/spec/lib/usps/imis/{error/api_error_spec.rb → error_spec.rb}

@@ -2,7 +2,7 @@
 
 require 'spec_helper'
 
-describe Usps::Imis::Error::ApiError do
+describe Usps::Imis::Error do
   it 'builds Bugsnag metadata' do
     error = described_class.new('Example', something: :else)
 

data/spec/lib/usps/imis/{error → errors}/response_error_spec.rb

@@ -4,7 +4,7 @@ require 'spec_helper'
 
 ApiResponseStub = Struct.new(:code, :body)
 
-describe Usps::Imis::Error::ResponseError do
+describe Usps::Imis::Errors::ResponseError do
   let(:error) { described_class.from(response) }
 
   describe 'error codes' do
@@ -61,7 +61,7 @@ describe Usps::Imis::Error::ResponseError do
     let(:response) { ApiResponseStub.new('500', 'Body of the API response error') }
     let(:warning_text) do
       <<~WARNING.chomp
-        Usps::Imis::Error::ResponseError: [INTERNAL_SERVER_ERROR] The iMIS API returned an error.
+        Usps::Imis::Errors::ResponseError: [INTERNAL_SERVER_ERROR] The iMIS API returned an error.
         Body of the API response error
       WARNING
     end
@@ -78,7 +78,7 @@ describe Usps::Imis::Error::ResponseError do
     let(:response) { ApiResponseStub.new('500', response_body) }
     let(:warning_text) do
       <<~WARNING.chomp
-        Usps::Imis::Error::ResponseError: [INTERNAL_SERVER_ERROR] The iMIS API returned an error.
+        Usps::Imis::Errors::ResponseError: [INTERNAL_SERVER_ERROR] The iMIS API returned an error.
         description
       WARNING
     end
@@ -95,7 +95,7 @@ describe Usps::Imis::Error::ResponseError do
     let(:response) { ApiResponseStub.new('500', response_body) }
     let(:warning_text) do
       <<~WARNING.chomp
-        Usps::Imis::Error::ResponseError: [INTERNAL_SERVER_ERROR] The iMIS API returned an error.
+        Usps::Imis::Errors::ResponseError: [INTERNAL_SERVER_ERROR] The iMIS API returned an error.
         #{response_body}
       WARNING
     end

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

@@ -9,7 +9,31 @@ describe Usps::Imis::Mapper do
     it 'stores the initial imis_id' do
       mapper = described_class.new(imis_id: 42)
 
-      expect(mapper.api.imis_id).to eq('42')
+      expect(mapper.api.imis_id).to eq(42)
+    end
+  end
+
+  describe '#fetch' do
+    before { api.imis_id = 31092 }
+
+    it 'fetches a mapped field' do
+      expect(api.mapper.fetch(:mm)).to be_a(Integer)
+    end
+
+    it 'supports Hash access syntax' do
+      expect(api.mapper[:mm]).to be_a(Integer)
+    end
+
+    it 'supports Hash access syntax on the Api directly' do
+      expect(api[:mm]).to be_a(Integer)
+    end
+
+    it 'raises for unmapped updates' do
+      expect { api.mapper.fetch(:another) }.to raise_error(
+        Usps::Imis::Errors::MapperError,
+        %(Mapper does not recognize field: "another".\n) \
+        'Please report what data you are attempting to work with to ITCom leadership.'
+      )
     end
   end
 
@@ -22,8 +46,8 @@ describe Usps::Imis::Mapper do
 
     it 'raises for unmapped updates' do
       expect { api.mapper.update(something: 'anything') }.to raise_error(
-        Usps::Imis::Error::MapperError,
-        'Unrecognized field: "something". ' \
+        Usps::Imis::Errors::MapperError,
+        %(Mapper does not recognize field: "something".\n) \
         'Please report what data you are attempting to work with to ITCom leadership.'
       )
     end

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

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Usps::Imis::Mocks::BusinessObject do
+  let(:mock) { described_class.new(**fields) }
+  let(:fields) { { TotMMS: 2, Something: 'Another' } }
+
+  let(:data) do
+    Usps::Imis::Properties.build do |props|
+      props.add 'TotMMS', 2
+      props.add 'Something', 'Another'
+    end
+  end
+
+  describe 'get' do
+    it 'returns the correct data' do
+      expect(mock.get).to eq(data)
+    end
+  end
+
+  describe 'get_field' do
+    it 'returns the correct field value' do
+      expect(mock.get_field('TotMMS')).to eq(2)
+    end
+  end
+
+  describe 'get_fields' do
+    it 'returns the correct field values' do
+      expect(mock.get_fields('TotMMS', 'Something')).to eq([2, 'Another'])
+    end
+  end
+
+  describe 'put_fields' do
+    let(:combined_data) do
+      Usps::Imis::Properties.build do |props|
+        props.add 'TotMMS', 2
+        props.add 'Something', 'Another'
+        props.add 'SomethingElse', 'interesting'
+      end
+    end
+
+    it 'returns the correct data' do
+      expect(mock.put_fields(SomethingElse: 'interesting')).to eq(combined_data)
+    end
+  end
+
+  describe 'put' do
+    it 'returns the correct data' do
+      expect(mock.put(data)).to eq(data)
+    end
+  end
+
+  describe 'post' do
+    it 'returns the correct data' do
+      expect(mock.post(data)).to eq(data)
+    end
+  end
+
+  describe 'delete' do
+    it 'returns the correct data' do
+      expect(mock.delete).to eq('')
+    end
+  end
+end

data/spec/lib/usps/imis/panels/base_panel_spec.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+module Usps
+  module Imis
+    module Panels
+      class InvalidPanel < BasePanel; end
+
+      class InvalidPanelWithBusinessObject < BasePanel
+      private
+
+        def business_object = 'Something'
+      end
+    end
+  end
+end
+
+describe Usps::Imis::Panels::BasePanel do
+  it 'requires #business_object to be defined' do
+    expect { Usps::Imis::Panels::InvalidPanel.new.get(1) }.to raise_error(
+      Usps::Imis::Errors::PanelUnimplementedError,
+      'Usps::Imis::Panels::InvalidPanel must implement #business_object'
+    )
+  end
+
+  it 'requires #payload(data) to be defined' do
+    expect { Usps::Imis::Panels::InvalidPanelWithBusinessObject.new.create({}) }.to raise_error(
+      Usps::Imis::Errors::PanelUnimplementedError,
+      'Usps::Imis::Panels::InvalidPanelWithBusinessObject must implement #payload(data)'
+    )
+  end
+end

data/spec/lib/usps/imis/panels/education_spec.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Usps::Imis::Panels::Education do
+  describe 'api example' do
+    let(:education) { described_class.new }
+
+    let(:details) do
+      {
+        certificate: 'E136924',
+        description: 'Marine Navigation',
+        effective_date: Time.now.strftime('%Y-%m-%dT00:00:00'),
+        source: 'Online Exams System',
+        code: 'MN',
+        type_code: 'CRS'
+      }
+    end
+
+    before { education.api.imis_id = 6374 }
+
+    describe '#get' do
+      it 'loads a specific object' do
+        expect(education.get(90737)).to be_a(Usps::Imis::Data)
+      end
+
+      it 'returns specific fields' do
+        expect(education.get(90737, 'ABC_Product_Code', 'ABC_Other_Code')).to eq(%w[CRS AP])
+      end
+    end
+
+    describe '#get_field' do
+      it 'returns a specific field' do
+        expect(education.get_field(90737, 'ABC_Product_Code')).to eq('CRS')
+      end
+    end
+
+    describe '#get_fields' do
+      it 'returns specific fields' do
+        expect(education.get_fields(90737, 'ABC_Product_Code', 'ABC_Other_Code')).to eq(%w[CRS AP])
+      end
+    end
+
+    # rubocop:disable RSpec/ExampleLength
+    it 'interacts with records correctly', :aggregate_failures do
+      new_record = education.create(details)
+      expect(new_record).to be_a(Usps::Imis::Data)
+
+      ordinal = new_record.ordinal
+
+      update_result =
+        education.update(details.merge(source: 'Online Exams System - Modified', ordinal:))
+      expect(update_result['ABC_Educ_Source_System']).to eq('Online Exams System - Modified')
+
+      put_fields_result = education.put_fields(ordinal, 'ABC_Educ_Source_System' => 'Online Exams System - Mod2')
+      expect(put_fields_result['ABC_Educ_Source_System']).to eq('Online Exams System - Mod2')
+
+      expect(education.destroy(ordinal)).to be(true)
+    end
+    # rubocop:enable RSpec/ExampleLength
+  end
+
+  describe 'initialization with ID' do
+    it 'can initialize with an iMIS ID' do
+      panel = described_class.new(imis_id: 6374)
+
+      expect(panel.api.imis_id).to eq(6374)
+    end
+  end
+end

data/spec/lib/usps/imis/{panel → panels}/vsc_spec.rb

@@ -2,7 +2,7 @@
 
 require 'spec_helper'
 
-describe Usps::Imis::Panel::Vsc do
+describe Usps::Imis::Panels::Vsc do
   let(:vsc) { described_class.new }
 
   let(:details) do
@@ -17,22 +17,21 @@ describe Usps::Imis::Panel::Vsc do
 
   describe '#get' do
     it 'loads a specific object' do
-      expect(vsc.get(1433)).to be_a(Hash)
+      expect(vsc.get(1433)).to be_a(Usps::Imis::Data)
     end
   end
 
   # rubocop:disable RSpec/ExampleLength
   it 'handles new records correctly', :aggregate_failures do
     new_record = vsc.create(details)
-    expect(new_record).to be_a(Hash)
+    expect(new_record).to be_a(Usps::Imis::Data)
 
-    ordinal = new_record['Identity']['IdentityElements']['$values'][1]
+    ordinal = new_record.ordinal
 
     update_result = vsc.update(details.merge(count: 43, ordinal:))
-    updated = update_result['Properties']['$values'].find { |v| v['Name'] == 'Quantity' }
-    expect(updated['Value']['$value']).to eq(43)
+    expect(update_result['Quantity']).to eq(43)
 
-    expect(vsc.destroy(ordinal)).to eq('')
+    expect(vsc.destroy(ordinal)).to be(true)
   end
   # rubocop:enable RSpec/ExampleLength
 end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Usps::Imis::Properties do
+  let(:builder) { described_class.new }
+
+  it 'wraps boolean property values' do
+    expect(builder.send(:wrap, true)).to eq(
+      '$type' => 'System.Boolean', '$value' => true
+    )
+  end
+
+  it 'raises an error for unexpected property types' do
+    expect { builder.send(:wrap, {}) }.to raise_error(
+      Usps::Imis::Errors::UnexpectedPropertyTypeError, 'Unexpected property type: {}'
+    )
+  end
+end

data/spec/spec_helper.rb

@@ -7,6 +7,7 @@ SimpleCov.minimum_coverage(line: 100, branch: 100)
 
 require 'dotenv/load'
 require 'usps/imis'
+require 'active_support/string_inquirer'
 
 ENV['TESTING'] = 'true'
 
@@ -30,6 +31,8 @@ RSpec.configure do |config|
 
       imis_config.username = ENV.fetch('IMIS_USERNAME', '')
       imis_config.password = ENV.fetch('IMIS_PASSWORD', '')
+
+      imis_config.logger = Logger.new(nil)
     end
   end
 end

data/usps-imis-api.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |s|
   s.version       = Usps::Imis::VERSION
   s.summary       = 'iMIS API Wrapper'
   s.description   = 'A wrapper for the iMIS API.'
-  s.homepage      = 'http://rubygems.org/gems/usps-imis-api'
+  s.homepage      = 'https://github.com/unitedstatespowersquadrons/imis-api-ruby'
   s.authors       = ['Julian Fiander']
   s.email         = 'jsfiander@gmail.com'
   s.require_paths = %w[lib]
@@ -15,4 +15,6 @@ Gem::Specification.new do |s|
   s.metadata['rubygems_mfa_required'] = 'true'
 
   s.required_ruby_version = '>= 3.4'
+
+  s.add_dependency 'activesupport', '~> 8.0'
 end

metadata

@@ -1,14 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: usps-imis-api
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.rc.4
+  version: 1.0.0.pre.rc.7
 platform: ruby
 authors:
 - Julian Fiander
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
 description: A wrapper for the iMIS API.
 email: jsfiander@gmail.com
 executables: []
@@ -27,33 +41,47 @@ files:
 - Readme.md
 - bin/console
 - bin/setup
-- 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
-- lib/usps/imis/error/response_error.rb
+- lib/usps/imis/data.rb
+- lib/usps/imis/error.rb
+- lib/usps/imis/errors/api_error.rb
+- lib/usps/imis/errors/config_error.rb
+- lib/usps/imis/errors/locked_id_error.rb
+- lib/usps/imis/errors/mapper_error.rb
+- lib/usps/imis/errors/not_found_error.rb
+- lib/usps/imis/errors/panel_unimplemented_error.rb
+- lib/usps/imis/errors/response_error.rb
+- lib/usps/imis/errors/unexpected_property_type_error.rb
 - lib/usps/imis/mapper.rb
-- lib/usps/imis/panel/base_panel.rb
-- lib/usps/imis/panel/education.rb
-- lib/usps/imis/panel/vsc.rb
+- lib/usps/imis/mocks.rb
+- lib/usps/imis/mocks/business_object.rb
+- lib/usps/imis/panels.rb
+- lib/usps/imis/panels/base_panel.rb
+- lib/usps/imis/panels/education.rb
+- lib/usps/imis/panels/vsc.rb
+- lib/usps/imis/properties.rb
+- lib/usps/imis/query.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
+- spec/lib/usps/imis/data_spec.rb
+- spec/lib/usps/imis/error_spec.rb
+- spec/lib/usps/imis/errors/response_error_spec.rb
 - spec/lib/usps/imis/mapper_spec.rb
-- spec/lib/usps/imis/panel/base_panel_spec.rb
-- spec/lib/usps/imis/panel/education_spec.rb
-- spec/lib/usps/imis/panel/vsc_spec.rb
+- spec/lib/usps/imis/mocks/business_object_spec.rb
+- spec/lib/usps/imis/panels/base_panel_spec.rb
+- spec/lib/usps/imis/panels/education_spec.rb
+- spec/lib/usps/imis/panels/vsc_spec.rb
+- spec/lib/usps/imis/properties_spec.rb
 - spec/lib/usps/imis_spec.rb
 - spec/spec_helper.rb
 - usps-imis-api.gemspec
-homepage: http://rubygems.org/gems/usps-imis-api
+homepage: https://github.com/unitedstatespowersquadrons/imis-api-ruby
 licenses: []
 metadata:
   rubygems_mfa_required: 'true'

data/lib/ext/hash.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-# Import a simplified version of to_query from Rails if not already defined
-class Hash
-  def to_query
-    map do |key, value|
-      "#{CGI.escape(key.to_s)}=#{CGI.escape(value.to_s)}"
-    end.sort * '&'
-  end
-end