anz_bank_csv_cleaner 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3c47469bac26468defb821bc4bef7bc89b827fb7
+  data.tar.gz: 50d6314e3540c9c39bcf0c1b74474099284d7bec
+SHA512:
+  metadata.gz: a005fbc3d7409987b5795b1825698b802aacd176f7aeea6a3b105892cf66bb44a8004c8163f7ea5dba10783806ded519b242c40925eef085e0db88a00214e92b
+  data.tar.gz: 6801ac1cbcd7375e8c92ac579bdb1cc6e02f63f5756478657bb6eb4d1edbe9197f884d26824f4eeca6ea7cbefe522d3ddae2fd6bce2cdd0213b0db9b1295c8d4

data/lib/anz_bank_csv_cleaner.rb

@@ -0,0 +1,89 @@
+require 'CSV'
+
+class ANZBankCSVCleaner
+  TYPE_FIELD = "Type"
+  DETAILS_FIELD = "Details"
+  PARTICULARS_FIELD = "Particulars"
+  CODE_FIELD = "Code"
+  REFERENCE_FIELD = "Reference"
+  AMOUNT_FIELD = "Amount"
+  DATE_FIELD = "Date"
+  DEBIT_VALUE = "DR"
+  CREDIT_VALUE = "CR"
+  VISA_PURCHASE_TYPE = "Visa Purchase"
+  EFTPOS_PURCHASE_TYPE = "Eft-Pos"
+
+  CLEAN_HEADER = [DATE_FIELD, AMOUNT_FIELD, TYPE_FIELD, DETAILS_FIELD]
+
+  def initialize(import_path:, export_path:)
+      @import_path = import_path
+      @export_path = export_path
+
+      unless (File.file?(@import_path))
+        raise StandardError.new("No input file")
+      end
+  end
+
+  def run
+    CSV.open(@export_path, "w", :write_headers => true, :headers => CLEAN_HEADER) do |clean_csv|
+      CSV.foreach(@import_path, :headers => true) do |import_row|
+        clean_csv << build_clean_row(import_row)
+      end
+    end
+  end
+
+  private
+
+  def check_required_fields(import_row)
+    if !import_row[DATE_FIELD]
+      raise StandardError.new("A '#{DATE_FIELD}' field is required.")
+    elsif !import_row[AMOUNT_FIELD]
+      raise StandardError.new("A '#{AMOUNT_FIELD}' field is required.")
+    end
+  end
+
+  def use_field(field_value)
+    field_value && field_value.length > 0
+  end
+
+  def clean_detail_field(import_row)
+    details_fields = []
+    type = import_row[TYPE_FIELD]
+
+    if(use_field(import_row[DETAILS_FIELD]) && type != VISA_PURCHASE_TYPE)
+      details_fields.push(import_row[DETAILS_FIELD])
+    end
+
+    if(use_field(import_row[PARTICULARS_FIELD]) && type != VISA_PURCHASE_TYPE && type != EFTPOS_PURCHASE_TYPE)
+      details_fields.push(import_row[PARTICULARS_FIELD])
+    end
+
+    if(use_field(import_row[CODE_FIELD]) && type != EFTPOS_PURCHASE_TYPE)
+      details_fields.push(import_row[CODE_FIELD])
+    end
+
+    if(use_field(import_row[REFERENCE_FIELD]) && type != VISA_PURCHASE_TYPE && type != EFTPOS_PURCHASE_TYPE)
+      details_fields.push(import_row[REFERENCE_FIELD])
+    end
+
+    details_field_result = ""
+    details_fields.each do |detail_field|
+      details_field_result << "#{detail_field} "
+    end
+
+    details_field_result
+  end
+
+  def build_clean_row(import_row)
+    check_required_fields(import_row)
+
+    clean_row = []
+    amount = import_row[AMOUNT_FIELD].to_f
+    clean_row[0] = import_row[DATE_FIELD]
+    clean_row[1] = amount
+    clean_row[2] = amount > 0 ? CREDIT_VALUE : DEBIT_VALUE
+    clean_row[3] = clean_detail_field(import_row)
+
+    clean_row
+  end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: anz_bank_csv_cleaner
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Jordan Crawford
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-12-11 00:00:00.000000000 Z
+dependencies: []
+description: ANZ Bank's CSV export contains many fields, making it difficult to identify
+  transactions. This Gem simplifies these fields, making the file easier to use.
+email: jordan@crawford.kiwi
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/anz_bank_csv_cleaner.rb
+homepage: 
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Produces a cleaner version of the ANZ Bank CSV export for easier transaction
+  identification.
+test_files: []