python-autopilot 1.4.1+17.04.20170305-0ubuntu1 / usr / share / doc / python-autopilot / html / _sources / tutorial / running_ap.rst.txt

This file is indexed.

/usr/share/doc/python-autopilot/html/_sources/tutorial/running_ap.rst.txt is in python-autopilot 1.4.1+17.04.20170305-0ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
Running Autopilot
=================

Autopilot test suites can be run with any python test runner (for example, the built-in testtools runner). However, several autopilot features are only available if you use the autopilot runner.

List Tests
----------

Autopilot can list all tests found within a particular module::

    $ autopilot list <modulename>

where *<modulename>* is the base name of the module you want to look at. The module must either be in the current working directory, or be importable by python. For example, to list the tests inside autopilot itself, you can run::

     $ autopilot list autopilot
        autopilot.tests.test_ap_apps.GtkTests.test_can_launch_qt_app
        autopilot.tests.test_ap_apps.QtTests.test_can_launch_qt_app
        autopilot.tests.test_application_mixin.ApplicationSupportTests.test_can_create
        autopilot.tests.test_application_mixin.ApplicationSupportTests.test_launch_raises_ValueError_on_unknown_kwargs
        autopilot.tests.test_application_mixin.ApplicationSupportTests.test_launch_raises_ValueError_on_unknown_kwargs_with_known
        autopilot.tests.test_application_mixin.ApplicationSupportTests.test_launch_with_bad_types_raises_typeerror
        autopilot.tests.test_application_registration.ApplicationRegistrationTests.test_can_register_new_application
        autopilot.tests.test_application_registration.ApplicationRegistrationTests.test_can_unregister_application
        autopilot.tests.test_application_registration.ApplicationRegistrationTests.test_registering_app_twice_raises_KeyError
        autopilot.tests.test_application_registration.ApplicationRegistrationTests.test_unregistering_unknown_application_raises_KeyError
        ...

         81 total tests.

Some results have been omitted for clarity.

The list command takes only one option:

-ro, --run-order    Display tests in the order in which they will be run,
                    rather than alphabetical order (which is the default).

Run Tests
---------

Running autopilot tests is very similar to listing tests::

    $ autopilot run <modulename>

However, the run command has many more options to customize the run behavior:

-h, --help            show this help message and exit

-o OUTPUT, --output OUTPUT
                      Write test result report to file. Defaults to stdout.
                      If given a directory instead of a file will write to a
                      file in that directory named:
                      <hostname>_<dd.mm.yyy_HHMMSS>.log

-f FORMAT, --format FORMAT
                      Specify desired output format. Default is "text".
                      Other option is 'xml' to produce junit xml format.

-r, --record          Record failing tests. Required 'recordmydesktop' app
                      to be installed. Videos are stored in /tmp/autopilot.

-rd PATH, --record-directory PATH
                      Directory to put recorded tests (only if -r)
                      specified.

-v, --verbose         If set, autopilot will output test log data to stderr
                      during a test run.

Common use cases
++++++++++++++++

1. **Run autopilot and save the test log**::

    $ autopilot run -o . <modulename>

  Autopilot will create a text log file named <hostname>_<dd.mm.yyy_HHMMSS>.log with the contents of the test log.

2. **Run autopilot and record failing tests**::

    $ autopilot run -r --rd . <modulename>

  Videos are recorded as *ogg-vorbis* files, with an .ogv extension. They will be named with the test id that failed. All videos will be placed in the directory specified by the ``-rd`` option - in this case the currect directory. If this option is omitted, videos will be placed in ``/tmp/autopilot/``.

3. **Save the test log as jUnitXml format**::

    $ autopilot run -o results.xml -f xml <modulename>

  The file 'results.xml' will be created when all the tests have completed, and will be in the jUnitXml file format. This is useful when running the autopilot tests within a jenkins environment.

.. _visualise_introspection_tree:

Visualise Introspection Tree
----------------------------

A very common thing to want to do while writing autopilot tests is see the structure of the application being tested. To support this, autopilot includes a simple application to help visualize the introspection tree. To start it, make sure the application you wish to test is running, and then run::

    $ autopilot vis

The result should be a window similar to below:

.. image:: /images/ap_vis_front_page.png

Selecting a connection from the drop-down box allows you to inspect different autopilot-supporting applications. If Unity is running, the Unity connection should always be present. If other applications have been started with the autopilot support enabled, they should appear in this list as well. Once a connection is selected, the introspection tree is rendered in the left-hand pane, and the details of each object appear in the right-hand pane.

.. image:: /images/ap_vis_object.png

APT Browse - Built by Thomas Orozco.