schwifty


Nameschwifty JSON
Version 2024.4.0 PyPI version JSON
download
home_pageNone
SummaryNone
upload_time2024-04-18 09:53:19
maintainerNone
docs_urlhttps://pythonhosted.org/schwifty/
authorNone
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. image:: https://img.shields.io/pypi/v/schwifty.svg?style=flat-square
    :target: https://pypi.python.org/pypi/schwifty
.. image:: https://img.shields.io/github/actions/workflow/status/mdomke/schwifty/lint-and-test.yml?branch=main&style=flat-square
    :target: https://github.com/mdomke/schwifty/actions?query=workflow%3Alint-and-test
.. image:: https://img.shields.io/pypi/l/schwifty.svg?style=flat-square
    :target: https://pypi.python.org/pypi/schwifty
.. image:: https://readthedocs.org/projects/schwifty/badge/?version=latest&style=flat-square
    :target: https://schwifty.readthedocs.io
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square
    :target: https://black.readthedocs.io/en/stable/index.html


Gotta get schwifty with your IBANs
==================================

.. teaser-begin

``schwifty`` is a Python library that let's you easily work with IBANs and BICs
as specified by the ISO. IBAN is the Internation Bank Account Number and BIC
the Business Identifier Code. Both are used for international money transfer.

Features
--------

``schwifty`` lets you

* `validate`_ check-digits and the country specific format of IBANs
* `validate`_ format and country codes from BICs
* `generate`_ BICs from country and bank-code
* `generate`_ IBANs from country-code, bank-code and account-number.
* get the BIC associated to an IBAN's bank-code
* access all relevant components as attributes

See the `docs <https://schwifty.readthedocs.io>`_ for more inforamtion.

.. _validate: https://schwifty.readthedocs.io/en/latest/examples.html#validation
.. _generate: https://schwifty.readthedocs.io/en/latest/examples.html#generation

.. teaser-end

Versioning
----------

Since the IBAN specification and the mapping from BIC to bank_code is updated from time to time,
``schwifty`` uses `CalVer <http://www.calver.org/>`_ for versioning with the scheme ``YY.0M.Micro``.


.. installation-begin

Installation
------------

To install ``schwifty``, simply:

.. code-block:: bash

  $ pip install schwifty

.. installation-end


Development
-----------

We use the `black`_ as code formatter. This avoids discussions about style preferences in the same
way as ``gofmt`` does the job for Golang. The conformance to the formatting rules is checked in the
CI pipeline, so that it is recommendable to install the configured `pre-commit`_-hook, in order to
avoid long feedback-cycles.

.. code-block:: bash

   $ pre-commit install

You can also use the ``fmt`` Makefile-target to format the code or use one of the available `editor
integrations`_.


Project Information
-------------------

``schwifty`` is released under `MIT`_ license and its documentation lives at `Read the Docs`_. The
code is maintained on `GitHub`_ and packages are distributed on `PyPI`_

Name
~~~~

Since ``swift`` and ``swiftly`` were already taken by the OpenStack-project, but we somehow wanted
to point out the connection to SWIFT, Rick and Morty came up with the idea to name the project
``schwifty``.

.. image:: https://i.cdn.turner.com/adultswim/big/video/get-schwifty-pt-2/rickandmorty_ep205_002_vbnuta15a755dvash8.jpg


