nacha 0.1.10 → 0.1.14

data/lib/nacha/record/third_iat_addenda.rb

@@ -1,11 +1,12 @@
 # coding: utf-8
 # frozen_string_literal: true
 
-require 'nacha/record/base.rb'
-require 'nacha/record/addenda_record_type.rb'
+require 'nacha/record/base'
+require 'nacha/record/addenda_record_type'
 
 module Nacha
   module Record
+    # Represents a third IAT addenda record.
     class ThirdIatAddenda < Nacha::Record::Base
       include AddendaRecordType
 

data/lib/nacha/record/trc_entry_detail.rb

@@ -1,11 +1,12 @@
 # coding: utf-8
 # frozen_string_literal: true
 
-require 'nacha/record/base.rb'
-require 'nacha/record/detail_record_type.rb'
+require 'nacha/record/base'
+require 'nacha/record/detail_record_type'
 
 module Nacha
   module Record
+    # Represents a Truncated Entry (TRC) detail record.
     class TrcEntryDetail < Nacha::Record::Base
       include DetailRecordType
 

data/lib/nacha/record/trx_addenda.rb

@@ -1,11 +1,12 @@
 # coding: utf-8
 # frozen_string_literal: true
 
-require 'nacha/record/base.rb'
-require 'nacha/record/addenda_record_type.rb'
+require 'nacha/record/base'
+require 'nacha/record/addenda_record_type'
 
 module Nacha
   module Record
+    # Represents a Truncated Entry (TRX) addenda record.
     class TrxAddenda < Nacha::Record::Base
       include AddendaRecordType
 

data/lib/nacha/record/trx_entry_detail.rb

@@ -1,11 +1,12 @@
 # coding: utf-8
 # frozen_string_literal: true
 
-require 'nacha/record/base.rb'
-require 'nacha/record/detail_record_type.rb'
+require 'nacha/record/base'
+require 'nacha/record/detail_record_type'
 
 module Nacha
   module Record
+    # Represents a Truncated Entry with Remittance Data (TRX) detail record.
     class TrxEntryDetail < Nacha::Record::Base
       include DetailRecordType
 
@@ -16,7 +17,8 @@ module Nacha
       nacha_field :total_amount, inclusion: 'M', contents: '$$$$$$$$¢¢', position: 30..39
       nacha_field :identification_number, inclusion: 'O', contents: 'Alphameric', position: 40..54
       nacha_field :number_of_addenda_records, inclusion: 'M', contents: 'Numeric', position: 55..58
-      nacha_field :receiving_company_name_id_number, inclusion: 'R', contents: 'Alphameric', position: 59..74
+      nacha_field :receiving_company_name_id_number, inclusion: 'R', contents: 'Alphameric',
+        position: 59..74
       nacha_field :reserved, inclusion: 'M', contents: 'C  ', position: 75..76
       nacha_field :item_type_indicator, inclusion: 'O', contents: 'Alphameric', position: 77..78
       nacha_field :addenda_record_indicator, inclusion: 'M', contents: 'Numeric', position: 79..79

data/lib/nacha/record/validations/field_validations.rb

@@ -5,37 +5,49 @@ module Nacha
   module Record
     module Validations
       module FieldValidations
-        def self.included base
+        def self.included(base)
           base.extend ClassMethods
         end
+
         module ClassMethods
-          def check_field_error(field, message = nil, condition = nil)
-            (block_given? ? yield : condition) || (field.add_error("'#{field.name}' '#{field}' is invalid") && false)
+          def check_field_error(field, _message = nil, condition = nil)
+            (block_given? ? yield : condition) ||
+              (field.add_error("'#{field.name}' '#{field}' is invalid") && false)
           end
 
-          def valid_service_class_code field
-            check_field_error(field, "'#{field.name}' '#{field}' should be one of #{SERVICE_CLASS_CODES.join(', ')}") {
+          def valid_service_class_code(field)
+            check_field_error(
+              field,
+              "'#{field.name}' '#{field}' should be one of #{SERVICE_CLASS_CODES.join(', ')}"
+            ) do
               SERVICE_CLASS_CODES.include? field.to_s
-            }
+            end
           end
 
-          def valid_standard_entry_class_code field
-            check_field_error(field, "'#{field.name}' '#{field}' should be one of #{STANDARD_ENTRY_CLASS_CODES.join(', ')}") {
+          def valid_standard_entry_class_code(field)
+            check_field_error(
+              field,
+              "'#{field.name}' '#{field}' should be one of " \
+                "#{STANDARD_ENTRY_CLASS_CODES.join(', ')}"
+            ) do
               STANDARD_ENTRY_CLASS_CODES.include? field.data
-            }
+            end
           end
 
