banks_registry 0.1.0 → 0.1.1

data/data/banks/ZW.yml

@@ -0,0 +1,402 @@
+---
+ZW:
+- name: Beverley Building Society
+  swift: BVBSZWH1XXX
+  swift8: BVBSZWH1
+  branch_name: Head Office
+  branch_address: Beverley Place Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: African Banking Corp.of Zimbabwe Ltd.
+  swift: FMBZZWHXXXX
+  swift8: FMBZZWHX
+  branch_name: Head Office
+  branch_address: Banc Abc Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Agricultural Bank Of Zimbabwe Ltd
+  swift: AGRZZWHAXXX
+  swift8: AGRZZWHA
+  branch_name: Head Office
+  branch_address: Hurudza House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Barclays Bank Of Zimbabwe
+  swift: BARCZWHXXXX
+  swift8: BARCZWHX
+  branch_name: Head Office
+  branch_address: Kurima House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Bard Discount House Limited
+  swift: BDHLZWH1XXX
+  swift8: BDHLZWH1
+  branch_name: Head Office
+  branch_address: Club House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Bard Stockbrokers
+  swift: BSTKZWH1XXX
+  swift8: BSTKZWH1
+  branch_name: Head Office
+  branch_address: Bard House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Central Africa Building Society
+  swift: CABSZWHAXXX
+  swift8: CABSZWHA
+  branch_name: Head Office
+  branch_address: Cabs Head Office Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Cfx Merchant Bank Limited
+  swift: CFXBZWH1XXX
+  swift8: CFXBZWH1
+  branch_name: Head Office
+  branch_address: Tendeseka Office Park Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Cfx Merchant Bank Limited
+  swift: CFXBZWHAXXX
+  swift8: CFXBZWHA
+  branch_name: Head Office
+  branch_address: Tendeseka Office Park Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Comesa Clearing House
+  swift: COCUZWHAXXX
+  swift8: COCUZWHA
+  branch_name: Head Office
+  branch_address: 4 Purbeck Close Highlands Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Commercial Bank Of Zimbabwe Limited
+  swift: COBZZWHAXXX
+  swift8: COBZZWHA
+  branch_name: Head Office
+  branch_address: Union House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Ecobank Zimbabwe Limited
+  swift: ECOCZWHXXXX
+  swift8: ECOCZWHX
+  branch_name: Head Office
+  branch_address: Sam Levys Office Park Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Edwards And Company
+  swift: EDCPZWH1XXX
+  swift8: EDCPZWH1
+  branch_name: Head Office
+  branch_address: Club Chambers Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Fbc Bank Ltd
+  swift: FBCPZWHAXXX
+  swift8: FBCPZWHA
+  branch_name: Head Office
+  branch_address: Fbc Centre Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Genesis Securities
+  swift: USPTZWH1XXX
+  swift8: USPTZWH1
+  branch_name: Head Office
+  branch_address: Corner House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Industrial Development Corporation Of Zimbabwe Limited
+  swift: IDCZZWH1XXX
+  swift8: IDCZZWH1
+  branch_name: Head Office
+  branch_address: 93 Parklane Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Infrastructure Development Bank Of Zimbabwe Ed
+  swift: ZDBLZWHAXXX
+  swift8: ZDBLZWHA
+  branch_name: Head Office
+  branch_address: Z.D.B. House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Intermarket Discount House
+  swift: INDHZWH1XXX
+  swift8: INDHZWH1
+  branch_name: Head Office
+  branch_address: Udc Centre Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Mast Stockbrokers (pvt) Ltd
+  swift: MSTPZWH1XXX
+  swift8: MSTPZWH1
+  branch_name: Head Office
+  branch_address: Ncr House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Mbca Bank Limited
+  swift: MBCAZWHXXXX
+  swift8: MBCAZWHX
+  branch_name: Head Office
+  branch_address: Old Mutual Centre Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Metropolitan Bank Of Zimbabwe Ltd
+  swift: MBOZZWHAXXX
+  swift8: MBOZZWHA
+  branch_name: Head Office
+  branch_address: Central House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Msasa Stockbrokers (pvt) Ltd
+  swift: MSSTZWH1XXX
+  swift8: MSSTZWH1
+  branch_name: Head Office
+  branch_address: Msasa House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Nmb Bank Limited
+  swift: NMBLZWHXBYO
+  swift8: NMBLZWHX
+  branch_name: Bulawayo Branch
+  branch_address: Bulawayo
+  branch_code: BYO
+  city: Bulawayo
+  country: Zimbabwe
+- name: Nmb Bank Limited
+  swift: NMBLZWHXXXX
+  swift8: NMBLZWHX
+  branch_name: Head Office
+  branch_address: Unity Court Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: P.t.a. Clearing House
+  swift: PTAHZWH1XXX
+  swift8: PTAHZWH1
+  branch_name: Head Office
+  branch_address: 101 Union Avenue Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: People's Own Savings Bank
+  swift: PWSBZWHXXXX
+  swift8: PWSBZWHX
+  branch_name: Head Office
+  branch_address: Causeway Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Premier Banking Corporation Ltd.
+  swift: PRDHZWH1XXX
+  swift8: PRDHZWH1
+  branch_name: Head Office
+  branch_address: Block a Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Renaissance Securities (private) Limited
+  swift: BSPVZWH1XXX
+  swift8: BSPVZWH1
+  branch_name: Head Office
+  branch_address: Social Security Centre Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Reserve Bank Of Zimbabwe
+  swift: REBZZWHQXXX
+  swift8: REBZZWHQ
+  branch_name: Head Office
+  branch_address: 80 Samora Machel Avenue Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Reserve Bank Of Zimbabwe
+  swift: REBZZWHXPCH
+  swift8: REBZZWHX
+  branch_name: Harare
+  branch_address: 80 Samora Machel Avenue Harare
+  branch_code: PCH
+  city: Harare
+  country: Zimbabwe
+- name: Reserve Bank Of Zimbabwe
+  swift: REBZZWHXXXX
+  swift8: REBZZWHX
+  branch_name: Head Office
+  branch_address: 76 Samora Machel Avenue Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Sagit Stockbrokers (private) Limited
+  swift: SAGSZWH1XXX
+  swift8: SAGSZWH1
+  branch_name: Head Office
+  branch_address: Southampton Life Centre Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Scotfin Limited
+  swift: SCLIZWH102B
+  swift8: SCLIZWH1
+  branch_name: Bulawayo
+  branch_address: Old Mutual Center Bulawayo
+  branch_code: 02B
+  city: Bulawayo
+  country: Zimbabwe
+- name: Scotfin Limited
+  swift: SCLIZWH102C
+  swift8: SCLIZWH1
+  branch_name: Chinhoyi
+  branch_address: Chinhoyi
+  branch_code: 02C
+  city: Chinhoyi
+  country: Zimbabwe
+- name: Scotfin Limited
+  swift: SCLIZWH102G
+  swift8: SCLIZWH1
+  branch_name: Gweru
+  branch_address: Gweru
+  branch_code: 02G
+  city: Gweru
+  country: Zimbabwe
+- name: Scotfin Limited
+  swift: SCLIZWH102M
+  swift8: SCLIZWH1
+  branch_name: Mutare
+  branch_address: Mutare
+  branch_code: 02M
+  city: Mutare
+  country: Zimbabwe
+- name: Scotfin Limited
+  swift: SCLIZWH1XXX
+  swift8: SCLIZWH1
+  branch_name: Head Office
+  branch_address: Zb House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Stanbic Bank Zimbabwe Limited
+  swift: SBICZWH102B
+  swift8: SBICZWH1
+  branch_name: Bulawayo
+  branch_address: Bulawayo
+  branch_code: 02B
+  city: Bulawayo
+  country: Zimbabwe
+- name: Stanbic Bank Zimbabwe Limited
+  swift: SBICZWH102G
+  swift8: SBICZWH1
+  branch_name: Gweru
+  branch_address: Gweru
+  branch_code: 02G
+  city: Gweru
+  country: Zimbabwe
+- name: Stanbic Bank Zimbabwe Limited
+  swift: SBICZWHXXXX
+  swift8: SBICZWHX
+  branch_name: Head Office
+  branch_address: Ottoman House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Standard Chartered Bank Zimbabwe Limited
+  swift: SCBLZWHXSSU
+  swift8: SCBLZWHX
+  branch_name: Securities Services Unit
+  branch_address: Harare
+  branch_code: SSU
+  city: Harare
+  country: Zimbabwe
+- name: Standard Chartered Bank Zimbabwe Limited
+  swift: SCBLZWHXXXX
+  swift8: SCBLZWHX
+  branch_name: Head Office
+  branch_address: 38 Speke Avenue Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Steward Bank Limited
+  swift: STBLZWHXXXX
+  swift8: STBLZWHX
+  branch_name: No branch name
+  branch_address: No branch address
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Tetrad Investment Bank Limited
+  swift: TTSLZWHXXXX
+  swift8: TTSLZWHX
+  branch_name: Head Office
+  branch_address: Arundel Office Park 263 Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: The Discount Company Of Zimbabwe Limited
+  swift: DCZWZWH1XXX
+  swift8: DCZWZWH1
+  branch_name: Head Office
+  branch_address: 70 Parklane Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: The Tetrad Group
+  swift: TEGRZWH1XXX
+  swift8: TEGRZWH1
+  branch_name: Head Office
+  branch_address: Pegasus House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Trust Corporate Securities (private) Limited
+  swift: TCSPZWH1XXX
+  swift8: TCSPZWH1
+  branch_name: Head Office
+  branch_address: Livingstone House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Zimbabwe Banking Corporation Ltd.
+  swift: ZBCOZWHXBYO
+  swift8: ZBCOZWHX
+  branch_name: Bulawayo
+  branch_address: Bulawayo
+  branch_code: BYO
+  city: Bulawayo
+  country: Zimbabwe
+- name: Zimbabwe Banking Corporation Ltd.
+  swift: ZBCOZWHXXXX
+  swift8: ZBCOZWHX
+  branch_name: Head Office
+  branch_address: Corner First Street and Speke Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe
+- name: Zimbabwe Stock Exchange
+  swift: XZIMZWH1XXX
+  swift8: XZIMZWH1
+  branch_name: Head Office
+  branch_address: Chiyedza House Harare
+  branch_code: XXX
+  city: Harare
+  country: Zimbabwe

