GettingStarted

Differences between revisions 42 and 48 (spanning 6 versions)
Revision 42 as of 2009-03-30 07:21:27
Size: 3506
Editor: 63
Comment:
Revision 48 as of 2009-08-17 00:59:01
Size: 3569
Editor: 117-10
Comment: Adding package dependencies for pidgin tests
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from Testing/Automation/Desktop/GettingStarted
Line 13: Line 14:
 * Install python-pyxmpp and python-msn packages (for pidgin tests).
Line 14: Line 16:
  * bzr branch lp:ubuntu-desktop-testing
 * Go the newly created folder and run ./bin/ubuntu-desktop-test. That will run ALL the available tests.
  * bzr branch lp:mago
 * Go the newly created folder and run {{{PYTHONPATH=. ./bin/mago}}}. That will run ALL the available tests.
Line 20: Line 22:
Usage: ubuntu-desktop-test [OPTIONS] Usage: mago [OPTIONS]
Line 37: Line 39:
                        ~/.ubuntu-desktop-test                         ~/.mago
Line 43: Line 45:
By default, logs are written at ~/.ubuntu-desktop-test. This folder can be changed using the -t option (see above). By default, logs are written at ~/.mago. This folder can be changed using the -t option (see above).
Line 58: Line 60:
The python package 'desktoptesting' will contain classes and modules to make the writing of new tests easier to the community. Also it will separate the things that need to be maintain, from the test cases themselves. The python package 'mago' will contain classes and modules to make the writing of new tests easier to the community. Also it will separate the things that need to be maintain, from the test cases themselves.
Line 61: Line 63:
 * [../DesktopTestingLibrary|Documentation on the desktoptesting library]  * [[../DesktopTestingLibrary|Documentation on the mago library]]
Line 65: Line 67:
 * [../IntegrationCheckbox|Integration with Checkbox] - Progress on running LDTP tests (and provide reports) with checkbox (https://launchpad.net/checkbox).  * [[../IntegrationCheckbox|Integration with Checkbox]] - Progress on running LDTP tests (and provide reports) with checkbox (https://launchpad.net/checkbox).

How to run the tests

Some easy steps to run the tests:

  • Enable the Assistive Technologies (System -> Preferences -> Assistive Technologies)

    • assistive.png

  • Restart your GNOME session (log out and log in again)
  • Install python-ldtp package (in universe).
  • Install python-pyxmpp and python-msn packages (for pidgin tests).
  • Get the latest tests from the Bazaar repository:
    • bzr branch lp:mago
  • Go the newly created folder and run PYTHONPATH=. ./bin/mago. That will run ALL the available tests.

ubuntu-desktop-test syntax

Usage: mago [OPTIONS]

Options:
  -h, --help            show this help message and exit
  -l FILE, --log=FILE   The file to write the log to.
  --log-level=LOG_LEVEL
                        One of debug, info, warning, error or critical.
  -a APPLICATION, --application=APPLICATION
                        Application name to test. Option can be repeated and
                        defaults to all applications
  -s SUITE, --suite=SUITE
                        Suite name to test within applications. Option can be
                        repeated and default to all suites
  -f FILE, --file=FILE  XML file name of the suite to test within
                        applications.
  -t FILE, --target=FILE
                        Target directory for logs and reports. Defaults to:
                        ~/.mago
  -c CASE, --case=CASE  Test cases to run (all, if not specified).

Logging

By default, logs are written at ~/.mago. This folder can be changed using the -t option (see above).

Two different logs are written per test:

  • A XML file, easier to parse.
  • A HTML file, better for reporting.

Applications with some test coverage

  • ubuntu-menu. Related to the Ubuntu menu located at the gnome-panel.

  • update-manager. Set of test cases related to the Update Manager application.

  • gedit. Set of test cases related to the Gedit application.

  • seahorse. Set of test cases related to the GNOME password manager application.

Testing Package

The python package 'mago' will contain classes and modules to make the writing of new tests easier to the community. Also it will separate the things that need to be maintain, from the test cases themselves.

Integration with other tools

Next steps

  1. Extend the coverage.

Blockers and open questions

  • Some of the applications does not have the correct accessibility information, which it is used by LDTP to recognize the objects. A list of this applications can be found at ../AtspiBlockers

Testing/Automation/Mago/GettingStarted (last edited 2009-09-14 21:58:30 by 67)