-          def valid_transaction_code field
-            check_field_error(field, "'#{field.name}' '#{field}' should be one of #{TRANSACTION_CODES.join(', ')}") {
+          def valid_transaction_code(field)
+            check_field_error(
+              field,
+              "'#{field.name}' '#{field}' should be one of #{TRANSACTION_CODES.join(', ')}"
+            ) do
               TRANSACTION_CODES.include? field.to_s
-            }
+            end
           end
 
-          def valid_receiving_dfi_identification field
+          def valid_receiving_dfi_identification(field)
             check_field_error(field) { field.valid? }
           end
 
-          def valid_filler field
+          def valid_filler(field)
             check_field_error(field) { field.to_s == ('9' * 93) }
           end
         end

data/lib/nacha/record/validations/record_validations.rb

@@ -5,9 +5,10 @@ module Nacha
   module Record
     module Validations
       module RecordValidations
-        def self.included base
+        def self.included(base)
           base.extend ClassMethods
         end
+
         module ClassMethods
         end
       end

data/lib/nacha/record/web_addenda.rb

@@ -1,11 +1,12 @@
 # coding: utf-8
 # frozen_string_literal: true
 
-require 'nacha/record/base.rb'
-require 'nacha/record/addenda_record_type.rb'
+require 'nacha/record/base'
+require 'nacha/record/addenda_record_type'
 
 module Nacha
   module Record
+    # Represents an Internet-Initiated Entry (WEB) addenda record.
     class WebAddenda < Nacha::Record::Base
       include AddendaRecordType
 

data/lib/nacha/record/web_entry_detail.rb

@@ -1,11 +1,12 @@
 # coding: utf-8
 # frozen_string_literal: true
 
-require 'nacha/record/base.rb'
-require 'nacha/record/detail_record_type.rb'
+require 'nacha/record/base'
+require 'nacha/record/detail_record_type'
 
 module Nacha
   module Record
+    # Represents an Internet-Initiated Entry (WEB) detail record.
     class WebEntryDetail < Nacha::Record::Base
       include DetailRecordType
 
@@ -14,7 +15,8 @@ module Nacha
       nacha_field :receiving_dfi_identification, inclusion: 'M', contents: 'TTTTAAAAC', position: 4..12
       nacha_field :dfi_account_number, inclusion: 'R', contents: 'Alphameric', position: 13..29
       nacha_field :amount, inclusion: 'M', contents: '$$$$$$$$¢¢', position: 30..39
-      nacha_field :individual_identification_number, inclusion: 'O', contents: 'Alphameric', position: 40..54
+      nacha_field :individual_identification_number, inclusion: 'O', contents: 'Alphameric',
+        position: 40..54
       nacha_field :individual_name, inclusion: 'R', contents: 'Alphameric', position: 55..76
       nacha_field :payment_type_code, inclusion: 'O', contents: 'Alphameric', position: 77..78
       nacha_field :addenda_record_indicator, inclusion: 'M', contents: 'Numeric', position: 79..79

data/lib/nacha/record/xck_entry_detail.rb

@@ -1,11 +1,12 @@
 # coding: utf-8
 # frozen_string_literal: true
 
-require 'nacha/record/base.rb'
-require 'nacha/record/detail_record_type.rb'
+require 'nacha/record/base'
+require 'nacha/record/detail_record_type'
 
 module Nacha
   module Record
+    # Represents a Destroyed Check Entry (XCK) detail record.
     class XckEntryDetail < Nacha::Record::Base
       include DetailRecordType
 

data/lib/nacha/version.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
 module Nacha
-  VERSION = '0.1.10'
+  module Version
+    STRING = '0.1.14'
+  end
+  VERSION = Version::STRING
 end

data/lib/nacha.rb

@@ -22,15 +22,15 @@ require 'nacha/numeric'
 # including various entry detail, addenda, batch, and file control records.
 module Nacha
   STANDARD_ENTRY_CLASS_CODES = %w[ACK ADV ARC ATX BOC CCD PPD CIE
-                                  COR CTX DNE ENR IAT POP POS SHR
-                                  MTE RCK TEL TRC TRX WEB XCK].freeze
+    COR CTX DNE ENR IAT POP POS SHR
+    MTE RCK TEL TRC TRX WEB XCK].freeze
 
   SERVICE_CLASS_CODES = %w[200 220 225 280].freeze
 
   CREDIT_TRANSACTION_CODES = %w[20 21 22 23 24 30 31 32 33 34 41 42
-                                43 44 51 52 53 54 81 83 85 87].freeze
+    43 44 51 52 53 54 81 83 85 87].freeze
   DEBIT_TRANSACTION_CODES  = %w[25 26 27 28 29 35 36 37 38 39 46 47
-                                48 49 55 56 82 84 86 88].freeze
+    48 49 55 56 82 84 86 88].freeze
 
   TRANSACTION_CODES = (CREDIT_TRANSACTION_CODES + DEBIT_TRANSACTION_CODES).freeze
 
