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.8.tar.gz (12.4 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for django-iban-0.2.8.tar.gz
Algorithm Hash digest
SHA256 c90649a6a6381ebd27448501ad9c767d10c4c0fcc4a8bdd0f5911c1cf158845e
MD5 3b87f0d7a135dc0761a52b4230b868cb
BLAKE2b-256 7d974f519bf0ce42dff819fececdf16792f10689907ed4816436880134732aa6

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