summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMitch Curtis <mitch.curtis@qt.io>2020-09-02 14:37:20 +0200
committerQt Cherry-pick Bot <cherrypick_bot@qt-project.org>2020-09-11 07:48:28 +0000
commit7a7996beb54fe077ac8767a4b46481031a07609f (patch)
tree3d651176f195caf47ff819bb510632fdd240bc0a
parent80c3d4a20ad63ed8a3dacccd7fdd2fe534370174 (diff)
Doc: explain how to blacklist QML tests on certain platforms
Change-Id: Icd505175805820c64593d7eb8f580a51008e2e1a Reviewed-by: Daniel Smith <Daniel.Smith@qt.io> (cherry picked from commit a4e4436e852c600a7ecd13b83fc487164dbc5ad7) Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-rw-r--r--src/testlib/qtestblacklist.cpp22
1 files changed, 20 insertions, 2 deletions
diff --git a/src/testlib/qtestblacklist.cpp b/src/testlib/qtestblacklist.cpp
index ae2913da9a..04e74f43bf 100644
--- a/src/testlib/qtestblacklist.cpp
+++ b/src/testlib/qtestblacklist.cpp
@@ -87,9 +87,27 @@ QT_BEGIN_NAMESPACE
[testfunction2:testData]
msvc-2010
+ QML test functions are identified using the following format:
+
+ <TestCase name>::<function name>:<data tag>
+
+ For example, to blacklist a QML test on RHEL 7.6:
+
+ # QTBUG-12345
+ [Button::test_display:TextOnly]
+ ci rhel-7.6
+
Keys are lower-case. Distribution name and version are supported if
- QSysInfo's productType() and productVersion() return them. Keys can be
- added via the space-separated QTEST_ENVIRONMENT environment variable.
+ QSysInfo's productType() and productVersion() return them.
+
+ Keys can be added via the space-separated QTEST_ENVIRONMENT
+ environment variable:
+
+ QTEST_ENVIRONMENT=ci ./tst_stuff
+
+ This can be used to "mock" a test environment. In the example above,
+ we add "ci" to the list of keys for the test environment, making it
+ possible to test BLACKLIST files that blacklist tests in a CI environment.
The other known keys are listed below:
*/