Skip to main content

A validated IBAN field for Django models

Project description

https://secure.travis-ci.org/benkonrath/django-iban.png?branch=master https://coveralls.io/repos/benkonrath/django-iban/badge.png?branch=master https://pypip.in/v/django-iban/badge.png https://pypip.in/d/django-iban/badge.png

Validated Django model fields for International Bank Account Numbers (IBAN - ISO 13616-1:2007) and SWIFT-BIC (ISO 9362:2009).

Author: Ben Konrath

License: 3-clause BSD

Features:

  • Support for all currently active and planned to be active IBAN countries / numbers.

  • Optional validation for IBANs included the Nordea IBAN extensions.

  • Validates IBAN using the official validation algorithm.

  • Basic validation for SWIFT-BIC.

  • Python 3.2 and 3.3 support for Django >= 1.5.

Usage:

Use the model fields IBANField and/or SWIFTBICField in your models:

from django.db import models
from django_iban.fields import IBANField, SWIFTBICField


class CustomerModel(models.Model):
    iban = IBANField()
    swift_bic = SWIFTBICField()

Use the form fields IBANFormField and/or SWIFTBICFormField in your forms:

from django import forms
from django_iban.forms import IBANFormField, SWIFTBICFormField


class CustomerForm(forms.Form):
    iban = IBANFormField()
    swift_bic = SWIFTBICFormField()

If you want to validate the Nordea IBAN extensions, the model and form fields can be setup like this:

class CustomerModel(models.Model):
    iban = IBANField(use_nordea_extensions=True)


class CustomerForm(forms.Form):
    iban = IBANFormField(use_nordea_extensions=True)

Development:

Coding style: PEP8 with 120 character lines.

Ideas for new features include:

  • SWIFT-BIC validation using referenced IBANField (SEPA requires both IBAN and SWIFT-BIC to be correct).

  • Translation of validation error messages using Transifex.

Pull requests happily accepted.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-iban-0.2.7.tar.gz (12.5 kB view details)

Uploaded Source

File details

Details for the file django-iban-0.2.7.tar.gz.

File metadata

  • Download URL: django-iban-0.2.7.tar.gz
  • Upload date:
  • Size: 12.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-iban-0.2.7.tar.gz
Algorithm Hash digest
SHA256 7ec4875128d33743eb6dc4c1999c87b166df1c9286de67903c105d67ea376ea4
MD5 bcf1cb98b6563558664c0179cc4bdcb1
BLAKE2b-256 79f430aa23849460cf99d98dcc64824debd843309fd1f7a095a518d54198537b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page