RubyGems - SingaporeBankCodes - Versions diffs - 0.0.1 - Mend

SingaporeBankCodes 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (31) hide show

checksums.yaml +7 -0
data/.gitignore +14 -0
data/Gemfile +4 -0
data/LICENSE.txt +22 -0
data/README.md +36 -0
data/Rakefile +1 -0
data/SingaporeBankCodes.gemspec +25 -0
data/lib/SingaporeBankCodes/version.rb +3 -0
data/lib/SingaporeBankCodes.rb +41 -0
data/lib/banks/bank_account.rb +29 -0
data/lib/banks/citibank.rb +78 -0
data/lib/banks/dbs.rb +229 -0
data/lib/banks/hsbc.rb +55 -0
data/lib/banks/malayan_banking_berhad.rb +36 -0
data/lib/banks/ocbc.rb +199 -0
data/lib/banks/posb.rb +17 -0
data/lib/banks/posb_plus.rb +6 -0
data/lib/banks/standard_chartered.rb +74 -0
data/lib/banks/uob/uob.rb +19 -0
data/lib/banks/uob/uob_branch_codes.rb +343 -0
data/spec/bank_code_resolver_spec.rb +16 -0
data/spec/banks/citibank_spec.rb +12 -0
data/spec/banks/dbs_spec.rb +12 -0
data/spec/banks/hsbc_spec.rb +12 -0
data/spec/banks/malayan_banking_berhad_spec.rb +12 -0
data/spec/banks/ocbc_spec.rb +12 -0
data/spec/banks/posb_spec.rb +12 -0
data/spec/banks/standard_charted_spec.rb +12 -0
data/spec/banks/uob_spec.rb +18 -0
data/spec/spec_helper.rb +2 -0
metadata +139 -0

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e7bc7de3e9adcb4fdfd1e17654464da76bb449f9
+  data.tar.gz: a24cc6957d898de788b4a6ad132354f80d74ea43
+SHA512:
+  metadata.gz: d8a8a851d01e0c0cb07bb174f6e8e3b6c799ffe63a4ae5025250a9f26a796097f023f244a55ed08c84ef47a8db81bb2b1629fd5d90eb38db9147c9b148a9f2e5
+  data.tar.gz: 77fcfc7b8f87354adc515781c1b88466b04d0f603cc04f85a815fba843af7a89c391fdb82bae9f32ef3a396b9e298bbbf4908ce20c9a20a0c1ec80515f85b5e9

data/.gitignore ADDED Viewed

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile ADDED Viewed

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

data/LICENSE.txt ADDED Viewed

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Sherwyn Goh
+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 ADDED Viewed

