Tests

Running tests

To run django-wiki’s tests, you need to have installed hatch (read more about it here) once installed you can execute hatch run test:all to test your changes across our matrix.

To run specific tests, see hatch run test:all --help.

To include Selenium tests, you need to have Xvfb installed (usually via system-provided package manager), chromedriver and set the environment variable INCLUDE_SELENIUM_TESTS=1. For example, run tests with (depending on whether you want to test directly or via the test matrix):

INCLUDE_SELENIUM_TESTS=1 hatch run test
INCLUDE_SELENIUM_TESTS=1 hatch run test:all

If you wish to also show the browser window while running the functional tests, set the environment variable SELENIUM_SHOW_BROWSER=1 in addition to INCLUDE_SELENIUM_TESTS=1, for example:

INCLUDE_SELENIUM_TESTS=1 SELENIUM_SHOW_BROWSER=1 hatch run test:all

Writing tests

Tests generally fall into a few categories:

  • Testing at the model level. These test cases should inherit from tests.base.TestBase.

  • Tests for views that return HTML. We normally use django-functest for these, especially if the page involves forms and handling of POST data. Test cases should inherit from tests.base.WebTestBase and tests.base.SeleniumBase - see tests.core.test_views.RootArticleViewTestsBase, RootArticleViewTestsWebTest and RootArticleViewTestsSelenium for an example.

    (In the past the Django test Client was used for these, and currently there are still a lot of tests written in this style. These should be gradually phased out where possible, because the test Client does a poor job of replicating what browsers and people actually do.

  • Tests for views that return JSON or other non-HTML. These test cases should inherit from tests.base.DjangoClientTestBase.

There are also other mixins in tests.base that provide commonly used fixtures for tests e.g. a root article.

Warning

Views should be written so that as far as possible they work without Javascript, and can be tested using the fast WebTest method, rather than relying on the slow and fragile Selenium method. Selenium tests are not run by default.