volksbanker 1.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in volksbanker.gemspec
+gemspec

data/README.md

@@ -0,0 +1,23 @@
+# Volksbanker
+
+Prepares Volksbank's electronic statements for upload to Freeagent.
+
+
+## Usage
+
+    vb STATEMENT > out.csv
+
+where STATEMENT is your electronic statement from Volksbank, and `out.csv` is the file you'll upload to Freeagent.
+
+
+## Installation
+
+    gem install volksbanker
+
+
+## Intellectual property
+
+Copyright 2012 Andrew Stewart, AirBlade Software Ltd.
+
+Released under the MIT licence.
+

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'lib' << 'test'
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true
+end
+

data/bin/vb

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby-local-exec
+
+lib_dir = File.join File.dirname(__FILE__), '..', 'lib'
+$LOAD_PATH.unshift lib_dir
+
+require 'volksbanker'
+
+Volksbanker::Cli.run ARGV.first
+

data/lib/volksbanker/amex_line_item.rb

@@ -0,0 +1,19 @@
+module Volksbanker
+
+  class AmexLineItem
+    DATE_FORMAT = '%d/%m/%Y'
+
+    attr_reader :amount, :description
+
+    def initialize(date, amount, description)
+      @date = date
+      @amount = amount
+      @description = description
+    end
+
+    def date
+      @date.strftime DATE_FORMAT
+    end
+  end
+
+end

data/lib/volksbanker/cli.rb

@@ -0,0 +1,19 @@
+require 'volksbanker/volksbank_file_reader'
+
+module Volksbanker
+
+  class Cli
+    def self.run(volksbank_file)
+      reader = VolksbankFileReader.new volksbank_file
+      reader.each_line_item do |vli|
+        unless vli.currency == 'EUR'
+          $stderr.puts "Skipping non-EUR currency line item: #{vli.inspect}"
+          next
+        end
+        ali = AmexLineItem.new vli.posting_date, vli.value, vli.description
+        CSV { |out| out << [ali.date, ali.amount, ali.description] }
+      end
+    end
+  end
+
+end

data/lib/volksbanker/version.rb

@@ -0,0 +1,3 @@
+module Volksbanker
+  VERSION = '1.0.0'
+end

data/lib/volksbanker/volksbank_file_reader.rb

@@ -0,0 +1,62 @@
+# Volksbank format line by line:
+#
+# Lines 1-13: header
+# Subsequent non-blank lines: semi-colon separated values
+#   posting date
+#   value date
+#   payer/payee
+#   recipient/payer
+#   account no.
+#   sortcode
+#   description
+#   currency
+#   amount
+#   credit (H) /debit (S)
+# Blank line
+# Footer (opening and closing balances)
+
+require 'volksbanker/volksbank_line_item'
+require 'volksbanker/amex_line_item'
+
+module Volksbanker
+
+  class VolksbankFileReader
+    def initialize(file)
+      @file = file
+    end
+
+    # Yields each transaction line item to the block.
+    # I.e. skips the header and footer information.
+    def each_line_item(&block)
+      data = File.open(@file,'r:iso-8859-1:utf-8') { |f| f.read }
+      data = clean_line_breaks data
+
+      line_number = 0
+      data.each_line do |line|
+        line_number += 1           # 1-based line numbering
+        next if line_number <= 13  # skip header
+        line.chomp!
+        break if line.empty?       # skip footer
+
+        yield VolksbankLineItem.new_from_csv line
+      end
+    end
+
+    private
+
+    def clean_line_breaks(str)
+      # Format uses \r\n for line breaks between inter-line breaks and \n for intra-line breaks.
+      # There must be a neat Ruby way to do this...
+      remove_inter_line_breaks remove_intra_line_breaks(str)
+    end
+
+    def remove_intra_line_breaks(str)
+      str.gsub /([^\r])\n/, '\1 '
+    end
+
+    def remove_inter_line_breaks(str)
+      str.gsub "\r\n", "\n"
+    end
+  end
+
+end

data/lib/volksbanker/volksbank_line_item.rb

@@ -0,0 +1,46 @@
+require 'csv'
+
+class VolksbankLineItem
+  DATE_FORMAT = '%d.%m.%Y'
+
+  attr_reader :posting_date, :value_date, :payer_or_payee, :recipient_or_payer,
+              :account_number, :sort_code, :description, :currency,
+              :value
+
+  def initialize(posting_date, value_date, payer_or_payee, recipient_or_payer,
+                account_number, sort_code, description, currency,
+                amount, credit_or_debit)
+    @posting_date       = parse_date posting_date
+    @value_date         = parse_date value_date
+    @payer_or_payee     = payer_or_payee
+    @recipient_or_payer = recipient_or_payer
+    @account_number     = account_number
+    @sort_code          = sort_code
+    @description        = description
+    @currency           = currency
+    amt = parse_number amount
+    @value = credit?(credit_or_debit) ? amt : (amt * -1)
+  end
+
+  def self.new_from_csv(line)
+    CSV.parse(line, col_sep: ';') { |row| return new(*row) }
+  end
+
+  private
+
+  def parse_date(str)
+    Date.strptime str, DATE_FORMAT
+  end
+
+  def parse_number(str)
+    str.               # There must be a better way to do this!
+      gsub('.', '').   # no thousand-separator
+      gsub(',', '.').  # use decimal point instead of comma for decimal separator
+      to_f
+  end
+
+  def credit?(str)
+    str == 'H'
+  end
+end
+

