nacha 0.1.12 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 737ec495f2219167b7ef5ec5a959a6b205a4cf551eba2fdee6b5d3f0324b0735
-  data.tar.gz: 67f479ed3d4f1affb7d7a0f3fb92168bc2554a84b33cca2c3108d884a36e3989
+  metadata.gz: 986181f9dfa47368890ac283705b188bfef4733adff641590cc889f491cf5ed2
+  data.tar.gz: 1aff3dd6aedd49cf8f1e9d2562131b28832452fd0332a71429f49955aa19e858
 SHA512:
-  metadata.gz: 3fbae7e0193e68fa8fda30e32ff8272c4380556352fd6b64d3fdd6eb806e974ac147952a033603810f712f06b5437207a7a0d6a7d84ae4abe435c87314716329
-  data.tar.gz: 666b409414698a8502a69d02dca7cdc35f929cda66c66a6ef68430701d252f4640ed8aaaeeec1ba0064c5ff49a94befe189a69757fb5903142eede3a706dcfbe
+  metadata.gz: f743d90e6aba9464d81f04a9d416ac6fa13a947e2a5f42c9727a0ebda1f484b55ebdf335a0c2daf857a4bb353d079a8f853b8f9af73c0b65abd1b2d6d8802bf2
+  data.tar.gz: 23259ac90baaf2e6f0a31b41a5e66ffe7a952d2b42a99ca81945a90ea065ed1a1bbe2d9658403574353750dc985f57509e505b281d91a89696e81a78b43dc21a

data/.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+name: CI
+
+on: [push]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['.ruby-version', 'jruby-head']
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run RSpec
+        run: bundle exec rspec
+      - name: Upload coverage to Coveralls
+        uses: coverallsapp/github-action@v2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          parallel: true
+          flag-name: ${{ matrix.ruby }}
+
+  coveralls_finish:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Coveralls Finished
+        uses: coverallsapp/github-action@v2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          parallel-finished: true
+# name: CI
+
+# on:
+#   push:
+#     branches: [ "main" ]
+#   pull_request:
+#     branches: [ "main" ]
+
+# jobs:
+#   test:
+#     runs-on: ubuntu-latest
+#     strategy:
+#       fail-fast: false
+#       matrix:
+#         ruby-version: ['3.2.8', 'jruby-latest']
+
+#     steps:
+#       - uses: actions/checkout@v4
+
+#       - name: Set up Ruby
+#         uses: ruby/setup-ruby@v1
+#         with:
+#           ruby-version: ${{ matrix.ruby-version }}
+#           bundler-cache: true # runs 'bundle install' and caches installed gems
+
+#       - name: Run tests
+#         run: bundle exec rspec

data/.gitignore

@@ -13,3 +13,5 @@
 .rspec_status
 .byebug_history
 .aider*
+TAGS
+CONVENTIONS.md

data/.rubocop.yml

@@ -26,6 +26,7 @@ Style/FrozenStringLiteralComment:
     - 'Rakefile'
     - 'spec/**/*'
 
+# So that ACH strings in tests won't trigger Cops
 Layout/LineLength:
   Max: 108
 

data/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.14] - 2025-07-19
+
+- Added markdown and github flavored markdown output
+
+- Better architecture for output formatting
+
+## [0.1.13] - 2025-07-16
+
+- Fixed an issue with IatEntryDetail where there were multiple
+  `reserved` fields.  Fixed the associated spec
+
+- Fixed column positions for FirstIatAddenda#reserved
+
+- Added `child_record_types` for DetailRecordType and AddendaRecordType
+  so that parsing work right.  Probably need to start using
+  `next_record_types` for some of the record types that are in
+  `child_record_types` right now
+
+- Sorted the fields by position.first when building the matcher and
+  the unpack string.
+
+- Split the `child_record_types` between the class method and the
+  instance method.  Concatenated the class method types when the
+  instance method is called.
+
 ## [0.1.12] - 2025-07-08
 
 - Fixed a bug with parsing files with misshapen lines.  Now it

data/README.md

@@ -1,11 +1,15 @@
 # Nacha
 
