Merge lp:~elopio/ubuntu-ui-toolkit/tabs_emulator-2 into lp:ubuntu-ui-toolkit

[Leo Arias]

Added the Tabs autopilot emulator.

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:624
http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-ci/379/
Executed test runs:
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-saucy/1308
    SUCCESS: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-amd64-ci/236
    SUCCESS: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-armhf-ci/236
        deb: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-armhf-ci/236/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-saucy/1312
        deb: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-saucy/1312/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-runner-saucy/1106

Click here to trigger a rebuild:
http://s-jenkins:8080/job/ubuntu-ui-toolkit-ci/379/rebuild

review: Approve (continuous-integration)

[Juhapekka Piiroinen (juhapekka-piiroinen)]

review: Approve

[PS Jenkins bot (ps-jenkins)]

FAILED: Autolanding.
More details in the following jenkins job:
http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-autolanding/169/
Executed test runs:
    UNSTABLE: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-saucy/1345
    SUCCESS: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-amd64-autolanding/95
    SUCCESS: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-armhf-autolanding/95
        deb: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-armhf-autolanding/95/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-saucy/1349
        deb: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-saucy/1349/artifact/work/output/*zip*/output.zip
    UNSTABLE: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-runner-saucy/1143

review: Needs Fixing (continuous-integration)

[lp:~elopio/ubuntu-ui-toolkit/tabs_emulator-2]

625. By Leo Arias on 2013-07-19

Merged with trunk.

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:625
http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-ci/383/
Executed test runs:
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-saucy/1358
    SUCCESS: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-amd64-ci/240
    SUCCESS: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-armhf-ci/240
        deb: http://jenkins.qa.ubuntu.com/job/ubuntu-ui-toolkit-saucy-armhf-ci/240/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-saucy/1362
        deb: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-saucy/1362/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-runner-saucy/1154

Click here to trigger a rebuild:
http://s-jenkins:8080/job/ubuntu-ui-toolkit-ci/383/rebuild

review: Approve (continuous-integration)

=== modified file 'tests/autopilot/UbuntuUiToolkit/emulators.py'
--- tests/autopilot/UbuntuUiToolkit/emulators.py	2013-07-19 06:08:14 +0000
+++ tests/autopilot/UbuntuUiToolkit/emulators.py	2013-07-19 23:11:26 +0000
@@ -14,12 +14,16 @@
 # You should have received a copy of the GNU Lesser General Public License
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 
+import time
+
 from autopilot import input, platform
 from autopilot.introspection import dbus
 
+_NO_TABS_ERROR = 'The MainView has no Tabs.'
+
 
 def get_pointing_device():
-    """Get the pointing device depending on the platform.
+    """Return the pointing device depending on the platform.
 
     If the platform is `Desktop`, the pointing device will be a `Mouse`.
     If not, the pointing device will be `Touch`.
@@ -44,17 +48,17 @@
         self.pointing_device = get_pointing_device()
 
     def get_header(self):
-        """Get the Header emulator of the MainView."""
+        """Return the Header emulator of the MainView."""
         return self.select_single('Header')
 
     def get_toolbar(self):
-        """Get the Toolbar emulator of the MainView."""
+        """Return the Toolbar emulator of the MainView."""
         return self.select_single(Toolbar)
 
     def open_toolbar(self):
         """Open the toolbar if it's not already opened.
 
-        :return: the toolbar.
+        :return: The toolbar.
 
         """
         toolbar = self.get_toolbar()
@@ -65,8 +69,7 @@
         return toolbar
 
     def _drag_to_open_toolbar(self):
-        x = self.globalRect[0]
-        y = self.globalRect[1]
+        x, y, _, _ = self.globalRect
         line_x = x + self.width * 0.50
         start_y = y + self.height - 1
         stop_y = y + self.height * 0.95
@@ -81,14 +84,97 @@
             toolbar.opened.wait_for(False)
 
     def _drag_to_close_toolbar(self):
-        x = self.globalRect[0]
-        y = self.globalRect[1]
+        x, y, _, _ = self.globalRect
         line_x = x + self.width * 0.50
         start_y = y + self.height * 0.95
         stop_y = y + self.height - 1
 
         self.pointing_device.drag(line_x, start_y, line_x, stop_y)
 
