summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMitch Curtis <mitch.curtis@qt.io>2020-09-02 14:37:20 +0200
committerMitch Curtis <mitch.curtis@qt.io>2020-09-10 17:32:34 +0200
commita4e4436e852c600a7ecd13b83fc487164dbc5ad7 (patch)
treea40e6c0ba8b8d141aac9ed99a071292b2015b1c3
parent4f658d04da03953358959c0a0921e564cf67ecb2 (diff)
Doc: explain how to blacklist QML tests on certain platforms
Change-Id: Icd505175805820c64593d7eb8f580a51008e2e1a Pick-to: 5.15 5.12 Reviewed-by: Daniel Smith <Daniel.Smith@qt.io>
-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 6695605f12..b9d174bbe0 100644
--- a/src/testlib/qtestblacklist.cpp
+++ b/src/testlib/qtestblacklist.cpp
@@ -88,9 +88,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:
*/