data/lib/volksbanker.rb

@@ -0,0 +1,6 @@
+require 'volksbanker/version'
+require 'volksbanker/cli'
+require 'volksbanker/volksbank_file_reader'
+require 'volksbanker/volksbank_line_item'
+require 'volksbanker/amex_line_item'
+

data/test/cli_test.rb

@@ -0,0 +1,25 @@
+require 'minitest/autorun'
+require 'test_helper'
+require 'volksbanker/cli'
+
+class CliTest < MiniTest::Unit::TestCase
+
+  def test_happy_path
+    expected_stdout = read_fixture 'result.csv'
+    expected_stderr = ''
+
+    assert_output expected_stdout, expected_stderr do
+      Volksbanker::Cli.run fixture('transactions.csv')
+    end
+  end
+
+  def test_skips_non_euro_line_items
+    out, err = capture_io do
+      Volksbanker::Cli.run fixture('transactions-with-non-euro.csv')
+    end
+
+    refute_match %r{30/07/2012}m, out
+    assert_match /Skipping/, err
+  end
+
+end

data/test/fixtures/result.csv

@@ -0,0 +1,7 @@
+08/08/2012,-7.5,Bankcard-Gebühr FOLGE-NR.   0 VERFALL 12.15 PREIS BEZAHLT BIS 12.2012
+08/08/2012,170.0,Vergütung INVOICE 7004
+07/08/2012,170.0,"Vergütung INVOICE 7003 Acme GmbH, JULY 2012"
+03/08/2012,2023.0,Vergütung INVOICE 7002
+31/07/2012,68.0,Vergütung RGNR. 2271
+30/07/2012,136.0,Vergütung INVOICE 7002
+17/07/2012,170.0,Vergütung INVOICE 2264

data/test/fixtures/transactions-with-non-euro.csv

@@ -0,0 +1,32 @@
+"Volksbank Rhein-Wehra eG"
+
+"Umsatzanzeige"
+
+"BLZ:";"68490000";;"Datum:";"13.08.2012"
+"Konto:";"12345678";;"Uhrzeit:";"11:54:07"
+"Abfrage von:";"Joe Bloggs";;"Kontoinhaber:";"Foo GmbH"
+
+"Zeitraum:";"4 Wochen";"von:";;"bis:";
+"Betrag in EUR:";;"von:";" ";"bis:";" "
+"Sortiert nach:";"Buchungstag";"absteigend"
+
+"Buchungstag";"Valuta";"Auftraggeber/Zahlungsempf�nger";"Empf�nger/Zahlungspflichtiger";"Konto-Nr.";"BLZ";"Vorgang/Verwendungszweck";"W�hrung";"Umsatz";" "
+"08.08.2012";"08.08.2012";;"PREIS VR-BANKCARD";"1234500000";"12340000";"Bankcard-Geb�hr
+FOLGE-NR.   0 VERFALL 12.15
+PREIS BEZAHLT BIS 12.2012";"EUR";"7,50";"S"
+"08.08.2012";"08.08.2012";"Foo GmbH";"Jane Doe";"1234567890";"12345678";"Verg�tung
+INVOICE 7004";"EUR";"170,00";"H"
+"07.08.2012";"07.08.2012";"BarApp";"Sarah Smith";"123456789";"12345678";"Verg�tung
+INVOICE 7003
+Acme GmbH, JULY 2012";"EUR";"170,00";"H"
+"03.08.2012";"03.08.2012";"Foo GmbH";"Some Firm GmbH";"1234567";"12345678";"Verg�tung
+INVOICE 7002";"EUR";"2.023,00";"H"
+"31.07.2012";"31.07.2012";"Foo GmbH";"James Brown";"1234567890";"12345678";"Verg�tung
+RGNR. 2271";"EUR";"68,00";"H"
+"30.07.2012";"30.07.2012";"Foo GmbH";"Example.com";"123456789";"12345678";"Verg�tung
+INVOICE 7002";"GBP";"136,00";"H"
+"17.07.2012";"17.07.2012";"Foo GmbH";"Blah Inc GmbH";"1234567890";"12345678";"Verg�tung
+INVOICE 2264";"EUR";"170,00";"H"
+
+"17.07.2012";;;;;;"EUR";"Anfangssaldo";"0,00";"H"
+"08.08.2012";;;;;;"EUR";"Endsaldo";"2.729,50";"H"

