comparison doc/installation.txt @ 7399:deb8e7e6d66d

Skip redis tests if unable to communicate with the server. If the redis module is in the test environment, the redis tests will not be skipped. If connecting to redis during testing fails with a ConnectionError because there is no redis server at localhost, or if it fails with an AuthenticationError, you would fail a slew of tests. This causes the tests to report as skipped if either of the two errors occurs. It is very inefficient as it fails in setup() for the tests, but at least it does report skipping the tests. Also documented how to pass the redis password to the tests in the test part of the install docs. Future note: running tests needs proper docs in development.txt (including database setup) and a link left to that doc in installation.txt.
author John Rouillard <rouilj@ieee.org>
date Wed, 24 May 2023 12:52:53 -0400
parents 72de757edf78
children 116ea5ce06ab
comparison
equal deleted inserted replaced
7398:07f8737fe04c 7399:deb8e7e6d66d
2124 install` as the test suite is not installed. Once you've unpacked 2124 install` as the test suite is not installed. Once you've unpacked
2125 roundup's source, if you have pytest installed, run ``python -m 2125 roundup's source, if you have pytest installed, run ``python -m
2126 pytest test`` in the Roundup source directory and make sure there 2126 pytest test`` in the Roundup source directory and make sure there
2127 are no errors. If there are errors, please let us know! 2127 are no errors. If there are errors, please let us know!
2128 2128
2129 Note that redis tests uses database 15 of the redis server running on
2130 localhost.The tests verify that the database is empty before the redis
2131 tests start. If you use a password on your redis database it can be
2132 specified in the ``pytest_redis_pw`` environment variable when you run
2133 the test.
2134
2129 .. _`user guide`: user_guide.html 2135 .. _`user guide`: user_guide.html
2130 .. _`roundup specification`: spec.html 2136 .. _`roundup specification`: spec.html
2131 .. _`tracker configuration`: reference.html#tracker-configuration 2137 .. _`tracker configuration`: reference.html#tracker-configuration
2132 .. _`customisation documentation`: customizing.html 2138 .. _`customisation documentation`: customizing.html
2133 .. _`Roundup reference`: reference.html 2139 .. _`Roundup reference`: reference.html

Roundup Issue Tracker: http://roundup-tracker.org/