======================== django-phonenumber-field

.. image:: https://github.com/django-phonenumber-field/django-phonenumber-field/workflows/Test/badge.svg :target: https://github.com/django-phonenumber-field/django-phonenumber-field/workflows/Test/badge.svg .. image:: https://img.shields.io/coveralls/django-phonenumber-field/django-phonenumber-field/develop.svg :target: https://coveralls.io/github/django-phonenumber-field/django-phonenumber-field?branch=main

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.

.. _python-phonenumbers: https://github.com/daviddrysdale/python-phonenumbers .. _libphonenumber: https://github.com/google/libphonenumber

Documentation

https://django-phonenumber-field.readthedocs.io/

Running tests

tox needs to be installed. To run the whole test matrix with the locally available Python interpreters and generate a combined coverage report::

tox

The cheat sheet for tox <https://tox.wiki/en/latest/user_guide.html#cli>__ gives the most useful commands.