This is an automated email from the ASF dual-hosted git repository.
hansva pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-hop-docs.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 1beb2a1 HOP-2122: add integration test docs
new da14e32 Merge pull request #19 from hansva/asf-site
1beb2a1 is described below
commit 1beb2a14ee31bdc85eda0fdcad90f8590589c414
Author: Hans Van Akelyen <[email protected]>
AuthorDate: Mon Dec 7 15:42:08 2020 +0100
HOP-2122: add integration test docs
---
.../modules/ROOT/pages/integration-testing.adoc | 25 ++++++++++++++++++++++
1 file changed, 25 insertions(+)
diff --git a/hop-dev-manual/modules/ROOT/pages/integration-testing.adoc
b/hop-dev-manual/modules/ROOT/pages/integration-testing.adoc
new file mode 100644
index 0000000..876d655
--- /dev/null
+++ b/hop-dev-manual/modules/ROOT/pages/integration-testing.adoc
@@ -0,0 +1,25 @@
+[[integration-testing]]
+= Integration Testing
+
+The Apache Hop team has created an integration testing framework that is being
used to test key components of the software.
+The integration tests run as a daily build on Jenkins and can be found
https://ci-builds.apache.org/job/Hop/job/Hop-integration-tests/[here].
+
+== Current Limitations
+
+* Only workflows are supported
+* No external sources to test against (no databases or other services
available)
+* Only local engines will work (including the Apache Beam Direct Runners)
+* No extra parameters can be provided to hop-run see
https://issues.apache.org/jira/browse/HOP-2271[HOP-2271]
+* No true negative test can be created see
https://issues.apache.org/jira/browse/HOP-2272[HOP-2272]
+
+
+== Adding a test
+
+The tests are stored in the source code repository and can be found in the
https://github.com/apache/incubator-hop/tree/master/integration-tests[integration-tests]
folder.
+Each folder represents an integration test that will be executed daily using
the master branch version of the software.
+
+Each folder contains a Hop project and all metadata needed for that project,
they are dynamically loaded and the `main.hwf` is executed using the `local`
workflow engine.
+
+Adding a test is as simple as creating a new project that contains a
`main.hwf` in the root folder and all test files should be self contained in
the project folder.
+Please give each folder a HOP issue number or a self explaining foldername as
this name is used for the test report in Jenkins.
+
