docs/testapi.html.in

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html>
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4   <body>
   5     <h1>libvirt-test-API:  Python based test suite </h1>
   6     <p>Libvirt-test-API is a powerful test tool designed to complement
   7        existing libvirt test tools such as libvirt-TCK and the internal
   8        test suite. It aims at functional regression testing, trying to
   9        exercise nearly all the API by the way of the Python bindings.</p>
  10     <p>The test API currently covers:</p>
  11     <ul>
  12       <li>domain: all classical lifetime operations, installation of
  13           various guests OSes, snapshots</li>
  14       <li>interfaces: define, create, destroy, undefine, NPIV</li>
  15       <li>virtual networks: define, create, destroy, undefine</li>
  16       <li>storage: regression tests for most storage types and configurations
  17           dir, disk, netfs, iSCSI, multipath</li>
  18     </ul>
  19     <p>Some of the tests need dedicated local resources whose definitions
  20        are stored in a configuration file. The tests are defined using
  21        Python modules defining the code for the test, this is called
  22        a <tt>test case</tt>, and test <tt>configuration files</tt> using one
  23        or more test case to define a given test scenario.</p>
  24     <p>For more details you can look at:</p>
  25     <ul>
  26       <li> A <a href="https://libvirt.org/sources/libvirt-test-API/Libvirt-test-API.pdf">documentation PDF</a>
  27            file describing the test suite and how to write test cases
  28            and test scenarios.</li>
  29     </ul>
  30     <p> Libvirt-test-API is maintained using
  31         <a href="https://libvirt.org/git/?p=libvirt-test-API.git">a GIT
  32         repository</a>, and comment, patches and reviews are carried
  33         on the <a href="contact.html">libvir-list</a> development list.</p>
  34   </body>
  35 </html>