1.4 KiB
SyTest
Dendrite uses SyTest for its
integration testing. When creating a new PR, add the test IDs (see below) that
your PR should allow to pass to testfile in dendrite's root directory. Not all
PRs need to make new tests pass. If we find your PR should be making a test pass
we may ask you to add to that file, as generally Dendrite's progress can be
tracked through the amount of SyTest tests it passes.
Finding out which tests to add
An easy way to do this will be let CircleCI run sytest, and then search for the tests that should be added in the test results file.
You may enable CircleCI for your own fork, or simply
refer to the CircleCI build for your PR. Once the build is complete, you can
find the test results in Container N/logs/results.tap under the Artifacts
tab on the CircleCI build page. To get the tests that should be added, search
for the string:
# TODO passed but expected fail
Generally, tests with this label should be the tests that your PR is allowing to pass.
To add a test into testfile, extract its test ID and append it to testfile.
For example, to add this test:
ok 4 (expected fail) POST /register rejects registration of usernames with '!' # TODO passed but expected fail
Append:
POST /register rejects registration of usernames with '!'
to testfile.