Schwifty

-------------------------
Added
~~~~~
* Added Revolut Bank for Spain `brunovilla <https://github.com/brunovila>`_
* Added support for Python 3.12
* Added manually curated bank registry for Montenegro `Djuka <https://github.com/Djuka>`_

Changed
~~~~~~~
* The bank registry is now internally validated, so that all domestic bank codes actaully match the
specification of the corresponding BBAN structure. As a result some entries had to be removed,
because they did contain invalid bank codes.
* The Danish national checksum algorithm is considered opaque and the checksum digit is assumed to
be part of the account number (which is now always 10 digits long).

Fixed
~~~~~
* The Czech bank registry was stored in latin-1 encoding while being read as UTF-8. This resulted
in invalid bank names `Natim <https://github.com/Natim>`_ and
`Cogax <https://github.com/Cogax>`_.
* The Norwegian national checksum algorithm was rendering wrong results in some edge-cases
`Natim <https://github.com/Natim>`_

-------------------------
Added
~~~~~

* 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 <https://github.com/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`.

Changed
~~~~~~~
* Use enhanced IBAN/BBAN format from `Wikipedia <https://en.wikipedia.org/wiki/International_Bank_Account_Number#IBAN_formats_by_country>`_,
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 <https://github.com/sh4dowb>`_ for the Turkish banks.

-------------------------
Added
~~~~~
* Add OKALI to the list of French banks `Natim <https://github.com/Natim>`_.

-------------------------
Changed
~~~~~~~
* 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.

-------------------------
Changed
~~~~~~~
* 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 to ``True``.
* 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 <https://github.com/Natim>`_.
* Many manually curated bank registry entries have been re-added by `dennisxtria <https://github.com/dennisxtria>`_

-------------------------
Added
~~~~~~~
* 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 <https://docs.pydantic.dev/latest/concepts/models/#basic-model-usage>`_

Changed
~~~~~~~
* 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.