Skip to main content

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-phonenumbers’ PhoneNumber 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.

Metadata

Release files for django-phonenumber-field 0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-phonenumber-field 0.5
File Size Uploaded
django-phonenumber-field-0.5.tar.gz 5.9 kB Details

Release files / django-phonenumber-field-0.5.tar.gz

Download URL django-phonenumber-field-0.5.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
01a2e59899745543c40a6bf4904a4a08c4ba82c849fce2dc29bcf6181683428f
BLAKE2b-256 checksum
How to use checksums
00d709e778a2c0bebfa9de165048c537fc629d73feec5e1f1da427d0517d2d17
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

8.5.0

2 release files

8.4.0

2 release files

8.3.0

2 release files

8.2.0

2 release files

8.1.0

2 release files

8.0.0

2 release files

7.3.0

2 release files

7.2.0

2 release files

7.1.0

2 release files

7.0.2

2 release files

7.0.1

2 release files

7.0.0

2 release files

6.4.0

2 release files

6.3.0

2 release files

6.2.0

2 release files

6.1.0

2 release files

6.0.0

2 release files

5.2.0

2 release files

5.1.0

2 release files

5.0.0

2 release files

4.0.0

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.4.0

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.0

1 release file

2.1.0

1 release file

2.0.1

1 release file

2.0.0

1 release file

1.3.0

1 release file

1.2.0

1 release file

1.1.0

2 release files

1.0.0

1 release file

0.7.2

1 release file

0.7.1

1 release file

0.6

1 release file

This release

0.5 This release

1 release file

0.2.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page