Sha256: 7f6a99e64cc7811591b954245d95a616bc461ab5ea716dadf0dfa0ab77b8a1d2
Contents?: true
Size: 2 KB
Versions: 3
Compression:
Stored size: 2 KB
Contents
[](https://codeclimate.com/github/mczuchnowski/polish_banks/maintainability) [](https://codeclimate.com/github/mczuchnowski/polish_banks/test_coverage) [](https://travis-ci.com/mczuchnowski/polish_banks) # PolishBanks - A Polish bank lookup Ruby gem Polish bank name and branch can be read from the IBAN or account number `PLkk BBBB BBBB MMMM MMMM MMMM MMMM` `PL` is the country code, `kk` are check digits. The `BBBB BBBB` is the bank and branch identifier needed to detect the bank. Polish National Bank regularly publishes a single text file containing up-to-date information about all the Polish banks and their branches [here](https://ewib.nbp.pl/faces/PlainDok?dokNazwa=plewibnra.txt). The file uses CP852 encoding. This gem makes it easier to identify banks and their branches based on the account number or IBAN. ## Installation Add to your Gemfile: gem 'polish_banks' And then execute: $ bundle install Or install on your own to test it in irb: $ gem install polish_banks ## How to use it You can use either IBAN or just account number - as string or as integer. If you don't provide the whole account number, the gem will try to determine at least the bank name. Non-Polish ibans will raise a `UnsupportedCountry` exception. require 'polish_banks' iban = "PL9912406999" bank = PolishBank.new(iban) bank.name # "Bank Polska Kasa Opieki Spółka Akcyjna" bank.branch # "Oddział w Tychach ul. Wyszyńskiego 27" If bank is not found, the gem will raise a `BankNotFound` exception. ## Contributing NOTE: To properly update bank lists, remove the /lib/data folder and run the data_generator. 1. Fork 2. Create a feature branch 3. Commit changes 4. Push to your branch 5. Create a new Pull Request based on your branch
Version data entries
3 entries across 3 versions & 1 rubygems
Version | Path |
---|---|
polish_banks-1.1.3 | README.md |
polish_banks-1.1.2 | README.md |
polish_banks-1.1.1 | README.md |