data/test/fixtures/transactions.csv

@@ -0,0 +1,32 @@
+"Volksbank Rhein-Wehra eG"
+
+"Umsatzanzeige"
+
+"BLZ:";"68490000";;"Datum:";"13.08.2012"
+"Konto:";"12345678";;"Uhrzeit:";"11:54:07"
+"Abfrage von:";"Joe Bloggs";;"Kontoinhaber:";"Foo GmbH"
+
+"Zeitraum:";"4 Wochen";"von:";;"bis:";
+"Betrag in EUR:";;"von:";" ";"bis:";" "
+"Sortiert nach:";"Buchungstag";"absteigend"
+
+"Buchungstag";"Valuta";"Auftraggeber/Zahlungsempf�nger";"Empf�nger/Zahlungspflichtiger";"Konto-Nr.";"BLZ";"Vorgang/Verwendungszweck";"W�hrung";"Umsatz";" "
+"08.08.2012";"08.08.2012";;"PREIS VR-BANKCARD";"1234500000";"12340000";"Bankcard-Geb�hr
+FOLGE-NR.   0 VERFALL 12.15
+PREIS BEZAHLT BIS 12.2012";"EUR";"7,50";"S"
+"08.08.2012";"08.08.2012";"Foo GmbH";"Jane Doe";"1234567890";"12345678";"Verg�tung
+INVOICE 7004";"EUR";"170,00";"H"
+"07.08.2012";"07.08.2012";"BarApp";"Sarah Smith";"123456789";"12345678";"Verg�tung
+INVOICE 7003
+Acme GmbH, JULY 2012";"EUR";"170,00";"H"
+"03.08.2012";"03.08.2012";"Foo GmbH";"Some Firm GmbH";"1234567";"12345678";"Verg�tung
+INVOICE 7002";"EUR";"2.023,00";"H"
+"31.07.2012";"31.07.2012";"Foo GmbH";"James Brown";"1234567890";"12345678";"Verg�tung
+RGNR. 2271";"EUR";"68,00";"H"
+"30.07.2012";"30.07.2012";"Foo GmbH";"Example.com";"123456789";"12345678";"Verg�tung
+INVOICE 7002";"EUR";"136,00";"H"
+"17.07.2012";"17.07.2012";"Foo GmbH";"Blah Inc GmbH";"1234567890";"12345678";"Verg�tung
+INVOICE 2264";"EUR";"170,00";"H"
+
+"17.07.2012";;;;;;"EUR";"Anfangssaldo";"0,00";"H"
+"08.08.2012";;;;;;"EUR";"Endsaldo";"2.729,50";"H"

data/test/test_helper.rb

@@ -0,0 +1,13 @@
+class MiniTest::Unit::TestCase
+
+  # Returns full path to fixture file.
+  def fixture(filename)
+    File.expand_path "../fixtures/#{filename}", __FILE__
+  end
+
+  # Returns contents of fixture file.
+  def read_fixture(filename)
+    File.open(fixture filename) { |f| f.read }
+  end
+
+end

data/volksbanker.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "volksbanker/version"
+
+Gem::Specification.new do |s|
+  s.name        = "volksbanker"
+  s.version     = Volksbanker::VERSION
+  s.authors     = ["Andy Stewart"]
+  s.email       = ["boss@airbladesoftware.com"]
+  s.homepage    = ""
+  s.summary     = "Prepares Volksbank's electronic statements for upload to Freeagent."
+  s.description = s.summary
+
+  s.rubyforge_project = "volksbanker"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency 'rake', '~> 0.9.2'
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: volksbanker
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Andy Stewart
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2159222460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: *2159222460
+description: Prepares Volksbank's electronic statements for upload to Freeagent.
+email:
+- boss@airbladesoftware.com
+executables:
+- vb
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- bin/vb
+- lib/volksbanker.rb
+- lib/volksbanker/amex_line_item.rb
+- lib/volksbanker/cli.rb
+- lib/volksbanker/version.rb
+- lib/volksbanker/volksbank_file_reader.rb
+- lib/volksbanker/volksbank_line_item.rb
+- test/cli_test.rb
+- test/fixtures/result.csv
+- test/fixtures/transactions-with-non-euro.csv
+- test/fixtures/transactions.csv
+- test/test_helper.rb
+- volksbanker.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3400310575893115125
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3400310575893115125
+requirements: []
+rubyforge_project: volksbanker
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Prepares Volksbank's electronic statements for upload to Freeagent.
+test_files:
+- test/cli_test.rb
+- test/fixtures/result.csv
+- test/fixtures/transactions-with-non-euro.csv
+- test/fixtures/transactions.csv
+- test/test_helper.rb