skip to navigation
skip to content

Not Logged In

django-phonenumber-field 0.5

An international phone number field for django models.

Latest Version: 0.7.1

A Django library which interfaces with python-phonenumbers to validate, pretty print and convert phone numbers. python-phonenumbers is a port of Google’s libphonenumber library, which powers Android’s phone number handling.

Included are:

  • PhoneNumber, a pythonic wrapper around python-phonenumbersPhoneNumber class
  • PhoneNumberField, a model field
  • PhoneNumberField, a form field
  • PhoneNumberPrefixWidget, a form widget

Installation

pip install django-phonenumber-field

Basic usage

Use it like any regular model field:

from phonenumber_field.modelfields import PhoneNumberField

class MyModel(models.Model):
    name = models.CharField(max_length=255)
    phone_number = PhoneNumberField()
    fax_number = PhoneNumberField(blank=True)

Internally, PhoneNumberField is based upon CharField and represents the number as a string of an international phonenumber in the database (e.g '+41524204242'). As with CharField’s, it is discouraged to use null=True.

The object returned is a PhoneNumber instance, not a string. If strings are used to initialize it, e.g. via MyModel(phone_number='+41524204242') or form handling, it has to be a phone number with country code.

 
File Type Py Version Uploaded on Size
django-phonenumber-field-0.5.tar.gz (md5) Source 2014-04-29 5KB
  • Downloads (All Versions):
  • 136 downloads in the last day
  • 1131 downloads in the last week
  • 2879 downloads in the last month