To run tests locally you can use
tox, which will run the tests with all supported Python versions (3.7 - 3.11)
Bear in mind that you need to have all those versions installed in your local environment for that to work.
For a faster and simpler testing alternative you can just run
It should automatically pickup the
tests directory and run the test suite.
Bear in mind that some tests may be be skipped in your local environment - make sure to look at which tests are being skipped.
Apart from skipped tests related to the interpreter (eg.
PyPy) or operational systems, slow tests are also skipped by default, but are ran in the GitHub CI/CD workflow.
To include slow tests in your local environment, use the
RUN_SLOW_TESTS_TOO=1 environment variable:
RUN_SLOW_TESTS_TOO=1 pytest .
If you want to analyze the coverage reports, you can use the
--cov argument to
pytest. By adding
--cov-report, you also have some flexibility in terms of the report output format:
RUN_SLOW_TESTS_TOO=1 pytest --cov=rq --cov-config=.coveragerc --cov-report= --durations=5
Where you replace the
report_format by the desired format (
If you rather use Vagrant, see these instructions.