@@ -53,17 +53,24 @@ module Nacha
 
     # Returns an array of all currently registered ACH record type class names.
     #
-    # @return [Array<String>] An array of strings representing the names of ACH record classes.
+    # @return [Array<String>] An array of ACH record class names.
     def ach_record_types
       @ach_record_types || []
     end
 
+    def to_h
+      types_hash = {}
+      ach_record_types.each do |record_type|
+        types_hash.merge! Object.const_get(record_type).to_h
+      end
+      types_hash
+    end
+
     # Parses a NACHA file or string into a structured object representation.
     #
     # @param object [String, File, IO] The input to parse, either a string containing
     #   NACHA data or an IO object (e.g., a File) representing the NACHA file.
-    # @return [Nacha::Record::Base] The parsed NACHA file object, typically a FileHeader record
-    #   with nested batch and entry detail records.
+    # @return [Nacha::Record::Base] The parsed NACHA file object.
     def parse(object)
       parser = Nacha::Parser.new
       if object.is_a?(String)
@@ -89,11 +96,11 @@ module Nacha
     # @param str [String] The string to underscore.
     # @return [String] The underscored string.
     def underscore(str)
-      str.gsub(/::/, '/').
-        gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
-        gsub(/([a-z\d])([A-Z])/,'\1_\2').
-        tr('-', '_').
-        downcase
+      str.gsub(/::/, '/')
+         .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+         .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+         .tr('-', '_')
+         .downcase
     end
   end
 end
@@ -110,11 +117,11 @@ require 'nacha/record/detail_record_type'
 # This is necessary because the parser relies on the record types being defined
 # and available in the Nacha module.
 
-Gem.find_files('nacha/record/*.rb').reject{|f| f =~ /\/spec\//}.each do |file|
+Gem.find_files('nacha/record/*.rb').reject { |f| f.include?('/spec/') }.each do |file|
   require File.expand_path(file)
 end
 
-Gem.find_files('nacha/record/**/*.rb').reject{|f| f =~ /\/spec\//}.each do |file|
+Gem.find_files('nacha/record/**/*.rb').reject { |f| f.include?('/spec/') }.each do |file|
   require File.expand_path(file)
 end
 

data/nacha.gemspec

@@ -14,6 +14,7 @@ Gem::Specification.new do |spec|
   spec.description   = %q(Ruby parser for ACH files.)
   spec.homepage      = 'https://github.com/dwilkins/nacha'
   spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.2.8'
 
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
@@ -23,23 +24,20 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
   spec.add_dependency 'bigdecimal'
 
-  spec.add_development_dependency "bundler"
-  # Conditionally add byebug only for MRI Ruby
-  if RUBY_ENGINE == 'ruby'
-    spec.add_development_dependency "byebug"
-  end
-  if RUBY_ENGINE == 'jruby'
-    spec.add_development_dependency "pry-nav"
-  end
-  spec.add_development_dependency "pry"
-  spec.add_development_dependency "factory_bot"
-  spec.add_development_dependency "gitlab-styles"
-  spec.add_development_dependency "guard"
-  spec.add_development_dependency "guard-rspec"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec"
-  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'byebug' if RUBY_ENGINE == 'ruby'
+  spec.add_development_dependency 'factory_bot'
+  spec.add_development_dependency 'gitlab-styles'
+  spec.add_development_dependency 'guard'
+  spec.add_development_dependency 'guard-rspec'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'pry-nav' if RUBY_ENGINE == 'jruby'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'reek'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'rubocop-performance'
   spec.add_development_dependency 'rubocop-rspec'
   spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'simplecov-lcov'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nacha
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.1.14
 platform: ruby
 authors:
 - David H. Wilkins
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-02 00:00:00.000000000 Z
+date: 2025-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -53,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: factory_bot
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: factory_bot
+  name: gitlab-styles
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,7 +81,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: gitlab-styles
+  name: guard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -95,7 +95,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: guard
+  name: guard-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -109,7 +109,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: guard-rspec
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -136,6 +136,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -206,6 +220,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov-lcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Ruby parser for ACH files.
 email:
 - dwilkins@conecuh.com
@@ -214,6 +242,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".gitlab-ci.yml"
 - ".rspec"
@@ -235,6 +264,11 @@ files:
 - lib/nacha/aba_number.rb
 - lib/nacha/ach_date.rb
 - lib/nacha/field.rb
+- lib/nacha/formatter.rb
+- lib/nacha/formatter/base.rb
+- lib/nacha/formatter/html_formatter.rb
+- lib/nacha/formatter/json_formatter.rb
+- lib/nacha/formatter/markdown_formatter.rb
 - lib/nacha/has_errors.rb
 - lib/nacha/numeric.rb
 - lib/nacha/parser.rb
@@ -315,7 +349,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.2.8
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="