From 1ffe68484f7ef53b0ff1032f51129b815ce00136 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ren=C3=A9=20Pfeuffer?= Date: Fri, 7 Aug 2020 20:54:23 +0200 Subject: [PATCH] Add documentation for integration tests --- docs/en/development/integration-tests.md | 24 ++++++++++++++++++++++++ docs/en/navigation.yml | 1 + 2 files changed, 25 insertions(+) create mode 100644 docs/en/development/integration-tests.md diff --git a/docs/en/development/integration-tests.md b/docs/en/development/integration-tests.md new file mode 100644 index 0000000000..4b9589acfe --- /dev/null +++ b/docs/en/development/integration-tests.md @@ -0,0 +1,24 @@ +--- +title: Integration Tests +subtitle: How to run integration tests +displayToc: false +--- + +You can find the integration tests in the module **scm-it** (and a few still in **scm-webapp**). To run them, +simply start maven with the profile `it`: + +``` +mvn install -Pit -DskipUnitTests -pl :scm-webapp,:scm-it +``` + +This will start a jetty server and execute all integration tests in the maven phase `integration-test` using the +normal failsafe plugin. Integration tests are all classes ending with `ITCase` and are written using JUnit. + +To develop integration tests, you should start a local server with the **scm-integration-test-plugin**. This plugin is +used as a way to introspect server internals. For example you can register event listeners here and access their +triggers with a REST endpoint. Of course, this plugin is not and should not be installed in productive systems. +You can start the server with this plugin using the following maven call: + +``` +mvn run -pl :scm-integration-test-plugin +``` diff --git a/docs/en/navigation.yml b/docs/en/navigation.yml index 9c30b03156..3d5b6518a8 100644 --- a/docs/en/navigation.yml +++ b/docs/en/navigation.yml @@ -31,6 +31,7 @@ - /development/definition-of-done/ - /development/ui-dod/ - /development/decision-table/ + - /development/integration-tests/ - section: Plugin Development entries: