Metadata-Version: 1.1
Name: django-phonenumber-field
Version: 0.2.1
Summary: An international phone number field for django models.
Home-page: http://github.com/stefanfoulis/django-phonenumber-field
Author: Stefan Foulis
Author-email: stefan.foulis@gmail.com
License: BSD
Description: ========================
        django-phonenumber-field
        ========================
        
        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://code.google.com/p/libphonenumber/
        
        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.
        
        
        
        
        
        
Platform: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
