From fea1143c45381aad67b03fe1b7041376252dd6a9 Mon Sep 17 00:00:00 2001 From: Phil Davis Date: Mon, 1 Feb 2021 13:14:03 +0545 Subject: [PATCH] Document the replaceUsernames setting in .drone.star --- .../pages/testing/acceptance-tests.adoc | 25 +++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/modules/developer_manual/pages/testing/acceptance-tests.adoc b/modules/developer_manual/pages/testing/acceptance-tests.adoc index 639d7f84f9..89ec0c8c7b 100644 --- a/modules/developer_manual/pages/testing/acceptance-tests.adoc +++ b/modules/developer_manual/pages/testing/acceptance-tests.adoc @@ -230,14 +230,35 @@ and specify the values to be used at run time. For example: } ---- -Then define the environment variable `REPLACE_USERNAMES` to be true: +If you are running tests locally, define the environment variable `REPLACE_USERNAMES` to be true: [source,bash] ---- export REPLACE_USERNAMES=true ---- -When you run acceptance tests, the user names and attributes will be replaced. +You can also run the acceptance tests in CI with the replaced user attributes. This is useful if you want to +run many acceptance tests with an unusual combination of usernames, display names, email addresses and +passwords without taking up many hours on a local machine. _A PR is necessary for testing but is not to be merged_, +it is just a way to get test results. In the `acceptance` section of `.drone.star` switch on the `replaceUsernames` setting. +Commit the changes to `.drone.star` and `tests/acceptance/usernames.json`, push to GitHub, and make a draft PR: + +[source,bash] +---- +'acceptance': { + 'api': { + 'suites': [ + 'apiAuth', + 'apiAuthOcs', + 'apiAuthWebDav', + # and so on... + ], + 'replaceUsernames': True, + }, +}, +---- + +When the acceptance tests are run, the user names and attributes will be replaced. === Displaying the ownCloud Log