summaryrefslogtreecommitdiffstats
path: root/src/testlib
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-10 21:10:27 +0000
commita664f4fc0e24994f2b722d666284af5a2b117667 (patch)
tree0637bdc50ab9b82a0a123697b2a7711bb3572bc9 /src/testlib
parentfebce79f346d02cb0619e185e61ecd5c13a0edd5 (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>
Diffstat (limited to 'src/testlib')
-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 f9ccde0280..ac4793eebf 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:
*/