bank-contact 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 35f525516d204bf07672f0e9eb8272fba286e433
+  data.tar.gz: c93cde9f372cb0d01562c612db3c23c56a81c26a
+SHA512:
+  metadata.gz: cb32dba59a577154600af67926b5e93cd461c9b9158bf609b56679a4bcbdf128f3740d5a4d36480480d022b852fd23ee531639c56af7f89d08ea20513e0098b0
+  data.tar.gz: da4bad5cc7555c3d9fa4f73a2ab355c1220ba198f52ae10ea07b7dfea71dbf5fec03d14a06291597dd9468cf26b529be42774c24ee42e8abcecfdf8dc873b4b6

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm: 
+  - 2.1.0
+  - 2.0.0
+  - 1.9.3

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Kevin
+
+MIT License
+
+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,94 @@
+# Bank
+
+IBAN & BIC information, validation and formatting. Ships with ActiveModel validators.
+
+[![GitHub version](https://badge.fury.io/gh/max-power%2Fbank.png)](http://badge.fury.io/gh/max-power%2Fbank)
+[![Build Status](https://travis-ci.org/max-power/bank.png?branch=master)](https://travis-ci.org/max-power/bank)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'bank-contact'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install bank-contact
+
+## Usage
+
+### Bank:::IBAN
+
+    require 'bank/iban'
+
+    iban = IBAN.new("DE89 3704 0044 0532 0130 00")
+
+    iban.country_code    # "DE"
+    iban.check_digits    # "89"
+    iban.bban            # "370400440532013000"
+    iban.account_number  # "0532013000"
+    iban.bank_identifier # "37040044"
+
+    iban.valid?          # true
+
+    iban.to_s            # "DE89370400440532013000"
+    iban.to_s(true)      # "DE89 3704 0044 0532 0130 00"
+
+    iban.to_i            # 370400440532013000131489
+    
+    # or 
+    
+    IBAN.valid? "DE89 3704 0044 0532 0130 00" # true
+
+or as ActiveModel Validator (make sure you have 'active_model' in your Gemfile)
+
+    class Company
+      include ActiveModel::Model
+      attr_accessor :iban
+      validates :iban, iban: true
+    end
+    
+### Bank::BIC 
+    
+    require 'bank/bic'
+    
+    bic  = Bank::BIC.new('BYLADEM1203')
+    bic.bank_code
+    bic.country_code
+    bic.location_code
+    bic.branch_code    
+    bic.to_s
+    bic.valid?
+    
+or as ActiveModel Validator (make sure you have 'active_model' in your Gemfile)
+
+    class Company
+      include ActiveModel::Model
+      attr_accessor :bic
+      validates :bic, bic: true
+    end
+    
+### Bank::Contact
+     
+    require 'bank/contact' # this requires 'iban' and 'bic'
+    
+    # paramters: IBAN, BIC
+    contact = Bank::Contact.new("DE89 3704 0044 0532 0130 00", "BYLADEM1203")
+    contact.iban
+    contact.bic
+    contact.to_h
+    contact.to_a
+    contact.valid?
+    
+
+## Contributing
+
+1. Fork it ( http://github.com/max-power/bank/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,19 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+  t.libs << 'spec'
+end
+
+desc "Run tests"
+task :default => :test
+
+desc "Run console"
+task :console do
+  require 'irb'
+  require 'irb/completion'
+  require 'bank/contact'
+  ARGV.clear
+  IRB.start
+end

data/bank.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bank/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "bank-contact"
+  spec.version       = Bank::VERSION
+  spec.authors       = ["Kevin"]
+  spec.email         = ["kevin.melchert@gmail.com"]
+  spec.summary       = %q{IBAN + SWIFT/BIC}
+  spec.description   = %q{IBAN + SWIFT/BIC: Information, Validation and Formatting.}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest", "~> 4.2"
+  spec.add_development_dependency 'activemodel', "~> 4.0.0"
+end

data/data/iban.yml

@@ -0,0 +1,406 @@
+# http://en.wikipedia.org/wiki/International_Bank_Account_Number#IBAN_formats_by_country
+# http://www.swift.com/dsp/resources/documents/IBAN_Registry.pdf
+
+al: # Albania
+  length: 28
+#  regexp: '\d{8}[A-Z0-9]{16}'
+  regexp: '(?<bank_identifier>\d{8})(?<account_number>[A-Z0-9]{16})'
+
+ad: # Andorra
+  length: 24
+#  regexp: '\d{8}[A-Z0-9]{12}'
+  regexp: '(?<bank_identifier>\d{4})(?<branch_identifier>\d{4})(?<account_number>[A-Z0-9]{12})'
+
+at: # Austria
+  length: 20
+#  regexp: '\d{16}'
+  regexp: '(?<bank_identifier>\d{5})(?<account_number>\d{11})'
+
+az: # Azerbaijan
+  length: 28
+#  regexp: '[A-Z0-9]{4}\d{20}'
+  regexp: '(?<bank_identifier>[A-Z0-9]{4})(?<account_number>\d{20})'
+
+bh: # Bahrain
+  length: 22
+#  regexp: '[A-Z]{4}[A-Z0-9]{14}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<account_number>[A-Z0-9]{14})'
+  
+be: # Belgium
+  length: 16
+#  regexp: '\d{12}'
+  regexp: '(?<bank_identifier>\d{3})(?<account_number>\d{7})(?<national_check_digits>\d{2})'
+  
+ba: # Bosnia and Herzegovina
+  length: 20
+#  regexp: '\d{16}'
+  regexp: '(?<bank_identifier>\d{3})(?<branch_identifier>\d{3})(?<account_number>\d{8})(?<national_check_digits>\d{2})'
+  
+br: # Brazil
+  length: 29
+#  regexp: '\d{23}[A-Z][A-Z0-9]'
+  regexp: '(?<bank_identifier>\d{8})(?<branch_identifier>\d{5})(?<account_number>\d{10})(?<account_type>[A-Z])(?<account_owner>[A-Z0-9])'
+  
+bg: # Bulgaria
+  length: 22
+#  regexp: '[A-Z]{4}\d{6}[A-Z0-9]{8}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<branch_identifier>\d{4})(?<account_type>\d{2})(?<account_number>[A-Z0-9]{8})'
+
+cr: # Costa Rica
+  length: 21
+#  regexp: '\d{17}'
+  regexp: '(?<bank_identifier>\d{3})(?<account_number>\d{14})'
+
+hr: # Croatia
+  length: 21
+#  regexp: '\d{17}'
+  regexp: '(?<bank_identifier>\d{7})(?<account_number>\d{10})'
+  
+cy: # Cyprus
+  length: 28
+#  regexp: '\d{8}[A-Z0-9]{16}'
+  regexp: '(?<bank_identifier>\d{3})(?<branch_identifier>\d{5})(?<account_number>[A-Z0-9]{16})'
+
+cz: # Czech Republic
+  length: 24
+#  regexp: '\d{20}'
+  regexp: '(?<bank_identifier>\d{4})(?<account_number>\d{6}\d{10})'
+  
+de: # Germany
+  length: 22
+#  regexp: '\d{18}'
+  regexp: '(?<bank_identifier>\d{8})(?<account_number>\d{10})'
+  
+dk: # Denmark
+  length: 18
+#  regexp: '\d{14}'
+  regexp: '(?<bank_identifier>\d{4})(?<account_number>\d{9})(?<national_check_digits>\d{1})'
+
+gl: # Greenland (same as Denmark)
+  length: 18
+#  regexp: '\d{14}'
+  regexp: '(?<bank_identifier>\d{4})(?<account_number>\d{9})(?<national_check_digits>\d{1})'
+
+fo: # Faroe Islands (same as Denmark)
+  length: 18
+#  regexp: '\d{14}'
+  regexp: '(?<bank_identifier>\d{4})(?<account_number>\d{9})(?<national_check_digits>\d{1})'
+
+do: # Dominican Republic
+  length: 28
+#  regexp: '[A-Z]{4}\d{20}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<account_number>\d{20})'
+
+ee: # Estonia
+  length: 20
+#  regexp: '\d{16}'
+  regexp: '(?<bank_identifier>\d{2})(?<branch_identifier>\d{2})(?<account_number>\d{11})(?<national_check_digits>\d{1})'
+
+fi: # Finland
+  length: 18
+#  regexp: '\d{14}'
+  regexp: '(?<bank_identifier>\d{6})(?<account_number>\d{7})(?<national_check_digits>\d{1})'
+
+fr: # France
+  length: 27
+#  regexp: '\d{10}[A-Z0-9]{11}\d{2}'
+  regexp: '(?<bank_identifier>\d{5})(?<branch_identifier>\d{5})(?<account_number>[A-Z0-9]{11})(?<national_check_digits>\d{2})'
+
+ge: # Georgia
+  length: 22
+#  regexp: '[A-Z]{2}\d{16}'
+  regexp: '(?<bank_identifier>[A-Z]{2})(?<account_number>\d{16})'
+
+gi: # Gibraltar
+  length: 23
+#  regexp: '[A-Z]{4}[A-Z0-9]{15}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<account_number>[A-Z0-9]{15})'
+
+gr: # Greece
+  length: 27
+#  regexp: '\d{7}[A-Z0-9]{16}'
+  regexp: '(?<bank_identifier>\d{4})(?<branch_identifier>\d{3})(?<account_number>[A-Z0-9]{16})'
+
+gt: # Guatemala
+  length: 28
+#  regexp: '[A-Z0-9]{4}[A-Z0-9]{20}'
+  regexp: '(?<bank_identifier>[A-Z0-9]{4})(?<account_number>[A-Z0-9]{20})'
+
+hu: # Hungary
+  length: 28
+#  regexp: '\d{24}'
+  regexp: '(?<bank_identifier>\d{3})(?<branch_identifier>\d{4})(?<account_number>\d{1}\d{15})(?<national_check_digits>\d{1})'
+  
+is: # Iceland
+  length: 26
+#  regexp: '\d{22}'
+  regexp: '(?<bank_identifier>\d{4})(?<branch_identifier>\d{2})(?<account_number>\d{6}\d{10})'
+
+ie: # Ireland
+  length: 22
+#  regexp: '[A-Z0-9]{4}\d{14}'
+  regexp: '(?<bank_identifier>[A-Z0-9]{4})(?<branch_identifier>\d{6})(?<account_number>\d{8})'
+
+il: # Israel
+  length: 23
+#  regexp: '\d{19}'
+  regexp: '(?<bank_identifier>\d{3})(?<branch_identifier>\d{3})(?<account_number>\d{13})'
+
+it: # Italy
+  length: 27
+#  regexp: '[A-Z]\d{10}[A-Z0-9]{12}'
+  regexp: '(?<national_check_digits>[A-Z])(?<bank_identifier>\d{5})(?<branch_identifier>\d{5})(?<account_number>[A-Z0-9]{12})'
+
+kz: # Kazakhstan
+  length: 20
+#  regexp: '\d{3}[A-Z0-9]{13}'
+  regexp: '(?<bank_identifier>\d{3})(?<account_number>[A-Z0-9]{13})'
+
+kw: # Kuwait
+  length: 30
+#  regexp: '[A-Z]{4}[A-Z0-9]{22}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<account_number>[A-Z0-9]{22})'
+
+lv: # Latvia
+  length: 21
+#  regexp: '[A-Z]{4}[A-Z0-9]{13}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<account_number>[A-Z0-9]{13})'
+
+lb: # Lebanon
+  length: 28
+#  regexp: '\d{4}[A-Z0-9]{20}'
+  regexp: '(?<bank_identifier>\d{4})(?<account_number>[A-Z0-9]{20})'
+
+li: # Liechtenstein
+  length: 21
+#  regexp: '\d{5}[A-Z0-9]{12}'
+  regexp: '(?<bank_identifier>\d{5})(?<account_number>[A-Z0-9]{12})'
+
+lt: # Lithuania
+  length: 20
+#  regexp: '\d{16}'
+  regexp: '(?<bank_identifier>\d{5})(?<account_number>\d{11})'
+
+lu: # Luxembourg
+  length: 20
+#  regexp: '\d{3}[A-Z0-9]{13}'
+  regexp: '(?<bank_identifier>\d{3})(?<account_number>[A-Z0-9]{13})'
+
+mk: # Macedonia
+  length: 19
+#  regexp: '\d{3}[A-Z0-9]{10}\d{2}'
+  regexp: '(?<branch_identifier>\d{3})(?<account_number>[A-Z0-9]{10})(?<national_check_digits>\d{2})'
+
+mt: # Malta
+  length: 31
+#  regexp: '[A-Z]{4}\d{5}[A-Z0-9]{18}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<branch_identifier>\d{5})(?<account_number>[A-Z0-9]{18})'
+
+mr: # Mauritania
+  length: 27
+#  regexp: '\d{23}'
+  regexp: '(?<bank_identifier>\d{5})(?<branch_identifier>\d{5})(?<account_number>\d{11})(?<national_check_digits>\d{2})'
+  
+mu: # Mauritius
+  length: 30
+#  regexp: '[A-Z]{4}\d{19}[A-Z]{3}'
+  regexp: '(?<bank_identifier>[A-Z]{4}\d{2})(?<branch_identifier>\d{2})(?<account_number>\d{12}\d{3}[A-Z]{3})'
+
+mc: # Monaco
+  length: 27
+#  regexp: '\d{10}[A-Z0-9]{11}\d{2}'
+  regexp: '(?<bank_identifier>\d{5})(?<branch_identifier>\d{5})(?<account_number>[A-Z0-9]{11})(?<national_check_digits>\d{2})'
+
+md: # Moldova
+  length: 24
+#  regexp: '[A-Z0-9]{2}\d{18}'
+  regexp: '(?<bank_identifier>[A-Z0-9]{2})(?<account_number>\d{18})'
+
+me: # Montenegro
+  length: 22
+#  regexp: '\d{18}'
+  regexp: '(?<bank_identifier>\d{3})(?<account_number>(\d{13})(\d{2}))'
+  
+nl: # Netherlands
+  length: 18
+#  regexp: '[A-Z]{4}\d{10}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<account_number>\d{10})'
+  
+'no': # Norway
+  length: 15
+#  regexp: '\d{11}'
+  regexp: '(?<bank_identifier>\d{4})(?<account_number>(\d{6})(\d{1}))'
+  
+pk: # Pakistan
+  length: 24
+#  regexp: '[A-Z0-9]{4}\d{16}'
+  regexp: '(?<bank_identifier>[A-Z0-9]{4})(?<account_number>\d{16})'
+  
+ps: # Palestine
+  length: 29
+#  regexp: '[A-Z0-9]{4}\d{21}'
+  regexp: '(?<bank_identifier>[A-Z0-9]{4})(?<account_number>\d{21})'
+  
+pl: # Poland
+  length: 28
+#  regexp: '\d{24}'
+  regexp: '(?<bank_identifier>\d{8})(?<account_number>\d{16})'
+  
+pt: # Portugal
+  length: 25
+#  regexp: '\d{21}'
+  regexp: '(?<bank_identifier>\d{4})(?<branch_identifier>\d{4})(?<account_number>\d{11})(?<national_check_digits>\d{2})'
+  
+ro: # Romania
+  length: 24
+#  regexp: '[A-Z]{4}[A-Z0-9]{16}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<account_number>[A-Z0-9]{16})'
+
+sm: # San Marino
+  length: 27
+#  regexp: '[A-Z]\d{10}[A-Z0-9]{12}'
+  regexp: '(?<national_check_digits>[A-Z])(?<bank_identifier>\d{5})(?<branch_identifier>\d{5})(?<account_number>[A-Z0-9]{12})'
+
+sa: # Saudi Arabia
+  length: 24
+#  regexp: '\d{2}[A-Z0-9]{18}'
+  regexp: '(?<bank_identifier>\d{2})(?<account_number>[A-Z0-9]{18})'
+
+rs: # Serbia
+  length: 22
+#  regexp: '\d{18}'
+  regexp: '(?<bank_identifier>\d{3})(?<account_number>\d{13})(?<national_check_digits>\d{2})'
+  
+sk: # Slovak Republic
+  length: 24
+#  regexp: '\d{20}'
+  regexp: '(?<bank_identifier>\d{4})(?<branch_identifier>\d{6})(?<account_number>\d{10})'
+
+si: # Slovenia
+  length: 19
+#  regexp: '\d{15}'
+  regexp: '(?<bank_identifier>\d{5})(?<account_number>\d{8})(?<national_check_digits>\d{2})'
+  
+es: # Spain
+  length: 24
+#  regexp: '\d{20}'
+  regexp: '(?<bank_identifier>\d{4})(?<branch_identifier>\d{4})(?<national_check_digits>\d{1}\d{1})(?<account_number>\d{10})'
+  
+se: # Sweden
+  length: 24
+#  regexp: '\d{20}'
+  regexp: '(?<bank_identifier>\d{3})(?<account_number>\d{16}\d{1})'
+
+ch: # Switzerland
+  length: 21
+#  regexp: '\d{5}[A-Z0-9]{12}'
+  regexp: '(?<bank_identifier>\d{5})(?<account_number>[A-Z0-9]{12})'
+
+tn: # Tunisia
+  length: 24
+#  regexp: '\d{20}'
+  regexp: '(?<bank_identifier>\d{2})(?<branch_identifier>\d{3})(?<account_number>\d{13}\d{2})'
+
+tr: # Turkey
+  length: 26
+#  regexp: '\d{5}[A-Z0-9]{17}'
+  regexp: '(?<bank_identifier>\d{5})([A-Z0-9])(?<account_number>[A-Z0-9]{16})'
+  
+ae: # United Arab Emirates
+  length: 23
+#  regexp: '\d{3}\d{16}'
+  regexp: '(?<bank_identifier>\d{3})(?<account_number>\d{16})'
+  
+gb: # United Kingdom
+  length: 22
+#  regexp: '[A-Z]{4}\d{14}'
+  regexp: '(?<bank_identifier>[A-Z]{4})(?<branch_identifier>\d{6})(?<account_number>\d{8})'
+  
+vg: # Virgin Islands, British
+  length: 24
+#  regexp: '[A-Z0-9]{4}\d{16}'
+  regexp: '(?<bank_identifier>[A-Z0-9]{4})(?<account_number>\d{16})'
+
+# In addition to the above list, Nordea has catalogued IBANs for countries listed below.[32]
+
+ao: # Angola
+  length: 25
+#  regexp: '\d{21}'
+  regexp: '\d{21}'
+
+bj: # Benin
+  length: 28
+#  regexp: '[A-Z]\d{23}'
+  regexp: '[A-Z]\d{23}'
+
+bf: # Burkina Faso
+  length: 27
+#  regexp: '\d{23}'
+  regexp: '\d{23}'
+
+bi: # Burundi
+  length: 16
+#  regexp: '\d{12}'
+  regexp: '\d{12}'
+
+cm: # Cameroon
+  length: 27
+#  regexp: '\d{23}'
+  regexp: '\d{23}'
+
+cv: # Cape Verde
+  length: 25
+#  regexp: '\d{21}'
+  regexp: '\d{21}'
+
+ir: # Iran
+  length: 26
+#  regexp: '\d{22}'
+  regexp: '\d{22}'
+
+ci: # Ivory Coast
+  length: 28
+#  regexp: '[A-Z]\d{23}'
+  regexp: '[A-Z]\d{23}'
+
+mg: # Madagascar
+  length: 27
+#  regexp: '\d{23}'
+  regexp: '\d{23}'
+
+ml: # Mali
+  length: 28
+#  regexp: '[A-Z]\d{23}'
+  regexp: '[A-Z]\d{23}'
+
+mz: # Mozambique
+  length: 25
+#  regexp: '\d{21}'
+  regexp: '\d{21}'
+
+sn: # Senegal
+  length: 28
+#  regexp: '[A-Z]\d{23}'
+  regexp: '[A-Z]\d{23}'
+
+# not quite sure about these:
+
+# cg: # Republic Congo
+#   length: 27
+# #  regexp: ''
+#
+# dz: # Algeria
+#   length: 24
+# #  regexp: ''
+#
+# eg: # Egypt
+#   length: 27
+# #  regexp: ''
+#
+# ga: # Gabun
+#   length: 27
+# #  regexp: ''
+#
+# ua: # Ukraine
+#  length: 29
+##  regexp: ''

data/lib/bank.rb

@@ -0,0 +1,9 @@
+require "bank/version"
+require "pathname"
+require "yaml"
+
+module Bank
+  def self.load_specifications(name)
+    YAML.load_file Pathname.new(__FILE__).dirname.parent + "data" + "#{name}.yml"
+  end
+end

data/lib/bank/bban.rb

@@ -0,0 +1,40 @@
+require 'bank'
+
+module Bank
+  class BBAN # Basic Bank Account Number
+    def initialize(country_code, code)
+      @country_code, @code = country_code, code
+    end
+    
+    def to_s
+      @code
+    end
+    
+    def valid?
+      valid_length? && !data.nil?
+    end
+    
+    # the bban is the iban minus the first 4 characters (country_code, check_digits)
+    def valid_length?
+      specification && specification['length'] - 4  == @code.length
+    end
+    
+    [:account_number, :bank_identifier, :branch_identifier].each do |m|
+      define_method(m) { data && data[m] }
+    end
+    
+    private
+    
+    def data
+      @code.match(/^#{specification['regexp']}$/) if specification
+    end
+    
+    def specification
+      @specification ||= self.class.specifications[@country_code.downcase]
+    end
+    
+    def self.specifications
+      @@specs ||= Bank.load_specifications(:iban)
+    end
+  end
+end

data/lib/bank/bic.rb

@@ -0,0 +1,67 @@
+require "bank/validators/bic_validator" if defined? ActiveModel
+
+module Bank
+  class BIC
+    
+    def self.valid?(code)
+      new(code).valid?
+    end
+    
+    def initialize(code)
+      @code = code.to_s.strip.gsub(/\s+/, '').upcase
+    end
+    
+    def bank_code
+      @code[0..3]
+    end
+    
+    def country_code
+      @code[4..5]
+    end
+  
+    def location_code
+      @code[6..7]
+    end
+    
+    def branch_code
+      @code[8..10]
+    end
+    
+    def to_s(formatted=false)
+      formatted ? "#{bank_code} #{country_code} #{location_code} #{branch_code}".strip : @code
+    end
+    
+    def test?
+      location_code[1] == '0'
+    end
+    
+    def passive?
+      location_code[1] == '1'
+    end
+
+    def reverse_billing?
+      location_code[1] == '2'
+    end
+    
+    def valid?
+      valid_length? && valid_format? && valid_location_code? && valid_branch_code?
+    end
+    
+    def valid_length?
+      @code.length == 8 || @code.length == 11
+    end
+    
+    def valid_format?
+      @code =~ /^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$/
+    end
+    
+    def valid_location_code?
+      location_code[0] != '0' && location_code[0] != '1' && location_code[1] != 'O'
+    end
+
+    def valid_branch_code?
+      branch_code.nil? || !(branch_code[0] == 'X' && branch_code != 'XXX')
+    end
+
+  end
+end

data/lib/bank/contact.rb

@@ -0,0 +1,33 @@
+require 'bank/iban'
+require 'bank/bic'
+
+module Bank
+  class Contact
+    attr_reader :iban, :bic
+    
+    def initialize(iban, bic)
+      self.iban = iban
+      self.bic  = bic
+    end
+    
+    def iban=(value)
+      @iban = IBAN.new(value)
+    end
+    
+    def bic=(value)
+      @bic = BIC.new(value)
+    end
+    
+    def valid?
+      iban.valid? && bic.valid?
+    end
+    
+    def to_h
+      { iban: iban.to_s, bic: bic.to_s }
+    end
+    
+    def to_a
+      to_h.values
+    end
+  end
+end

data/lib/bank/iban.rb

@@ -0,0 +1,46 @@
+require "forwardable"
+require "bank/bban"
+require "bank/validators/iban_validator" if defined? ActiveModel
+
+module Bank
+  class IBAN # International Bank Account Number
+    extend Forwardable
+    def_delegators :bban, :account_number, :bank_identifier, :branch_identifier
+    
+    def self.valid?(code)
+      new(code).valid?
+    end
+    
+    def initialize(code)
+      @code = code.to_s.strip.gsub(/\s+/, '').upcase
+    end
+    
+    def country_code
+      @code[0..1]
+    end
+    
+    def check_digits
+      @code[2..3]
+    end
+    
+    def bban
+      @bban ||= BBAN.new(country_code, @code[4..-1])
+    end
+    
+    def valid?
+      valid_check_digits? && bban.valid?
+    end
+    
+    def valid_check_digits?
+      to_i % 97 == 1
+    end
+    
+    def to_i
+      "#{bban}#{country_code}#{check_digits}".each_char.map { |chr| chr.to_i(36) }.join.to_i
+    end
+    
+    def to_s(formatted=false)
+      formatted ? @code.gsub(/(.{4})/, '\1 ').strip : @code
+    end
+  end
+end

data/lib/bank/validators/bic_validator.rb

@@ -0,0 +1,7 @@
+require 'active_model/validator'
+
+class BicValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    record.errors.add(attribute, :invalid) unless BIC.valid?(value)
+  end
+end

data/lib/bank/validators/iban_validator.rb

@@ -0,0 +1,7 @@
+require 'active_model/validator'
+
+class IbanValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    record.errors.add(attribute, :invalid) unless Bank::IBAN.valid?(value)
+  end
+end

data/lib/bank/version.rb

@@ -0,0 +1,3 @@
+module Bank
+  VERSION = "0.0.2"
+end

data/spec/activemodel_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+
+class Company
+  include ActiveModel::Model
+
+  attr_accessor :iban, :name
+  validates :iban, iban: true
+
+  def persisted?
+    false
+  end
+end
+
+class Person
+  include ActiveModel::Model
+
+  attr_accessor :iban
+  validates :iban, iban: true, allow_nil: true
+
+  def persisted?
+    false
+  end
+end
+  
+
+describe IbanValidator do
+  before {
+    @model = Company.new
+  }
+  
+  it "should be valid" do
+    @model.iban = 'FR1420041010050500013M02606'
+    @model.valid?.must_equal true
+  end
+  
+  it "should not be valid" do
+    @model.iban = 'FR1420041010050500013'
+    @model.valid?.must_equal false
+    @model.errors[:iban].must_include "is invalid"
+  end
+  
+  it "should not validate with nil value" do
+    @model.iban.must_equal nil
+    @model.valid?.must_equal false
+  end
+  
+  it "should not use the validator with option allow_nil: true" do
+    @person = Person.new
+    @person.iban.must_equal nil
+    @person.valid?.must_equal true
+  end
+end

data/spec/contact_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+require 'bank/contact'
+
+describe Bank::Contact do
+  before do
+    @iban = Bank::IBAN.new('FR14 2004 1010 0505 0001 3M026 06')
+    @bic  = Bank::BIC.new('BYLADEM1203')
+    @contact = Bank::Contact.new(@iban, @bic)
+  end
+  
+  it "should validate" do
+    @contact.valid?.must_equal true
+  end
+  
+  it "should have the right types" do
+    @contact.iban.must_be_kind_of Bank::IBAN
+    @contact.bic.must_be_kind_of Bank::BIC
+  end
+  
+  it "should export to_h" do
+    @contact.to_h.must_equal({iban: "FR1420041010050500013M02606", bic: "BYLADEM1203"})
+  end
+  
+  it "should export to_a" do
+    @contact.to_a.must_equal(["FR1420041010050500013M02606", "BYLADEM1203"])
+  end
+
+end

data/spec/iban_spec.rb

@@ -0,0 +1,150 @@
+require 'spec_helper'
+
+
+describe Bank::IBAN do
+  before do
+    @iban = Bank::IBAN.new('FR14 2004 1010 0505 0001 3M026 06')
+  end
+  
+  it "should valid from class method" do
+    Bank::IBAN.valid?('FR14 2004 1010 0505 0001 3M026 06').must_equal true
+  end
+  
+  it "should load the validation rules" do
+    Bank.load_specifications(:iban).wont_be :empty?
+    Bank.load_specifications(:iban).must_be_kind_of Hash
+  end
+
+  it "should return the county code" do
+    @iban.country_code.must_equal "FR"
+  end
+ 
+  it "should return the check digits" do
+    @iban.check_digits.must_equal "14"
+  end
+ 
+  it "should return the BBAN" do
+    @iban.bban.must_be_kind_of Bank::BBAN 
+    @iban.bban.to_s.must_equal "20041010050500013M02606"
+  end
+ 
+  it "should convert to integer value" do
+    @iban.to_i.must_equal 200410100505000132202606152714
+  end
+ 
+  it "should convert to string" do
+    @iban.to_s.must_equal 'FR1420041010050500013M02606'
+  end
+  
+  it "should convert to formatted string" do
+    @iban.to_s(true).must_equal 'FR14 2004 1010 0505 0001 3M02 606'
+  end
+
+  it "should respond_to? account_number" do
+    @iban.respond_to?(:account_number).must_equal true
+  end
+
+  it "should return account_number" do
+    @iban.account_number.must_equal "0500013M026"
+  end
+  
+  it "should return bank_identifier" do
+    @iban.bank_identifier.must_equal "20041"
+  end
+  
+  it "should return branch_identifier" do
+    @iban.branch_identifier.must_equal "01005"
+  end
+  
+  [
+    "AL47212110090000000235698741",
+    "AD12 00012030200359100100",
+    "AT611904300234573201",
+    "BE68539007547034",
+    "BA391290079401028494",
+    "BG80BNBG96611020345678",
+    "HR1210010051863000160",
+    "CY17002001280000001200527600",
+    "CZ6508000000192000145399",
+    "DK5000400440116243",
+    "EE382200221020145685",
+    "FO1464600009692713",
+    "FI2112345600000785",
+    "FR1420041010050500013M02606",
+    "GE29NB0000000101904917",
+    "DE89370400440532013000",
+    "GI75NWBK000000007099453",
+    "GR1601101250000000012300695",
+    "GL8964710001000206",
+    "HU42117730161111101800000000",
+    "IS140159260076545510730339",
+    "IE29AIBK93115212345678",
+    "IT60X0542811101000000123456",
+    "LV80BANK0000435195001",
+    "LI21088100002324013AA",
+    "LT121000011101001000",
+    "LU280019400644750000",
+    "MK07300000000042425",
+    "MT84MALT011000012345MTLCAST001S",
+    "MD24AG000225100013104168",
+    "MC5813488000010051108001292",
+    "ME25505000012345678951",
+    "NL91ABNA0417164300",
+    "NO9386011117947",
+    "PL27114020040000300201355387",
+    "PT50000201231234567890154",
+    "RO49AAAA1B31007593840000",
+    "SM86U0322509800000000270100",
+    "RS35260005601001611379",
+    "SK3112000000198742637541",
+    "SI56191000000123438",
+    "ES9121000418450200051332",
+    "SE3550000000054910000003",
+    "CH9300762011623852957",
+    #"UA573543470006762462054925026",
+    "GB29NWBK60161331926819",
+    #"DZ4000400174401001050486",
+    "AO06000600000100037131174",
+    "AZ21NABZ00000000137010001944",
+    "BH29BMAG1299123456BH00",
+    "BJ11B00610100400271101192591",
+    "BR9700360305000010009795493P1",
+    "VG96VPVG0000012345678901",
+    "BF1030134020015400945000643",
+    "BI43201011067444",
+    "CM2110003001000500000605306",
+    "CV64000300004547069110176",
+    "FR7630007000110009970004942",
+    #"CG5230011000202151234567890",
+    "CR0515202001026284066",
+    "DO28BAGR00000001212453611324",
+    #"EG1100006001880800100014553",
+    #"GA2140002000055602673300064",
+    "GT82TRAJ01020000001210029690",
+    "IR580540105180021273113007",
+    "IL620108000000099999999",
+    "CI05A00060174100178530011852",
+    "KZ176010251000042993",
+    "KW74NBOK0000000000001000372151",
+    "LB30099900000001001925579115",
+    "MG4600005030010101914016056",
+    "ML03D00890170001002120000447",
+    "MR1300012000010000002037372",
+    "MU17BOMM0101101030300200000MUR",
+    "MZ59000100000011834194157",
+    "PK24SCBL0000001171495101",
+    "PS92PALS000000000400123456702",
+    "PT50000200000163099310355",
+    "SA0380000000608010167519",
+    "SN12K00100152000025690007542",
+    "TN5914207207100707129648",
+    "TR330006100519786457841326",
+    "AE260211000000230064016"
+  ].each do |code|
+    describe code do
+      it "should be valid" do
+        Bank::IBAN.new(code).valid?.must_equal true
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+# -*- encoding: utf-8 -*-
+require 'rubygems'
+require 'bundler/setup'
+
+require 'minitest/autorun'
+require 'minitest/spec'
+begin; require 'turn/autorun'; rescue LoadError; end
+
+require 'active_model'
+require 'bank/iban'

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: bank-contact
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Kevin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+description: 'IBAN + SWIFT/BIC: Information, Validation and Formatting.'
+email:
+- kevin.melchert@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bank.gemspec
+- data/iban.yml
+- lib/bank.rb
+- lib/bank/bban.rb
+- lib/bank/bic.rb
+- lib/bank/contact.rb
+- lib/bank/iban.rb
+- lib/bank/validators/bic_validator.rb
+- lib/bank/validators/iban_validator.rb
+- lib/bank/version.rb
+- spec/activemodel_spec.rb
+- spec/contact_spec.rb
+- spec/iban_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- MIT
+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.2.0
+signing_key: 
+specification_version: 4
+summary: IBAN + SWIFT/BIC
+test_files:
+- spec/activemodel_spec.rb
+- spec/contact_spec.rb
+- spec/iban_spec.rb
+- spec/spec_helper.rb