Merge lp:~hiroshidi/ubuntu-terminal-app/autopilot-tests-panels into lp:ubuntu-terminal-app

[Dmitry Zagnoyko]

add autopilot test for panels and the circle menu
add ubuntusdk emu from lp:~nskaggs/+junk/ubuntusdk_autopilot_emulator

Added Autopilot Testcase for:
- Control keys panel - LP: #1188835
- Function keys panel - LP: #1188836
- Text control panel - LP: #1188837
- Circle-menu - LP: #1188838

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

PASSED: Continuous integration, rev:16
http://91.189.93.125:8080/job/ubuntu-terminal-app-ci/5/
Executed test runs:
    SUCCESS: http://91.189.93.125:8080/job/ubuntu-terminal-app-quantal-amd64-ci/4
    SUCCESS: http://91.189.93.125:8080/job/ubuntu-terminal-app-raring-amd64-ci/5

Click here to trigger a rebuild:
http://91.189.93.125:8080/job/ubuntu-terminal-app-ci/5/rebuild

review: Approve (continuous-integration)

[Nicholas Skaggs (nskaggs)]

Looks good Dmitry! Can you incorporate the emulator WIP for this? lp:~nskaggs/+junk/ubuntusdk_autopilot_emulator. We're going to continue to iterate on this to have many of the common functions (like tab switching, toolbar access, etc) and we want to be able to keep tests up to date on best practices as they continue to evolve :-)

That said, this is otherwise a nice basic testcase -- good base to build on.

review: Needs Fixing

[lp:~hiroshidi/ubuntu-terminal-app/autopilot-tests-panels]

17. By Dmitry Zagnoyko on 2013-06-19

Merged ubuntusdk autopilot testcase emulator. Merged branch: lp:~nskaggs/+junk/ubuntusdk_autopilot_emulator

[Ubuntu Phone Apps Jenkins Bot (ubuntu-phone-apps-jenkins-bot)]

PASSED: Continuous integration, rev:17
http://91.189.93.125:8080/job/ubuntu-terminal-app-ci/6/
Executed test runs:
    SUCCESS: http://91.189.93.125:8080/job/ubuntu-terminal-app-quantal-amd64-ci/5
    SUCCESS: http://91.189.93.125:8080/job/ubuntu-terminal-app-raring-amd64-ci/6

Click here to trigger a rebuild:
http://91.189.93.125:8080/job/ubuntu-terminal-app-ci/6/rebuild

review: Approve (continuous-integration)

[Nicholas Skaggs (nskaggs)]

Let's push this in. I need to add the popover function to the sdk somehow.. work for me to gt right :-) Thanks Dmitry!

review: Approve