@@ -0,0 +1,36 @@
+# SingaporeBankCodes
+This gem allows you to provide a bank name and account number, and will generate the branch code, bank code, and branch name. Singapore banks only. Currently serviced banks are:
+ ['OCBC', 'DBS', 'UOB', 'FEB', 'POSB', 'POSB Plus', 'HSBC', 'Standard Chartered', 'CITIBANK', 'Malayan Banking Berhad']
+## Installation
+Add this line to your application's Gemfile:
+```ruby
+gem 'SingaporeBankCodes'
+```
+And then execute:
+    $ bundle
+Or install it yourself as:
+    $ gem install SingaporeBankCodes
+## Usage
+```ruby
+resolver = BankCodeResolver.new(name: 'POSB', account: '123456789')
+resolver.get_result
+#returns a hash with keys bank_code, branch_code, branch_name and resolved account number, which can be different from supplied account number
+BankCodeResolver.bank_options #for possible bank names
+```
+## Contributing
+1. Fork it ( https://github.com/[my-github-username]/SingaporeBankCodes/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 a new Pull Request

data/Rakefile ADDED Viewed

	@@ -0,0 +1 @@
1	+ require "bundler/gem_tasks"

data/SingaporeBankCodes.gemspec ADDED Viewed

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'SingaporeBankCodes/version'
+Gem::Specification.new do |spec|
+  spec.name          = "SingaporeBankCodes"
+  spec.version       = SingaporeBankCodes::VERSION
+  spec.authors       = ["Sherwyn Goh"]
+  spec.email         = ["sherwyn.lj.goh@gmail.com"]
+  spec.summary       = %q{Account number to bank branch and bank code converter.}
+  spec.description   = %q{}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", '~> 3.0'
+  spec.add_development_dependency "pry", '~> 0.10.0'
+end

data/lib/SingaporeBankCodes/version.rb ADDED Viewed

@@ -0,0 +1,3 @@
+module SingaporeBankCodes
+  VERSION = "0.0.1"
+end

data/lib/SingaporeBankCodes.rb ADDED Viewed

@@ -0,0 +1,41 @@
+require_relative './banks/bank_account'
+require_relative './banks/citibank'
+require_relative './banks/dbs'
+require_relative './banks/hsbc'
+require_relative './banks/malayan_banking_berhad'
+require_relative './banks/ocbc'
+require_relative './banks/posb'
+require_relative './banks/posb_plus'
+require_relative './banks/uob/uob_branch_codes'
+require_relative './banks/uob/uob'
+require_relative './banks/standard_chartered'
+class BankCodeResolver
+  BANKS = ['OCBC', 'DBS', 'UOB', 'FEB', 'POSB', 'POSB Plus', 'HSBC', 'Standard Chartered', 'CITIBANK', 'Malayan Banking Berhad']
+  attr_accessor :name, :number
+  def initialize(args)
+    @name   = args.fetch(:name)
+    @number = args.fetch(:number)
+    raise ArgumentError.new "Name(#{@name}) needs to be one of #{BankCodeResolver::BANKS}" unless BankCodeResolver::BANKS.include?(@name)
+    @bank_account      = Object.const_get(@name.delete(' ').upcase).new(@number)
+    min_length = @bank_account.min_length
+    raise ArgumentError.new "Account number needs to be at least #{min_length}" unless (@number.to_s.length >= min_length)
+  end
+  def self.bank_options
+    BankCodeResolver::BANKS
+  end
+  def get_result
+    bank_code, branch_code, branch_name, resolved_number = @bank_account.resolve!
+    {
+      'bank_account' => bank_code,
+      'branch_code' => branch_code,
+      'branch_name' => branch_name,
+      'resolved_account_number' => resolved_number,
+    }
+  end
+end

data/lib/banks/bank_account.rb ADDED Viewed

@@ -0,0 +1,29 @@
+module SingaporeBankCode
+  class BankAccount
+    attr_accessor :number
+    def initialize number
+      @number = number
+    end
+    def branch_code
+      @number.to_s[0..2]
+    end
+    def branch_name
+      reference_hash_collection[branch_code] rescue 'Branch not registered'
+    end
+    def min_length
+      4
+    end
+    def resolved_number
+      @number
+    end
+    def resolve!
+      [bank_code, branch_code, branch_name, resolved_number]
+    end
+  end
+end

data/lib/banks/citibank.rb ADDED Viewed

@@ -0,0 +1,78 @@
+class CITIBANK < SingaporeBankCode::BankAccount
+  def bank_code
+    '7214'
+  end
+  def reference_hash_collection
+    {
+      '001' => 'Shenton Way - IB',
+      '002' => 'Orchard Road - IB',
+      '003' => 'Taman Jurong - IB',
+      '011' => 'Shenton Way - CSG',
+      '012' => 'Orchard Road - CSG',
+      '013' => 'Taman Jurong - CSG',
+      '015' => 'Esplanade',
+      '017' => 'Cuscaden Road',
+      '018' => 'Citibank Card Centre',
+      '019' => 'Great World City',
+      '020' => 'Parkway Parade',
+      '021' => 'Paragon',
+      '022' => 'Bishan',
+      '023' => 'Marina Bay Sands',
+      '024' => 'Vivo City',
+      '025' => 'Holland Village',
+      '026' => 'Ang Mo Kio',
+      '027' => 'Tampines Plaza',
+      '028' => 'SMRT',
+      '029' => 'Serangoon',
+      '031' => 'Private Bank',
+      '032' => 'Asia Square',
+      '033' => 'Woodlands',
+    }
+  end
+end

data/lib/banks/dbs.rb ADDED Viewed

@@ -0,0 +1,229 @@
+class DBS < SingaporeBankCode::BankAccount
+  def min_length
+    9
+  end
+  def bank_code
+    '7171'
+  end
+  def reference_hash_collection
+    {
+      '001' => 'DBS Shenton Way',
+      '002' => 'DBS Jurong Point',
+      '003' => 'Shenton Way (03)',
+      '004' => 'Parkway Parade (004)',
+      '005' => 'DBS Toa Payoh',
+      '006' => 'DBS Alexandra',
+      '007' => 'South Bridge (07)',
+      '008' => 'DBS Great World City',
+      '009' => 'Shenton Way (09)',
+      '010' => 'DBS South Bridge',
+      '011' => 'DBS Rochor',
+      '012' => 'DBS HarbourFront',
+      '014' => 'DBS Bukit Timah',
+      '015' => 'DBS Thomson',
+      '016' => 'Payment Ops (Remittance)',
+      '017' => 'DBS Bedok',
+      '018' => 'DBS AMK Hub',
+      '019' => 'DBS Woodlands',
+      '020' => 'DBS Clementi',
+      '021' => 'Staff',
+      '022' => 'DBS Battery Road',
+      '023' => 'DBS Hougang',
+      '024' => 'DBS Balestier',
+      '025' => 'DBS Towner Road',
+      '026' => 'Towner Road (26)',
+      '027' => 'DBS Parkway Parade',
+      '028' => 'Balestier (28)',
+      '029' => 'DBS Tampines Centre',
+      '030' => 'Jurong (30)',
+      '031' => 'Investment Banking',
+      '032' => 'Buona Vista (32)',
+      '033' => 'DBS Raffles City',
+      '036' => 'Finance & Tax',
+      '037' => 'Financial Institutions Group',
+      '038' => 'BOSC',
+      '047' => 'DBS Serangoon Garden',
+      '048' => 'DBS Raffles Place',
+      '049' => 'Clementi (49)',
+      '050' => 'Shenton Way (50)',
+      '051' => 'Shenton Way (51)',
+      '052' => 'DBS Eunos Station',
+      '053' => 'Bedok (53)',
+      '054' => 'DBS Westgate',
+      '055' => 'Shenton Way (55)',
+      '056' => 'Liat Towers (56)',
+      '057' => 'DBS RWS Sentosa',
+      '060' => 'Shenton Way (60)',
+      '061' => 'Marina Bay Sands',
+      '062' => 'DBS Scape',
+      '063' => 'DBS Holland Village',
+      '064' => 'DBS Gleneagles',
+      '065' => 'DBS Liat Towers',
+      '066' => 'DBS Choa Chu Kang',
+      '067' => 'Shenton Way (67)',
+      '069' => 'Liat Towers (69)',
+      '070' => 'DBS Bishan',
+      '072' => 'Raffles Place (72)',
+      '074' => 'DBS Suntec City',
+      '081' => 'Local Clearing',
+      '082' => 'Cashline',
+      '096' => 'Br Remittances Unit',
+      '098' => 'Liat Tower (098)',
+      '100' => 'DBS Plaza Singapura',
+      '104' => 'DBS Tai Seng',
+      '105' => 'DBS NUS Remix',
+      '106' => 'DBS Telepark',
+      '107' => 'Buona Vista Corp',
+      '109' => 'Treasures Ctr - Ngee Ann',
+      '110' => 'Treasures Centre - Siglap Treasures',
+      '113' => 'MBFC',
+      '118' => 'DBS China Square',
+      '120' => 'iBanking',
+      '121' => 'Bras Basah (121)',
+      '122' => 'POSB Hougang Central',
+      '123' => 'Bras Basah (123)',
+      '124' => "Bras Basah (124)",
+      '125' => "POSB ITE College Central",
+      '126' => "Bras Basah (126)",
+      '127' => "Bras Basah (127)",
+      '128' => "Bras Basah (128)",
+      '129' => "POSB Jurong Point",
+      '130' => "POSB Bukit Panjang",
+      '131' => "Bras Basah (131)",
+      '132' => "Bras Basah (132)",
+      '133' => "Bras Basah (133)",
+      '134' => "Bras Basah (134)",
+      '135' => "Bras Basah (135)",
+      '136' => "Bras Basah (136)",
+      '137' => "Bras Basah (137)",
+      '138' => "POSB Tampines West",
+      '139' => "Bras Basah (139)",
+      '140' => "Bras Basah (140)",
+      '141' => "POSB Newton",
+      '142' => "POSB Kaki Bukit",
+      '143' => "POSB Yishun West",
+      '144' => "Bras Basah (144)",
+      '145' => "KeyPoint",
+      '146' => "POSB Macpherson",
+      '147' => "Bras Basah (147)",
+      '148' => "Bras Basah (148)",
+      '149' => "POSB Jurong West",
+      '150' => "POSB Bukit Batok Central",
+      '151' => "Bras Basah (151)",
+      '152' => "Bras Basah (152)",
+      '153' => "POSB Punggol Plaza",
+      '154' => "Bras Basah (154)",
+      '155' => "Bras Basah (155)",
+      '156' => "Bras Basah (156)",
+      '157' => "POSB Siglap",
+      '158' => "Bras Basah (158)",
+      '159' => "Bras Basah (159)",
+      '160' => "Bras Basah (160)",
+      '161' => "Bras Basah (161)",
+      '162' => "POSB Taman Warna",
+      '163' => "POSB Yew Tee",
+      '164' => "POSB Tanjong Pagar",
+      '165' => "Bras Basah (165)",
+      '166' => "POSB Tiong Bahru",
+      '167' => "POSB Toa Payoh East",
+      '168' => "POSB Bukit Batok West",
+      '169' => "Bras Basah (169)",
+      '170' => "Bras Basah (170)",
+      '171' => "POSB Woodlands West",
+      '172' => "Bras Basah (172)",
+      '173' => "Bras Basah (173)",
+      '174' => "Bras Basah (174)",
+      '175' => "POSB Zhenghua",
+      '176' => "POSB Telok Blangah East",
+      '177' => "Bras Basah (177)",
+      '178' => "POSB Bras Basah",
+      '179' => "POSB Toa Payoh Central",
+      '180' => "Bras Basah (180)",
+      '181' => "POSB Marine Parade",
+      '182' => "Bras Basah (182)",
+      '183' => "Bras Basah (183)",
+      '184' => "Bras Basah (184)",
+      '185' => "Bras Basah (185)",
+      '186' => "POSB Sims Ave",
+      '187' => "Bras Basah (187)",
+      '188' => "Bras Basah (188)",
+      '189' => "POSB Centrepoint",
+      '190' => "POSB Suntec City",
+      '191' => "POSB Yishun Central",
+      '192' => "Bras Basah (192)",
+      '193' => "POSB Eastpoint",
+      '194' => "Bras Basah (194)",
+      '195' => "POSB Vivo City",
+      '196' => "Bras Basah (196)",
+      '197' => "Bras Basah (197)",
+      '198' => "POSB Ang Mo Kio Central",
+      '199' => "POSB Bukit Merah Central",
+      '200' => "POSB Bedok Central",
+      '201' => "POSB Clementi Central",
+      '202' => "POSB Woodlands",
+      '203' => "POSB Thomson Plaza",
+      '204' => "POSB Beauty World",
+      '205' => "Bras Basah (205)",
+      '206' => "Bras Basah (206)",
+      '207' => "POSB Ang Mo Kio North",
+      '208' => "Bras Basah (208)",
+      '209' => "POSB SGH",
+      '210' => "Bras Basah (210)",
+      '211' => "Bras Basah (211)",
+      '212' => "Bras Basah (212)",
+      '213' => "POSB Bedok South",
+      '214' => "POSB Collyer Quay",
+      '215' => "Bras Basah (215)",
+      '216' => "POSB Boon Lay",
+      '217' => "POSB Potong Pasir",
+      '218' => "Bras Basah (218)",
+      '219' => "Bras Basah (219)",
+      '220' => "Bras Basah (220)",
+      '221' => "POSB Square 2",
+      '222' => "Bras Basah (222)",
+      '223' => "Bras Basah (223)",
+      '224' => "Bras Basah (224)",
+      '225' => "Bras Basah (225)",
+      '226' => "Bras Basah (226)",
+      '227' => "Bras Basah (227)",
+      '228' => "POSB Raffles Quay",
+      '229' => "Bras Basah (229)",
+      '230' => "POSB Tampines East",
+      '231' => "POSB Funan Centre",
+      '232' => "Bras Basah (232)",
+      '233' => "POSB Nanyang Estate",
+      '234' => "Bras Basah (234)",
+      '235' => "POSB Upper Cross Street",
+      '236' => "Bras Basah (236)",
+      '237' => "Bras Basah (237)",
+      '238' => "POSB Heartland Mall",
+      '239' => "Bras Basah (239)",
+      '240' => "POSB Jurong East Central",
+      '241' => "POSB Kampong Ubi",
+      '242' => "POSB Serangoon Central",
+      '243' => "POSB Tampines Central",
+      '244' => "POSB Bishan Central",
+      '245' => "POSB White Sands",
+      '246' => "Bras Basah (246)",
+      '247' => "POSB Ngee Ann City",
+      '248' => "POSB Great World City",
+      '249' => "Bras Basah (249)",
+      '250' => "Bras Basah (250)",
+      '251' => "Bras Basah (251)",
+      '254' => "Payment Ops (Chq & Giro)",
+      '257' => "POSB Compass Point",
+      '259' => "POSB Nee Soon South",
+      '260' => "POSB Pasir Ris East Branch",
+      '287' => "POSB West Coast",
+      '288' => "DBS MBFC",
+      '289' => "POSB Canberra",
+      '291' => "DBS Sports Hub",
+      '347' => "Outward Clearing Centre 1",
+      '363' => "Network Management",
+      '390' => "Giro Processing Unit",
+      '391' => "Outward Clearing Centre 2",
+    }
+  end
+end

data/lib/banks/hsbc.rb ADDED Viewed

@@ -0,0 +1,55 @@
+class HSBC < SingaporeBankCode::BankAccount
+  def bank_code
+    '7232'
+  end
+  def resolved_number
+    @number[3..-1]
+  end
+  def reference_hash_collection
+    {
+      '041' => "Collyer Quay 041",
+      '042' => "Orchard Dhoby Ghaut 042",
+      '043' => "Claymore-Tanglin 043",
+      '044' => "Holland Village 044",
+      '045' => "Serangoon 045",
+      '046' => "Jurong 046",
+      '047' => "Collyer Quay-TG Pagar 047",
+      '049' => "Suntec 049",
+      '050' => "Jurong-Bukit Timah 050",
+      '051' => "Marine Parade 051",
+      '052' => "Collyer Quay 052",
+      '054' => "Serangoon-Bishan 054",
+      '055' => "Claymore-Ord Central 055",
+      '056' => "Collyer Quay-Vivocity 056",
+      '057' => "Claymore – Nassim 057",
+      '071' => "Tampines 071",
+      '141' => "Collyer Quay-OCB141",
+      '142' => "Orchard Dhoby Ghaut 142",
+      '143' => "Liat Tower Wealth Hub",
+      '144' => "Holland Village",
+      '145' => "Serangoon Garden",
+      '146' => "Jurong",
+      '147' => "Tanjong Pagar",
+      '149' => "Suntec City",
+      '150' => "Upper Bukit Timah",
+      '151' => "Marine Parade",
+      '152' => "Collyer Quay",
+      '154' => "Bishan",
+      '155' => "Orchard Central",
+      '156' => "VivoCity",
+      '157' => "Nassim Hill",
+      '171' => "Tampines",
+      '172' => "Claymore",
+      '800' => "VA DBU 00",
+      '801' => "VA DBU 01",
+      '802' => "VA DBU 02",
+      '803' => "VA DBU 03",
+      '870' => "VA ACU 70",
+      '872' => "VA ACU 72",
+      '873' => "VA ACU 73",
+    }
+  end
+end

data/lib/banks/malayan_banking_berhad.rb ADDED Viewed

@@ -0,0 +1,36 @@
+class MALAYANBANKINGBERHAD < SingaporeBankCode::BankAccount
+  def bank_code
+    '7302'
+  end
+  def reference_hash_collection
+    {
+    '001' => 'Main Branch',
+    '002' => 'Robinson Road',
+    '003' => 'Tampines',
+    '004' => 'Woodlands 888 Plaza',
+    '005' => 'Maybank@HDBHub',
+    '006' => 'Bukit Timah',
+    '007' => 'Jurong Point',
+    '008' => 'Balestier Plaza',
+    '009' => 'North Bridge Road',
+    '010' => 'Ang Mo Kio',
+    '011' => 'Queensway',
+    '012' => 'Maybank@nex',
+    '013' => 'Bedok',
+    '014' => 'Geylang Serai',
+    '015' => 'Marine Parade',
+    '016' => 'Choa Chu Kang',
+    '017' => 'Chinatown',
+    '018' => 'Holland Village',
+    '019' => 'Jurong East',
+    '020' => 'Yishun',
+    '021' => 'Textile Centre',
+    '022' => 'Kovan',
+    '033' => 'HP Processing Centre',
+    '052' => 'Maybank Card Centre',
+    '080' => 'e-Banking',
+    }
+  end
+end