############################################################################ # # 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") import re # test search in help mode and advanced search searchKeywordDictionary={ "deployment":True, "deplmint":False, "build":True, "bld":False } def __getSelectedText__(): hv = getHelpViewer() try: selText = hv.selectedText if className(selText) != 'instancemethod': return str(selText) except: pass try: selText = getHighlightsInHtml(str(hv.toHtml())) except: test.warning("Could not get highlighted text.") selText = '' return str(selText) def __getUrl__(): helpViewer = getHelpViewer() try: url = helpViewer.url except: try: url = helpViewer.source except: return "" return str(url.scheme) + "://" + str(url.host) + str(url.path) def getHighlightsInHtml(htmlCode): pattern = re.compile('color:#ff0000;">(.*?)') res = "" for curr in pattern.finditer(htmlCode): if curr.group(1) in res: continue res += "%s " % curr.group(1) return res def verifySelection(expected): selText = str(__getSelectedText__()) if test.verify(selText, "Verify that there is a selection"): # verify if search keyword is found in results test.verify(expected.lower() in selText.lower(), "'%s' search result can be found" % expected) def main(): global sdkPath noMatch = "Your search did not match any documents." startApplication("qtcreator" + SettingsPath) if not startedWithoutPluginError(): return addHelpDocumentation([os.path.join(sdkPath, "Documentation", "qt.qch")]) # switch to help mode switchViewTo(ViewConstants.HELP) # verify that search widget is accessible mouseClick(waitForObjectItem(":Qt Creator_Core::Internal::CommandComboBox", "Search")) test.verify(checkIfObjectExists("{type='QHelpSearchQueryWidget' unnamed='1' visible='1' " "window=':Qt Creator_Core::Internal::MainWindow'}"), "Verifying search widget visibility.") # try to search empty string clickButton(waitForObject("{text='Search' type='QPushButton' unnamed='1' visible='1' " "window=':Qt Creator_Core::Internal::MainWindow'}")) progressBarWait(600000) test.verify(waitFor("noMatch in " "str(waitForObject(':Hits_QCLuceneResultWidget').plainText)", 2000), "Verifying if search did not match anything.") # workaround for "endless waiting cursor" mouseClick(waitForObject("{column='0' container=':Qt Creator_QHelpContentWidget' " "text='Qt Reference Documentation' type='QModelIndex'}")) # try to search keyword from list searchLineEdit = getChildByClass(waitForObject("{type='QHelpSearchQueryWidget' unnamed='1' visible='1' " "window=':Qt Creator_Core::Internal::MainWindow'}"), "QLineEdit") for searchKeyword,shouldFind in searchKeywordDictionary.items(): mouseClick(searchLineEdit) replaceEditorContent(searchLineEdit, searchKeyword) type(searchLineEdit, "") progressBarWait(warn=False) if shouldFind: test.verify(waitFor("re.match('[1-9]\d* - [1-9]\d* of [1-9]\d* Hits'," "str(findObject(':Hits_QLabel').text))", 2000), "Verifying if search results found with 1+ hits for: " + searchKeyword) selText = __getSelectedText__() url = __getUrl__() # click in the widget, tab to first item and press enter mouseClick(waitForObject(":Hits_QCLuceneResultWidget"), 1, 1, 0, Qt.LeftButton) type(waitForObject(":Hits_QCLuceneResultWidget"), "") type(waitForObject(":Hits_QCLuceneResultWidget"), "") waitFor("__getUrl__() != url or selText != __getSelectedText__()", 20000) verifySelection(searchKeyword) else: test.verify(waitFor("noMatch in " "str(waitForObject(':Hits_QCLuceneResultWidget').plainText)", 1000), "Verifying if search did not match anything for: " + searchKeyword) # advanced search - setup clickButton(waitForObject("{text='+' type='QToolButton' unnamed='1' visible='1' " "window=':Qt Creator_Core::Internal::MainWindow'}")) label = ("{text='%s' type='QLabel' unnamed='1' visible='1' " "window=':Qt Creator_Core::Internal::MainWindow'}") lineEdit = ("{leftWidget=%s type='QLineEdit' unnamed='1' visible='1' " "window=':Qt Creator_Core::Internal::MainWindow'}") labelTextsToSearchStr = {"words similar to:":"deploy", "without the words:":"bookmark", "with exact phrase:":"sql in qt", "with all of the words:":"designer sql", "with at least one of the words:":"printing"} for labelText,searchStr in labelTextsToSearchStr.items(): type(waitForObject(lineEdit % (label % labelText)), searchStr) # advanced search - do search clickButton(waitForObject("{text='Search' type='QPushButton' unnamed='1' visible='1' " "window=':Qt Creator_Core::Internal::MainWindow'}")) progressBarWait(warn=False) # verify that advanced search results found test.verify(waitFor("re.search('1 - 2 of 2 Hits'," "str(findObject(':Hits_QLabel').text))", 3000), "Verifying if 2 search results found") resultsView = waitForObject(":Hits_QCLuceneResultWidget") mouseClick(resultsView, 1, 1, 0, Qt.LeftButton) type(resultsView, "") type(resultsView, "") verifySelection("printing") for i in range(2): type(resultsView, "") type(resultsView, "") verifySelection("sql") # verify if simple search is properly disabled test.verify(not searchLineEdit.enabled, "Verifying if simple search is not active in advanced mode.") # exit invokeMenuItem("File", "Exit")