Feel free to open pull requests before you've finished your code or tests. Opening your pull request soon will allow others to comment on it sooner.
A checklist of things to remember when making a feature:
- Write tests if applicable
- Note important changes in the CHANGES file
- Update the README file if needed
- Update the documentation if needed
- Add yourself to the AUTHORS file
The Makefile can be used for generating documentation and running tests.
To install the requirements necessary for generating the documentation and running tests:
make init
This will install:
- tox: used for running the tests against all supported versions of Django and Python
- coverage: used for analyzing test coverage for tests
- Sphinx: used for generating documentation
If not using a virtualenv, the command should be prepended with sudo.
To regenerate the documentation run:
make docs
Please add tests for your pull requests and make sure your changes don't break existing tests.
To run tox and generate an HTML code coverage report (available in the
htmlcov directory):
make test
To quickly run the tests against a single version of Python and Django (note: you must pip install django beforehand):
python setup.py test