diff options
author | marian.vaclavik@telekom.com <marian.vaclavik@telekom.com> | 2023-07-31 10:59:39 +0200 |
---|---|---|
committer | marian.vaclavik@telekom.com <marian.vaclavik@telekom.com> | 2023-08-08 09:50:35 +0200 |
commit | 1c4023ccc06e633233ed642eb9d1ac85e82feaf0 (patch) | |
tree | d1b42076f13075d4bc7255120a5934f753774559 /README.md | |
parent | c38f1100b43a48a9f86bc50c2e560ae94d15956a (diff) |
Issue-ID: PORTALNG-35
Change-Id: I606b3f265dfdb98d7eb9cfd8ab021e2895ee5152
Signed-off-by: marian.vaclavik@telekom.com <marian.vaclavik@telekom.com>
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..e81a777 --- /dev/null +++ b/README.md @@ -0,0 +1,60 @@ +# portal-ng end-to-end ui tests +This project contains portal-ng edition end-to-end UI tests. + +This project is using Java, Cucumber, Selenide and Allure. + +## Run tests +If you want to test a remote instance of the Portal, change the $PORTAL_ENV variable: +`export PORTAL_ENV=test-remote.properties` + +or provide the base url in an environment variable PORTAL_BASE_URL=https://external-host.org + +`export PORTAL_BASE_URL=https://external-host.org` + +Then adjust the properties file as needed. + + +By default `test-local.properties` is used. + +### In Chrome +To run the tests with Chrome from gradle wrapper: +```shell +./gradlew cucumber +``` +or with +```shell +./gradlew clean cucumber +``` +### In headless mode +There's also a task for running in a headless mode (used in pipelines): +```shell +./gradlew cucumberCli +``` +## Local development + +If you want to run a single scenario for debugging while developing any of the tests or creating a new one, you can do so. + +First you have to specify a `@debug` tag in any of the `.feature` files adding the `@debug` tag above the line `Scenario:` +and then you can run the task to only run this scenario: + +```shell +./gradlew cucumberLocalDebug +``` + +You can also add `@debug` to more scenarios to be executed within the project and run the task above again. + +This will also work in IntelliJ Idea when you create a gradle configuration, so you can easily run tests that you are currently developing. + +Don't forget to add `PORTAL_ENV=test-local.properties` as an environment variable in your IntelliJ configuration. + +## Test Reports + +To generate allure reports on MAC +you must install allure via **brew** and then: + +```shell +allure generate --clean +``` + +the report will appear: +`./allure-report/index.html` |