.. _black: https://black.readthedocs.io/en/stable/index.html
.. _pre-commit: https://pre-commit.com
.. _editor integrations:  https://black.readthedocs.io/en/stable/editor_integration.html
.. _MIT: https://choosealicense.com/licenses/mit/
.. _Read the Docs: https://schwifty.readthedocs.io
.. _GitHub: https://github.com/mdomke/schwifty
.. _PyPI: https://pypi.org/project/schwifty

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "schwifty",
    "maintainer": null,
    "docs_url": "https://pythonhosted.org/schwifty/",
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Martin Domke <mail@martindomke.net>",
    "download_url": "https://files.pythonhosted.org/packages/8a/8a/fc4c9caf88d01fb2543b55236fe95419754f99009635129ea7f62423604c/schwifty-2024.4.0.tar.gz",
    "platform": null,
    "description": ".. image:: https://img.shields.io/pypi/v/schwifty.svg?style=flat-square\n    :target: https://pypi.python.org/pypi/schwifty\n.. image:: https://img.shields.io/github/actions/workflow/status/mdomke/schwifty/lint-and-test.yml?branch=main&style=flat-square\n    :target: https://github.com/mdomke/schwifty/actions?query=workflow%3Alint-and-test\n.. image:: https://img.shields.io/pypi/l/schwifty.svg?style=flat-square\n    :target: https://pypi.python.org/pypi/schwifty\n.. image:: https://readthedocs.org/projects/schwifty/badge/?version=latest&style=flat-square\n    :target: https://schwifty.readthedocs.io\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square\n    :target: https://black.readthedocs.io/en/stable/index.html\n\n\nGotta get schwifty with your IBANs\n==================================\n\n.. teaser-begin\n\n``schwifty`` is a Python library that let's you easily work with IBANs and BICs\nas specified by the ISO. IBAN is the Internation Bank Account Number and BIC\nthe Business Identifier Code. Both are used for international money transfer.\n\nFeatures\n--------\n\n``schwifty`` lets you\n\n* `validate`_ check-digits and the country specific format of IBANs\n* `validate`_ format and country codes from BICs\n* `generate`_ BICs from country and bank-code\n* `generate`_ IBANs from country-code, bank-code and account-number.\n* get the BIC associated to an IBAN's bank-code\n* access all relevant components as attributes\n\nSee the `docs <https://schwifty.readthedocs.io>`_ for more inforamtion.\n\n.. _validate: https://schwifty.readthedocs.io/en/latest/examples.html#validation\n.. _generate: https://schwifty.readthedocs.io/en/latest/examples.html#generation\n\n.. teaser-end\n\nVersioning\n----------\n\nSince the IBAN specification and the mapping from BIC to bank_code is updated from time to time,\n``schwifty`` uses `CalVer <http://www.calver.org/>`_ for versioning with the scheme ``YY.0M.Micro``.\n\n\n.. installation-begin\n\nInstallation\n------------\n\nTo install ``schwifty``, simply:\n\n.. code-block:: bash\n\n  $ pip install schwifty\n\n.. installation-end\n\n\nDevelopment\n-----------\n\nWe use the `black`_ as code formatter. This avoids discussions about style preferences in the same\nway as ``gofmt`` does the job for Golang. The conformance to the formatting rules is checked in the\nCI pipeline, so that it is recommendable to install the configured `pre-commit`_-hook, in order to\navoid long feedback-cycles.\n\n.. code-block:: bash\n\n   $ pre-commit install\n\nYou can also use the ``fmt`` Makefile-target to format the code or use one of the available `editor\nintegrations`_.\n\n\nProject Information\n-------------------\n\n``schwifty`` is released under `MIT`_ license and its documentation lives at `Read the Docs`_. The\ncode is maintained on `GitHub`_ and packages are distributed on `PyPI`_\n\nName\n~~~~\n\nSince ``swift`` and ``swiftly`` were already taken by the OpenStack-project, but we somehow wanted\nto point out the connection to SWIFT, Rick and Morty came up with the idea to name the project\n``schwifty``.\n\n.. image:: https://i.cdn.turner.com/adultswim/big/video/get-schwifty-pt-2/rickandmorty_ep205_002_vbnuta15a755dvash8.jpg\n\n\n.. _black: https://black.readthedocs.io/en/stable/index.html\n.. _pre-commit: https://pre-commit.com\n.. _editor integrations:  https://black.readthedocs.io/en/stable/editor_integration.html\n.. _MIT: https://choosealicense.com/licenses/mit/\n.. _Read the Docs: https://schwifty.readthedocs.io\n.. _GitHub: https://github.com/mdomke/schwifty\n.. _PyPI: https://pypi.org/project/schwifty\n",
    "bugtrack_url": null,
    "license": null,
    "summary": null,
    "version": "2024.4.0",
    "project_urls": {
        "Changelog": "https://github.com/mdomke/schwifty/blob/main/CHANGELOG.rst",
        "Documentation": "https://schwifty.readthedocs.io/en/latest/",
        "Homepage": "http://github.com/mdomke/schwifty"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "c7312984c28ca0286307bc25805d532322381987f21d68e3f43d6924e223924a",
                "md5": "41c5c1c25ac7b47e757690d0470a162d",
                "sha256": "d05d67fecd18099387ca6d57dd86601b8fc8d7ec0ad05c2b31f8e3b53d13d0ce"
            },
            "downloads": -1,
            "filename": "schwifty-2024.4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "41c5c1c25ac7b47e757690d0470a162d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 337746,
            "upload_time": "2024-04-18T09:53:22",
            "upload_time_iso_8601": "2024-04-18T09:53:22.002847Z",
            "url": "https://files.pythonhosted.org/packages/c7/31/2984c28ca0286307bc25805d532322381987f21d68e3f43d6924e223924a/schwifty-2024.4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8a8afc4c9caf88d01fb2543b55236fe95419754f99009635129ea7f62423604c",
                "md5": "764602bb433f25b82c1d28545fdbd168",
                "sha256": "d44576a22d8b05c8f0d94ee72aa7555150e5142cd1f11a97e6d548722c35b6b8"
            },
            "downloads": -1,
            "filename": "schwifty-2024.4.0.tar.gz",
            "has_sig": false,
            "md5_digest": "764602bb433f25b82c1d28545fdbd168",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 706745,
            "upload_time": "2024-04-18T09:53:19",
            "upload_time_iso_8601": "2024-04-18T09:53:19.778965Z",
            "url": "https://files.pythonhosted.org/packages/8a/8a/fc4c9caf88d01fb2543b55236fe95419754f99009635129ea7f62423604c/schwifty-2024.4.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-18 09:53:19",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "mdomke",
    "github_project": "schwifty",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "schwifty"
}
        
Elapsed time: 0.27645s