Merge lp:~nskaggs/dropping-letters/finish_elopio_branch into lp:dropping-letters

[Nicholas Skaggs]

This closes all open bugs for autopilot tests. Implements new game test, intro screen test, and playing and selecting letters and words.

I have some concerns about not being able to truly test finishing a word and having it be correct -- there's no good way to do that that won't randomly fail; ie, waiting for letters you know will spell a word. The current version checks for the word being valid and asserts properly however.

Finally, grabbing the popover seemed impossible; thus a raw select is used as it's the only popover on the start screen. It works, but isn't ideal.

This closes all open bugs for autopilot tests. Implements new game test, intro screen test, and playing and selecting letters and words.

I have some concerns about not being able to truly test finishing a word and having it be correct -- there's no good way to do that that won't randomly fail; ie, waiting for letters you know will spell a word. The current version checks for the word being valid and asserts properly however.

Finally, grabbing the popover seemed impossible; thus a raw select is used as it's the only popover on the start screen. It works, but isn't ideal.

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

PASSED: Continuous integration, rev:40
http://91.189.93.70:8080/job/dropping-letters-ci/3/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-precise-amd64-ci/3
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-quantal-amd64-ci/3
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-raring-amd64-ci/3
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-saucy-amd64-ci/3

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/dropping-letters-ci/3/rebuild

review: Approve (continuous-integration)

[lp:~nskaggs/dropping-letters/finish_elopio_branch]

41. By Nicholas Skaggs on 2013-08-01

tweak tile selection to account for indexing (3rd tiling attempting to be selected while still falling)

42. By Nicholas Skaggs on 2013-08-01

add timeouts to avoid infinite loops and nice asserts to go with it

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

PASSED: Continuous integration, rev:41
http://91.189.93.70:8080/job/dropping-letters-ci/4/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-precise-amd64-ci/4
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-quantal-amd64-ci/4
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-raring-amd64-ci/4
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-saucy-amd64-ci/4

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/dropping-letters-ci/4/rebuild

review: Approve (continuous-integration)

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

PASSED: Continuous integration, rev:42
http://91.189.93.70:8080/job/dropping-letters-ci/5/
Executed test runs:
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-precise-amd64-ci/5
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-quantal-amd64-ci/5
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-raring-amd64-ci/5
    SUCCESS: http://91.189.93.70:8080/job/dropping-letters-saucy-amd64-ci/5

Click here to trigger a rebuild:
http://91.189.93.70:8080/job/dropping-letters-ci/5/rebuild

review: Approve (continuous-integration)