=== modified file 'Terminal.qml'
--- Terminal.qml	2013-05-24 16:18:10 +0000
+++ Terminal.qml	2013-06-19 18:58:26 +0000
@@ -82,6 +82,7 @@
 
         CtrlKeys {
             id: kbCtrl
+            objectName: "kbCtrl"
             visible: false
             width: parent.width
             anchors{
@@ -97,6 +98,7 @@
 
         FnKeys {
             id: kbFn
+            objectName: "kbFn"
             visible: false
             width: parent.width
             anchors{
@@ -113,6 +115,7 @@
 
         ScrlKeys {
             id: kbScrl
+            objectName: "kbScrl"
             visible: false
             width: parent.width
             anchors{
@@ -141,6 +144,7 @@
 
                 CircleMenu {
                     id: cmenu
+                    objectName: "cmenu"
                     z: 99
                     visible: false
                     anchors.centerIn: parent
@@ -181,6 +185,7 @@
 
                 KTerminal {
                     id: kterm
+                    objectName: "kterm"
 
                     //////////////////////////////////////
                     /// FONT SIZE = 24 (FINE FOR GNEXUS)
@@ -195,6 +200,7 @@
 
                     session: KSession {
                         id: ksession
+                        objectName: "ksession"
                         kbScheme: "linux"
                     }
                 }
 
=== modified file 'tests/autopilot/ubuntu_terminal_app/emulators/main_window.py'
--- tests/autopilot/ubuntu_terminal_app/emulators/main_window.py	2013-05-31 13:10:55 +0000
+++ tests/autopilot/ubuntu_terminal_app/emulators/main_window.py	2013-06-19 18:58:26 +0000
@@ -7,18 +7,21 @@
 
 """Terminal app autopilot emulators."""
 
-
 class MainWindow(object):
     """An emulator class that makes it easy to interact with the
-    terminal-app.
-
-    """
-    def __init__(self, app):
+    terminal-app."""
+    def __init__(self, autopilot, app):
         self.app = app
-
-    def get_qml_view(self):
-        """Get the main QML view"""
-        return self.app.select_single("QQuickView")
-
-    def get_toolbar(self):
-        return self.app.select_single("Toolbar")
+        self.autopilot = autopilot
+
+    def click_popup_item(self, popupLable):
+        """Clicks the toolbar popup item with popupLable"""
+        li  = self.app.select_single("ActionSelectionPopover")
+        row = li.select_single("QQuickColumn")
+        loaderList = row.select_many("QQuickLoader")
+        for loader in loaderList:
+            labelList = loader.select_many("Label")
+            for label in labelList:
+                if label.text == popupLable:
+                    self.autopilot.pointing_device.click_object(label)
+
 
=== added file 'tests/autopilot/ubuntu_terminal_app/emulators/ubuntusdk.py'
--- tests/autopilot/ubuntu_terminal_app/emulators/ubuntusdk.py	1970-01-01 00:00:00 +0000
+++ tests/autopilot/ubuntu_terminal_app/emulators/ubuntusdk.py	2013-06-19 18:58:26 +0000
@@ -0,0 +1,154 @@
+# -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
+#
+# Copyright (C) 2013 Canonical Ltd
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# Authored by: Nicholas Skaggs <[e-mail]>
+
+from testtools.matchers import Equals, NotEquals, Not, Is
+from autopilot.matchers import Eventually
+
+class ubuntusdk(object):
+    """An emulator class that makes it easy to interact with the ubuntu sdk applications."""
+
+    def __init__(self, autopilot, app):
+        self.app = app
+        self.autopilot = autopilot
+
+    def get_qml_view(self):
+        """Get the main QML view"""
+        return self.app.select_single("QQuickView")
+
+    def get_object(self, typeName, name):
+        """Get a specific object"""
+        return self.app.select_single(typeName, objectName=name)
+
+    def get_objects(self, typeName, name):
+        """Get more than one object"""
+        return self.app.select_many(typeName, objectName=name)
+
+    def switch_to_tab(self, tab):
+        """Switch to the specified tab number"""
+        tabs = self.get_tabs()
+        currentTab = tabs.selectedTabIndex
+
+        #perform operations until tab == currentTab
+        while tab != currentTab:
+            if tab > currentTab:
+                self._previous_tab()
+            if tab < currentTab:
+                self._next_tab()
+            currentTab = tabs.selectedTabIndex
+
+    def toggle_toolbar(self):
+        """Toggle the toolbar between revealed and hidden"""
+        #check and see if the toolbar is open or not
+        if self.get_toolbar().opened:
+            self.hide_toolbar()
+        else:
+            self.open_toolbar()
+
+    def get_toolbar(self):
+        """Returns the toolbar in the main events view."""
+        return self.app.select_single("Toolbar")
+
+    def get_toolbar_button(self, buttonLabel):
+        """Returns the toolbar button at position index"""
+        toolbar = self.get_toolbar()
+        if not toolbar.opened:
+            self.open_toolbar()
+        row = toolbar.select_single("QQuickRow")
+        loaderList = row.select_many("QQuickLoader")
+        for loader in loaderList:
+            buttonList = loader.select_many("Button")
+            for button in buttonList:
+                if button.text == buttonLabel:
+                    return button
+
+    def click_toolbar_button(self, buttonLabel):
+        """Clicks the toolbar button with buttonLabel"""
+        #The toolbar button is assumed to be the following format
+        #ToolbarActions {
+        #           Action {
+        #               objectName: "name"
+        #                text: value
+        button = self.get_toolbar_button(buttonLabel)
+        self.autopilot.pointing_device.click_object(button)
+
+    def open_toolbar(self):
+        """Open the toolbar"""
+        qmlView = self.get_qml_view()
+
+        lineX = qmlView.x + qmlView.width * 0.50
+        startY = qmlView.y + qmlView.height - 1
+        stopY = qmlView.y + qmlView.height * 0.95
+
+        self.autopilot.pointing_device.drag(lineX, startY, lineX, stopY)
+
+    def hide_toolbar(self):
+        """Hide the toolbar"""
+        qmlView = self.get_qml_view()
+
+        lineX = qmlView.x + qmlView.width * 0.50
+        startY = qmlView.y + qmlView.height * 0.95
+        stopY = qmlView.y + qmlView.height - 1
+
+        self.autopilot.pointing_device.drag(lineX, startY, lineX, stopY)
+
+    def set_popup_value(self, popover, button, value):
+        """Changes the given popover selector to the request value
+        At the moment this only works for values that are currently visible. To
+        access the remaining items, a help method to drag and recheck is needed."""
+        #The popover is assumed to be the following format
+        #    Popover {
+        #        Column {
+        #            ListView {
+        #                delegate: Standard {
+        #                    objectName: "name"
+        #                    text: value
+
+        self.autopilot.pointing_device.click_object(button)
+        #we'll get all matching objects, incase the popover is reused between buttons
+        itemList = lambda: self.get_objects("Standard", popover)
+
+        for item in itemList():
+            if item.get_properties()['text'] == value:
+                self.autopilot.pointing_device.click_object(item)
+
+    def get_tabs(self):
+        """Return all tabs"""
+        return self.get_object("Tabs", "rootTabs")
+
+    def _previous_tab(self):
+        """Switch to the previous tab"""
+        qmlView = self.get_qml_view()
+
+        startX = qmlView.x + qmlView.width * 0.35
+        stopX = qmlView.x + qmlView.width * 0.50
+        lineY = qmlView.y + qmlView.height * 0.05
+
+        self.autopilot.pointing_device.drag(startX, lineY, stopX, lineY)
+        self.autopilot.pointing_device.click()
+        self.autopilot.pointing_device.click()
+
+    def _next_tab(self):
+        """Switch to the next tab"""
+        qmlView = self.get_qml_view()
+
+        startX = qmlView.x + qmlView.width * 0.50
+        stopX = qmlView.x + qmlView.width * 0.35
+        lineY = qmlView.y + qmlView.height * 0.05
+
+        self.autopilot.pointing_device.drag(startX, lineY, stopX, lineY)
+        self.autopilot.pointing_device.click()
 
=== modified file 'tests/autopilot/ubuntu_terminal_app/tests/__init__.py'
--- tests/autopilot/ubuntu_terminal_app/tests/__init__.py	2013-05-31 13:10:55 +0000
+++ tests/autopilot/ubuntu_terminal_app/tests/__init__.py	2013-06-19 18:58:26 +0000
@@ -14,6 +14,7 @@
 from autopilot.testcase import AutopilotTestCase
 
 from ubuntu_terminal_app.emulators.main_window import MainWindow
+from ubuntu_terminal_app.emulators.ubuntusdk import ubuntusdk
 
 
 class TerminalTestCase(AutopilotTestCase):
@@ -52,4 +53,9 @@
 
     @property
     def main_window(self):
-        return MainWindow(self.app)
+        return MainWindow(self, self.app)
+        
+    @property
+    def ubuntu_sdk(self):
+        return ubuntusdk(self, self.app)
+        
 
=== modified file 'tests/autopilot/ubuntu_terminal_app/tests/test_terminal.py'
--- tests/autopilot/ubuntu_terminal_app/tests/test_terminal.py	2013-05-31 13:10:55 +0000
+++ tests/autopilot/ubuntu_terminal_app/tests/test_terminal.py	2013-06-19 18:58:26 +0000
@@ -14,25 +14,64 @@
 
 from ubuntu_terminal_app.tests import TerminalTestCase
 
+import time
 
 class TestMainWindow(TerminalTestCase):
 
     def setUp(self):
         super(TestMainWindow, self).setUp()
         self.assertThat(
-            self.main_window.get_qml_view().visible, Eventually(Equals(True)))
+            self.ubuntu_sdk.get_qml_view().visible, Eventually(Equals(True)))
 
     def tearDown(self):
         super(TestMainWindow, self).tearDown()
 
-    def test_toolbar_shows(self):
-        """Make sure that dragging from the bottom reveals the hidden
-        toolbar."""
-        toolbar = self.main_window.get_toolbar()
-
-        x, y, w, h = toolbar.globalRect
-        tx = x + (w / 2)
-        ty = y + (h - 2)
-
-        self.pointing_device.drag(tx, ty, tx, ty - h)
-        self.assertThat(toolbar.state, Eventually(Equals("spread")))
+    def test_Control_Panel_shows(self):
+        """Make sure that Control Keys Panel is visible
+        when clicking the toolbar popup items."""
+        self.ubuntu_sdk.click_toolbar_button("Panels")
+        self.main_window.click_popup_item("Control keys")
+        panelCtrl = self.ubuntu_sdk.get_object("CtrlKeys", "kbCtrl")
+        self.assertThat(panelCtrl.visible, Eventually(Equals(True)))
+        
+    def test_Function_Panel_shows(self):
+        """Make sure that Function Keys Panel is visible
+        when clicking the toolbar popup items."""
+        self.ubuntu_sdk.click_toolbar_button("Panels")
+        self.main_window.click_popup_item("Function keys")
+        panelFunc = self.ubuntu_sdk.get_object("FnKeys", "kbFn")
+        self.assertThat(panelFunc.visible, Eventually(Equals(True)))
+        
+    def test_TextCtrl_Panel_shows(self):
+        """Make sure that Text Control Keys Panel is visible
+        when clicking the toolbar popup items."""
+        self.ubuntu_sdk.click_toolbar_button("Panels")
+        self.main_window.click_popup_item("Text ctrl keys")
+        panelScrl = self.ubuntu_sdk.get_object("ScrlKeys", "kbScrl")
+        self.assertThat(panelScrl.visible, Eventually(Equals(True)))
+        
+    def test_Panels_hide(self):
+        """Make sure that all panels are hide
+        when clicking the toolbar popup items."""
+        self.ubuntu_sdk.click_toolbar_button("Panels")
+        self.main_window.click_popup_item("Hide extra panel")
+        panelCtrl = self.ubuntu_sdk.get_object("CtrlKeys", "kbCtrl")
+        panelFunc = self.ubuntu_sdk.get_object("FnKeys", "kbFn")
+        panelScrl = self.ubuntu_sdk.get_object("ScrlKeys", "kbScrl")
+        self.assertThat(panelCtrl.visible, Eventually(Equals(False)))
+        self.assertThat(panelFunc.visible, Eventually(Equals(False)))
+        self.assertThat(panelScrl.visible, Eventually(Equals(False)))
+        
+    def test_CircleMenu_shows(self):
+        """Make sure that Circle Menu is visible
+        on long tap"""
+        kterm = self.ubuntu_sdk.get_object("KTerminalDisplay", "kterm")
+        menu = self.ubuntu_sdk.get_object("CircleMenu", "cmenu")
+        self.pointing_device.click_object(kterm)
+        self.pointing_device.press()
+        time.sleep(1)
+        self.pointing_device.release()
+        self.assertThat(menu.visible, Eventually(Equals(True)))
+        
+        
+