data/data/rules/CH.yml

@@ -0,0 +1,4 @@
+---
+CH:
+  bban: 5!n12!c
+  iban: CH2!n5!n12!c

data/data/rules/DE.yml

@@ -0,0 +1,4 @@
+---
+DE:
+  bban: 8!n10!n
+  iban: DE2!n8!n10!n

data/lib/banks_registry/loaders/banks_loader.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'banks_registry/models/bank'
+
+module BanksRegistry
+  module Loaders
+    class BanksLoader
+      BANKS_FOLDER = 'data/banks'
+
+      def initialize
+        @cache = {}
+      end
+
+      def call(code)
+        return @cache[code] if @cache.key?(code)
+
+        @cache[code] =
+          YAML.load_file("#{BANKS_FOLDER}/#{code}.yml")[code].map do |bank|
+            Models::Bank.new(bank)
+          end
+      end
+    end
+  end
+end

data/lib/banks_registry/loaders/rules_loader.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'banks_registry/models/rule'
+
+module BanksRegistry
+  module Loaders
+    class RulesLoader
+      RULES_FOLDER = 'data/rules'
+
+      def initialize
+        @cache = {}
+      end
+
+      def call(code)
+        return @cache[code] if @cache.key?(code)
+
+        @cache[code] = Models::Rule.new(load_rule_yml(code))
+      end
+
+      private
+
+      def load_rule_yml(code)
+        YAML.load_file("#{RULES_FOLDER}/#{code}.yml")[code]
+      end
+    end
+  end
+end

