~thomir-deactivatedaccount/autopilot/trunk-add-help

« back to all changes in this revision

Viewing changes to docs/tutorial/getting_started.rst

  • Committer: Tarmac
  • Author(s): Thomi Richards
  • Date: 2013-09-27 01:00:57 UTC
  • mfrom: (333.2.4 trunk-fix-docs)
  • Revision ID: tarmac-20130927010057-6kwp09v00pjs9sn9
Update autopilot documentation to fix porting guide, and add several objects to the documentation index. Fixes: https://bugs.launchpad.net/bugs/1230038, https://bugs.launchpad.net/bugs/1231690.

Approved by PS Jenkins bot, Christopher Lee.

Show diffs side-by-side

added added

removed removed

Lines of Context:
87
87
 
88
88
.. otto:: **What is a Proxy Object?**
89
89
 
90
 
        Whenever you launch an application, autopilot gives you a "proxy object". These are instances of the :class:`~autopilot.introspection.DBusIntrospectionObject` class, with all the data from your application mirrored in the proxy object instances. For example, if you have a proxy object for a push button class (say, ``QPushButton``, for example), the proxy object will have attribute to match every attribute in the class within your application. Autopilot automatically keeps the data in these instances up to date, so you can use them in your test assertions.
 
90
        Whenever you launch an application, autopilot gives you a "proxy object". These are instances of the :class:`~autopilot.introspection.dbus.DBusIntrospectionObject` class, with all the data from your application mirrored in the proxy object instances. For example, if you have a proxy object for a push button class (say, ``QPushButton``, for example), the proxy object will have attribute to match every attribute in the class within your application. Autopilot automatically keeps the data in these instances up to date, so you can use them in your test assertions.
91
91
 
92
92
        User interfaces are made up of a tree of widgets, and autopilot represents these widgets as a tree of proxy objects. Proxy objects have a number of methods on them for selecting child objects in the introspection tree, so test authors can easily inspect the parts of the UI tree they care about.
93
93