Contributing to Django money

Django-money is contribute-friendly project. Contributions are highly welcomed and appreciated. There is a guideline for contributing.

Quickstart

  • All code contributions should be tested

  • Code should conform to syntax conventions. There’s a tox command to help fixing it: tox -e fix-lint

  • Documentation should be updated if it is required

  • Put a note to the changelog.

Syntax and conventions

The source code should conform to PEP8 with following notice:

  • Line length should not exceed 120 characters.

Running the tests

We use tox to run the tests:

$ tox -e lint,django111-py36,django111-py27

The test environments above are usually enough to cover most cases locally.

Report bugs

Report bugs in the issue tracker.

If you are reporting a bug, please include:

  • Any details about your local setup that might be helpful in troubleshooting, specifically the Python interpreter version, Django & django-money versions.

  • Detailed steps to reproduce the bug.

If you can write a demonstration test that currently fails but should pass (xfail), that is a very useful commit to make as well, even if you cannot fix the bug itself.