+    def get_tabs(self):
+        """Return the Tabs emulator of the MainView."""
+        tabs = self.select_single(Tabs)
+        assert tabs is not None, _NO_TABS_ERROR
+        return tabs
+
+    def switch_to_next_tab(self):
+        """Open the next tab.
+
+        :return: The newly opened tab.
+
+        """
+        self.get_header().switch_to_next_tab()
+        current_tab = self.get_tabs().get_current_tab()
+        current_tab.visible.wait_for(True)
+        return current_tab
+
+    def switch_to_tab_by_index(self, index):
+        """Open a tab.
+
+        :parameter index: The index of the tab to open.
+        :return: The newly opened tab.
+
+        """
+        tabs = self.get_tabs()
+        if index >= tabs.get_number_of_tabs():
+            raise IndexError('Tab index out of range.')
+        current_tab = tabs.get_current_tab()
+        while not tabs.selectedTabIndex == index:
+            current_tab = self.switch_to_next_tab()
+        return current_tab
+
+    def switch_to_previous_tab(self):
+        """Open the previous tab.
+
+        :return: The newly opened tab.
+
+        """
+        tabs = self.get_tabs()
+        if tabs.selectedTabIndex == 0:
+            previous_tab_index = tabs.get_number_of_tabs() - 1
+        else:
+            previous_tab_index = tabs.selectedTabIndex - 1
+        return self.switch_to_tab_by_index(previous_tab_index)
+
+    def switch_to_tab(self, object_name):
+        """Open a tab.
+
+        :parameter object_name: The QML objectName property of the tab.
+        :return: The newly opened tab.
+
+        """
+        tabs = self.get_tabs()
+        for index, tab in enumerate(tabs.select_many('Tab')):
+            if tab.objectName == object_name:
+                return self.switch_to_tab_by_index(index)
+        raise ValueError(
+            'Tab with objectName "{0}" not found.'.format(object_name))
+
+
+class Header(UbuntuUIToolkitEmulatorBase):
+    """Header Autopilot emulator."""
+
+    def __init__(self, *args):
+        super(Header, self).__init__(*args)
+        self.pointing_device = get_pointing_device()
+
+    def switch_to_next_tab(self):
+        """Open the next tab."""
+        tab_bar = self.select_single('NewTabBar')
+        assert tab_bar is not None, _NO_TABS_ERROR
+        tab_bar_x, tab_bar_y, _, _ = tab_bar.globalRect
+        line_y = tab_bar_y + tab_bar.height * 0.5
+        current_tab_x = tab_bar_x + tab_bar.width * 0.35
+        next_tab_x = tab_bar_x + tab_bar.width * 0.65
+
+        self.pointing_device.move(current_tab_x, line_y)
+        self.pointing_device.click()
+        self.pointing_device.move(next_tab_x, line_y)
+        self.pointing_device.click()
+
+        # Sleep while the animation finishes.
+        time.sleep(tab_bar.buttonPositioningVelocity)
+
 
 class Toolbar(UbuntuUIToolkitEmulatorBase):
     """Toolbar Autopilot emulator."""
@@ -104,10 +190,22 @@
 
         """
         button = self._get_button(object_name)
-        not_found_error = 'Button with objectName "{0}" not found.'.format(
-            object_name)
-        assert button is not None, not_found_error
+        if button is None:
+            raise ValueError(
+                'Button with objectName "{0}" not found.'.format(object_name))
         self.pointing_device.click_object(button)
 
     def _get_button(self, object_name):
         return self.select_single('ActionItem', objectName=object_name)
+
+
+class Tabs(UbuntuUIToolkitEmulatorBase):
+    """Tabs Autopilot emulator."""
+
+    def get_current_tab(self):
+        """Return the currently selected tab."""
+        return self.select_many('Tab')[self.selectedTabIndex]
+
+    def get_number_of_tabs(self):
+        """Return the number of tabs."""
+        return len(self.select_many('Tab'))

=== modified file 'tests/autopilot/UbuntuUiToolkit/tests/test_emulators.py'
--- tests/autopilot/UbuntuUiToolkit/tests/test_emulators.py	2013-07-19 06:17:46 +0000
+++ tests/autopilot/UbuntuUiToolkit/tests/test_emulators.py	2013-07-19 23:11:26 +0000
@@ -44,6 +44,19 @@
         self.assertIsInstance(toolbar, emulators.Toolbar)
         self.assertFalse(toolbar.opened)
 
+    def test_get_tabs_without_tabs(self):
+        error = self.assertRaises(
+            AssertionError, self.main_view.get_tabs)
+        self.assertEqual(
+            error.message, 'The MainView has no Tabs.')
+
+    def test_switch_to_next_tab_without_tabs(self):
+        header = self.main_view.get_header()
+        error = self.assertRaises(
+            AssertionError, header.switch_to_next_tab)
+        self.assertEqual(
+            error.message, 'The MainView has no Tabs.')
+
 
 class PageTestCase(tests.UbuntuUiToolkitTestCase):
 
@@ -61,8 +74,9 @@
 }
 """)
 
