Introduce the autotest module

This module allows different autotests to run in different ways, for
instance with a custom working directory.

[ChangeLog] Introduced the autotest module

Change-Id: I8e0438f0a9fb1d9103bbd3cc0d2b6d46c244def6
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>

2 files changed, 73 insertions, 0 deletions

diff --git a/doc/reference/items/convenience/autotestrunner.qdoc b/doc/reference/items/convenience/autotestrunner.qdoc
index f471d4bea..3ec58e456 100644
--- a/doc/reference/items/convenience/autotestrunner.qdoc
+++ b/doc/reference/items/convenience/autotestrunner.qdoc
@@ -73,6 +73,8 @@
     \qmlproperty stringList AutotestRunner::arguments
 
     The list of arguments to invoke the autotest with.
+    A test can override this by setting the \l{autotest::arguments}{arguments} property
+    of the \l autotest module.
 
     \defaultvalue \c []
 */
@@ -114,6 +116,8 @@
 
     If this property is set, it will be the working directory for all invoked test executables.
     Otherwise, the working directory will the the parent directory of the respective executable.
+    A test can override this by setting the \l{autotest::workingDir}{workingDir} property
+    of the \l autotest module.
 
     \nodefaultvalue
     \since Qbs 1.12
diff --git a/doc/reference/modules/autotest-module.qdoc b/doc/reference/modules/autotest-module.qdoc
new file mode 100644
index 000000000..ddd9e0078
--- /dev/null
+++ b/doc/reference/modules/autotest-module.qdoc
@@ -0,0 +1,69 @@
+/****************************************************************************
+**
+** Copyright (C) 2018 The Qt Company Ltd.
+** Contact: https://www.qt.io/licensing/
+**
+** This file is part of Qbs.
+**
+** $QT_BEGIN_LICENSE:FDL$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and The Qt Company. For licensing terms
+** and conditions see https://www.qt.io/terms-conditions. For further
+** information use the contact form at https://www.qt.io/contact-us.
+**
+** GNU Free Documentation License Usage
+** Alternatively, this file may be used under the terms of the GNU Free
+** Documentation License version 1.3 as published by the Free Software
+** Foundation and appearing in the file included in the packaging of
+** this file. Please review the following information to ensure
+** the GNU Free Documentation License version 1.3 requirements
+** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+    \contentspage index.html
+    \qmltype autotest
+    \inqmlmodule QbsModules
+    \since Qbs 1.13
+
+    \brief Allows to fine-tune autotest execution.
+
+    The \c autotest module provides properties that allow autotest applications to specify
+    how exactly they should be run.
+*/
+
+/*!
+    \qmlproperty bool autotest::allowFailure
+
+    Autotests for which this property is \c true can return a non-zero exit code without
+    causing the entire \l AutotestRunner to fail. Use this for tests that are known
+    to be unreliable.
+
+    \defaultvalue \c false
+*/
+
+/*!
+    \qmlproperty stringList autotest::arguments
+
+    The list of arguments to invoke the autotest with. If not specified, then
+    the \l{AutotestRunner::arguments}{arguments} property of the
+    \l AutotestRunner that invokes the autotest is used.
+
+    \nodefaultvalue
+*/
+
+/*!
+    \qmlproperty string autotest::workingDir
+
+    The working directory for running the autotest. If not specified, then
+    the \l{AutotestRunner::workingDir}{workingDir} property of the
+    \l AutotestRunner that invokes the autotest is used.
+
+    \nodefaultvalue
+*/
+