mt940 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,7 @@
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "shoulda", ">= 0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.2"
+end

data/Gemfile.lock

@@ -0,0 +1,17 @@
+GEM
+  specs:
+    git (1.2.5)
+    jeweler (1.6.2)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.8.7)
+    shoulda (2.11.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.6.2)
+  shoulda

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Frank Oxener - Agile Dovadi BV
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,40 @@
+MT940
+======
+
+Basis parser for MT940 files, see [MT940](http://nl.wikipedia.org/wiki/MT940)
+
+The following Dutch banks are implemented:
+
+* ABN Amro
+* ING
+* Rabobank
+* Triodos
+
+Usage
+=====
+
+* At this moment there is no automatic determination which bank needs to be parsed. So you need to choose the corresponding MT940 subclass for the specific bank you want to parse. 
+
+    `file_name = File.dirname(__FILE__) + 'ing.940'`
+    `@transactions = MT940::ING.transactions(file_name)`
+
+* Independent of the bank, a transaction always consists of an amount and a description. 
+* With some implementations the contra_account with its owner is extracted as well.
+
+
+Contributing to MT940
+=====================
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+Copyright
+==========
+
+Copyright (c) 2011 Frank Oxener - Agile Dovadi BV. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,45 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "mt940"
+  gem.homepage = "http://github.com/dovadi/mt940"
+  gem.license = "MIT"
+  gem.summary = %Q{MT940 parser}
+  gem.description = %Q{A basic MT940 parser with implementations for Dutch banks.}
+  gem.email = "frank.oxener@gmail.com"
+  gem.authors = ["dovadi"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "mt940 #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/mt940/banks/abnamro.rb

@@ -0,0 +1,23 @@
+class MT940::Abnamro < MT940::Base
+
+  def parse
+    tag86 = false
+    @lines.each do |line|
+      if line.match(/^:25:(\d*)/) 
+        @bank_account = $1
+        tag86 = false
+      elsif line.match(/^:61:\d{6}\d{4}(C|D)(\d+),(\d{0,2})/) #:61:1105240524D9,N192NONREF
+        type = $1 == 'D' ? -1 : 1
+        @transaction = MT940::Transaction.new(:bank_account => @bank_account, :amount => type * ($2 + '.' + $3).to_f)
+        @transactions << @transaction
+        tag86 = false
+      elsif line.match(/^:86:(.*)$/)
+        @transaction.description = $1.strip
+        tag86 = true
+      elsif tag86 && line.match(/^[^:]/)
+        @transaction.description += ' ' + line.strip.gsub(/\n/,'')
+      end
+    end
+  end
+
+end

data/lib/mt940/banks/ing.rb

@@ -0,0 +1,23 @@
+class MT940::ING < MT940::Base
+
+  def parse
+    tag86 = false
+    @lines.each do |line|
+      if line.match(/^:25:(\d{10})/)
+        @bank_account = $1
+        tag86 = false
+      elsif line.match(/^:61:(\d{6})(C|D)(\d+),(\d{0,2})/)
+        type = $2 == 'D' ? -1 : 1
+        @transaction = MT940::Transaction.new(:bank_account => @bank_account, :amount => type * ($3 + '.' + $4).to_f)
+        @transactions << @transaction
+        tag86 = false
+      elsif line.match(/^:86:\s?(.*)$/)
+        tag86 = true
+        @transaction.description = $1
+      elsif tag86 && line.match(/^[^:]/)
+        @transaction.description += ' ' + line.strip.gsub(/\n/,'')
+      end
+    end
+  end
+
+end

data/lib/mt940/banks/rabobank.rb

@@ -0,0 +1,19 @@
+class MT940::Rabobank < MT940::Base
+
+  def parse
+    @lines.each do |line|
+      if line.match(/^:25:(\d{4}.\d{2}.\d{3})/)
+        @bank_account = $1
+      elsif line.match(/^:61:\d{6}(C|D)(\d+),(\d{0,2})\w{4}(.{16})(.+)$/)
+        type = $1 == 'D' ? -1 : 1
+        @transaction = MT940::Transaction.new(:bank_account => @bank_account, :amount => type * ($2 + '.' + $3).to_f)
+        @transaction.contra_account = $4.strip
+        @transaction.contra_account_name = $5.strip
+        @transactions << @transaction
+      elsif line.match(/^:86:(.*)$/)
+        @transaction.description = $1.strip
+      end
+    end
+  end
+
+end

data/lib/mt940/banks/triodos.rb

@@ -0,0 +1,23 @@
+class MT940::Triodos < MT940::Base
+
+  def parse
+    tag86 = false
+    @lines.each do |line|
+      if line.match(/^:25:TRIODOSBANK\/(\d*)$/) 
+        @bank_account = $1
+        tag86 = false
+      elsif line.match(/^:61:\d{6}(C|D)(\d+),(\d{0,2})/) #:61:1105240524D9,N192NONREF
+        type = $1 == 'D' ? -1 : 1
+        @transaction = MT940::Transaction.new(:bank_account => @bank_account, :amount => type * ($2 + '.' + $3).to_f)
+        @transactions << @transaction
+        tag86 = false
+      elsif line.match(/^:86:(.*)$/)
+        @transaction.description = $1.strip.gsub(/>\d{2}/,'')
+        tag86 = true
+      elsif tag86 && line.match(/^[^:]/)
+        @transaction.description += line.strip.gsub(/\n/,'').gsub(/>\d{2}/,'')
+      end
+    end
+  end
+
+end

data/lib/mt940/base.rb

@@ -0,0 +1,24 @@
+module MT940
+
+  class Base
+
+    def self.transactions(file_name)
+      instance = self.new(file_name)
+      instance.parse
+      instance.instance_variable_get('@transactions')
+    end
+
+    private
+
+    def initialize(file_name)
+      @transactions = []
+      @lines = File.readlines(file_name)
+    end
+
+    def parse
+      raise NoMethodError, 'Code must be implemented in subclass'
+    end
+
+  end
+
+end

data/lib/mt940/transaction.rb

@@ -0,0 +1,16 @@
+module MT940
+
+  class Transaction
+
+    attr_accessor :bank_account, :contra_account, :amount, :description, :contra_account_name
+
+    def initialize(attributes = {})
+      @bank_account        = attributes[:bank_account]
+      @amount              = attributes[:amount]
+      @description         = attributes[:description]
+      @contra_account_name = attributes[:contra_account_name]
+    end
+
+  end
+
+end

data/lib/mt940.rb

@@ -0,0 +1,9 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'mt940/base'
+require 'mt940/transaction'
+require 'mt940/banks/ing'
+require 'mt940/banks/rabobank'
+require 'mt940/banks/abnamro'
+require 'mt940/banks/triodos'

data/test/fixtures/abnamro.txt

@@ -0,0 +1,41 @@
+ABNANL2A
+940
+ABNANL2A
+:20:ABN AMRO BANK NV
+:25:517852257
+:28:19321/1
+:60F:C110522EUR3236,28
+:61:1105240524D9,N192NONREF
+:86:GIRO   428428 KPN - DIGITENNE    BETALINGSKENM.  000000042188659
+5314606715                       BETREFT FACTUUR D.D. 20-05-2011
+INCL. 1,44 BTW
+:61:1105210523D11,59N426NONREF
+:86:BEA   NR:XXX1234   21.05.11/12.54 DIRCKIII FIL2500 KATWIJK,PAS999
+:61:1105230523D11,63N426NONREF
+:86:BEA   NR:XXX1234   23.05.11/09.08 DIGROS FIL1015 KATWIJK Z,PAS999
+:61:1105220523D11,8N426NONREF
+:86:BEA   NR:XXX1234   22.05.11/14.25 MC DONALDS A44 LEIDEN,PAS999
+:61:1105210523D13,45N426NONREF
+:86:BEA   NR:XXX1234   21.05.11/12.09 PRINCE FIL. 55 KATWIJK Z,PAS999
+:61:1105210523D15,49N426NONREF
+:86:BEA   NR:XXX1234   21.05.11/12.55 DIRX FIL6017 KATWIJK ZH ,PAS999
+
+:61:1105210523D107,N426NONREF
+:86:BEA   NR:XXX1234   21.05.11/12.04 HANS ANDERS OPT./056 KAT,PAS999
+:61:1105220523D141,48N426NONREF
+:86:BEA   NR:XXX1234   22.05.11/13.45 MYCOM DEN HAAG  S-GRAVEN,PAS999
+:62F:C110523EUR876,84
+-
+ABNANL2A
+940
+ABNANL2A
+:20:ABN AMRO BANK NV
+:25:517852257
+:28:19322/1
+:60F:C110523EUR2876,84
+:61:1105240524D9,49N426NONREF
+:86:BEA   NR:XXX1234   24.05.11/09.18 PETS PLACE KATWIJK KATWI,PAS999
+:61:1105240524D15,N426NONREF
+:86:BEA   NR:XXX1234   24.05.11/09.17 BRAINWASH KATWIJK KATWIJ,PAS999
+:62F:C110524EUR1849,75
+-

data/test/fixtures/ing.txt

@@ -0,0 +1,24 @@
+0000 01INGBNL2AXXXX00001
+0000 01INGBNL2AXXXX00001
+940 00
+:20:MPBZ
+:25:0001234567
+:28C:000
+:60F:C100722EUR0,00
+:61:100722D25,03NOV NONREF
+:86: RC AFREKENING BETALINGSVERKEER
+BETREFT REKENING 4715589 PERIODE: 01-10-2010 / 31-12-2010
+ING Bank N.V. tarifering ING
+:61:100722D3,03NOV NONREF
+:86:0111111111 GPSEOUL SPOEDBETALING	MPBZS1016000047 GPSEOUL
+:61:100722D1,11NGT TMG TANGO
+:86:0111111111 ING iDEAL KN: TMG TANGO TRANSACTIENR 0050000534527978 10­06­2010 15:32 TMG TANGO ING Bank inzake GPKyoto
+:61:100722D20,00NGM NONREF
+:86: ABN AMRO BANK>AMSTERDAM 22­07­2010 09:57 002	5595781
+:61:100722D1,10NGT NONREF
+:86:0111111111 GPPeking 170000001AC
+:61:100722C3,68NVZ NONREF
+:86:0111111111 EJ46GREENP100610T1456 CLIEOP TMG GPHONGKONG AMSTERDAM
+:62F:C100723EUR3,47
+:86:D000004C000002D25,24C28,71
+-XXX

data/test/fixtures/rabobank.txt

@@ -0,0 +1,24 @@
+:940:
+
+:20:940A110615
+:25:1291.99.348EUR
+:28:00000/00
+:60F:C110614EUR000000000473,17
+:61:110615D000000000077,35N071P005675159      Uitgeverij De Druif
+:86:Factuurnummer 234578
+:62F:C110615EUR000000000395,82
+
+:20:940A110616
+:25:1291.99.348EUR
+:28:00000/00
+:60F:C110615EUR0000000001000,89
+:62F:C110616EUR0000000001000,89
+
+:20:940A110617
+:25:1291.99.348EUR
+:28:00000/00
+:60F:C110616EUR0000000001295,82
+:61:110617D000000000044,95N0600733959555      T-MOBILE NETHERLANDS BV
+:86:BETALINGSKENM.  123456789
+:86:FACTUURNUMMER 987654321
+:62F:C110617EUR0000000001250,87

data/test/fixtures/triodos.txt

@@ -0,0 +1,14 @@
+:20:1308728725026/1
+:25:TRIODOSBANK/0390123456
+:28:1
+:60F:C110101EUR4975,09
+:61:110101D15,70N000NONREF
+:86:000>100000000000
+>20ALGEMENE TUSSENREKENING KOS>21TEN VAN 01-10-2010 TOT EN M
+>22ET 31-12-2010>310390123456
+:61:110125D700,00N000NONREF
+:86:000>100133967858
+>20 HUUR>21 KANTOOR - FEB 2010
+:62F:C110201EUR4370,79
+-
+

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'mt940'
+
+class Test::Unit::TestCase
+end

data/test/test_mt940.rb

@@ -0,0 +1,13 @@
+require 'helper'
+
+class TestMt940 < Test::Unit::TestCase
+
+  def setup
+    @file_name = File.dirname(__FILE__) + '/fixtures/ing.txt'
+  end
+
+  should 'raise a NoMethodError if not implemented' do
+    assert_raise(NoMethodError) { MT940::Base.get_transactions(@file_name) }
+  end
+
+end

data/test/test_mt940_abnamro.rb

@@ -0,0 +1,29 @@
+require 'helper'
+
+class TestMt940Abnamro < Test::Unit::TestCase
+
+  def setup
+    file_name = File.dirname(__FILE__) + '/fixtures/abnamro.txt'
+    @transactions = MT940::Abnamro.transactions(file_name)
+    @transaction = @transactions.first
+  end
+  
+  should 'have the correct number of transactions' do
+    assert_equal 10, @transactions.size
+  end
+
+  context 'Transaction' do
+    should 'have a bank_account' do
+      assert_equal '517852257', @transaction.bank_account
+    end
+
+    should 'have an amount' do
+      assert_equal -9.00, @transaction.amount
+    end
+
+    should 'have a description' do
+      assert_equal 'GIRO   428428 KPN - DIGITENNE    BETALINGSKENM.  000000042188659 5314606715                       BETREFT FACTUUR D.D. 20-05-2011 INCL. 1,44 BTW', @transaction.description
+    end
+  end
+
+end

data/test/test_mt940_ing.rb

@@ -0,0 +1,29 @@
+require 'helper'
+
+class TestMt940Ing < Test::Unit::TestCase
+
+  def setup
+    file_name = File.dirname(__FILE__) + '/fixtures/ing.txt'
+    @transactions = MT940::ING.transactions(file_name)
+    @transaction = @transactions.first
+  end
+  
+  should 'have the correct number of transactions' do
+    assert_equal 6, @transactions.size
+  end
+
+  context 'Transaction' do
+    should 'have a bank_account' do
+      assert_equal '0001234567', @transaction.bank_account
+    end
+
+    should 'have an amount' do
+      assert_equal -25.03, @transaction.amount
+    end
+
+    should 'have a description' do
+      assert_equal 'RC AFREKENING BETALINGSVERKEER BETREFT REKENING 4715589 PERIODE: 01-10-2010 / 31-12-2010 ING Bank N.V. tarifering ING', @transaction.description
+    end
+  end
+
+end

data/test/test_mt940_rabobank.rb

@@ -0,0 +1,37 @@
+require 'helper'
+
+class TestMt940Rabobank < Test::Unit::TestCase
+
+  def setup
+    file_name = File.dirname(__FILE__) + '/fixtures/rabobank.txt'
+    @transactions = MT940::Rabobank.transactions(file_name)
+    @transaction = @transactions.first
+  end
+  
+  should 'have the correct number of transactions' do
+    assert_equal 2, @transactions.size
+  end
+
+  context 'Transaction' do
+    should 'have a bank_account' do
+      assert_equal '1291.99.348', @transaction.bank_account
+    end
+
+    should 'have a contra_account' do
+      assert_equal 'P005675159', @transaction.contra_account
+    end
+
+    should 'have an amount' do
+      assert_equal -77.35, @transaction.amount
+    end
+
+    should 'have a contra_account_name' do
+      assert_equal 'Uitgeverij De Druif', @transaction.contra_account_name
+    end
+
+    should 'have a description' do
+      assert_equal 'Factuurnummer 234578', @transaction.description
+    end
+  end
+
+end

data/test/test_mt940_triodos.rb

@@ -0,0 +1,29 @@
+require 'helper'
+
+class TestMt940Triodos < Test::Unit::TestCase
+
+  def setup
+    file_name = File.dirname(__FILE__) + '/fixtures/triodos.txt'
+    @transactions = MT940::Triodos.transactions(file_name)
+    @transaction = @transactions.first
+  end
+  
+  should 'have the correct number of transactions' do
+    assert_equal 2, @transactions.size
+  end
+
+  context 'Transaction' do
+    should 'have a bank_account' do
+      assert_equal '0390123456', @transaction.bank_account
+    end
+
+    should 'have an amount' do
+      assert_equal -15.7, @transaction.amount
+    end
+
+    should 'have a description' do
+      assert_equal '0000000000000ALGEMENE TUSSENREKENING KOSTEN VAN 01-10-2010 TOT EN MET 31-12-20100390123456', @transaction.description
+    end
+  end
+
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification 
+name: mt940
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- dovadi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-23 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  prerelease: false
+  type: :development
+  name: shoulda
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  prerelease: false
+  type: :development
+  name: bundler
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 6
+        - 2
+        version: 1.6.2
+  prerelease: false
+  type: :development
+  name: jeweler
+  version_requirements: *id003
+description: A basic MT940 parser with implementations for Dutch banks.
+email: frank.oxener@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.md
+files: 
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- lib/mt940.rb
+- lib/mt940/banks/abnamro.rb
+- lib/mt940/banks/ing.rb
+- lib/mt940/banks/rabobank.rb
+- lib/mt940/banks/triodos.rb
+- lib/mt940/base.rb
+- lib/mt940/transaction.rb
+- test/fixtures/abnamro.txt
+- test/fixtures/ing.txt
+- test/fixtures/rabobank.txt
+- test/fixtures/triodos.txt
+- test/helper.rb
+- test/test_mt940.rb
+- test/test_mt940_abnamro.rb
+- test/test_mt940_ing.rb
+- test/test_mt940_rabobank.rb
+- test/test_mt940_triodos.rb
+has_rdoc: true
+homepage: http://github.com/dovadi/mt940
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: MT940 parser
+test_files: []
+