Metadata-Version: 1.0
Name: django-cep
Version: 1.0.1
Summary: Address fields autofill app for forms using brazilian CEP field.
Home-page: https://github.com/staticdev/django-cep
Author: Thiago Carvalho D Avila
Author-email: thiagocavila@gmail.com
License: LICENSE.txt
Description: django-cep
        ===============
        This application enables [django](https://www.djangoproject.com/) powered websites to have autofilled address fields in forms based on brazilian CEP field.
        
        Installation
        ------------
        To install ``django-cep`` simply run::
        
            pip install -e git://github.com/staticdev/django-cep.git#egg=django-cep
        
        Configuration
        -------------
        
        We need to hook ``django-cep`` into our project.
        
        Put ``cep`` into your ``INSTALLED_APPS`` at settings module::
        
              INSTALLED_APPS = (
                 ...
                 'cep',
              )
        
        Usage
        -----
        Currently the only syntax supported is setting the IDs of the address fields in the widget of the CEP field. For other ways to set this up, see the NEXT-STEPS file.
        
        1. Import the django-cep widget CEPInput in your forms.py::
        
            from cep.widgets import CEPInput
        
        2. Set your CEP field for using the CEPInput, with the correct address fields ID, for example::
        
            my_cep_field = MyCEPField(label=u"CEP", help_text="Format: XXXXX-XXX", required=False, widget=CEPInput(address={'street': 'id_street_field', 'district': 'id_district_field', 'city': 'id_city_field', 'state': 'id_state_field'}))
        
         That stands for a street field ID equals id_street_field, district field ID equals id_district_field, city field ID equals id_city_field and a state field ID equals id_state_field. 
        
         It is highly recommended that you use Django localflavor's BRStateChoiceField for the State field, to make it render the correct brazilian state from the list.
Platform: UNKNOWN
