usps-imis-api 0.10.3 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a699891bdb0679741aafb3754e7939bfcd7f854b51e6cab76c25f6d9fc69995
-  data.tar.gz: 97ff09a0b7d9c1981b9170c96e3885e57f82465e08fa8a8be4c1b20cf7c8f822
+  metadata.gz: 6a938a3621c6e575ac4d205495bbdccf39b4579a986a4431730d366bee510824
+  data.tar.gz: 7cfbacbf135e1f9899510fc54ff05aa079bf70f24b1c93b81de0bcd78fc26218
 SHA512:
-  metadata.gz: 49f73bb0e65581cb15cb8004170ed22963e025693e8fb62f33a09b6c2afa5ca548a9a37354867679a9562205ff752a18b812bcca085b1b575c3c5bc48ec45564
-  data.tar.gz: 5f455a1a8a0231e08d6b83297ebcfcfea0c423dc6396ae4e1ec312d6da52e111b6a25babc978f232631242ac86da14499cfc2d6ac246c90779e41be6049b3fb7
+  metadata.gz: 679178e131a5fa45915738be179b82173fa8383c0109ba6fe5e2d73b9f85c1ecdb6bc160e94ed385866371ed10e465de17a05409b55de64e015f8d44d4b12c0a
+  data.tar.gz: 66466bcfca8c602e00a04a3f52599cf96f0bae5d64065542e615bbb8acb9cab27fd5b44552e9367ecdb8ef3004ac9a40e3417a5ec8bc6a46b8ffb04cff7aed96

data/Readme.md

