1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
############################################################################
#
# Copyright (C) 2016 The Qt Company Ltd.
# Contact: https://www.qt.io/licensing/
#
# This file is part of Qt Creator.
#
# 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 General Public License Usage
# Alternatively, this file may be used under the terms of the GNU
# General Public License version 3 as published by the Free Software
# Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT
# included in the packaging of this file. Please review the following
# information to ensure the GNU General Public License requirements will
# be met: https://www.gnu.org/licenses/gpl-3.0.html.
#
############################################################################
source("../../shared/qtcreator.py")
getStarted = 'Get Started'
def clickItemVerifyHelpCombo(button, expectedHelpComboRegex, testDetails):
global getStarted
mouseClick(button)
helpCombo = waitForObject(":Qt Creator_HelpSelector_QComboBox")
if not test.verify(waitFor('re.match(expectedHelpComboRegex, str(helpCombo.currentText))',
5000), testDetails):
test.log("Found %s" % str(helpCombo.currentText))
# select "Welcome" page from left toolbar again
switchViewTo(ViewConstants.WELCOME)
wsButtonFrame, wsButtonLabel = getWelcomeScreenSideBarButton(getStarted)
return test.verify(all((wsButtonFrame, wsButtonLabel)),
"Verifying: '%s' button is being displayed." % getStarted)
def buttonActive(button):
# colors of the default theme for active button on Welcome page
(activeRed, activeGreen, activeBlue) = (69, 206, 85)
# QPalette::Window (used background color of Welcome page buttons)
enumQPaletteWindow = 10
color = button.palette.color(enumQPaletteWindow)
return color.red == activeRed and color.green == activeGreen and color.blue == activeBlue
def waitForButtonsState(projectsActive, examplesActive, tutorialsActive, timeout=5000):
projButton = getWelcomeScreenSideBarButton('Projects')[0]
exmpButton = getWelcomeScreenSideBarButton('Examples')[0]
tutoButton = getWelcomeScreenSideBarButton('Tutorials')[0]
if not all((projButton, exmpButton, tutoButton)):
return False
return waitFor('buttonActive(projButton) == projectsActive '
'and buttonActive(exmpButton) == examplesActive '
'and buttonActive(tutoButton) == tutorialsActive', timeout)
def checkTableViewForContent(tableViewStr, expectedRegExTitle, section, atLeastOneText):
try:
tableView = findObject(tableViewStr) # waitForObject does not work - visible is 0?
model = tableView.model()
children = [ch for ch in object.children(tableView) if className(ch) == 'QModelIndex']
for child in children:
match = re.match(expectedRegExTitle, str(model.data(child).toString()))
if match:
test.passes(atLeastOneText, "Found '%s'" % match.group())
return
test.fail("No %s are displayed on Welcome page (%s)" % (section.lower(), section))
except:
test.fail("Failed to get tableview to check content of Welcome page (%s)" % section)
def main():
global getStarted
# open Qt Creator
startQC()
if not startedWithoutPluginError():
return
setFixedHelpViewer(HelpViewer.HELPMODE)
addCurrentCreatorDocumentation()
buttonsAndState = {'Projects':False, 'Examples':True, 'Tutorials':False}
for button, state in buttonsAndState.items():
wsButtonFrame, wsButtonLabel = getWelcomeScreenSideBarButton(button)
if test.verify(all((wsButtonFrame, wsButtonLabel)),
"Verified whether '%s' button is shown." % button):
test.compare(buttonActive(wsButtonFrame), state,
"Verifying whether '%s' button is active (%s)." % (button, state))
# select Projects and roughly check this
switchToSubMode('Projects')
for button in ['Create Project...', 'Open Project...']:
wsButtonFrame, wsButtonLabel = getWelcomeScreenSideBarButton(button)
if test.verify(all((wsButtonFrame, wsButtonLabel)),
"Verified whether '%s' button is shown." % button):
test.verify(not buttonActive(wsButtonFrame),
"Verifying whether '%s' button is inactive." % button)
wsButtonFrame, wsButtonLabel = getWelcomeScreenSideBarButton(getStarted)
if test.verify(all((wsButtonFrame, wsButtonLabel)),
"Verifying: Qt Creator displays Welcome Page with '%s' button." % getStarted):
if clickItemVerifyHelpCombo(wsButtonLabel, "Getting Started | Qt Creator Manual",
"Verifying: Help with Creator Documentation is being opened."):
textUrls = {'Online Community':'https://forum.qt.io',
'Blogs':'https://planet.qt.io',
'Qt Account':'https://account.qt.io',
'User Guide':'qthelp://org.qt-project.qtcreator/doc/index.html'
}
for text, url in textUrls.items():
button, label = getWelcomeScreenBottomButton(text)
if test.verify(all((button, label)),
"Verifying whether link button (%s) exists." % text):
test.compare(str(button.toolTip), url, "Verifying URL for %s" % text)
wsButtonFrame, wsButtonLabel = getWelcomeScreenSideBarButton(getStarted)
if wsButtonLabel is not None:
mouseClick(wsButtonLabel)
qcManualQModelIndexStr = getQModelIndexStr("text~='Qt Creator Manual [0-9.]+'",
":Qt Creator_QHelpContentWidget")
if str(waitForObject(":Qt Creator_HelpSelector_QComboBox").currentText) == "(Untitled)":
mouseClick(qcManualQModelIndexStr)
test.warning("Clicking '%s' the second time showed blank page (Untitled)" % getStarted)
else:
test.fatal("Something's wrong - failed to find/click '%s' the second time." % getStarted)
# select "Welcome" page from left toolbar again
switchViewTo(ViewConstants.WELCOME)
wsButtonFrame, wsButtonLabel = getWelcomeScreenSideBarButton(getStarted)
test.verify(wsButtonFrame is not None and wsButtonLabel is not None,
"Verifying: Getting Started topic is being displayed.")
# select Examples and roughly check them
switchToSubMode('Examples')
test.verify(waitForButtonsState(False, True, False), "Buttons' states have changed.")
expect = (("QListView", "unnamed='1' visible='1' window=':Qt Creator_Core::Internal::MainWindow'",
"examples list"),
("QLineEdit", "placeholderText='Search in Examples...'", "examples search line edit"),
("QComboBox", "currentText~='.*Qt.*'", "Qt version combo box"))
search = "{type='%s' %s}"
for (qType, prop, info) in expect:
test.verify(checkIfObjectExists(search % (qType, prop)),
"Verifying whether %s is shown" % info)
checkTableViewForContent(search % (expect[0][0], expect[0][1]), ".*Example", "Examples",
"Verifying that at least one example is displayed.")
# select Tutorials and roughly check them
switchToSubMode('Tutorials')
test.verify(waitForButtonsState(False, False, True), "Buttons' states have changed.")
expect = (("QListView", "unnamed='1' visible='1' window=':Qt Creator_Core::Internal::MainWindow'",
"tutorials list"),
("QLineEdit", "placeholderText='Search in Tutorials...'",
"tutorials search line edit"))
for (qType, prop, info) in expect:
test.verify(checkIfObjectExists(search % (qType, prop)),
"Verifying whether %s is shown" % info)
checkTableViewForContent(search % (expect[0][0], expect[0][1]), "Help: Creating .*", "Tutorials",
"Verifying that at least one tutorial is displayed.")
# exit Qt Creator
invokeMenuItem("File", "Exit")
|
