Autotest

This page is a draft only
It is still under construction and content may change. Do not rely on the information on this page.

What is autotest?

Autotest is "a framework for automated testing". It gives us a way to run automated tests and collect results. For more information, see their wiki: http://autotest.kernel.org/

How is it used in Fedora?

Currently there is no public autotest instance. The QA team has been working on packaging autotest for use in the Fedora infrastructure.

We're planning to use it as the test harness for AutoQA, starting with the Israwhidebroken.com Proposal. In the future we may open it up to allow all Fedora contributors to write tests and have them be run automatically.

How do I write a test for autotest?

The short version:

1. Write a test. You can write it in whatever language you're comfortable with.
2. Create a control file. This gives autotest some metadata about the test.
   • Some control file requirements are listed under ControlRequirements on the autotest wiki.
3. Create a test script. This runs your test program and reports back the results.
   • The test scripts are written in Python; see AddingTest and AutotestAPI on the autotest wiki for details.
4. Create a new dir in the autoqa git tree for your test.
   • The details of this process have yet to be finalized.

Writing a test

TODO

Writing a control file

TODO

Writing the test script

TODO

Checking in the new test

TODO