Contributing to django-localflavor
As an open source project, django-localflavor welcomes contributions of many forms, similar to its origin in the Django framework.
Examples of contributions include:
- Code patches
- Documentation improvements
- Bug reports and patch reviews
Extensive contribution guidelines are available online at:
File a ticket to suggest changes or send pull requests.
django-localflavor uses Github's issue system to keep track of bugs, feature requests, and pull requests for patches.
Running tests is as simple as installing Tox and running it in the root Git clone directory:
$ git clone https://github.com/django/django-localflavor [..] $ cd django-localflavor $ tox [..] congratulations :)
The previous command will run the tests in different combinations of Python
(if available) and Django versions. To see the full list of combinations use
$ tox -l docs py27-1.8 py32-1.8 py33-1.8 py34-1.8 py27-1.9 py27-master py34-1.9 py34-master py35-1.9 py35-master
You can run each environment with the
$ tox -e py27-1.8 # runs the tests only on Pyton 2.7 and Django 1.8.x
Optionally you can also specify a country whose tests you want to run:
$ COUNTRY=us tox
And combine both options:
$ COUNTRY=us tox -e py27-1.8