banktools-se 0.0.1

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 bank-tools-se.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,6 @@
+guard 'rspec', :version => 2, :cli => "--color" do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/banktools-se/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/README.markdown

@@ -0,0 +1,108 @@
+# Swedish bank tools
+
+Ruby gem to validate, normalize/prettify and to some extent interpret
+
+  * Swedish bank account numbers
+  * Swedish plusgiro numbers
+  * Swedish bankgiro numbers
+
+Inspired by [iulianu/iban-tools](https://github.com/iulianu/iban-tools). Please consider contributing gems for your country.
+
+
+## Installation
+
+With Bundler for e.g. Ruby on Rails, add this to your `Gemfile`:
+
+    gem 'banktools-se', :git => 'git://github.com/barsoom/banktools-se.git'
+
+and run
+
+    bundle
+
+to install it.
+
+
+## Usage
+
+    # Bankgiro
+
+    valid_account = BankTools::SE::Bankgiro.new(" 5402968 1 ")
+    valid_account.valid?  # => true
+    valid_account.errors  # => []
+    valid_account.normalize  # => "5402-9681"
+
+    bad_account = BankTools::SE::Bankgiro.new(" 1X ")
+    bad_account.valid?  # => false
+    bad_account.errors  # => [ :too_short, :invalid_characters, :bad_checksum ]
+    bad_account.normalize  # => " 1 "
+
+    # 90-konto
+    fundraising_account = BankTools::SE::Bankgiro.new("902-0033")
+    fundraising_account.fundraising?  # => true
+
+
+    # Plusgiro
+
+    valid_account = BankTools::SE::Plusgiro.new("2865434")
+    valid_account.valid?  # => true
+    valid_account.errors  # => []
+    valid_account.normalize  # => "28 65 53-4"
+
+    bad_account = BankTools::SE::Plusgiro.new(" 1X ")
+    bad_account.valid?  # => false
+    bad_account.errors  # => [ :too_short, :invalid_characters, :bad_checksum ]
+    bad_account.normalize  # => " 1 "
+
+    # 90-konto
+    fundraising_account = BankTools::SE::Plusgiro.new("90 20 03-3")
+    fundraising_account.fundraising?  # => true
+
+
+    # Bank account
+
+    valid_account = BankTools::SE::Account.new("1100-0000000")
+    valid_account.valid?  # => true
+    valid_account.errors  # => []
+    valid_account.bank  # => "Nordea"
+    valid_account.normalize  # => "11000000007"
+
+    bad_account = BankTools::SE::Account.new(" 0000-0000000X ")
+    bad_account.valid?  # => false
+    bad_account.errors  # => [ :invalid_characters, :unknown_clearing_number ]
+    bad_account.bank  # => nil
+    bad_account.normalize  # => " 0000-0000000X "
+
+
+## TODO
+
+Possible improvements to make:
+
+  * Handle [Swedbank zerofill](http://www.danskebank.se/sv-se/eBanking-content/text-pages/Pages/Bankliste2.aspx).
+  * Handle [Sparbanken zerofill](http://www.danskebank.se/sv-se/eBanking-content/text-pages/Pages/Bankliste2.aspx).
+  * Look into just what bank account numbers need Luhn validation of which part.
+
+
+## Credits and license
+
+By [Henrik Nyh](http://henrik.nyh.se/) for [Barsoom](http://barsoom.se) under the MIT license:
+
+>  Copyright (c) 2011 Barsoom AB
+>
+>  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/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/banktools-se.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "banktools-se/version"
+
+Gem::Specification.new do |s|
+  s.name        = "banktools-se"
+  s.version     = BankTools::SE::VERSION
+  s.authors     = ["Henrik Nyh"]
+  s.email       = ["henrik@barsoom.se"]
+  s.homepage    = ""
+  s.summary     = %q{Validate and normalize Swedish bank account numbers, plusgiro and bankgiro.}
+
+  s.rubyforge_project = "banktools-se"
+
+  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 "rspec"
+  s.add_development_dependency "guard"
+  s.add_development_dependency "guard-rspec"
+end

data/lib/banktools-se/account.rb

@@ -0,0 +1,161 @@
+# encoding: utf-8
+
+module BankTools
+  module SE
+    class Account
+
+      # http://sv.wikipedia.org/wiki/Lista_%C3%B6ver_clearingnummer_till_svenska_banker
+      # Max lengths from
+      #   http://www.danskebank.se/sv-se/eBanking-content/text-pages/Pages/Bankliste2.aspx
+      # Min lengths are educated guesses based on the above and
+      #   http://sv.wikipedia.org/wiki/Bankkonto
+      # When it's uncertain, let's error on the side of allowing too much.
+      # 1..99 means we have no idea.
+
+      DEFAULT_SERIAL_NUMBER_LENGTH = 7
+
+      CLEARING_NUMBER_MAP = {
+        1100..1199 => { :name => "Nordea" },
+        1200..1399 => { :name => "Danske Bank" },
+        1400..2099 => { :name => "Nordea" },
+        2300..2309 => { :name => "JP Nordiska", :serial_number_length => 1..99 },
+        2310..2310 => { :name => "Ålandsbanken" },
+        2311..2399 => { :name => "JP Nordiska", :serial_number_length => 1..99 },
+        2950..2950 => { :name => "Sambox", :serial_number_length => 1..99 },
+        3000..3299 => { :name => "Nordea" },
+        3300..3300 => { :name => "Nordea", :serial_number_length => 10, :luhn_for_serial => true },  # Personkonto.
+        3301..3399 => { :name => "Nordea" },
+        3400..3409 => { :name => "Länsförsäkringar Bank" },
+        3410..3781 => { :name => "Nordea" },
+        3782..3782 => { :name => "Nordea", :serial_number_length => 10, :luhn_for_serial => true },  # Personkonto.
+        3783..4999 => { :name => "Nordea" },
+        5000..5999 => { :name => "SEB" },
+        6000..6999 => { :name => "Handelsbanken", :serial_number_length => 9 },
+        7000..7120 => { :name => "Swedbank" },
+        7121..7122 => { :name => "Sparbanken i Enköping", :serial_number_length => 7..10 },  # 7? 10? Who knows.
+        7123..7999 => { :name => "Swedbank" },
+        8000..8999 => { :name => "Swedbank och fristående Sparbanker", :serial_number_length => 10, :checksum_for_clearing => true },
+        9020..9029 => { :name => "Länsförsäkringar Bank" },
+        9040..9049 => { :name => "Citibank" },
+        9050..9059 => { :name => "HSB Bank", :serial_number_length => 1..99 },
+        9060..9069 => { :name => "Länsförsäkringar Bank" },
+        9080..9080 => { :name => "Calyon Bank", :serial_number_length => 1..99 },
+        9090..9099 => { :name => "ABN AMRO", :serial_number_length => 1..99 },
+        9100..9100 => { :name => "Nordnet Bank" },
+        9120..9124 => { :name => "SEB" },
+        9130..9149 => { :name => "SEB" },
+        9150..9169 => { :name => "Skandiabanken" },
+        9170..9179 => { :name => "Ikano Bank" },
+        9180..9189 => { :name => "Danske Bank" },
+        9190..9199 => { :name => "Den Norske Bank" },
+        9200..9209 => { :name => "Stadshypotek Bank", :serial_number_length => 1..99 },
+        9230..9230 => { :name => "Bank2" },
+        9231..9239 => { :name => "SalusAnsvar Bank", :serial_number_length => 1..99 },
+        9260..9269 => { :name => "Gjensidige NOR Sparebank", :serial_number_length => 1..99 },
+        9270..9279 => { :name => "ICA Banken" },
+        9280..9289 => { :name => "Resurs Bank" },
+        9290..9299 => { :name => "Coop Bank", :serial_number_length => 1..99 },
+        9300..9349 => { :name => "Sparbanken Öresund", :serial_number_length => 10 },
+        9400..9400 => { :name => "Forex Bank" },
+        9460..9460 => { :name => "GE Money Bank" },
+        9469..9469 => { :name => "GE Money Bank" },
+        9500..9547 => { :name => "Plusgirot Bank", :serial_number_length => 10 },
+        9548..9548 => { :name => "Ekobanken", :serial_number_length => 1..99 },
+        9549..9549 => { :name => "JAK Medlemsbank", :serial_number_length => 1..99 },
+        9550..9550 => { :name => "Avanza Bank" },
+        9960..9969 => { :name => "Plusgirot Bank", :serial_number_length => 10 },
+      }
+
+      attr_reader :number
+
+      def initialize(number)
+        @number = number
+      end
+
+      def valid?
+        errors.empty?
+      end
+
+      def errors
+        errors = []
+
+        errors << :too_short if serial_number.length < min_length
+        errors << :too_long if serial_number.length > max_length
+        errors << :invalid_characters if number.to_s.match(/[^0-9 -]/)
+
+        if luhn_for_serial?
+          errors << :bad_checksum unless BankTools::SE::Utils.valid_luhn?(serial_number)
+        end
+
+        errors << :unknown_clearing_number unless bank
+
+        errors
+      end
+
+      def normalize
+        if valid?
+          [ clearing_number, serial_number ].join("-")
+        else
+          number
+        end
+      end
+
+      def bank
+        bank_data[:name]
+      end
+
+      def clearing_number
+        digits[0,4]
+      end
+
+      def serial_number
+        value = digits[4..-1] || ""
+        if checksum_for_clearing? && value.length == max_length
+          value[1..-1]
+        else
+          value
+        end
+      end
+
+      private
+
+      def bank_data
+        number = clearing_number.to_i
+        _, found_data = CLEARING_NUMBER_MAP.find do |interval, data|
+          interval.include?(number)
+        end
+        found_data || {}
+      end
+
+      def min_length
+        if bank_data
+          Array(bank_data[:serial_number_length] || DEFAULT_SERIAL_NUMBER_LENGTH).first
+        else
+          0
+        end
+      end
+
+      def max_length
+        if bank_data
+          Array(bank_data[:serial_number_length] || DEFAULT_SERIAL_NUMBER_LENGTH).last +
+            (checksum_for_clearing? ? 1 : 0)
+        else
+          1/0.0  # Infinity.
+        end
+      end
+
+      def luhn_for_serial?
+        bank_data[:luhn_for_serial]
+      end
+
+      def checksum_for_clearing?
+        bank_data[:checksum_for_clearing]
+      end
+
+      def digits
+        number.to_s.gsub(/\D/, '')
+      end
+
+    end
+  end
+end

data/lib/banktools-se/bankgiro.rb

@@ -0,0 +1,48 @@
+module BankTools
+  module SE
+    class Bankgiro
+
+      # http://sv.wikipedia.org/wiki/Bankgirot#Bankgironummer
+
+      attr_reader :number
+
+      def initialize(number)
+        @number = number
+      end
+
+      def valid?
+        errors.empty?
+      end
+
+      def errors
+        errors = []
+
+        errors << :too_short if digits.length < 7
+        errors << :too_long if digits.length > 8
+        errors << :invalid_characters if number.to_s.match(/[^0-9 -]/)
+        errors << :bad_checksum unless BankTools::SE::Utils.valid_luhn?(number)
+
+        errors
+      end
+
+      def normalize
+        if valid?
+          digits.split(/(\d{4})$/).join("-")
+        else
+          number
+        end
+      end
+
+      def fundraising?
+        valid? && digits.match(/^90[0-4]/)
+      end
+
+      private
+
+      def digits
+        number.to_s.gsub(/\D/, '')
+      end
+
+    end
+  end
+end

data/lib/banktools-se/plusgiro.rb

@@ -0,0 +1,53 @@
+module BankTools
+  module SE
+    class Plusgiro
+
+      # Could sadly not find anything more authoritative than
+      #   http://pellesoft.se/communicate/forum/view.aspx?msgid=267449&forumid=63&sum=0
+
+      attr_reader :number
+
+      def initialize(number)
+        @number = number
+      end
+
+      def valid?
+        errors.empty?
+      end
+
+      def errors
+        errors = []
+
+        errors << :too_short if digits.length < 2
+        errors << :too_long if digits.length > 8
+        errors << :invalid_characters if number.to_s.match(/[^0-9 -]/)
+        errors << :bad_checksum unless BankTools::SE::Utils.valid_luhn?(number)
+
+        errors
+      end
+
+      def normalize
+        if valid?
+          pre, pairs, post = digits.split(/(\d{2}*)(\d)$/)
+          pairs = pairs.split(/(\d\d)/).reject { |x| x.empty? }
+          [ pre, pairs.join(" "), "-", post ].join
+        else
+          number
+        end
+      end
+
+      # http://www.plusgirot.se/Om+PlusGirot/90-konton/508552.html
+      # http://www.insamlingskontroll.se/
+      def fundraising?
+        valid? && digits.match(/^90\d{5}$/)
+      end
+
+      private
+
+      def digits
+        number.to_s.gsub(/\D/, '')
+      end
+
+    end
+  end
+end

data/lib/banktools-se/utils.rb

@@ -0,0 +1,19 @@
+module BankTools
+  module SE
+    module Utils
+
+      # Based on http://blog.internautdesign.com/2007/4/18/ruby-luhn-check-aka-mod-10-formula
+      require "enumerator"
+      def self.valid_luhn?(number)
+        digits = number.to_s.scan(/\d/).reverse.map { |x| x.to_i }
+        digits = digits.enum_with_index.map { |d, i|
+          d *= 2 if i.odd?
+          d > 9 ? d - 9 : d
+        }
+        sum = digits.inject(0) { |m, x| m + x }
+        sum % 10 == 0
+      end
+
+    end
+  end
+end

data/lib/banktools-se/version.rb

@@ -0,0 +1,5 @@
+module BankTools
+  module SE
+    VERSION = "0.0.1"
+  end
+end

data/lib/banktools-se.rb

@@ -0,0 +1,5 @@
+require "banktools-se/version"
+require "banktools-se/utils"
+require "banktools-se/bankgiro"
+require "banktools-se/plusgiro"
+require "banktools-se/account"

data/spec/account_spec.rb

@@ -0,0 +1,176 @@
+# encoding: utf-8
+
+require "spec_helper"
+require "banktools-se"
+
+describe BankTools::SE::Account do
+
+  it "should initialize" do
+    BankTools::SE::Account.new("foo").should be_a(BankTools::SE::Account)
+  end
+
+  describe "#valid?" do
+
+    it "should be true with no errors" do
+      account = BankTools::SE::Account.new("foo")
+      account.stub!(:errors).and_return([])
+      account.should be_valid
+    end
+
+    it "should be false with errors" do
+      account = BankTools::SE::Account.new("foo")
+      account.stub!(:errors).and_return([:error])
+      account.should_not be_valid
+    end
+
+  end
+
+  describe "#errors" do
+    [
+      "1100-0000000",       # Nordea.
+      "1155-0000000",       # Nordea.
+      "1199-0000000",       # Nordea.
+      "1200-0000000",       # Danske Bank.
+      "1400-0000000",       # Nordea.
+      "2300-00",            # JP Nordiska.
+      "2310-0000000",       # Ålandsbanken.
+      "2311-00",            # JP Nordiska.
+      "2950-00",            # Sambox.
+      "3000-0000000",       # Nordea.
+      "3300-800928-6249",   # Nordea personkonto.
+      "3301-0000000",       # Nordea.
+      "3400-0000000",       # Länsförsäkringar Bank.
+      "3410-0000000",       # Nordea.
+      "3782-800928-6249",   # Nordea personkonto.
+      "3783-0000000",       # Nordea.
+      "5000-0000000",       # SEB.
+      "6000-000000000",     # Handelsbanken.
+      "7000-0000000",       # Swedbank.
+      "7121-0000000",       # Sparbanken i Enköping.
+      "7123-0000000",       # Swedbank.
+      "8000-0000000000",    # Swedbank/Sparbanker.
+      "8000-2-0000000000",  # Swedbank/Sparbanker with clearing number checksum.
+      "9020-0000000",       # Länsförsäkringar Bank.
+      "9040-0000000",       # Citibank.
+      "9050-00",            # HSB Bank.
+      "9060-0000000",       # Länsförsäkringar Bank.
+      "9080-00",            # Calyon Bank.
+      "9090-00",            # ABN AMBRO.
+      "9100-0000000",       # Nordnet Bank.
+      "9120-0000000",       # SEB.
+      "9130-0000000",       # SEB.
+      "9150-0000000",       # Skandiabanken.
+      "9170-0000000",       # Ikano Bank.
+      "9180-0000000",       # Danske Bank.
+      "9190-0000000",       # Den Norske Bank.
+      "9200-00",            # Stadshypotek Bank.
+      "9230-0000000",       # Bank2.
+      "9231-00",            # SalusAnsvar Bank.
+      "9260-00",            # Gjensidige NOR Sparebank.
+      "9270-0000000",       # ICA Banken.
+      "9280-0000000",       # Resurs Bank.
+      "9290-00",            # Coop Bank.
+      "9300-0000000000",    # Sparbanken Öresund.
+      "9400-0000000",       # Forex Bank.
+      "9460-0000000",       # GE Money Bank.
+      "9469-0000000",       # GE Money Bank.
+      "9500-0000000000",    # Plusgirot Bank.
+      "9548-00",            # Ekobanken.
+      "9549-00",            # JAK Medlemsbank.
+      "9550-0000000",       # Avanza Bank.
+      "9960-0000000000",    # Plusgirot Bank.
+
+    ].each do |number|
+      it "should be empty for a valid number like #{number}" do
+        BankTools::SE::Account.new(number).errors.should == []
+      end
+    end
+
+    it "should include :too_short for numbers shorter than the bank allows" do
+      BankTools::SE::Account.new("11007").errors.should include(:too_short)
+    end
+
+    it "should include :too_long for numbers longer than the bank allows" do
+      BankTools::SE::Account.new("1100000000007").errors.should include(:too_long)
+    end
+
+    it "should not include :too_long for Swedbank/Sparbanker numbers with clearing checksum" do
+      BankTools::SE::Account.new("8000-2-0000000000").errors.should_not include(:too_long)
+    end
+
+    it "should include :invalid_characters for numbers with other character than digits, spaces and dashes" do
+      BankTools::SE::Account.new("1 2-3X").errors.should include(:invalid_characters)
+      BankTools::SE::Account.new("1 2-3").errors.should_not include(:invalid_characters)
+    end
+
+    it "should include :bad_checksum for Nordea personkonto if the serial Luhn/mod 10 checksum is incorrect" do
+      BankTools::SE::Utils.valid_luhn?("800928-6249").should be_true
+      BankTools::SE::Utils.valid_luhn?("3300-800928-6249").should be_false
+      BankTools::SE::Account.new("3300-800928-6249").errors.should_not include(:bad_checksum)
+    end
+
+    it "should include :unknown_clearing_number if the clearing number is unknown" do
+      BankTools::SE::Account.new("10000000009").errors.should include(:unknown_clearing_number)
+      BankTools::SE::Account.new("11000000007").errors.should_not include(:unknown_clearing_number)
+    end
+
+  end
+
+  describe "#bank" do
+
+    it "should return the bank for the current clearing number" do
+      BankTools::SE::Account.new("11000000007").bank.should == "Nordea"
+      BankTools::SE::Account.new("11550000001").bank.should == "Nordea"
+      BankTools::SE::Account.new("11990000009").bank.should == "Nordea"
+      BankTools::SE::Account.new("12000000005").bank.should == "Danske Bank"
+    end
+
+    it "should return nil for unknown clearing numbers" do
+      BankTools::SE::Account.new("10000000009").bank.should be_nil
+    end
+
+  end
+
+  describe "#clearing_number" do
+
+    it "should be the first four digits" do
+      BankTools::SE::Account.new("12345678").clearing_number.should == "1234"
+    end
+
+  end
+
+  describe "#serial_number" do
+
+    it "should be the digits after the first four digits" do
+      BankTools::SE::Account.new("12345678").serial_number.should == "5678"
+    end
+
+    it "should be the empty string if there aren't enough numbers" do
+      BankTools::SE::Account.new("12").serial_number.should == ""
+    end
+
+    it "should exclude any Swedbank/Sparbanker clearing checksum" do
+      BankTools::SE::Account.new("8000-2-0000000000").serial_number.should == "0000000000"
+      BankTools::SE::Account.new("8000-0000000000").serial_number.should == "0000000000"
+    end
+
+  end
+
+  describe "#normalize" do
+
+    it "should normalize to clearing number dash serial number" do
+      account = BankTools::SE::Account.new("11000000007").normalize.should == "1100-0000007"
+    end
+
+    it "should remove any Swedbank/Sparbanker clearing checksum" do
+      BankTools::SE::Account.new("8000-2-0000000000").normalize.should == "8000-0000000000"
+      BankTools::SE::Account.new("8000-0000000000").normalize.should == "8000-0000000000"
+    end
+
+    it "should not attempt to normalize invalid numbers" do
+      account = BankTools::SE::Account.new(" 1-2-3 ").normalize.should == " 1-2-3 "
+    end
+
+  end
+
+end

data/spec/bankgiro_spec.rb

@@ -0,0 +1,95 @@
+require "spec_helper"
+require "banktools-se"
+
+describe BankTools::SE::Bankgiro do
+
+  it "should initialize" do
+    BankTools::SE::Bankgiro.new("foo").should be_a(BankTools::SE::Bankgiro)
+  end
+
+  describe "#valid?" do
+
+    it "should be true with no errors" do
+      account = BankTools::SE::Bankgiro.new("foo")
+      account.stub!(:errors).and_return([])
+      account.should be_valid
+    end
+
+    it "should be false with errors" do
+      account = BankTools::SE::Bankgiro.new("foo")
+      account.stub!(:errors).and_return([:error])
+      account.should_not be_valid
+    end
+
+  end
+
+  describe "#errors" do
+    # From http://www.carnegie.se/sv/Carnegie-fonder/Kopa-fonder/Bankgironummer/
+    [
+      "5402-9681",
+      "297-3675",
+      "640-5070",
+    ].each do |number|
+      it "should be empty for a valid number like #{number}" do
+        BankTools::SE::Bankgiro.new(number).errors.should be_empty
+      end
+    end
+
+    it "should include :too_short for numbers shorter than 7 digits" do
+      BankTools::SE::Bankgiro.new(nil).errors.should include(:too_short)
+      BankTools::SE::Bankgiro.new("").errors.should include(:too_short)
+      BankTools::SE::Bankgiro.new("54-0296").errors.should include(:too_short)
+      BankTools::SE::Bankgiro.new("54---------0296").errors.should include(:too_short)
+    end
+
+    it "should include :too_long for numbers longer than 8 digits" do
+      BankTools::SE::Bankgiro.new("5402-96810").errors.should include(:too_long)
+    end
+
+    it "should include :invalid_characters for numbers with other character than digits, spaces and dashes" do
+      BankTools::SE::Bankgiro.new("5402-9681X").errors.should include(:invalid_characters)
+      BankTools::SE::Bankgiro.new(" 5 4 0 2 - 9 6 8 1 ").errors.should_not include(:invalid_characters)
+    end
+
+    it "should include :bad_checksum if the Luhn/mod 10 checksum is incorrect" do
+      BankTools::SE::Bankgiro.new("5402-9682").errors.should include(:bad_checksum)
+    end
+
+  end
+
+  describe "#normalize" do
+
+    it "should normalize 7-digit numbers to NNN-NNNN" do
+      account = BankTools::SE::Bankgiro.new(" 6-40 - 5070")
+      account.normalize.should == "640-5070"
+    end
+
+    it "should normalize 8-digit numbers to NNNN-NNNN" do
+      account = BankTools::SE::Bankgiro.new(" 5-4-0-2-9-6- 81-  ")
+      account.normalize.should == "5402-9681"
+    end
+
+    it "should not attempt to normalize invalid numbers" do
+      account = BankTools::SE::Bankgiro.new(" 1-2-3 ")
+      account.normalize.should == " 1-2-3 "
+    end
+
+  end
+
+  describe "#fundraising? (90-konto)" do
+
+    it "should be true for the number series 900-nnnn to 904-nnnn" do
+      BankTools::SE::Bankgiro.new("902-0033").should be_fundraising
+    end
+
+    it "should be false for invalid numbers in the right series" do
+      BankTools::SE::Bankgiro.new("902-0034").should_not be_fundraising
+    end
+
+    it "should be false for numbers outside the right series" do
+      BankTools::SE::Bankgiro.new("5402-9681").should_not be_fundraising
+    end
+
+  end
+
+end

data/spec/plusgiro_spec.rb

@@ -0,0 +1,100 @@
+require "spec_helper"
+require "banktools-se"
+
+describe BankTools::SE::Plusgiro do
+
+  it "should initialize" do
+    BankTools::SE::Plusgiro.new("foo").should be_a(BankTools::SE::Plusgiro)
+  end
+
+  describe "#valid?" do
+
+    it "should be true with no errors" do
+      account = BankTools::SE::Plusgiro.new("foo")
+      account.stub!(:errors).and_return([])
+      account.should be_valid
+    end
+
+    it "should be false with errors" do
+      account = BankTools::SE::Plusgiro.new("foo")
+      account.stub!(:errors).and_return([:error])
+      account.should_not be_valid
+    end
+
+  end
+
+  describe "#errors" do
+    [
+      "28 65 43-4",  # IKEA
+      "410 54 68-5",  # IKEA
+      "4-2",  # Sveriges riksbank
+    ].each do |number|
+      it "should be empty for a valid number like #{number}" do
+        BankTools::SE::Plusgiro.new(number).errors.should be_empty
+      end
+    end
+
+    it "should include :too_short for numbers shorter than 2 digits" do
+      BankTools::SE::Plusgiro.new(nil).errors.should include(:too_short)
+      BankTools::SE::Plusgiro.new("").errors.should include(:too_short)
+      BankTools::SE::Plusgiro.new("1").errors.should include(:too_short)
+      BankTools::SE::Plusgiro.new("1---------").errors.should include(:too_short)
+    end
+
+    it "should include :too_long for numbers longer than 8 digits" do
+      BankTools::SE::Plusgiro.new("410 54 68-51").errors.should include(:too_long)
+    end
+
+    it "should include :invalid_characters for numbers with other character than digits, spaces and dashes" do
+      BankTools::SE::Plusgiro.new("410 54 68-5X").errors.should include(:invalid_characters)
+      BankTools::SE::Plusgiro.new("4 1 0 5 4 6 8 - 5 ").errors.should_not include(:invalid_characters)
+    end
+
+    it "should include :bad_checksum if the Luhn/mod 10 checksum is incorrect" do
+      BankTools::SE::Plusgiro.new("410 54 68-6").errors.should include(:bad_checksum)
+    end
+
+  end
+
+  describe "#normalize" do
+
+    it "should normalize short numbers to the format N-N" do
+      account = BankTools::SE::Plusgiro.new(" 4 - 2")
+      account.normalize.should == "4-2"
+    end
+
+    it "should normalize odd-length numbers to the format NN NN NN-N" do
+      account = BankTools::SE::Plusgiro.new("2865434")
+      account.normalize.should == "28 65 43-4"
+    end
+
+    it "should normalize even-length numbers to the format NNN NN NN-N" do
+      account = BankTools::SE::Plusgiro.new("41054685")
+      account.normalize.should == "410 54 68-5"
+    end
+
+    it "should not attempt to normalize invalid numbers" do
+      account = BankTools::SE::Plusgiro.new(" 1-2-3 ")
+      account.normalize.should == " 1-2-3 "
+    end
+
+  end
+
+  describe "#fundraising? (90-konto)" do
+
+    it "should be true for the number series 90-nnnn" do
+      BankTools::SE::Plusgiro.new("90 20 03-3").should be_fundraising
+    end
+
+    it "should be false for invalid numbers in the right series" do
+      BankTools::SE::Plusgiro.new("90 20 03-4").should_not be_fundraising
+    end
+
+    it "should be false for numbers outside the right series" do
+      BankTools::SE::Plusgiro.new("4-2").should_not be_fundraising
+    end
+
+  end
+
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.filter_run :focus => true
+  config.run_all_when_everything_filtered = true
+end

data/spec/utils_spec.rb

@@ -0,0 +1,36 @@
+require "spec_helper"
+require "banktools-se/utils"
+
+describe BankTools::SE::Utils, "valid_luhn?" do
+
+  [
+    "00",
+    "18",
+    "26",
+    "34",
+    "42",
+    "59",
+    "67",
+    "75",
+    "83",
+    "91",
+    "109",
+    "117",
+    "5402-9681",
+  ].each do |number|
+    it "should allow a valid number like #{number}" do
+      BankTools::SE::Utils.valid_luhn?(number).should be_true
+    end
+  end
+
+  [
+    "01",
+    "118",
+    "5402-9682",
+  ].each do |number|
+    it "should disallow an invalid number like #{number}" do
+      BankTools::SE::Utils.valid_luhn?(number).should be_false
+    end
+  end
+
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification 
+name: banktools-se
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Henrik Nyh
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-10-12 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: guard
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: guard-rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: 
+email: 
+- henrik@barsoom.se
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Guardfile
+- README.markdown
+- Rakefile
+- banktools-se.gemspec
+- lib/banktools-se.rb
+- lib/banktools-se/account.rb
+- lib/banktools-se/bankgiro.rb
+- lib/banktools-se/plusgiro.rb
+- lib/banktools-se/utils.rb
+- lib/banktools-se/version.rb
+- spec/account_spec.rb
+- spec/bankgiro_spec.rb
+- spec/plusgiro_spec.rb
+- spec/spec_helper.rb
+- spec/utils_spec.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: banktools-se
+rubygems_version: 1.5.3
+signing_key: 
+specification_version: 3
+summary: Validate and normalize Swedish bank account numbers, plusgiro and bankgiro.
+test_files: 
+- spec/account_spec.rb
+- spec/bankgiro_spec.rb
+- spec/plusgiro_spec.rb
+- spec/spec_helper.rb
+- spec/utils_spec.rb