mirror of
https://github.com/Hopiu/django-model-utils.git
synced 2026-03-17 04:10:24 +00:00
48 lines
1.1 KiB
ReStructuredText
48 lines
1.1 KiB
ReStructuredText
Contributing
|
|
============
|
|
|
|
Below is a list of tips for submitting issues and pull requests. These are
|
|
suggestions and not requirements.
|
|
|
|
Submitting Issues
|
|
-----------------
|
|
|
|
Issues are often easier to reproduce/resolve when they have:
|
|
|
|
- A pull request with a failing test demonstrating the issue
|
|
- A code example that produces the issue consistently
|
|
- A traceback (when applicable)
|
|
|
|
Pull Requests
|
|
-------------
|
|
|
|
When creating a pull request, try to:
|
|
|
|
- Write tests if applicable
|
|
- Note important changes in the `CHANGES`_ file
|
|
- Update the `README`_ file if needed
|
|
- Add yourself to the `AUTHORS`_ file
|
|
|
|
.. _AUTHORS: AUTHORS.rst
|
|
.. _CHANGES: CHANGES.rst
|
|
.. _README: README.rst
|
|
|
|
Testing
|
|
-------
|
|
|
|
Please add tests for your code and ensure existing tests don't break. To run
|
|
the tests against your code::
|
|
|
|
python setup.py test
|
|
|
|
Please use tox to test the code against supported Python and Django versions.
|
|
First install tox::
|
|
|
|
pip install tox
|
|
|
|
To run tox and generate a coverage report (in ``htmlcov`` directory)::
|
|
|
|
make test
|
|
|
|
**Please note**: Before a pull request can be merged, all tests must pass and
|
|
code/branch coverage in tests must be 100%.
|