Add header record using Fixy and DryRB Validation gems

.rubocop.yml

@@ -3,15 +3,23 @@ require:
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 2.6  
+  TargetRubyVersion: 2.7
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/BlockLength:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
 
 Style/StringLiterals:
   Enabled: true
   EnforcedStyle: double_quotes
 
-Style/StringLiteralsInInterpolation:
-  Enabled: true
-  EnforcedStyle: double_quotes
+RSpec/ExampleLength:
+  Enabled: false
 
-Layout/LineLength:
-  Max: 120
+RSpec/MultipleExpectations:
+  Enabled: false

lib/mt9.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
+require "fixy"
+
 require_relative "mt9/version"
+require_relative "mt9/base_record"
+require_relative "mt9/header_record"
 
 module MT9
   class Error < StandardError; end

lib/mt9/base_record.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "formatters"
+
+module MT9
+  class BaseRecord < Fixy::Record
+    include Fixy::Formatter::Alphanumeric
+    include Fixy::Formatter::Numeric
+
+    SPACE = " "
+
+    set_record_length 160
+  end
+end

lib/mt9/formatters.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Fixy
+  module Formatter
+    module Numeric
+      RESERVED_BANK_CODES = %w[99].freeze
+
+      def format_numeric(input, length)
+        input = input.to_s
+        raise ArgumentError, "Invalid Input (only digits are accepted)" unless input =~ /^\d+$/
+        raise ArgumentError, "Invalid Length (length must be #{length} not #{input.length})" if input.length != length
+
+        input
+      end
+
+      def format_file_type(input, _length)
+        input = input.to_s
+        unless MT9::HeaderRecord::FILE_TYPES.include?(input)
+          raise(
+            ArgumentError,
+            "Invalid filetype. Must be one of the following: #{MT9::HeaderRecord::FILE_TYPES.join(', ')}"
+          )
+        end
+
+        input
+      end
+
+      def format_account_number(input, length)
+        input = format_numeric(input, length)
+        if input.start_with?(*RESERVED_BANK_CODES)
+          raise ArgumentError, "Invalid account number. Cannot start with a reserved bank code"
+        end
+
+        input
+      end
+    end
+  end
+end

lib/mt9/header_record.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module MT9
+  class HeaderRecord < BaseRecord
+    DIRECT_CREDIT = "12"
+    DIRECT_DEBIT = "20"
+    FILE_TYPES = [DIRECT_CREDIT, DIRECT_DEBIT].freeze
+
+    attr_reader :file_type, :account_number, :due_date, :client_short_name
+
+    field :file_type, 2, "1-2", :file_type
+    field :account_number, 15, "3-17", :account_number
+    field :filler1, 1, "18", :alphanumeric
+    field :due_date, 6, "19-24", :numeric
+    field :filler7, 7, "25-31", :alphanumeric
+    field :client_short_name, 20, "32-51", :alphanumeric
+    field :filler109, 109, "52-160", :alphanumeric
+
+    field_value :filler1, SPACE
+    field_value :filler7, SPACE * 7
+    field_value :filler109, SPACE * 109
+
+    def initialize(file_type:, account_number:, due_date:, client_short_name:)
+      @file_type = file_type
+      @account_number = account_number
+      @due_date = due_date
+      @client_short_name = client_short_name
+    end
+  end
+end

mt9.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
     "MT9 is a data standard used within the NZ banking industry for the creation of Bulk Payments and Receipts."
   spec.homepage = "https://github.com/zeptofs/mt9"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
+  spec.required_ruby_version = ">= 2.7.0"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -25,8 +25,7 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
+  spec.add_dependency "fixy", "~> 0.0.9"
 
   # For more information and examples about making a new gem, check out our
   # guide at: https://bundler.io/guides/creating_gem.html