~ubuntu-branches/ubuntu/natty/mago/natty

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Ara Pulido
  • Date: 2010-04-14 14:05:34 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20100414140534-grv0bwv9wv97khir
Tags: 0.2-0ubuntu1
* Mago tests updated for Lucid
  + Fixes arguments handling (LP: #562965)
  + Fixes seahorse tests (LP: #552618)
  + Fixes ubuntu-menu tests (LP: #551492)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
MAGO
2
2
----
3
 
Mago is an desktop testing initiative, built on top of LDTP (http://ldtp.freedesktop.org/), that aims to have a set of processes and code to make writing automated test scripts easier and more reusable. Although we started this effort as an Ubuntu project it works for vanilla GNOME in most of the cases. 
 
3
Mago is a desktop testing initiative, built on top of LDTP (http://ldtp.freedesktop.org/), that aims to have a set of processes and code to make writing automated test scripts easier and more reusable. Although we started this effort as an Ubuntu project it works for vanilla GNOME in most of the cases. 
4
4
 
5
5
How to run the tests
6
6
--------------------
21
21
 
22
22
Mago syntax
23
23
-----------
24
 
Usage: mago [OPTIONS]
 
24
Usage: mago [options]
 
25
 
 
26
Execute automated tests
25
27
 
26
28
Options:
27
29
  -h, --help            show this help message and exit
28
 
  -l FILE, --log=FILE   The file to write the log to.
29
 
  --log-level=LOG_LEVEL
30
 
                        One of debug, info, warning, error or critical.
31
 
  -a APPLICATION, --application=APPLICATION
 
30
  -i, --info            Display information about test cases without executing
 
31
                        them
 
32
 
 
33
  Test selection options:
 
34
    -a APPLICATION, --application=APPLICATION
32
35
                        Application name to test. Option can be repeated and
33
36
                        defaults to all applications
34
 
  -s SUITE, --suite=SUITE
 
37
    -n NAME, --suite_name=NAME
35
38
                        Suite name to test within applications. Option can be
36
 
                        repeated and default to all suites
37
 
  -f FILE, --file=FILE  XML file name of the suite to test within
38
 
                        applications.
39
 
  -t FILE, --target=FILE
 
39
                        repeated and default to all suites unless suite name
 
40
                        or suite file filtering has been enabled
 
41
    -f FILE, --suite_file=FILE
 
42
                        Suite file to test within applications. Option can be
 
43
                        repeated and default to all suites unless suite name
 
44
                        or suite file filtering has been enabled
 
45
    -c CASE, --case=CASE
 
46
                        Test cases to run (all, if not specified).
 
47
 
 
48
  Logging options:
 
49
    -l FILE, --log=FILE
 
50
                        The file to write the log to.
 
51
    --log-level=LOG_LEVEL
 
52
                        One of debug, info, warning, error or critical.
 
53
    -t DIR, --target=DIR
40
54
                        Target directory for logs and reports. Defaults to:
41
55
                        ~/.mago
42
 
  -c CASE, --case=CASE  Test cases to run (all, if not specified).
 
56
 
 
57
Logging
 
58
-------
 
59
By default, logs are written at ~/.mago. This folder can be changed using the -t option (see above).
 
60
 
 
61
Two different logs are written per test:
 
62
 * A XML file, easier to parse.
 
63
 * A HTML file, better for reporting.
43
64