Versions follow CalVer with the scheme YY.0M.Micro
.
2024.01.1 - 2024/01/05
- Support aspirational countries:
- Algeria
- Angola
- Benin
- Burkina Faso
- Burundi
- Cabo Verde
- Cameroon
- Central African Republic
- Chad
- Comoros
- Congo
- Côte d'Ivoire
- Djibouti
- Equatorial Guinea
- Gabon,
- Guinea-Bissau
- Honduras
- Iran
- Madagascar
- Mali
- Morocco
- Mozambique
- Nicaragua
- Niger
- Senegal
- Togo
- National checksum algorithms for many countries have been added:
- Albania
- Bosnia and Herzegovina
- Czech Republic
- East Timor
- Estonia
- Finland
- Iceland
- Mauritania
- Montenegro
- North Macedonia
- Norway
- Poland
- Portugal
- Serbia
- Slovakia
- Slovenia
- Spain
- Tunisia
- Add new banks to the list of French banks @Natim:
- ARKEA BP Brest
- Anytime
- Lydia Bank
- MEMO BANK
- Revolut
- SHINE
- SumUp Limited
- New :attr:`.IBAN.in_sepa_zone`-property to indicate if the IBAN's country is part of the SEPA zone.
- New manual bank registries for
- Andorra
- Arabic Emirates
- Costa Rica
- Portugal
- New attributes :attr:`.IBAN.account_id`, :attr:`.IBAN.account_holder_id` and :attr:`.IBAN.account_type` that are available depending on the country's BBAN specification. E.g. :attr:`.IBAN.account_holder_id` is currently only available for Iceland (Kennitala) and only Brazil defines an :attr:`.IBAN.account_id`.
- Use enhanced IBAN/BBAN format from Wikipedia, since the official information from SWIFT is often inacurate.
- The support for national checksum digits has been reimplemented.
- The :class:`.IBAN`-class now has an additional :attr:`.IBAN.bban`-attribute, where all country specific functionality has been moved to.
- Updated bank registries. Thanks to @sh4dowb for the Turkish banks.
2023.11.2 - 2023/11/27
- Add OKALI to the list of French banks @Natim.
2023.11.1 - 2023/11/27
- The Swiss bank registry is now generated from the SIX Group.
- Manually add missing bank entry for Spain.
- Updated bank registr for Austria and Poland.
2023.11.0 - 2023/11/17
- The validation of a :class:`.BIC` is now performed in the context of ISO 9362:2022 which allows
numbers in the business party prefix. If strict SWIFT compliance is reqruied the
enforce_swift_compliance
parameter can be set toTrue
. - The :meth:`.BIC.from_bank_code`-method will now select the most generic BIC (e.g. with no branch specifier or the "XXX" value) if multiple BICs are associated to the given domestic bank code. @Natim.
- Many manually curated bank registry entries have been re-added by @dennisxtria
2023.10.0 - 2023/10/31
- The Pydantic v2 protocol is now supported, so that the :class:`.IBAN` and :class:`.BIC` classes can be directly used as type annotations in Pydantic models
- The :class:`.IBAN` and :class:`.BIC` classes are now subclasses of :class:`str` so that all string related methods and functionallities (e.g. slicing) are directly available.
2023.09.0 - 2023/09/25
- Support for Python 3.7 has been dropped.
- New method :meth:`.BIC.candidates_from_bank_code` to list all matching BICs to a given domestic bank code @Natim.
- The Italian bank registry is now automatically generated thanks to @Krystofee
- Switch project tooling to hatch.
- Use ruff instead of [flake8](https://flake8.pycqa.org/en/latest/) as linter.
- Upgrade mypy to 1.5.1 and fix all new typing errors.
2023.06.0 - 2023/06/21
- For Ukrainian banks calling
iban.bic
did result in aTypeError
. Thanks @bernoreitsma for reporting.
- Updated generated bank registries for Austria, Belgium, Czech Republic, Germany, Netherlands, Hungary, Norway, Poland and Ukraine.
2023.03.0 - 2023/03/14
- Updated generated bank registries for Austria, Belgium, Germany, Netherlands, Hungary, Slovenia and Ukraine.
- New bank registry for Norway thanks to @ezet
2023.02.1 - 2023/02/28
- The domestic checksum calculation for Belgium now returns 97 in case the modulo operation results in 0. @mhemeryck
- Updated generated bank registries for Austria, Belgium, Czech Republic, Germany, Spain, Hungary and Croatia.
2023.02.0 - 2023/02/06
- New banks for Portugal and Italy @dennisxtria
- Added support for Ukrainian banks @shpigunov
- Corrected bank codes for Cypriot banks @Krystofee
2022.09.0 - 2022/16/09
- IBAN validation for Senegal mkopec87
- Refactored most of the scripts to generate the bank registry to use Pandas @pebosi
- Updated bank registry for Austria, Belgium, Germany, Spain, Hungary, Netherlands and Poland.
2022.07.1 - 2022/28/07
- In some countries the BBAN does not include a bank code, but only a branch code (e.g. Poland). In those cases the branch code should be used to lookup the bank associated to an IBAN instead of the obviously empty bank code.
2022.07.0 - 2022/07/07
- Hungarian bank registry generator script was fixed by @Krystofee
2022.06.3 - 2022/06/29
- Generated list of Lithuanian BICs @Draugelis
- Removed manually curated list of Lithuanian banks.
2022.06.2 - 2022/06/22
- Updated bank registry for Austria, Belgium, Czech Republic, Germany, Croatia, Netherlands, Poland and Slovenia.
- The domestic bank code for Hungarian banks was wrongly generated @Krystofee
2022.06.1 - 2022/06/06
- Generated list of Romanian BICs @Krystofee
- Generated list of Hungarian BICs @Krystofee
- Extended manually curated list of Irish BICs @dennisxtria
2022.06.0 - 2022/06/06
- Manually curated list of Bulgarian BICs @Krystofee
- Manually curated list of Saudi Arabian BICs @samizaman
- Support for PyInstaller @Lukasz87
- Run tests on Python 3.10 @adamchainz
- Use standard keys in
setup.cfg
@adamchainz - Don't rely on
hacking
in test-setup @adamchainz
2022.04.2 - 2022/04/29
- Allow getting bank names from IBAN. Previously, you could do
iban.bic.bank_names[0]
, but since a BIC can be associated to multiple bank codes the context of the specific bank is lost and you could end up with the wrong bank name. @jose-reveni
2022.04.1 - 2022/04/29
- The Italian BBAN checksum algorithm is now also applied for San Marino @fabienpe
2022.04.0 - 2022/04/11
- Update bank registry for Austria, Czech Republic, Germany, Spain, Poland and Slovakia.
- Removed bogus line from dutch bank registry.
- Loading the bank registry now also works on machines that don't have UTF-8 as their default encoding @imad3v
2022.03.1 - 2022/03/05
- Country specifc checksum validation for French banks (based on the work of @sholan)
2022.03.0 - 2022/03/04
- The :class:`.IBAN` and :class:`.BIC` classes now support the
__len__
method to allow a more Pythonic calculation of the length.
- Update bank registry for Czech Republic, Spain, Hungary, Poland and Slovakia.
2022.02.0 - 2022/02/15
- N26 BIC for Spain @brunovila
- Manually curated entries for banks from Iceland @gautinils
- Removed manually curated bank entries for Spain since all values were already part of the generated registry.
- Updated bank registry for Austria, Belgium, Czech Republic, Germany, Spain, Netherlands and Poland
- Added overwrite for IBAN spec of Czech Republic and France. The branch and account code positions are wrongly provided in the official IBAN registry.
2021.10.2 - 2021/10/12
- Added 440 additional bank records for Spain.
2021.10.1 - 2021/10/11
- Use importlib.resources
for loading internal registries. This removes the need to have
setuptools
installed. Thank you @a-recknagel for the idea!
- Ensure that Belgian BBAN checksums are always 2 digits long.
2021.10.0 - 2021/10/01
- Added IBAN spec for Sudan (SD).
- Added and extended manually curated bank entries for Turkey, Italy, Israel, Ireland, Spain, Switzerland and Denmark @howorkon.
- Updated bank registry for Austria, Belgium, Czech Republic, Germany, Netherlands, Poland, Slovenia and Slovakia.
- Disallow
schwifty
to be installed for Python versions older than 3.7. It was unsupported before but is now rejected upon installation with an appropriate error message. - Austrian bank codes are now consistently left padded with zeros. This fixes the mapping from IBAN to BIC for the Austrian federal bank institutes.
2021.06.1 - 2021/06/24
- Enable tool based type checking as described in PEP-0561 by adding the
py.typed
marker @jmfederico
2021.06.0 - 2021/06/17
- Added bank registry for Swedish Banks @jmfederico
2021.05.2 - 2021/05/23
- Country specifc checksum validation for Belgian banks, as well as support for generating the checksum when using the :meth:`.IBAN.generate`-method. @mhemeryck
2021.05.1 - 2021/05/20
- The IBAN validation now optionally includes the verification of the country specific checksum within the BBAN. This currently works for German and Italian banks. For German banks the checksum algorithm for the account code is chosen by the bank code. Since there are over 150 bank specific algorithms in Germany not all of them are implemented at the moment, but the majority of banks should be covered.
- Update bank registry for Germany, Poland, Czech Republic, Austria and Netherlands.
2021.05.0 - 2021/05/02
- Added manually curated list of Lithuanian Banks (e.g Revolut Payments UAB).
2021.04.0 - 2021/04/23
- Added type hints to the entire code base.
- Dropped support for Python 3.6
- Update bank registry for Austria, Poland, Germany, Belgium, Czech Republic, Netherlands, Slovenia and Slovakia.
2021.01.0 - 2021/01/20
- Restructure documentation and change theme to furo.
- Added dedicated exception classes for various validation errors.
- Drop support for Python 2. Only Python 3.6+ will be supported from now on.
- Use PEP 517/518 compliant build setup.
2020.11.0 - 2020/12/02
- Updated IBAN registry and bank registries of Poland, Germany, Austria, Belgium, Netherlands, Czech Republic and Slovenia.
- Added generated banks for Slovakia @petrboros.
- Added a test to validate the correctnes of BICs in the registry @ckoehn.
- Fixed encoding for Polish bank registry @michal-michalak.
2020.09.0 - 2020/09/07
- Migrated build and test pipelines to GitHub actions.
- Added generated banks for Netherlands @insensitiveclod.
- Added generated banks for Spain.
2020.08.3 - 2020/08/31
- Fixed IBAN generation for countries with branch/sort code
- Add generated banks for Spain
2020.08.2 - 2020/08/30
- Poland's IBAN spec only has a branch-code but no bank-code
- Fixed listing of supported countries for BIC derivation.
- Fixed bank registry for Hungary.
- Updated bank registry Poland, Belgium and Austria.
- Updated IBAN spec for Sao Tome and Principe
2020.08.1 - 2020/08/28
- New attribute :attr:`.BIC.is_valid` and :attr:`.IBAN.is_valid`.
2020.08.0 - 2020/08/06
- Updated bank registry for Poland.
2020.05.3 - 2020/05/25
- Added banks for France, Switzerland and Great Britain.
2020.05.2 - 2020/05/08
- Added :attr:`.BIC.country` and :attr:`.IBAN.country`.