+[![Coverage Status](https://coveralls.io/repos/github/badges/shields/badge.svg?branch=master)](https://coveralls.io/github/badges/shields?branch=master)
+
 Validating Ruby ACH parser and generator
 
 Format documentation here: http://achrulesonline.org/
 
-The definition of the records exactly mirrors the NACHA documentation so that
-development and business can use the same terminology.
+Record Documentation here: https://nachaoperatingrulesonline.org/assets/attachments/25_basic_appendixes.pdf
+
+The definition of the records in this gem exactly mirrors the NACHA
+documentation so that development and business can use the same terminology.
 
 Work in progress - contributors welcome.
 
@@ -76,6 +80,10 @@ Parsing starts by looking for a default record type 'Nacha::Record::FileHeader'
 When that is found, the valid child record types for 'Nacha::Record::FileHeader'
 are gathered and the subsequent lines are parsed using only those types
 
+If there is no record type match after exhausing the list of child record types
+for previous records in the hierarchy, the entire list of ACH record types is
+checked
+
 When a record is created, the fields for the instance are created from
 the field definitions.
 

data/exe/nacha

@@ -2,10 +2,11 @@
 # frozen_string_literal: true
 
 $LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
-require 'byebug'
 require 'thor'
 require 'json'
-require 'nacha' # Assuming this loads the Nacha gem
+require 'nacha'
+require 'nacha/formatter'
+require 'openssl'
 
 module Nacha
   class CLI < Thor
@@ -18,24 +19,24 @@ module Nacha
     desc "parse FILE", "Parse an ACH file"
     option :output_file, aliases: "-o"
     option :format, aliases: "-f", default: "html",
-      desc: "Output format (html, json, or ach)", enum: %w[html json ach]
+      desc: "Output format (html, json, md, or ach)", enum: %w[html json md ach]
+    option :md_flavor, default: "common_mark", enum: %w[common_mark github]
     def parse(file_path)
       unless File.exist?(file_path)
         puts "Error: File not found at #{file_path}"
         exit 1
       end
 
-      ach_file = Nacha.parse(File.open(file_path))
+      file = File.open(file_path)
+      ach_file = Nacha.parse(file)
 
-      # TODO: Determine a user-friendly way to output the parsed data.
-      # For now, let's print the records.
       if ach_file && ach_file.is_a?(Array) && !ach_file.empty?
         if options[:output_file]
-          File.open(options[:output_file], "w") do |file|
-            write_output(ach_file, file)
+          File.open(options[:output_file], "w") do |f|
+            write_output(ach_file, f, file)
           end
         else
-          write_output(ach_file, $stdout)
+          write_output(ach_file, $stdout, file)
         end
       else
         puts "Could not parse the file or the file was empty."
@@ -48,52 +49,37 @@ module Nacha
 
     private
 
-    def write_output(ach_records, io)
+    def write_output(ach_records, io, file)
+      formatter_options = {
+        file_name: File.basename(file.path),
+        file_size: file.size,
+        number_of_lines: ach_records.size,
+        created_at: file.ctime,
+        modified_at: file.mtime,
+        checksum: OpenSSL::Digest::SHA256.file(File.expand_path(file.path)).hexdigest,
+        preamble: HTML_PREAMBLE_FILE,
+        postamble: HTML_POSTAMBLE_FILE
+      }
+
       case options[:format]
-      when 'html'
-        output_html(ach_records, io)
-      when 'json'
-        output_json(ach_records, io)
       when 'ach'
         output_ach(ach_records, io)
+      when 'md'
+        formatter_options[:flavor] = options[:md_flavor].to_sym
+        formatter = Nacha::Formatter::FormatterFactory.get(:markdown, ach_records, formatter_options)
+        io.puts formatter.format
+      else
+        formatter = Nacha::Formatter::FormatterFactory.get(options[:format].to_sym, ach_records,
+          formatter_options)
+        io.puts formatter.format
       end
     end
 
-    def output_json(ach_records, io)
-      io.puts JSON.pretty_generate(ach_records.map(&:to_h))
-      # io.puts JSON.pretty_generate(json_output)
-    end
-
-    def record_to_h(record)
-      {
-        record.class.name.split('::').last => {
-          fields: record.fields.transform_values(&:to_s),
-          children: record.children.map { |child| record_to_h(child) }
-        }
-      }
-    end
-
     def output_ach(ach_records, io)
       ach_records.each do |record|
         io.puts record.to_ach
       end
     end
-
-    def output_html(ach_records, io)
-      io.puts html_preamble
-      ach_records.each do |record|
-        io.puts record.to_html
-      end
-      io.puts html_postamble
-    end
-
-    def html_preamble
-      @html_preamble ||= File.read(HTML_PREAMBLE_FILE)
-    end
-
-    def html_postamble
-      @html_postamble ||= File.read(HTML_POSTAMBLE_FILE)
-    end
   end
 end
 

data/lib/nacha/aba_number.rb

@@ -2,21 +2,25 @@
 
 require "nacha/has_errors"
 
+# Validates and formats an ABA routing number.
 class Nacha::AbaNumber
-  attr_reader :routing_number, :aba_number
+  attr_reader :routing_number
 
   include Nacha::HasErrors
 
   def initialize(routing_number)
     @errors = []
-    self.routing_number = routing_number
+    @valid = nil
+    @routing_number = routing_number.to_s.strip
   end
 
+  # :reek:FeatureEnvy
   def compute_check_digit
-    n = @routing_number.to_s.strip.ljust(8, '0').chars.collect(&:to_i)
-    sum = (3 * (n[0] + n[3] + n[6])) +
-      (7 * (n[1] + n[4] + n[7])) +
-      (n[2] + n[5])
+    digit_array = @routing_number.ljust(8, '0').chars.collect(&:to_i)
+    sum = (3 * (digit_array[0] + digit_array[3] + digit_array[6])) +
+      (7 * (digit_array[1] + digit_array[4] + digit_array[7])) +
+      (digit_array[2] + digit_array[5])
+
     intermediate = (sum % 10)
     intermediate.zero? ? '0' : (10 - intermediate).to_s
   end
@@ -32,9 +36,10 @@ class Nacha::AbaNumber
   end
 
   def check_digit
-    return unless @routing_number.length == 9 && compute_check_digit == @routing_number[8]
+    check = @routing_number[8]
+    return unless @routing_number.length == 9 && compute_check_digit == check
 
-    @routing_number[8]
+    check
   end
 
   def valid?
@@ -62,8 +67,9 @@ class Nacha::AbaNumber
   end
 
   def valid_check_digit?
-    if compute_check_digit != @routing_number[8]
-      add_error("Incorrect Check Digit \"#{@routing_number[8]}\" should be " \
+    check = @routing_number[8]
+    if compute_check_digit != check
+      add_error("Incorrect Check Digit \"#{check}\" should be " \
         "\"#{compute_check_digit}\"")
       false
     else
@@ -71,11 +77,11 @@ class Nacha::AbaNumber
     end
   end
 
-  def to_s(with_checkdigit = true)
-    if with_checkdigit
-      @routing_number
-    else
-      @routing_number[0..7]
-    end
+  def to_s
+    @routing_number
+  end
+
+  def to_s_base
+    @routing_number[0..7]
   end
 end

data/lib/nacha/field.rb

@@ -133,37 +133,11 @@ class Nacha::Field
     # rubocop:enable GitlabSecurity/PublicSend
   end
 
-  def to_json_output
-    if @json_output
-      @json_output.reduce(@data) do |memo, operation|
-        # rubocop:disable GitlabSecurity/PublicSend
-        memo&.public_send(*operation)
-        # rubocop:enable GitlabSecurity/PublicSend
-      end
-    else
-      to_s
-    end
-  end
-
   def human_name
     # @human_name ||= @name.to_s.gsub('_', ' ').capitalize
     @human_name ||= @name.to_s.split('_').map(&:capitalize).join(' ')
   end
 
-  def to_html
-    tooltip_text = "<span class=\"tooltiptext\" >#{human_name} #{errors.join(' ')}</span>"
-    field_classes = ["nacha-field tooltip"]
-    field_classes += ['mandatory'] if mandatory?
-    field_classes += ['required'] if required?
-    field_classes += ['optional'] if optional?
-    field_classes += ['error'] if errors.any?
-
-    ach_string = to_ach.gsub(' ', '&nbsp;')
-    "<span data-field-name=\"#{@name}\" contentEditable=true " \
-      "class=\"#{field_classes.join(' ')}\" data-name=\"#{@name}\">" \
-      "#{ach_string}#{tooltip_text}</span>"
-  end
-
   def to_s
     # rubocop:disable GitlabSecurity/PublicSend
     @data.public_send(*output_conversion).to_s

data/lib/nacha/formatter/base.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'digest'
+
+module Nacha
+  module Formatter
+    class Base
+      attr_reader :records, :options
+
+      def initialize(records, options = {})
+        @records = records
+        @options = options
+      end
+
+      def format
+        raise NotImplementedError, 'Subclasses must implement a format method'
+      end
+
+      private
+
+      def file_statistics
+        {
+          file_name: options.fetch(:file_name, 'STDIN'),
+          file_size: options.fetch(:file_size, 0),
+          number_of_lines: options.fetch(:number_of_lines, 0),
+          created_at: options.fetch(:created_at, ''),
+          modified_at: options.fetch(:modified_at, ''),
+          checksum: options.fetch(:checksum, ''),
+          number_of_filler_lines: number_of_filler_lines
+        }
+      end
+
+      def number_of_filler_lines
+        records.count { |r| r.is_a?(Nacha::Record::Filler) }
+      end
+
+      def preamble
+        return '' unless options[:preamble]
+        return options[:preamble] unless File.exist?(options[:preamble])
+
+        File.read(options[:preamble])
+      end
+
+      def postamble
+        return '' unless options[:postamble]
+        return options[:postamble] unless File.exist?(options[:postamble])
+
+        File.read(options[:postamble])
+      end
+    end
+  end
+end

data/lib/nacha/formatter/html_formatter.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require 'nacha/formatter/base'
+
+module Nacha
+  module Formatter
+    class HtmlFormatter < Base
+      def format
+        [
+          html_preamble,
+          file_statistics_html,
+          records_html,
+          html_postamble
+        ].join("\n")
+      end
+
+      private
+
+      def html_preamble
+        preamble_content = options.fetch(:preamble, default_preamble)
+        if File.exist?(preamble_content)
+          File.read(preamble_content)
+        else
+          preamble_content
+        end
+      end
+
+      def html_postamble
+        postamble_content = options.fetch(:postamble, default_postamble)
+        if File.exist?(postamble_content)
+          File.read(postamble_content)
+        else
+          postamble_content
+        end
+      end
+
+      def file_statistics_html
+        stats = file_statistics
+        <<~HTML
+          <div class="file-statistics">
+            <h2>File Information</h2>
+            <ul>
+              <li><strong>File Name:</strong> #{stats[:file_name]}</li>
+              <li><strong>File Size:</strong> #{stats[:file_size]} bytes</li>
+              <li><strong>Number of Lines:</strong> #{stats[:number_of_lines]}</li>
+              <li><strong>Created At:</strong> #{stats[:created_at]}</li>
+              <li><strong>Modified At:</strong> #{stats[:modified_at]}</li>
+              <li><strong>Checksum (SHA256):</strong> #{stats[:checksum]}</li>
+              <li><strong>Number of Filler Lines:</strong> #{stats[:number_of_filler_lines]}</li>
+            </ul>
+          </div>
+        HTML
+      end
+
+      def records_html
+        records.map { |record| record_to_html(record) }.join("\n")
+      end
+
+      def record_to_html(record)
+        record_error_class = record.errors.any? ? 'error' : ''
+        field_html = record.fields.values.map { |field| field_to_html(field) }.join
+
+        "<div class=\"nacha-record tooltip #{record.record_type} #{record_error_class}\">" \
+          "<span class=\"nacha-record-number\" data-name=\"record-number\">#{Kernel.format('%05d',
+            record.line_number)}&nbsp;|&nbsp</span>" \
+          "#{field_html}" \
+          "<span class=\"record-type\" data-name=\"record-type\">#{record.human_name}</span>" \
+          "</div>"
+      end
+
+      def field_to_html(field)
+        tooltip_text = "<span class=\"tooltiptext\">#{field.human_name} #{field.errors.join(' ')}</span>"
+        field_classes = %w[nacha-field tooltip]
+        field_classes << 'mandatory' if field.mandatory?
+        field_classes << 'required' if field.required?
+        field_classes << 'optional' if field.optional?
+        field_classes << 'error' if field.errors.any?
+
+        ach_string = field.to_ach.gsub(' ', '&nbsp;')
+        "<span data-field-name=\"#{field.name}\" contentEditable=true " \
+          "class=\"#{field_classes.join(' ')}\" data-name=\"#{field.name}\">" \
+          "#{ach_string}#{tooltip_text}</span>"
+      end
+
+      def default_preamble
+        stylesheet = options.fetch(:stylesheet, default_stylesheet)
+        javascript = options.fetch(:javascript, '')
+        <<~HTML
+          <!DOCTYPE html>
+          <html>
+          <head>
+            <title>NACHA File</title>
+            <style>#{stylesheet}</style>
+            <script>#{javascript}</script>
+          </head>
+          <body>
+        HTML
+      end
+
+      def default_postamble
+        <<~HTML
+          </body>
+          </html>
+        HTML
+      end
+
+      def default_stylesheet
+        <<~CSS
+          body { font-family: monospace; }
+          .tooltip { position: relative; display: inline-block; border-bottom: 1px dotted black; }
+          .tooltip .tooltiptext { visibility: hidden; width: 120px; background-color: black; color: #fff; text-align: center; border-radius: 6px; padding: 5px 0; position: absolute; z-index: 1; }
+          .tooltip:hover .tooltiptext { visibility: visible; }
+          .nacha-record { white-space: nowrap; }
+          .error { background-color: #ffdddd; }
+        CSS
+      end
+    end
+  end
+end

data/lib/nacha/formatter/json_formatter.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'nacha/formatter/base'
+require 'json'
+
+module Nacha
+  module Formatter
+    class JsonFormatter < Base
+      def format
+        output = {
+          file: file_statistics,
+          records: records.map { |record| record_to_h(record) }
+        }
+
+        JSON.pretty_generate(output)
+      end
+
+      private
+
+      def record_to_h(record)
+        {
+          nacha_record_type: record.record_type,
+          metadata: {
+            klass: record.class.name,
+            errors: record.errors,
+            line_number: record.line_number,
+            original_input_line: record.original_input_line
+          }
+        }.merge(
+          record.fields.keys.to_h do |key|
+            [key, field_to_json_output(record.fields[key])]
+          end
+        )
+      end
+
+      def field_to_json_output(field)
+        if field.json_output
+          # rubocop:disable GitlabSecurity/PublicSend
+          field.json_output.reduce(field.raw) do |memo, operation|
+            memo&.public_send(*operation)
+          end
+          # rubocop:enable GitlabSecurity/PublicSend
+        else
+          field.to_s
+        end
+      end
+    end
+  end
+end

data/lib/nacha/formatter/markdown_formatter.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'nacha/formatter/base'
+
+module Nacha
+  module Formatter
+    class MarkdownFormatter < Base
+      def format
+        [
+          file_statistics_markdown,
+          records_markdown
+        ].join("\n")
+      end
+
+      private
+
+      def file_statistics_markdown
+        stats = file_statistics
+        <<~MARKDOWN
+          # File Information
+
+          - **File Name:** #{stats[:file_name]}
+          - **File Size:** #{stats[:file_size]} bytes
+          - **Number of Lines:** #{stats[:number_of_lines]}
+          - **Created At:** #{stats[:created_at]}
+          - **Modified At:** #{stats[:modified_at]}
+          - **Checksum (SHA256):** #{stats[:checksum]}
+          - **Number of Filler Lines:** #{stats[:number_of_filler_lines]}
+        MARKDOWN
+      end
+
+      def records_markdown
+        records.map { |record| record_to_markdown(record) }.join("\n")
+      end
+
+      def record_to_markdown(record)
+        if options[:flavor] == :github
+          github_flavored_markdown(record)
+        else
+          common_mark_markdown(record)
+        end
+      end
+
+      def common_mark_markdown(record)
+        "## #{record.human_name}\n\n" +
+          record.fields.map { |name, field| "* **#{name}:** #{field}" }.join("\n")
+      end
+
+      def github_flavored_markdown(record)
+        "### #{record.human_name}\n\n" \
+          "| Field | Value |\n" \
+          "|-------|-------|\n" +
+          record.fields.map { |name, field| "| #{name} | #{field} |" }.join("\n")
+      end
+    end
+  end
+end

data/lib/nacha/formatter.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'nacha/formatter/json_formatter'
+require 'nacha/formatter/html_formatter'
+require 'nacha/formatter/markdown_formatter'
+
+module Nacha
+  module Formatter
+    class FormatterFactory
+      def self.get(format, records, options = {})
+        case format
+        when :json
+          JsonFormatter.new(records, options)
+        when :html
+          HtmlFormatter.new(records, options)
+        when :markdown
+          MarkdownFormatter.new(records, options)
+        else
+          raise ArgumentError, "Unknown format: #{format}"
+        end
+      end
+    end
+  end
+end

data/lib/nacha/parser.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'byebug'
 require 'nacha'
 require 'nacha/parser_context'
 
@@ -56,12 +55,19 @@ class Nacha::Parser
       record = parse_first_by_types(line, record_types)
       break if record || !parent
 
-      record.validate if record
+      record_types = valid_record_types(parent.parent)
       parent = parent.parent
-      record_types = valid_record_types(parent)
     end
-    record.line_number = line_num if record
-    add_child(parent, record)
+    # Check all record types if no record was found
+    # TODO: remove this fallback logic
+    record ||= parse_first_by_types(line, Nacha.ach_record_types)
+
+    if record
+      record.line_number = line_num
+      record.validate
+      add_child(parent, record)
+    end
+
     record
   end
 

data/lib/nacha/record/addenda_record_type.rb

@@ -9,7 +9,14 @@ module Nacha
 
       module ClassMethods
         def child_record_types
-          []
+          [
+            "Nacha::Record::SecondIatAddenda",
+            "Nacha::Record::ThirdIatAddenda",
+            "Nacha::Record::FourthIatAddenda",
+            "Nacha::Record::FifthIatAddenda",
+            "Nacha::Record::SixthIatAddenda",
+            "Nacha::Record::SeventhIatAddenda"
+          ]
         end
 
         def self.next_record_types

data/lib/nacha/record/base.rb

@@ -56,7 +56,9 @@ module Nacha
         end
 
         def unpack_str
-          @unpack_str ||= definition.values.collect do |field_def|
+          @unpack_str ||= definition.values
+                            .sort { |a, b| a[:position].first <=> b[:position].first }
+                            .collect do |field_def|
             Nacha::Field.unpack_str(field_def)
           end.join.freeze
         end
@@ -68,7 +70,8 @@ module Nacha
           @matcher ||= begin
             output_started = false
             skipped_output = false
-            Regexp.new('\A' + definition.values.reverse.collect do |field|
+            Regexp.new('\A' + definition.values
+                                .sort { |a,b| a[:position].first <=> b[:position].first }.reverse.collect do |field|
                          contents = field[:contents]
                          position = field[:position]
                          size = position.size
@@ -83,9 +86,9 @@ module Nacha
                            end
                          elsif contents.match?(/\ANumeric\z/) || contents.match?(/\AYYMMDD\z/)
                            output_started = true
-                           '[0-9 ]' + "{#{size}}"
+                           "[0-9 ]{#{size}}"
                          elsif output_started
-                           '.' + "{#{size}}"
+                           ".{#{size}}"
                          else
                            skipped_output = true
                            ''
@@ -181,7 +184,7 @@ module Nacha
           field.to_html
         end.join
         "<div class=\"nacha-record tooltip #{record_type} #{record_error_class}\">" \
-          "<span class=\"nacha-field\" data-name=\"record-number\">#{format('%05d',
+          "<span class=\"nacha-record-number\" data-name=\"record-number\">#{format('%05d',
             line_number)}&nbsp;|&nbsp</span>" \
           "#{field_html}" \
           "<span class=\"record-type\" data-name=\"record-type\">#{human_name}</span>" \

data/lib/nacha/record/batch_header_record_type.rb

@@ -9,16 +9,17 @@ module Nacha
 
       module ClassMethods
         def child_record_types
-          []
+          [
+            'Nacha::Record::BatchControl'
+          ]
         end
       end
 
       def child_record_types
         sec = standard_entry_class_code.to_s.capitalize
         [
-          "Nacha::Record::#{sec}EntryDetail",
-          'Nacha::Record::BatchControl'
-        ]
+          "Nacha::Record::#{sec}EntryDetail"
+        ] + self.class.child_record_types
       end
     end
   end

data/lib/nacha/record/detail_record_type.rb

@@ -9,7 +9,10 @@ module Nacha
 
       module ClassMethods
         def child_record_types
-          []
+          [
+            "Nacha::Record::FirstIatAddenda"
+            # Among other ...
+          ]
         end
 
         def next_record_types

data/lib/nacha/record/first_iat_addenda.rb

@@ -16,7 +16,7 @@ module Nacha
       nacha_field :foreign_payment_amount, inclusion: 'R', contents: 'Alphameric', position: 7..24
       nacha_field :foreign_trace_number, inclusion: 'O', contents: 'Alphameric', position: 25..46
       nacha_field :receiving_company_name, inclusion: 'M', contents: 'Alphameric', position: 47..81
-      nacha_field :reserved, inclusion: 'M', contents: 'C      ', position: 84..87
+      nacha_field :reserved, inclusion: 'M', contents: 'C      ', position: 82..87
       nacha_field :entry_detail_sequence_number, inclusion: 'M', contents: 'Numeric', position: 88..94
     end
   end

data/lib/nacha/record/iat_entry_detail.rb

@@ -14,10 +14,10 @@ module Nacha
       nacha_field :transaction_code, inclusion: 'M', contents: 'Numeric', position: 2..3
       nacha_field :receiving_dfi_identification, inclusion: 'M', contents: 'TTTTAAAAC', position: 4..12
       nacha_field :number_of_addenda_records, inclusion: 'M', contents: 'Alphameric', position: 13..16
-      nacha_field :reserved, inclusion: 'O', contents: 'C             ', position: 17..29
+      nacha_field :reserved1, inclusion: 'O', contents: 'C             ', position: 17..29
       nacha_field :amount, inclusion: 'M', contents: '$$$$$$$$¢¢', position: 30..39
       nacha_field :dfi_account_number, inclusion: 'M', contents: 'Numeric', position: 40..74
-      nacha_field :reserved, inclusion: 'O', contents: 'C  ', position: 75..76
+      nacha_field :reserved2, inclusion: 'O', contents: 'C  ', position: 75..76
       nacha_field :gateway_operator_ofac_screening_indicator, inclusion: 'O', contents: 'Alphameric',
         position: 77..77
       nacha_field :secondary_ofac_screening_indicator, inclusion: 'O', contents: 'Alphameric',

data/lib/nacha/version.rb

@@ -2,7 +2,7 @@
 
 module Nacha
   module Version
-    STRING = '0.1.12'
+    STRING = '0.1.14'
   end
   VERSION = Version::STRING
 end

data/nacha.gemspec

@@ -39,4 +39,5 @@ Gem::Specification.new do |spec|
   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.12
+  version: 0.1.14
 platform: ruby
 authors:
 - David H. Wilkins
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-09 00:00:00.000000000 Z
+date: 2025-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -220,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
@@ -228,6 +242,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".gitlab-ci.yml"
 - ".rspec"
@@ -249,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