data/lib/banks_registry/matchers/bic_matcher.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'banks_registry/loaders/banks_loader'
+
+module BanksRegistry
+  module Matchers
+    class BicMatcher
+      def call(bic)
+        banks_loader.call(country_from_bic(bic)).find do |bank|
+          bank.bic == bic
+        end
+      end
+
+      private
+
+      def country_from_bic(bic)
+        bic[4..5].upcase
+      end
+
+      def banks_loader
+        @banks_loader ||= ::BanksRegistry::Loaders::BanksLoader.new
+      end
+    end
+  end
+end

data/lib/banks_registry/matchers/iban_matcher.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'banks_registry/rule_converter'
+require 'banks_registry/loaders/rules_loader'
+
+module BanksRegistry
+  module Matchers
+    class IbanMatcher
+      LEADING_ZEROS_REGEX = /\A0+([^0])/.freeze
+      EXTRA_ZEROS_REGEX = /\A0+\z/.freeze
+      CLEAR_IBAN_REGEX = /\s/.freeze
+
+      def call(iban)
+        bank_code_from_iban = bank_code(iban)
+
+        return unless bank_code_from_iban
+
+        banks_loader.call(country_from_iban(iban)).find do |bank|
+          clear_code(bank.code) == clear_code(bank_code_from_iban)
+        end
+      end
+
+      private
+
+      def country_from_iban(iban)
+        iban[0..1].upcase
+      end
+
+      def clear_code(bank_code)
+        bank_code.gsub(LEADING_ZEROS_REGEX, '\1').gsub(EXTRA_ZEROS_REGEX, '0')
+      end
+
+      def clear_iban(iban)
+        iban.gsub(CLEAR_IBAN_REGEX, '')
+      end
+
+      def bank_code(iban)
+        bank_code_regexp(iban)&.match(clear_iban(iban))&.[](2)
+      end
+
+      def bank_code_regexp(iban)
+        rule_converter.call(iban_rule(country_from_iban(iban)))
+      end
+
+      def iban_rule(code)
+        rules_loader.call(code).iban
+      end
+
+      def rule_converter
+        @rule_converter ||= ::BanksRegistry::RuleConverter.new
+      end
+
+      def rules_loader
+        @rules_loader ||= ::BanksRegistry::Loaders::RulesLoader.new
+      end
+
+      def banks_loader
+        @banks_loader ||= ::BanksRegistry::Loaders::BanksLoader.new
+      end
+    end
+  end
+end