-    def test_get_header(self):
+    def test_header_custom_emulator(self):
         header = self.main_view.get_header()
+        self.assertIsInstance(header, emulators.Header)
         self.assertTrue(header.visible)
         self.assertEqual(header.title, "Test title")
 
@@ -137,6 +151,101 @@
     def test_click_unexisting_button(self):
         toolbar = self.main_view.open_toolbar()
         error = self.assertRaises(
-            AssertionError, toolbar.click_button, 'unexisting')
+            ValueError, toolbar.click_button, 'unexisting')
         self.assertEqual(
             error.message, 'Button with objectName "unexisting" not found.')
+
+
+class TabsTestCase(tests.UbuntuUiToolkitTestCase):
+
+    test_qml = ("""
+import QtQuick 2.0
+import Ubuntu.Components 0.1
+import Ubuntu.Components.ListItems 0.1 as ListItem
+
+MainView {
+    width: units.gu(48)
+    height: units.gu(60)
+
+    Tabs {
+        id: tabs
+        Tab {
+            objectName: "tab1"
+            title: "Test tab 1"
+        }
+        Tab {
+            objectName: "tab2"
+            title: "Test tab 2"
+        }
+    }
+}
+""")
+
+    def test_tabs_custom_emulator(self):
+        self.assertIsInstance(self.main_view.get_tabs(), emulators.Tabs)
+
+    def test_get_current_tab(self):
+        tabs = self.main_view.get_tabs()
+        self.assertEqual(tabs.get_current_tab().title, 'Test tab 1')
+
+    def test_switch_to_next_tab_from_header(self):
+        header = self.main_view.get_header()
+        header.switch_to_next_tab()
+        current_tab = self.main_view.get_tabs().get_current_tab()
+        self.assertEqual(current_tab.title, 'Test tab 2')
+
+    def test_switch_to_next_tab_from_main_view(self):
+        current_tab = self.main_view.switch_to_next_tab()
+        self.assertEqual(current_tab.title, 'Test tab 2')
+
+    def test_switch_to_next_tab_from_last(self):
+        last_tab_index = 1
+        self.main_view.switch_to_tab_by_index(last_tab_index)
+        current_tab = self.main_view.switch_to_next_tab()
+        self.assertEqual(current_tab.title, 'Test tab 1')
+
+    def test_switch_to_tab_by_index(self):
+        current_tab = self.main_view.switch_to_tab_by_index(1)
+        self.assertEqual(current_tab.title, 'Test tab 2')
+        current_tab = self.main_view.switch_to_tab_by_index(0)
+        self.assertEqual(current_tab.title, 'Test tab 1')
+
+    def test_switch_to_opened_tab_is_not_opened_again(self):
+        with mock.patch.object(
+                emulators.Header, 'switch_to_next_tab') as mock_switch:
+            current_tab = self.main_view.switch_to_tab_by_index(0)
+
+        self.assertFalse(mock_switch.called)
+        self.assertEqual(current_tab.title, 'Test tab 1')
+
+    def test_get_number_of_tabs(self):
+        tabs = self.main_view.get_tabs()
+        self.assertEqual(tabs.get_number_of_tabs(), 2)
+
+    def test_swith_to_tab_by_index_out_of_range(self):
+        last_tab_index = 1
+        error = self.assertRaises(
+            IndexError, self.main_view.switch_to_tab_by_index,
+            last_tab_index + 1)
+        self.assertEqual(error.message, 'Tab index out of range.')
+
+    def test_switch_to_previous_tab_from_first(self):
+        current_tab = self.main_view.switch_to_previous_tab()
+        self.assertEqual(current_tab.title, 'Test tab 2')
+
+    def test_switch_to_previous_tab_not_from_first(self):
+        self.main_view.switch_to_tab_by_index(1)
+        current_tab = self.main_view.switch_to_previous_tab()
+        self.assertEqual(current_tab.title, 'Test tab 1')
+
+    def test_switch_to_tab_by_object_name(self):
+        current_tab = self.main_view.switch_to_tab('tab2')
+        self.assertEqual(current_tab.title, 'Test tab 2')
+        current_tab = self.main_view.switch_to_tab('tab1')
+        self.assertEqual(current_tab.title, 'Test tab 1')
+
+    def test_switch_to_unexisting_tab(self):
+        error = self.assertRaises(
+            ValueError, self.main_view.switch_to_tab, 'unexisting')
+        self.assertEqual(
+            error.message, 'Tab with objectName "unexisting" not found.')