django-localflavor-ve
django-localflavor-ve copied to clipboard
Django Local Flavor For Venezuela
================================= Django Local Flavor For Venezuela
A Django_ localflavor_ For Venezuela.
- Code repository: http://github.com/macagua/django-local-flavor-ve
- Questions, comments and bug reports to http://github.com/macagua/django-local-flavor-ve/issues
.. contents::
Features
- A field that accepts a 'classic' NNNN Zip Zone Code.
- A field that validates 'Cédula de Identidad' (DNI) numbers.
- A field that validates a Register Tax Information (Registro Único de Información Fiscal - RIF) issued by SENIAT.
- A field that validates as Venezuelan phone postal code.
- A Select widget that uses a list of Venezuelan regions as its choices.
- A Select widget that uses a list of Venezuelan states as its choices.
Download and Install
Download the source code:
::
$ git clone git://github.com/macagua/django-local-flavor-ve.git
Install the source code adding the ve
module to your PYTHONPATH
environment variable:
::
$ cd django-local-flavor-ve $ export PYTHONPATH=$PWD
On windows you may want to use set PYTHONPATH=%CD%
Test your installation with the following commands from a Python shell:
::
$ python
from ve import forms dir(forms) exit()
Cloned sources includes an example project. To try it out run:
::
$ cd django-local-flavor-ve/example $ python manage.py runserver
Now that the server's running, visit http://127.0.0.1:8000/example/ with your Web browser. You'll see a "A Form example for Venezuelan localflavor" page. Then It worked!
Using Venezuela Local Flavor on my project
You can see an example to use the Venezuelan Local Flavor in your Django_ projects here_.
Tested
- Django 1.2.4 and Python 2.6
TODO
- Add full support to ISO-3166-2:VE_ regulations.
- Write tests for all fields
.. _Django: http://djangoproject.com/ .. _localflavor: http://docs.djangoproject.com/en/dev/ref/contrib/localflavor/ .. _ISO-3166-2:VE: https://secure.wikimedia.org/wikipedia/en/wiki/ISO_3166-2:VE .. _here: https://github.com/macagua/django-local-flavor-ve/tree/master/example