Merge lp:~nskaggs/ubuntu-sdk-tutorials/autopilot into lp:ubuntu-sdk-tutorials

[Nicholas Skaggs]

Add autopilot tests

[David Planella (dpm)]

Looks good to me, and I trust you know what you're doing! ;-)

review: Approve

[lp:~nskaggs/ubuntu-sdk-tutorials/autopilot]

14. By David Planella on 2013-06-05

Added autopilot tests to currency converter

=== modified file 'CurrencyConverter/CurrencyConverter.qml'
--- CurrencyConverter/CurrencyConverter.qml	2013-06-04 17:39:45 +0000
+++ CurrencyConverter/CurrencyConverter.qml	2013-06-05 17:00:51 +0000
@@ -85,6 +85,7 @@
                         height: parent.height - header.height
                         model: currencies
                         delegate: Standard {
+                            objectName: "currencySelectorList"
                             text: currency
                             onClicked: {
                                 caller.currencyIndex = index
@@ -110,6 +111,7 @@
 
                 Button {
                     id: selectorFrom
+                    objectName: "selectorFrom"
                     property int currencyIndex: 0
                     property TextField input: inputFrom
                     text: currencies.getCurrency(currencyIndex)
@@ -118,6 +120,7 @@
 
                 TextField {
                     id: inputFrom
+                    objectName: "inputFrom"
                     errorHighlight: false
                     validator: DoubleValidator {notation: DoubleValidator.StandardNotation}
                     width: pageLayout.width - 2 * root.margins - root.buttonWidth
@@ -139,6 +142,7 @@
                 spacing: units.gu(1)
                 Button {
                     id: selectorTo
+                    objectName: "selectorTo"
                     property int currencyIndex: 1
                     property TextField input: inputTo
                     text: currencies.getCurrency(currencyIndex)
@@ -147,6 +151,7 @@
 
                 TextField {
                     id: inputTo
+                    objectName: "inputTo"
                     errorHighlight: false
                     validator: DoubleValidator {notation: DoubleValidator.StandardNotation}
                     width: pageLayout.width - 2 * root.margins - root.buttonWidth
@@ -165,6 +170,8 @@
             }
 
             Button {
+                id: clearBtn
+                objectName: "clearBtn"
                 text: i18n.tr("Clear")
                 width: units.gu(12)
                 onClicked: {

=== added directory 'CurrencyConverter/tests'
=== added directory 'CurrencyConverter/tests/autopilot'
=== added directory 'CurrencyConverter/tests/autopilot/CurrencyConverter'
=== added file 'CurrencyConverter/tests/autopilot/CurrencyConverter/__init__.py'
--- CurrencyConverter/tests/autopilot/CurrencyConverter/__init__.py	1970-01-01 00:00:00 +0000
+++ CurrencyConverter/tests/autopilot/CurrencyConverter/__init__.py	2013-06-05 17:00:51 +0000
@@ -0,0 +1,19 @@
+# -#- 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]>
+
+"""CurrencyConverter autopilot tests and emulators - top level package."""

=== added directory 'CurrencyConverter/tests/autopilot/CurrencyConverter/emulators'
=== added file 'CurrencyConverter/tests/autopilot/CurrencyConverter/emulators/__init__.py'
--- CurrencyConverter/tests/autopilot/CurrencyConverter/emulators/__init__.py	1970-01-01 00:00:00 +0000
+++ CurrencyConverter/tests/autopilot/CurrencyConverter/emulators/__init__.py	2013-06-05 17:00:51 +0000
@@ -0,0 +1,17 @@
+# -*- 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]>

=== added file 'CurrencyConverter/tests/autopilot/CurrencyConverter/emulators/main_window.py'
--- CurrencyConverter/tests/autopilot/CurrencyConverter/emulators/main_window.py	1970-01-01 00:00:00 +0000
+++ CurrencyConverter/tests/autopilot/CurrencyConverter/emulators/main_window.py	2013-06-05 17:00:51 +0000
@@ -0,0 +1,52 @@
+# -*- 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]>
+
+
+class MainWindow(object):
+    """An emulator class that makes it easy to interact with the CurrencyConverter."""
+
+    def __init__(self, app):
+        self.app = app
+
+    def get_qml_view(self):
+        """Get the main QML view"""
+        return self.app.select_single("QQuickView")
+
+    def get_clear_button(self):
+        """Returns the clear button object"""
+        return self.app.select_single("Button", objectName="clearBtn")
+
+    def get_from_currency_field(self):
+        """Returns the from currency field"""
+        return self.app.select_single("TextField", objectName="inputFrom")
+
+    def get_to_currency_field(self):
+        """Returns the to currency field"""
+        return self.app.select_single("TextField", objectName="inputTo")
+
+    def get_from_currency_button(self):
+        """Returns the select for the from currency field"""
+        return self.app.select_single("Button", objectName="selectorFrom")
+
+    def get_to_currency_button(self):
+        """Returns the select for the to currency field"""
+        return self.app.select_single("Button", objectName="selectorTo")
+
+    def get_object(self, typeName, name):
+        """Returns an object using select_single method from autopilot """
+        return self.app.select_single(typeName, objectName=name)

=== added directory 'CurrencyConverter/tests/autopilot/CurrencyConverter/tests'
=== added file 'CurrencyConverter/tests/autopilot/CurrencyConverter/tests/__init__.py'
--- CurrencyConverter/tests/autopilot/CurrencyConverter/tests/__init__.py	1970-01-01 00:00:00 +0000
+++ CurrencyConverter/tests/autopilot/CurrencyConverter/tests/__init__.py	2013-06-05 17:00:51 +0000
@@ -0,0 +1,69 @@
+# -*- 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]>
+
+
+"""CurrencyConverter autopilot tests."""
+
+import os.path
+import os
+
+from autopilot.input import Mouse, Touch, Pointer
+from autopilot.platform import model
+from autopilot.testcase import AutopilotTestCase
+
+from CurrencyConverter.emulators.main_window import MainWindow
+
+
+class CurrencyConverterTestCase(AutopilotTestCase):
+
+    """A common test case class that provides several useful methods for
+    CurrencyConverter tests.
+
+    """
+
+    if model() == 'Desktop':
+        scenarios = [('with mouse', dict(input_device_class=Mouse))]
+    else:
+        scenarios = [('with touch', dict(input_device_class=Touch))]
+
+    local_location = "../../CurrencyConverter.qml"
+
+    def setUp(self):
+        self.pointing_device = Pointer(self.input_device_class.create())
+        super(CurrencyConverterTestCase, self).setUp()
+        if os.path.exists(self.local_location):
+            self.launch_test_local()
+        else:
+            self.launch_test_installed()
+
+    def launch_test_local(self):
+        self.app = self.launch_test_application(
+            "qmlscene",
+            self.local_location,
+            app_type='qt')
+
+    def launch_test_installed(self):
+        self.app = self.launch_test_application(
+            "qmlscene",
+            "/usr/share/CurrencyConverter/CurrencyConverter.qml",
+            "--desktop_file_hint=/usr/share/applications/CurrencyConverter.desktop",
+            app_type='qt')
+
+    @property
+    def main_window(self):
+        return MainWindow(self.app)

=== added file 'CurrencyConverter/tests/autopilot/CurrencyConverter/tests/test_CurrencyConverter.py'
--- CurrencyConverter/tests/autopilot/CurrencyConverter/tests/test_CurrencyConverter.py	1970-01-01 00:00:00 +0000
+++ CurrencyConverter/tests/autopilot/CurrencyConverter/tests/test_CurrencyConverter.py	2013-06-05 17:00:51 +0000
@@ -0,0 +1,109 @@
+# -*- 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]>
+
+
+""" Tests for CurrencyConverter """
+
+from __future__ import absolute_import
+
+from testtools.matchers import Equals, NotEquals, Not, Is
+from autopilot.matchers import Eventually
+
+from CurrencyConverter.tests import CurrencyConverterTestCase
+
+
+class TestCurrencyConverter(CurrencyConverterTestCase):
+    """ Tests the CurrencyConverter page features """
+
+    def setUp(self):
+        super(TestCurrencyConverter, self).setUp()
+        self.assertThat(
+            self.main_window.get_qml_view().visible, Eventually(Equals(True)))
+
+    def tearDown(self):
+        super(TestCurrencyConverter, self).tearDown()
+
+    def _set_currency(self, button, currency):
+        """Changes the given currency selector to the requested currency
+
+        This only works for currencies that are currently visible. To
+        access the remaining items, a help method to drag and recheck is
+        needed."""
+        self.pointing_device.click_object(button)
+        item_list = lambda: self.main_window.get_object("Standard","currencySelectorList")
+
+        self.assertThat(item_list, Eventually(NotEquals(None)))
+        for item in item_list():
+            if item.get_properties()['text'] == currency:
+                self.pointing_device.click_object(item)
+
+    """ Test if the currency rate is converted """
+    def test_convert_currency(self):
+        fromField = self.main_window.get_from_currency_field()
+        toField = self.main_window.get_to_currency_field()
+        fromCurrencyButton = self.main_window.get_from_currency_button()
+        toCurrencyButton = self.main_window.get_to_currency_button()
+
+        #store current values
+        oldToValue = toField.text
+
+        #input value to convert from
+        self.pointing_device.click_object(fromField)
+        self.keyboard.type('1')
+
+        #store current values
+        oldFromValue = fromField.text
+
+        #verify fromField was updated and toField is still the same
+        self.assertThat(toField.text, Eventually(NotEquals(oldToValue)))
+        self.assertThat(fromField.text, Eventually(Equals(oldFromValue)))
+
+        #store current values
+        oldFromValue = fromField.text
+        oldToValue = toField.text
+
+        #change the from currency
+        self._set_currency(fromCurrencyButton, 'HUF')
+
+        #verify fromField was updated and toField is still the same
+        self.assertThat(fromField.text, Eventually(NotEquals(oldFromValue)))
+        self.assertThat(toField.text, Eventually(Equals(oldToValue)))
+
+        #store current values
+        oldFromValue = fromField.text
+        oldToValue = toField.text
+
+        #change the to currency
+        self._set_currency(toCurrencyButton, 'BGN')
+
+        #verify fromField is the same and toField is updated
+        self.assertThat(fromField.text, Eventually(Equals(oldFromValue)))
+        self.assertThat(toField.text, Eventually(NotEquals(oldToValue)))
+
+    """ Test if the clear button clears the screen """
+    def test_clear_button(self):
+        clearButton = self.main_window.get_clear_button()
+        fromField = self.main_window.get_from_currency_field()
+        toField = self.main_window.get_to_currency_field()
+
+        #click the clear button
+        self.pointing_device.click_object(clearButton)
+
+        #confirm fields have been wiped
+        self.assertThat(fromField.text, Eventually(Equals('0.0')))
+        self.assertThat(toField.text, Eventually(Equals('0.0')))