pre-commit-hooks/tests/README.md
2017-07-17 21:18:17 +02:00

1.5 KiB

Testing

The test will run with the following environments:

  • Python version 2.7
  • Python version 3.5
  • Python version 3.6
  • PyPy

Installing the test environment

Debian-based distributions (Ubuntu, Mint, etc.)

$ sudo apt install pypy python2.7 python3.5 python3.6 python-tox

Running the tests

Running the complete test suite

$ make test

If the tests failed whereas the ones from the last tag did not, your Git configuration might interfere with pre-commit-hooks. In this case, you can ignore your current Git configuration by setting a temporary environment variable:

$ env HOME=/tmp make test

Running only a specific test

If you are developing a new hook or adding features to an existing one, you may want to run the tests for that particular hook. The following command will run the wanted test on every supported Python version.

$ tox tests/<your_test>.py

If you want to run your test for a specific Python version (for a quicker execution), you can specify it with the -e option of tox. At the moment, the supported Python versions are 2.7 (-e py27), 3.4 (-e py34), and 3.5 (-e py35). For example:

$ tox -e py27 tests/<your_test>.py

You can run your specific test ignoring your own Git configuration like so:

$ env HOME=/tmp tox -e py27 tests/<your_test>.py