Merge lp:~elopio/autopilot/fix1195092-tutorial-emulator_base into lp:autopilot

[Leo Arias]

Added to the tutorial the step to pass the custom emulator as an argument to the launch_test_application method.

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:251
http://jenkins.qa.ubuntu.com/job/autopilot-ci/143/
Executed test runs:
    SUCCESS: http://jenkins.qa.ubuntu.com/job/autopilot-saucy-amd64-ci/71
    SUCCESS: http://jenkins.qa.ubuntu.com/job/autopilot-saucy-armhf-ci/71

Click here to trigger a rebuild:
http://s-jenkins:8080/job/autopilot-ci/143/rebuild

review: Approve (continuous-integration)

[Thomi Richards (thomir-deactivatedaccount)]

Looks great - thanks!

review: Approve

=== modified file 'docs/tutorial/advanced_autopilot.rst'
--- docs/tutorial/advanced_autopilot.rst	2013-05-28 00:52:21 +0000
+++ docs/tutorial/advanced_autopilot.rst	2013-06-27 03:20:32 +0000
@@ -250,8 +250,19 @@
 
         # Add custom methods here...
 
-3. As long as this custom class has been seen by the python interpreter (usually by importing it somewhere within the test suite), autopilot will use it every time it needs to generate a ``QLabel`` instance. You can also pass this class to methods like :meth:`~autopilot.introspection.DBusIntrospectionObject.select_single` instead of a string. So, for example, the following is a valid way of selecting the QLabel instances in an application::
-
-    # self.app is the application proxy object.
+3. Pass the emulator base as an argument to the launch_test_application method on your test class. Something like this::
+
+    from autopilot.testcase import AutopilotTestCase
+
+    class TestCase(AutopilotTestCase):
+
+        def setUp(self):
+            super(TestCase, self).setUp()
+            self.app = self.launch_test_application(
+                '/path/to/the/application',
+                emulator_base=EmulatorBase)
+
+4. You can pass the emulator class to methods like :meth:`~autopilot.introspection.DBusIntrospectionObject.select_single` instead of a string. So, for example, the following is a valid way of selecting the QLabel instances in an application::
+
     # Get all QLabels in the applicaton:
     labels = self.app.select_many(QLabel)