cookiecutter-django/CONTRIBUTING.md

1.4 KiB

How to Contribute

Always happy to get issues identified and pull requests!

Getting your pull request merged in

  1. Keep it small. The smaller the pull request, the more likely we are to accept.
  2. Pull requests that fix a current issue get priority for review.

Testing

Installation

Please install tox, which is a generic virtualenv management and test command line tool.

tox is available for download from PyPI via pip:

$ pip install tox

It will automatically create a fresh virtual environment and install our test dependencies, such as pytest-cookies and flake8.

Run the Tests

Tox uses pytest under the hood, hence it supports the same syntax for selecting tests.

For further information please consult the pytest usage docs.

To run all tests using various versions of python in virtualenvs defined in tox.ini, just run tox.:

$ tox

It is possible to test with a specific version of python. To do this, the command is:

$ tox -e py39

This will run pytest with the python3.9 interpreter, for example.

To run a particular test with tox for against your current Python version:

$ tox -e py -- -k test_default_configuration