Ubuntu Wiki

How to run the tests

Some easy steps to run the tests:

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

  • 

• Restart your GNOME session (log out and log in again)
• Get the latest tests from the Bazaar repository:
  • bzr branch lp:ubuntu-desktop-testing
• Go the newly created folder and run ./bin/ubuntu-desktop-test. That will run ALL the available tests.

ubuntu-desktop-test syntax

Usage: ubuntu-desktop-test [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
  -t FILE, --target=FILE
                        Target directory for logs and reports. Defaults to:
                        ~/.ubuntu-desktop-tests

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 'ubuntutesting' 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.

• Link to the latest python documentation of the module: http://people.ubuntu.com/~ara/ldtp/doc/testing_module_doc/

• [/HowToUseTestingLibrary]

• [/HowToExtendTestingLibrary]

• [/TestingPackageDocumentation] - Please add anything that would be nice to have here.

PPA packages

LDTP

If you need to run the tests in Hardy you can use the packages available at https://launchpad.net/~apulido/+archive that contains the latest upstream version of LDTP. Intrepid universe packages are already sync with this upstream version, nevertheless, if you want to run the Gedit UTF-8 test, you will need the PPA version.

Desktop Testing Library

There are PPA packages for Intrepid. To install the library:

1. Add the following lines to your /etc/apt/source.lists:

deb http://ppa.launchpad.net/apulido/ubuntu intrepid main
deb-src http://ppa.launchpad.net/apulido/ubuntu intrepid main

2. $ sudo apt-get update
3. $ sudo apt-get install desktop-testing-library

Ubuntu Desktop Tests

There are PPA packages for Intrepid. To install the tests:

1. Add the following lines to your /etc/apt/source.lists:

deb http://ppa.launchpad.net/apulido/ubuntu intrepid main
deb-src http://ppa.launchpad.net/apulido/ubuntu intrepid main

2. $ sudo apt-get update
3. $ sudo apt-get install ubuntu-desktop-tests

Integration with other tools

• [/IntegrationCheckbox] - Progress on running LDTP tests (and provide reports) with checkbox (https://launchpad.net/checkbox).

Next steps

1. Write the testing library documentation and a tutorial on how to write tests for Ubuntu using the library
2. Write documentation about how to extend the library
3. 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

Links to test cases

• http://www.go-evolution.org/Automation_using_LDTP

• http://ldtp.freedesktop.org/wiki/Projects_using_LDTP

Links to documentation

• http://ldtp.freedesktop.org/wiki/