From Fedora Project Wiki

(Add section on control files)
m (change example control file code to be less wide)
Line 5: Line 5:
Before it reads the control file, Autotest imports all the symbols from the <code>autotest_lib.client.bin.util</code> module.<ref>http://autotest.kernel.org/browser/branches/0.10.1/client/bin/job.py#L19</ref> This means the control files can use any function defined in <code>common_lib.utils</code> or <code>bin.base_utils</code><ref>http://autotest.kernel.org/browser/branches/0.10.1/client/bin/utils.py</ref>. This lets you do things like:
Before it reads the control file, Autotest imports all the symbols from the <code>autotest_lib.client.bin.util</code> module.<ref>http://autotest.kernel.org/browser/branches/0.10.1/client/bin/job.py#L19</ref> This means the control files can use any function defined in <code>common_lib.utils</code> or <code>bin.base_utils</code><ref>http://autotest.kernel.org/browser/branches/0.10.1/client/bin/utils.py</ref>. This lets you do things like:
<pre>arch = get_arch()
<pre>arch = get_arch()
baseurl = 'http://download.fedora.redhat.com/pub/fedora/linux/development/%s/os/' % arch
baseurl = '%s/development/%s/os/' % (mirror_baseurl, arch)
job.run_test('some_test', arch=arch, baseurl=baseurl)</pre>
job.run_test('some_rawhide_test', arch=arch, baseurl=baseurl)</pre>
since <code>get_arch</code> is defined in common_lib.utils.
since <code>get_arch</code> is defined in common_lib.utils.



Revision as of 19:56, 31 July 2009

Will's notes (to be integrated into main page)

Control Files

The control file is actually interpreted as a Python script. So you can do any of the normal pythonic things you might want to do.

Before it reads the control file, Autotest imports all the symbols from the autotest_lib.client.bin.util module.[1] This means the control files can use any function defined in common_lib.utils or bin.base_utils[2]. This lets you do things like:

arch = get_arch()
baseurl = '%s/development/%s/os/' % (mirror_baseurl, arch)
job.run_test('some_rawhide_test', arch=arch, baseurl=baseurl)

since get_arch is defined in common_lib.utils.

Test Objects: Getting test results

The result of the test is the exit code of the command. Usually retrieved like so:

self.results = utils.system_output(cmd, retain_output=True)

Further test-level info can be returned by using test.write_test_keyval(dict):

extrainfo = dict()
for line in self.results.stdout:
    if line.startswith("kernel version "):
        extrainfo['kernelver'] = line.split()[3]
    ...
self.write_test_keyval(extrainfo)
  • For per-iteration data (performance numbers, etc) there are three methods:
    • Just attr: test.write_attr_keyval(attr_dict)
    • Just perf: test.write_perf_keyval(perf_dict)
    • Both: test.write_iteration_keyval(attr_dict, perf_dict)

Test Objects: Attributes for directories

test objects have the following attributes available[3]:

outputdir       eg. results/<job>/<testname.tag>
resultsdir      eg. results/<job>/<testname.tag>/results
profdir         eg. results/<job>/<testname.tag>/profiling
debugdir        eg. results/<job>/<testname.tag>/debug
bindir          eg. tests/<test>
src             eg. tests/<test>/src
tmpdir          eg. tmp/<tempname>_<testname.tag>