Skip to main content
https://travis-ci.org/GaretJax/django-phonenumber-field.svg?branch=develop https://coveralls.io/repos/GaretJax/django-phonenumber-field/badge.png?branch=develop

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.

Download files

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

Source Distribution

django-phonenumber-field-0.7.1.tar.gz (9.6 kB view details)

Uploaded Source

File details

Details for the file django-phonenumber-field-0.7.1.tar.gz.

File metadata

File hashes

Hashes for django-phonenumber-field-0.7.1.tar.gz
Algorithm Hash digest
SHA256 e0aa51121b58135222eefa380e873d8b9971431dee7dd3ca4d584a65e3525fd1
MD5 dfb2d364b63263a536e7e31a3ad8d617
BLAKE2b-256 e4201757e6e1c05d068f135a674ed9bb8220dbf15205ffd9a2b5e1c3142f40fd

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 Sentry Error logging StatusPage Status page