data/lib/banks_registry/models/bank.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module BanksRegistry
+  module Models
+    class Bank
+      def initialize(attributes = {})
+        @attributes = attributes
+      end
+
+      def name
+        attributes['name']
+      end
+
+      def code
+        attributes['code']
+      end
+
+      def bic
+        attributes['swift']
+      end
+
+      def bic8
+        attributes['swift8']
+      end
+
+      def branch_name
+        attributes['branch_name']
+      end
+
+      def branch_address
+        attributes['branch_address']
+      end
+
+      def branch_code
+        attributes['branch_code']
+      end
+
+      def city
+        attributes['city']
+      end
+
+      def country
+        attributes['country']
+      end
+
+      private
+
+      attr_reader :attributes
+    end
+  end
+end

data/lib/banks_registry/models/rule.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module BanksRegistry
+  module Models
+    class Rule
+      def initialize(attributes = {})
+        @attributes = attributes
+      end
+
+      def iban
+        attributes['iban']
+      end
+
+      def bban
+        attributes['bban']
+      end
+
+      private
+
+      attr_reader :attributes
+    end
+  end
+end

data/lib/banks_registry/rule_converter.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module BanksRegistry
+  class RuleConverter
+    CONVENTIONS = {
+      '(\d+)!n' => '(\d{\1})',
+      '(\d+)!c' => '([A-Za-z0-9]{\1})',
+      '(\d+)!e' => '(\s{\1})',
+      '(\d+)!a' => '([A-Z]{\1})',
+      '(\d+)n' => '(\d{1,\1})',
+      '(\d+)c' => '([A-Za-z0-9]{1,\1})',
+      '(\d+)e' => '(\s{1,\1})',
+      '(\d+)a' => '([A-Z]{1,\1})'
+    }.freeze
+
+    def call(rule)
+      Regexp.new("\\A#{prepare_for_regexp(rule)}\\z")
+    end
+
+    private
+
+    def prepare_for_regexp(rule)
+      CONVENTIONS.each.inject(rule) do |memo, (k, v)|
+        memo.gsub(Regexp.new(k), v)
+      end
+    end
+  end
+end

data/lib/banks_registry/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module BanksRegistry
+  VERSION = '0.1.1'
+end