@@ -39,380 +39,9 @@ Usps::Imis.configure do |config|
 end
 ```
 
-When using `bin/console`, this configuration will be run by default.
-
-Instantiate the API object:
-
-```ruby
-api = Usps::Imis::Api.new
-```
-
-If you already have an iMIS ID to work with, you can pass that in immediately:
-
-```ruby
-api = Usps::Imis::Api.new(imis_id: imis_id)
-```
-
-### Authentication
-
-If a token is not available, this will automatically fetch one when needed. As long as that token
-should still be valid, it will reuse the same token. If the token should expire, this will
-automatically request a new token.
-
 ## Usage
 
-### iMIS ID
-
-To act on member data, you need to have the iMIS ID. If you already have access to that from the
-database, you can skip this step.
-
-To convert a member's certificate number into their iMIS ID, run the following method:
-
-```ruby
-api.imis_id_for(certificate)
-```
-
-This will both return the ID, and store it for use with other requests. If you need to change which
-member you are working with, just run this method again with the new certificate number.
-
-You can also manually set the current ID, if you already have it for a given member
-
-```ruby
-api.imis_id = imis_id
-```
-
-#### Without an iMIS ID
-
-Running requests without an iMIS ID set will raise an exception.
-
-If you want to query the entire Business Object, use the query interface instead:
-
-```ruby
-api = Usps::Imis::Api.new # No iMIS ID set
-
-# These requests are identical:
-
-Usps::Imis::Query.new(api, 'ABC_ASC_Individual_Demog')
-
-api.on('ABC_ASC_Individual_Demog').query
-
-api.query('ABC_ASC_Individual_Demog')
-```
-
-### Business Object and Panel Actions
-
-Business Objects and Panels support the following actions.
-
-Panels require passing in the ordinal identifier as an argument, except for `POST`.
-
-#### GET
-
-To fetch member data, run e.g.:
-
-```ruby
-data = api.on('ABC_ASC_Individual_Demog').get
-```
-
-You can also pass in specific field names to filter the returned member data, e.g.:
-
-```ruby
-data = api.on('ABC_ASC_Individual_Demog').get('TotMMS', 'MMS_Updated')
-```
-
-The response from `get` behaves like a Hash, but directly accesses property values by name.
-If you need to access the rest of the underlying data, use the `raw` method:
-
-```ruby
-data = api.on('ABC_ASC_Individual_Demog').get
-data['TotMMS']
-data.raw['EntityTypeName']
-```
-
-Alias: `read`
-
-#### GET Field
-
-To fetch a specific field from member data, run e.g.:
-
-```ruby
-tot_mms = api.on('ABC_ASC_Individual_Demog').get_field('TotMMS')
-```
-
-You can also access fields directly on the Business Object or Panel like a Hash:
-
-```ruby
-tot_mms = api.on('ABC_ASC_Individual_Demog')['TotMMS']
-```
-
-Alias: `fetch`
-
-#### GET Fields
-
-To fetch multiple specific fields from member data, run e.g.:
-
-```ruby
-data = api.on('ABC_ASC_Individual_Demog').get_fields('TotMMS', 'MMS_Updated')
-```
-
-Alias: `fetch_all`
-
-#### PUT Fields
-
-To update member data, run e.g.:
-
-```ruby
-data = { 'MMS_Updated' => Time.now.strftime('%Y-%m-%dT%H:%M:%S'), 'TotMMS' => new_total }
-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
-update, to reduce the likelihood of update collisions or type validation failures.
-
-Alias: `patch`
-
-#### PUT
-
-To update member data, run e.g.:
-
-```ruby
-update = api.on('ABC_ASC_Individual_Demog').put(complete_imis_object)
-```
-
-This method requires a complete iMIS data structure. However, any properties not included will be
-left unmodified (meaning this also effectively handles `PATCH`, though iMIS does not accept that
-HTTP verb).
-
-Alias: `update`
-
-#### POST
-
-To create new member data, run e.g.:
-
-```ruby
-created = api.on('ABC_ASC_Individual_Demog').post(complete_imis_object)
-```
-
-This method requires a complete iMIS data structure.
-
-Alias: `create`
-
-#### DELETE
-
-To remove member data, run e.g.:
-
-```ruby
-api.on('ABC_ASC_Individual_Demog').delete
-```
-
-Alias: `destroy`
-
-### QUERY
-
-Run an IQA Query
-
-`query_params` is a hash of shape: `{ param_name => param_value }`
-
-```ruby
-query = api.query(query_name, query_params)
-
-query.each do |item|
-  # Download all pages of the query, then iterate on the results
-end
-
-query.find_each do |item|
-  # Iterate one page at a time, fetching new pages automatically
-end
-```
-
-### Field Mapper
-
-For fields that have already been mapped between the ITCom database and iMIS, you can use the
-Mapper class to further simplify the `fetch` / `update` interfaces:
-
-```ruby
-mm = api.mapper.fetch(:mm)
-mm = api.mapper[:mm]
-```
-
-```ruby
-api.mapper.update(mm: 15)
-```
-
-For simplicity, you can also call `fetch` (or simply use Hash access syntax) and `update` on the
-`Api` class directly:
-
-```ruby
-api.fetch(:mm)
-api[:mm]
-```
-
-```ruby
-api.update(mm: 15)
-api[:mm] = 15
-```
-
-If there is no known mapping for the requested field, the Mapper will give up, but will provide
-you with the standard API call syntax, and will suggest you inform ITCom leadership of the new
-mapping you need.
-
-### Panels
-
-For supported panels (usually, business objects with composite identity keys), you can interact
-with them in the same general way:
-
-```ruby
-vsc = Usps::Imis::Panels::Vsc.new(imis_id: 6374)
-
-vsc.get(1417)
-
-# All of these options are identical
-#
-vsc.get(1417, 'Quantity').first
-vsc.get(1417)['Quantity']
-vsc[1417, 'Quantity']
-vsc.get(1417).raw['Properties']['$values'].find { it['Name'] == 'Quantity' }['Value']['$value']
-vsc.get_field(1417, 'Quantity')
-
-created = vsc.create(certificate: 'E136924', year: 2024, count: 42)
-
-# Get the Ordinal identifier from the response
-#
-# All of these options are identical
-#
-ordinal = created.ordinal
-ordinal = created['Ordinal']
-ordinal = created.raw['Properties']['$values'].find { it['Name'] == 'Ordinal' }['Value']['$value']
-ordinal = created.raw['Identity']['IdentityElements']['$values'][1].to_i # Value is duplicated here
-
-vsc.update(certificate: 'E136924', year: 2024, count: 43, ordinal: ordinal)
-
-vsc.put_fields(ordinal, 'Quantity' => 44)
-vsc[ordinal, 'Quantity'] = 44
-
-vsc.destroy(ordinal)
-```
-
-If you already have an iMIS ID to work with, you can pass that in immediately:
-
-```ruby
-vsc = Usps::Imis::Panels::Vsc.new(imis_id: imis_id)
-```
-
-Panels are also accessible directly from the API object:
-
-```ruby
-api.panels.vsc.get(1417)
-```
-
-### DSL Mode
-
-Instead of manually setting the current iMIS ID, then running individual queries, you can instead
-run queries in DSL mode. This specifies the iMIS ID for the scope of the block, then reverts to the
-previous value.
-
-```ruby
-api.with(31092) do
-  # These requests are identical:
-
-  on('ABC_ASC_Individual_Demog') { put_fields('TotMMS' => 15) }
-
-  on('ABC_ASC_Individual_Demog').put_fields('TotMMS' => 15)
-
-  mapper.update(mm: 15)
-
-  update(mm: 15)
-
-  mapper[:mm] = 15
-end
-
-# This request fetches the same data, but leaves the iMIS ID selected
-api.with(31092)[:mm] = 15
-```
-
-```ruby
-api.with(6374) do
-  panels.vsc.get(1417)
-end
-```
-
-```ruby
-api.with(31092) do
-  # These requests are identical:
-
-  on('ABC_ASC_Individual_Demog') do
-    get.raw['Properties']['$values'].find { it['Name'] == 'TotMMS' }['Value']['$value']
-
-    get['TotMMS']
-
-    get_field('TotMMS')
-
-    get_fields('TotMMS').first
-  end
-
-  on('ABC_ASC_Individual_Demog').get_field('TotMMS')
-
-  on('ABC_ASC_Individual_Demog')['TotMMS']
-end
-
-# These requests fetch the same data, but leave the iMIS ID selected
-api.with(31092).on('ABC_ASC_Individual_Demog').get_field('TotMMS')
-api.with(31092).on('ABC_ASC_Individual_Demog')['TotMMS']
-```
-
-### Data Methods
-
-Data responses from the API can be handled as a standard Hash using the `raw` method.
-
-If you need to access all of the property values, you can use the `properties` method.
-By default, this will exclude the `ID` and `Ordinal` properties; they can be included with
-`properties(include_ids: true)`.
-
-## Test Data Mocking
-
-You can use the provided Business Object Mock to generate stub data for rspec:
-
-```ruby
-allow(api).to(
-  receive(:on).with('ABC_ASC_Individual_Demog').and_return(
-    Usps::Imis::Mocks::BusinessObject.new(TotMMS: 2)
-  )
-)
-```
-
-### VCR
-
-If you would like to use the included VCR config, make sure your Gemfile includes the required gems:
-
-```ruby
-gem 'cgi' # 2025-10-27 - Currently required for Ruby 3.5
-gem 'vcr'
-gem 'webmock'
-```
-
-In `spec_helper.rb`, add the following:
-
-```ruby
-require 'usps/vcr'
-Usps::Vcr::Config.configure!
-```
-
-You can also pass additional VCR config options through:
-
-```ruby
-Usps::Vcr::Config.configure! do |config|
-  config.ignore_localhost = true
-end
-```
-
-If you have any tests that are dependent on ordering to (re-)generate cassettes, a helper is also
-available to support adding example metadata, which will use a fixed order when the environment
-varialbe `VCR=all` is set:
-
-```ruby
-describe 'examples that care about order', order: Usps::Vcr::Config.vcr_record_ordered do
-  # ...
-end
-```
+For more details and examples, refer to the [Wiki](https://github.com/unitedstatespowersquadrons/imis-api-ruby/wiki).
 
 ## Exception Handling
 

data/lib/usps/imis/business_object.rb

@@ -39,6 +39,18 @@ module Usps
       #
       def query = api.query(business_object_name)
 
+      # Support passthrough for Api#with
+      #
+      def with(imis_id, &)
+        # Bring into local scope
+        wrapper_business_object_name = business_object_name
+        wrapper_ordinal = ordinal
+
+        api.with(imis_id) do
+          on(wrapper_business_object_name, ordinal: wrapper_ordinal, &)
+        end
+      end
+
       # Get a business object for the current member
       #
       # If +fields+ is provided, will return only those field values

data/lib/usps/imis/command_line/interface.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    module CommandLine
+      # Command line interface for the Api
+      #
+      class Interface
+        NAME = 'USPS iMIS API - Ruby'
+
+        attr_reader :options
+
+        def self.run(...) = new(...).run
+
+        def initialize(**)
+          @options = input_options.merge(**)
+          validate_options!
+          configure! if options[:config]
+          logging!
+        end
+
+        def run
+          set_member
+
+          result = simplify(perform!)
+
+          output { result }
+
+          result
+        end
+
+      private
+
+        # :nocov:
+        def input_options
+          if ENV.fetch('CI', false)
+            defaults = {
+              raw: false,
+              quiet: false,
+              log: false,
+              log_level: 'info',
+              version: false,
+              help: false
+            }
+            return defaults
+          end
+
+          OptionsParser.new.options
+        end
+        # :nocov:
+
+        def api
+          @api ||= Usps::Imis::Api.new
+        end
+
+        def set_member
+          case options
+          in certificate: then api.imis_id_for(certificate)
+          in id: then api.imis_id = id
+          else
+            # Query
+          end
+        end
+
+        # rubocop:disable Metrics
+        def perform!
+          case options
+          in map:, data: then api.mapper[map.to_sym] = data
+          in map: then api.mapper[map.to_sym]
+
+          in on:, delete: true then api.on(on).delete
+          in on:, data:, post: true then api.on(on).post(data)
+          in on:, data:, field: then api.on(on).put_field(field, data)
+          in on:, data: then api.on(on).put_fields(data)
+          in on:, fields: then api.on(on).get_fields(*fields)
+          in on:, field: then api.on(on).get_field(field)
+          in on: then api.on(on).get
+
+          in panel:, ordinal:, delete: true then api.panels.public_send(panel).delete(ordinal)
+          in panel:, data:, post: true then api.panels.public_send(panel).post(data)
+          in panel:, ordinal:, data:, field: then api.panels.public_send(panel).put_field(ordinal, field, data)
+          in panel:, ordinal:, data: then api.panels.public_send(panel).put_fields(ordinal, data)
+          in panel:, ordinal:, fields: then api.panels.public_send(panel).get_fields(ordinal, *fields)
+          in panel:, ordinal:, field: then api.panels.public_send(panel).get_field(ordinal, field)
+          in panel:, ordinal: then api.panels.public_send(panel).get(ordinal)
+
+          in query:, data: then api.query(query, data)
+          in query: then api.query(query)
+          end
+        rescue NoMatchingPatternError => e
+          raise Errors::CommandLineError, "Unable to match pattern from options: #{e.message}"
+        end
+        # rubocop:enable Metrics
+
+        def simplify(data)
+          return data.to_a if data.is_a?(Query)
+          return data if options[:raw]
+          return data unless data.is_a?(Hash) # Includes Usps::Imis::Data
+
+          data.properties(include_ids: options[:include_ids])
+        end
+
+        # :nocov:
+        def output(&block)
+          return if ENV.fetch('SUPPRESS_OUTPUT', false)
+
+          puts JSON.dump(block.call) if block_given?
+        end
+        # :nocov:
+
+        def configure!
+          json_config = JSON.parse(File.read(options[:config]))
+
+          Usps::Imis.configure do |config|
+            json_config.each do |key, value|
+              config.public_send("#{key}=", value)
+            end
+          end
+        end
+
+        def logging!
+          Usps::Imis.configure do |config|
+            # :nocov:
+            if options[:quiet] || ENV.fetch('SUPPRESS_OUTPUT', false)
+              config.logger = ActiveSupport::TaggedLogging.new(Logger.new(nil))
+            elsif options[:log]
+              # Use default
+            else
+              config.logger = ActiveSupport::TaggedLogging.new(Logger.new($stderr))
+            end
+            # :nocov:
+
+            config.logger.level = options[:log_level]
+          end
+        end
+
+        def validate_options!
+          if options[:log_level] == 'info' && options.except(:log_level, :quiet).values.none?
+            raise Errors::CommandLineError, 'No options provided'
+          end
+
+          return if options[:query].nil? || options[:query].start_with?('$/')
+
+          raise Errors::CommandLineError, 'Invalid IQA Query name'
+        end
+      end
+    end
+  end
+end

data/lib/usps/imis/command_line/options_parser.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    module CommandLine
+      # Command line options parser
+      #
+      class OptionsParser
+        OPTIONS = {
+          certificate: ['Member certificate number', { type: :string }],
+          id: ['Member iMIS ID', { type: :integer }],
+          on: ['Business Object name', { type: :string }],
+          panel: ['Panel name', { type: :string }],
+          ordinal: ['Ordinal ID within a Panel', { type: :integer }],
+          query: ['IQA Query name', { type: :string, short: :Q }],
+          post: ["Send a #{'POST'.cyan} request", { short: :P }],
+          delete: ["Send a #{'DELETE'.cyan} request", { short: :D }],
+          field: ['Specific field to return or update', { type: :string }],
+          fields: ['Specific field(s) to return', { type: :strings, short: :F }],
+          map: ['Mapped field name to return or update', { type: :string }],
+          data: ['JSON string input', { type: :string }],
+          config: ['Path to the JSON config file to use', { type: :string, short: :C }],
+          raw: ['Return raw JSON output, rather than simplified data', { short: :R }],
+          include_ids: ['Include ID properties in returned data'],
+          quiet: ['Suppress logging to STDERR'],
+          log: ['Redirect logging to STDOUT'],
+          log_level: ['Set the logging level', { type: :string, default: 'info', short: :L }]
+        }.freeze
+
+        CONFLICTING_OPTION_GROUPS = [
+          %i[certificate id],
+          %i[on panel query map],
+          %i[field fields map query]
+        ].freeze
+
+        attr_reader :arguments, :options
+
+        def self.banner_contents
+          <<~BANNER
+            Usage:
+              imis.rb #{'[options]'.gray}
+
+              The default HTTP verb is #{'GET'.cyan}.
+              If #{'--data'.green}/#{'-d'.green} is provided, the default HTTP verb is #{'PUT'.cyan}.
+
+              #{'--data'.green}/#{'-d'.green} is used to provide field(s) data for #{'PUT'.cyan}
+              requests and mapper updates, object data for #{'POST'.cyan},
+              and to provide any query params.
+
+              Configuration can be specified with #{'--config'.green}/#{'-C'.green}, or by setting
+              the following environment variables:
+                #{'IMIS_ENVIRONMENT'.yellow}
+                #{'IMIS_USERNAME'.yellow}
+                #{'IMIS_PASSWORD'.yellow}
+                #{'IMIS_ID_QUERY_NAME'.yellow}
+
+            Options:
+          BANNER
+        end
+
+        def initialize
+          @options = parse_options.compact
+          @arguments = ARGV # Not currently used
+
+          # :nocov:
+          @options[:data] = JSON.parse(read_stdin) if stdin?
+          # :nocov:
+        end
+
+      private
+
+        def parse_options
+          Optimist.options do
+            version "#{Interface::NAME} (v#{Usps::Imis::VERSION})"
+
+            banner "#{version.bold.blue}\n \n"
+            banner OptionsParser.banner_contents
+
+            OPTIONS.each { |option, data| opt(option, *data) }
+            CONFLICTING_OPTION_GROUPS.each { |group| conflicts(*group) }
+
+            educate_on_error
+          end
+        end
+
+        # :nocov:
+        def stdin? = $stdin.wait_readable(0)
+        def read_stdin = $stdin.read.chomp
+        # :nocov:
+      end
+    end
+  end
+end

data/lib/usps/imis/command_line.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'optimist'
+require 'colorize'
+
+module Usps
+  module Imis
+    # Wrapper for the command line interface
+    #
+    module CommandLine; end
+  end
+end
+
+require_relative 'command_line/options_parser'
+require_relative 'command_line/interface'

data/lib/usps/imis/config.rb

@@ -12,7 +12,7 @@ module Usps
       attr_reader :environment, :logger, :logger_level
 
       def initialize
-        @environment = defined?(::Rails) ? ::Rails.env : ActiveSupport::StringInquirer.new('development')
+        @environment = default_environment
         @imis_id_query_name = ENV.fetch('IMIS_ID_QUERY_NAME', nil)
         @username = ENV.fetch('IMIS_USERNAME', nil)
         @password = ENV.fetch('IMIS_PASSWORD', nil)
@@ -53,6 +53,14 @@ module Usps
       # Parameters to filter out of logging
       #
       def filtered_parameters = %i[password]
+
+    private
+
+      def default_environment
+        return ::Rails.env if defined?(::Rails)
+
+        ActiveSupport::StringInquirer.new(ENV.fetch('IMIS_ENVIRONMENT', 'development'))
+      end
     end
   end
 end

data/lib/usps/imis/data.rb

@@ -36,7 +36,7 @@ module Usps
         return if property.nil?
 
         value = property['Value']
-        value.is_a?(String) ? value : value['$value']
+        value.nil? || value.is_a?(String) ? value : value['$value']
       end
 
       # Hash of all property names to values

data/lib/usps/imis/error.rb

@@ -52,3 +52,4 @@ require_relative 'errors/not_found_error'
 require_relative 'errors/response_error'
 require_relative 'errors/panel_unimplemented_error'
 require_relative 'errors/unexpected_property_type_error'
+require_relative 'errors/command_line_error'

data/lib/usps/imis/errors/command_line_error.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Usps
+  module Imis
+    module Errors
+      # Exception raised by the command line interface
+      #
+      class CommandLineError < Error; end
+    end
+  end
+end

data/lib/usps/imis/version.rb

@@ -2,6 +2,6 @@
 
 module Usps
   module Imis
-    VERSION = '0.10.3'
+    VERSION = '0.11.0'
   end
 end

data/lib/usps/imis.rb

@@ -1,3 +1,4 @@
+#!/usr/bin/env ruby
 # frozen_string_literal: true
 
 # Core dependencies
@@ -20,6 +21,7 @@ require_relative 'imis/error'
 require_relative 'imis/api'
 require_relative 'imis/properties'
 require_relative 'imis/panels'
+require_relative 'imis/command_line'
 require_relative 'imis/mocks'
 require_relative 'imis/version'
 
@@ -56,3 +58,9 @@ module Usps
     end
   end
 end
+
+# Invoke CLI, only if invoked from the command line
+#
+# :nocov:
+Usps::Imis::CommandLine::Interface.run if __FILE__ == $PROGRAM_NAME
+# :nocov:

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: usps-imis-api
 version: !ruby/object:Gem::Version
-  version: 0.10.3
+  version: 0.11.0
 platform: ruby
 authors:
 - Julian Fiander
@@ -23,6 +23,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: optimist
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.1
 description: A wrapper for the iMIS API.
 email: jsfiander@gmail.com
 executables: []
@@ -33,10 +61,14 @@ files:
 - lib/usps/imis.rb
 - lib/usps/imis/api.rb
 - lib/usps/imis/business_object.rb
+- lib/usps/imis/command_line.rb
+- lib/usps/imis/command_line/interface.rb
+- lib/usps/imis/command_line/options_parser.rb
 - lib/usps/imis/config.rb
 - lib/usps/imis/data.rb
 - lib/usps/imis/error.rb
 - lib/usps/imis/errors/api_error.rb
+- lib/usps/imis/errors/command_line_error.rb
 - lib/usps/imis/errors/config_error.rb
 - lib/usps/imis/errors/locked_id_error.rb
 - lib/usps/imis/errors/mapper_error.rb