=== modified file 'dropping-letters.qml'
--- dropping-letters.qml	2013-07-31 18:33:19 +0000
+++ dropping-letters.qml	2013-08-01 20:50:36 +0000
@@ -27,8 +27,8 @@
     }
 
     Page {
-        tools: ToolbarActions {
-            Action {
+        tools: ToolbarItems {
+            ToolbarButton {
                 text: i18n.tr("Sound")
                 iconSource: (volume.audible ? "audio-volume-high-symbolic.svg" : "audio-volume-muted-symbolic.svg")
                 visible: volume.supportsMedia
@@ -36,7 +36,8 @@
                     volume.audible = !volume.audible;
                 }
             }
-            Action {
+            ToolbarButton {
+                objectName: "new_game"
                 text: i18n.tr("New game")
                 iconSource: ("new.png")
                 onTriggered: {
@@ -133,6 +134,7 @@
                                     color: Qt.hsla(210/360, 0.84, 0.25 + ((4-parent.lineIndex) * 0.05) + ((4-index) * 0.05));
                                     //radius: "medium"
                                     Label {
+                                        objectName: "lettertile"
                                         text: modelData
                                         anchors.centerIn: parent
                                         fontSize: "x-large"
@@ -179,6 +181,7 @@
                 }
                 Label {
                     id: bestscore
+                    objectName: "bestscorelabel"
                     property int bestsofar: 0
                     text: "..."
                     anchors.top: playbutton.bottom
@@ -196,10 +199,12 @@
 
                 Rectangle {
                     id: helpbutton
+                    objectName: "introhelpbutton"
                     width: units.gu(5)
                     height: units.gu(5)
                     radius: units.gu(1)
                     Label {
+                        objectName: "introhelplabel"
                         text: "?"
                         anchors.centerIn: parent
                     }
@@ -217,7 +222,9 @@
                     id: helppop
                     Popover {
                         id: helpsheet
+                        objectName: "helpsheetpopover"
                         Rectangle {
+                            objectName: "helpsheetpopoverbox"
                             anchors.top: parent.top
                             anchors.left: parent.left
                             anchors.right: parent.right
@@ -225,6 +232,7 @@
                             border.color: "#ddd"
                             radius: 2
                             Label {
+                                objectName: "helpsheetpopoverlabel"
                                 anchors.fill: parent
                                 anchors.margins: units.gu(1)
                                 text: "game by <a href='http://twitter.com/sil'>@sil</a><br>music: <a href='http://incompetech.com/music/royalty-free/index.html?isrc=USUAN1200076'>Easy Lemon</a> from Kevin McCloud (incompetech.com)<br>sounds: freesound from <a href='http://www.freesound.org/people/kantouth/sounds/106727/'>kantouth</a> / <a href='http://www.freesound.org/people/tictacshutup/sounds/407/'>tictacshutup</a> / <a href='http://www.freesound.org/people/dj-chronos/sounds/45137/'>dj-chronos</a> / <a href='http://www.freesound.org/people/justinbw/sounds/80921/'>justinbw</a>"
@@ -240,6 +248,7 @@
 
             back: Rectangle {
                 id: main
+                objectName: "lettersRectangles"
                 color: "#58585A"
                 width: flipable.width // 48 * 7 + 2 * 7 + 2
                 height: flipable.height // 48 * 10 + 2 * 10 + 50
@@ -330,6 +339,7 @@
                     color: Qt.hsla(210/360, 0.84, 0.2)
 
                     Item {
+                        objectName: "mainscore"
                         id: mainscore
                         anchors {
                             centerIn: bottombar
@@ -449,6 +459,7 @@
 
                 Label {
                     id: scoredisplay
+                    objectName: "scoredisplaylabel"
                     anchors.centerIn: parent
                     z: 3
                     fontSize: "x-large"
@@ -519,6 +530,7 @@
 
                 Rectangle {
                     id: game
+                    objectName: "gametile"
                     property int squaresize: Math.min((flipable.width) / 7, (flipable.height - (flipable.minChromeHeight * 2)) / 10)
                     anchors.top: topbar.bottom
                     anchors.bottom: bottombar.top
@@ -548,6 +560,7 @@
                                     model: letters
                                     Rectangle {
                                         id: box
+                                        objectName: "gametilebox"
                                         property bool selected: false
                                         property int idx: index
                                         property string containedLetter: letter
@@ -569,6 +582,7 @@
                                         y: game.height + game.squaresize
                                         z: 5
                                         Label {
+                                            objectName: "gametilelabel"
                                             anchors.centerIn: parent
                                             text: letter
                                             fontSize: "large"

=== removed directory 'tests/autopilot/dropping_letters_app/emulators'
=== added file 'tests/autopilot/dropping_letters_app/emulators.py'
--- tests/autopilot/dropping_letters_app/emulators.py	1970-01-01 00:00:00 +0000
+++ tests/autopilot/dropping_letters_app/emulators.py	2013-08-01 20:50:36 +0000
@@ -0,0 +1,47 @@
+# -*- 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 Lesser General Public License as published by
+# the Free Software Foundation; version 3.
+#
+# 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 Lesser General Public License for more details.
+#
+# 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/>.
+
+from ubuntuuitoolkit import emulators as toolkit_emulators
+
+
+class MainView(toolkit_emulators.MainView):
+
+    def get_main_score_label(self):
+        item = self.select_single('QQuickItem', objectName='mainscore')
+        return item.select_single('Label')
+
+    def get_letter_tiles(self):
+        item = self.select_many('QQuickRectangle', objectName='gametilebox')
+        return item
+
+    def get_word_label(self):
+        item = self.select_single('Label', objectName='accumulate')
+        return item
+
+    def get_help_button(self):
+        item = self.select_single('QQuickRectangle', objectName='introhelpbutton')
+        return item
+
+    def get_help_popover(self):
+        #checking the popup seems to fail -- https://bugs.launchpad.net/autopilot/+bug/1195141?
+        #we can't get the popup by objectname for ??
+        #this works OK because at the moment, there is only one popup -- needs fixed
+        #item = self.select_single('Label', objectname='helpsheetpopoverlabel')
+        #item = self.select_single('QQuickRectangle', objectname='helpsheetpopoverbox')
+        #item = self.select_single('Popover', objectname='helpsheetpopover')
+
+        item = self.select_single('Popover')
+        return item

=== removed file 'tests/autopilot/dropping_letters_app/emulators/__init__.py'
--- tests/autopilot/dropping_letters_app/emulators/__init__.py	2013-07-10 18:26:02 +0000
+++ tests/autopilot/dropping_letters_app/emulators/__init__.py	1970-01-01 00:00:00 +0000
@@ -1,6 +0,0 @@
-# -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
-# Copyright 2013 Canonical
-#
-# 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.

=== removed file 'tests/autopilot/dropping_letters_app/emulators/main_window.py'
--- tests/autopilot/dropping_letters_app/emulators/main_window.py	2013-07-31 18:33:19 +0000
+++ tests/autopilot/dropping_letters_app/emulators/main_window.py	1970-01-01 00:00:00 +0000
@@ -1,33 +0,0 @@
-# -*- 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/>.
-#
-
-"""Dropping Letters app autopilot emulators."""
-
-class MainWindow(object):
-    """An emulator class that makes it easy to interact with the Dropping
-    Letters app."""
-
-    def __init__(self, app):
-        self.app = app
-
-    def get_main_view(self):
-        """Get the main QML view"""
-        return self.app.select_single("MainView", objectName="mainView")
-
-    def get_qml_view(self):
-        """Get the main QML view"""
-        return self.app.select_single("QQuickView")

=== removed file 'tests/autopilot/dropping_letters_app/emulators/ubuntusdk.py'
--- tests/autopilot/dropping_letters_app/emulators/ubuntusdk.py	2013-07-26 07:38:40 +0000
+++ tests/autopilot/dropping_letters_app/emulators/ubuntusdk.py	1970-01-01 00:00:00 +0000
@@ -1,155 +0,0 @@
-# -*- 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 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("ToolbarActions")
-        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 = int(qmlView.x + qmlView.width * 0.50)
-        startY = int(qmlView.y + qmlView.height - 1)
-        stopY = int(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 = int(qmlView.x + qmlView.width * 0.50)
-        startY = int(qmlView.y + qmlView.height * 0.95)
-        stopY = int(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 = int(qmlView.x + qmlView.width * 0.35)
-        stopX = int(qmlView.x + qmlView.width * 0.50)
-        lineY = int(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 = int(qmlView.x + qmlView.width * 0.50)
-        stopX = int(qmlView.x + qmlView.width * 0.35)
-        lineY = int(qmlView.y + qmlView.height * 0.05)
-
-        self.autopilot.pointing_device.drag(startX, lineY, stopX, lineY)
-        self.autopilot.pointing_device.click()

=== modified file 'tests/autopilot/dropping_letters_app/tests/__init__.py'
--- tests/autopilot/dropping_letters_app/tests/__init__.py	2013-07-26 07:38:40 +0000
+++ tests/autopilot/dropping_letters_app/tests/__init__.py	2013-08-01 20:50:36 +0000
@@ -1,9 +1,18 @@
 # -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
-# Copyright 2013 Canonical
-#
-# 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.
+#
+# Copyright (C) 2013 Canonical Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation; version 3.
+#
+# 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 Lesser General Public License for more details.
+#
+# 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/>.
 
 """Dropping Letters app autopilot tests."""
 
@@ -13,8 +22,8 @@
 from autopilot.platform import model
 from autopilot.testcase import AutopilotTestCase
 
-from dropping_letters_app.emulators.main_window import MainWindow
-from dropping_letters_app.emulators.ubuntusdk import ubuntusdk
+from ubuntuuitoolkit import emulators as toolkit_emulators
+from dropping_letters_app import emulators
 
 
 class DroppingLettersTestCase(AutopilotTestCase):
@@ -42,7 +51,8 @@
         self.app = self.launch_test_application(
             "qmlscene",
             self.local_location,
-            app_type='qt')
+            app_type='qt',
+            emulator_base=toolkit_emulators.UbuntuUIToolkitEmulatorBase)
 
     def launch_test_installed(self):
         self.app = self.launch_test_application(
@@ -50,12 +60,9 @@
             "/usr/share/dropping-letters/dropping-letters.qml",
             "--desktop_file_hint=/usr/share/applications/"
             "dropping-letters.desktop",
-            app_type='qt')
-
-    @property
-    def main_window(self):
-        return MainWindow(self.app)
-
-    @property
-    def ubuntusdk(self):
-        return ubuntusdk(self, self.app)
+            app_type='qt',
+            emulator_base=toolkit_emulators.UbuntuUIToolkitEmulatorBase)
+
+    @property
+    def main_view(self):
+        return self.app.select_single(emulators.MainView)

=== modified file 'tests/autopilot/dropping_letters_app/tests/test_dropping_letters.py'
--- tests/autopilot/dropping_letters_app/tests/test_dropping_letters.py	2013-07-31 18:33:19 +0000
+++ tests/autopilot/dropping_letters_app/tests/test_dropping_letters.py	2013-08-01 20:50:36 +0000
@@ -1,18 +1,28 @@
 # -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
-# Copyright 2013 Canonical
-#
-# 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.
+#
+# Copyright (C) 2013 Canonical Ltd.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation; version 3.
+#
+# 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 Lesser General Public License for more details.
+#
+# 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/>.
 
 """Dropping Letters app autopilot tests."""
 
 from __future__ import absolute_import
 
 from autopilot.matchers import Eventually
-from testtools.matchers import Equals
+from testtools.matchers import Equals, NotEquals, LessThan
 
 from dropping_letters_app.tests import DroppingLettersTestCase
+from time import sleep
 
 
 class TestMainWindow(DroppingLettersTestCase):
@@ -20,11 +30,90 @@
     def setUp(self):
         super(TestMainWindow, self).setUp()
         self.assertThat(
-            self.main_window.get_qml_view().visible, Eventually(Equals(True)))
-
-    def test_mainView_visible(self):
-        self.assertThat(
-            self.main_window.get_qml_view().visible, Eventually(Equals(True)))
-
-    def tearDown(self):
-        super(TestMainWindow, self).tearDown()
+            self.main_view.visible, Eventually(Equals(True)))
+
+    def _assert_game_screen(self):
+        main_score_label = self.main_view.get_main_score_label()
+        self.assertTrue(main_score_label.visible)
+
+    def test_intro_screen(self):
+        helpbutton = self.main_view.get_help_button()
+        #check help button popup
+        self.assertTrue(helpbutton.visible)
+
+        #open the popup
+        self.pointing_device.click_object(helpbutton)
+
+        #check and ensure help popover appears
+        helpPopover = self.main_view.get_help_popover()
+        self.assertThat(lambda: helpPopover, Eventually(NotEquals(None)))
+        properties = helpPopover.get_properties()
+        self.assertTrue(properties["visible"])
+
+        #check and ensure help popover disappears
+        self.pointing_device.click_object(helpbutton)
+        helpPopover = self.main_view.get_help_popover()
+        self.assertThat(lambda: helpPopover, Eventually(Equals(None)))
+
+    def test_start_new_game(self):
+        toolbar = self.main_view.open_toolbar()
+        toolbar.click_button('new_game')
+        self._assert_game_screen()
+        main_score_label = self.main_view.get_main_score_label()
+        self.assertEquals(main_score_label.text, '0')
+
+    def test_finishing_a_word(self):
+        #start game and close toolbar
+        toolbar = self.main_view.open_toolbar()
+        toolbar.click_button('new_game')
+        self._assert_game_screen()
+        toolbar = self.main_view.close_toolbar()
+
+        #check for letters falling
+        #select first 2 letters; wait for 3 letters to appear so first 2 are settled for clicking
+        tiles = self.main_view.get_letter_tiles()
+        while len(tiles) < 3:
+            tiles = self.main_view.get_letter_tiles()
+
+        #click the accumlated letters
+        #check and make sure they get selected
+        #add tries as a control to avoid infinite loop and provide better failure feedback
+        tries = 0
+        self.pointing_device.click_object(tiles[0])
+        tileProperties = tiles[0].get_properties()
+        while (tileProperties["selected"] == False and tries < 10):
+            sleep(1)
+            tries += 1
+            self.pointing_device.click_object(tiles[0])
+            tileProperties = tiles[0].get_properties()
+
+        self.assertThat(tries, LessThan(10))
+
+        tries = 0
+        self.pointing_device.click_object(tiles[1])
+        tileProperties = tiles[1].get_properties()
+        while (tileProperties["selected"] == False and tries < 10):
+            sleep(1)
+            tries += 1
+            self.pointing_device.click_object(tiles[1])
+            tileProperties = tiles[1].get_properties()
+
+        self.assertThat(tries, LessThan(10))
+
+        #check the text to make sure it's the same
+        wordValue = tiles[0].containedLetter + tiles[1].containedLetter
+        word = self.main_view.get_word_label()
+        self.assertEquals(word.text, wordValue)
+
+        #click to complete word
+        validWord = word.isValid
+        self.pointing_device.click_object(word)
+
+        #depending on if the property isValid is true or not, score should increase or stay the same after completion
+        #we don't need to get fancy, since the start value is 0; check for zero or non-zero score
+        main_score_label = self.main_view.get_main_score_label()
+        if validWord:
+            self.assertNotEquals(main_score_label.text, '0')
+        else:
+            self.assertEquals(main_score_label.text, '0')
+