summaryrefslogtreecommitdiff
path: root/tests/auto
diff options
context:
space:
mode:
authorCaroline Chao <caroline.chao@digia.com>2013-05-27 11:31:18 +0200
committerThe Qt Project <gerrit-noreply@qt-project.org>2013-05-27 16:02:55 +0200
commitd3e9b0e8e0ee822e02e3e89d4e890de4ed0ffcd4 (patch)
tree8b70e61aae1086aa4d68697fc334cc713552701b /tests/auto
parent89b6c336f1670a24bdc9ffbea8ad236b8148176d (diff)
downloadqtquickcontrols-d3e9b0e8e0ee822e02e3e89d4e890de4ed0ffcd4.tar.gz
Autotest: Move the README file to the tests/auto folder
So it is more visible. Add some tips if user needs to run the autotests. Change-Id: I86739a06b1cd62a061aec20fb640f7c66cfc557c Reviewed-by: Liang Qi <liang.qi@digia.com>
Diffstat (limited to 'tests/auto')
-rw-r--r--tests/auto/README.txt38
-rw-r--r--tests/auto/testplugin/README.txt11
2 files changed, 38 insertions, 11 deletions
diff --git a/tests/auto/README.txt b/tests/auto/README.txt
new file mode 100644
index 00000000..948242f0
--- /dev/null
+++ b/tests/auto/README.txt
@@ -0,0 +1,38 @@
+
+Here are some tips if you need to run the Qt Quick Controls auto tests.
+
+ - Testplugin
+
+Some autotests require the test plugin under testplugin/QtQuickControlsTests.
+
+The test plugin is not installed (i.e. to the qml folder), so
+in order for the tst_controls to find it, you can either:
+
+- Run make check in the controls folder. The plugin will be found
+at run time because IMPORTPATH is defined in the pro file.
+
+- In Qt Creator run settings or in the console, set QML2_IMPORT_PATH
+macro to the testplugin path. At run time QML2_IMPORT_PATH is used by
+by qmlscene to find imports required.
+i.e: export QML2_IMPORT_PATH=<path_qtquickcontrols_git_clone>/tests/auto/testplugin
+
+- Use the -import command-line option:
+$ cd build/qt5/qtquickcontrols/tests/auto/controls
+$ ./tst_controls -import ../testplugin
+
+ - Running specific tests:
+
+i) It is possible to run a single file using the -input option. For example:
+
+$ ./tst_controls -input data/test.qml
+
+$ ./tst_controls -input <full_path>/test.qml
+
+Specifying the full path to the qml test file is for example needed for shadow builds.
+
+
+ii) The -functions command-line option will return a list of the current tests functions.
+It is possible to run a single test function using the name of the test function as an argument. For example:
+
+tst_controls Test_Name::function1
+
diff --git a/tests/auto/testplugin/README.txt b/tests/auto/testplugin/README.txt
deleted file mode 100644
index c22837db..00000000
--- a/tests/auto/testplugin/README.txt
+++ /dev/null
@@ -1,11 +0,0 @@
-
-The test plugin is not installed (i.e. to the qml folder).
-In order for the tst_controls to find it, you can either:
-
-- Run make check in the controls folder. The plugin will be found
-at run time because IMPORTPATH is defined in the pro file.
-
-- In Qt Creator run settings or in the console, set QML2_IMPORT_PATH
-macro to the testplugin path. At run time QML2_IMPORT_PATH is used by
-by qmlscene to find imports required.
-i.e: export QML2_IMPORT_PATH=<path_qtquickcontrols_git_clone>/tests/auto/testplugin