Imported Upstream version 1.2.4
[archive/platform/upstream/libvirt.git] / docs / testapi.html
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml">
4 <!--
5         This file is autogenerated from testapi.html.in
6         Do not edit this file. Changes will be lost.
7       -->
8   <head>
9     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
10     <link rel="stylesheet" type="text/css" href="main.css" />
11     <link rel="SHORTCUT ICON" href="32favicon.png" />
12     <title>libvirt: libvirt-test-API:  Python based test suite </title>
13     <meta name="description" content="libvirt, virtualization, virtualization API" />
14   </head>
15   <body>
16     <div id="header">
17       <div id="headerLogo"></div>
18       <div id="headerSearch">
19         <form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><div>
20             <input id="query" name="query" type="text" size="12" value="" />
21             <input id="submit" name="submit" type="submit" value="Search" />
22           </div></form>
23       </div>
24     </div>
25     <div id="body">
26       <div id="menu">
27         <ul class="l0"><li>
28             <div>
29               <a title="Front page of the libvirt website" class="inactive" href="index.html">Home</a>
30             </div>
31           </li><li>
32             <div>
33               <a title="Details of new features and bugs fixed in each release" class="inactive" href="news.html">News</a>
34             </div>
35           </li><li>
36             <div>
37               <a title="Applications known to use libvirt" class="inactive" href="apps.html">Applications</a>
38             </div>
39           </li><li>
40             <div>
41               <a title="Get the latest source releases, binary builds and get access to the source repository" class="inactive" href="downloads.html">Downloads</a>
42             </div>
43           </li><li>
44             <div>
45               <a title="Information for users, administrators and developers" class="inactive" href="docs.html">Documentation</a>
46             </div>
47           </li><li>
48             <div>
49               <a title="User contributed content" class="inactive" href="http://wiki.libvirt.org">Wiki</a>
50             </div>
51           </li><li>
52             <div>
53               <a title="Frequently asked questions" class="inactive" href="http://wiki.libvirt.org/page/FAQ">FAQ</a>
54             </div>
55           </li><li>
56             <div>
57               <a title="How and where to report bugs and request features" class="inactive" href="bugs.html">Bug reports</a>
58             </div>
59           </li><li>
60             <div>
61               <a title="How to contact the developers via email and IRC" class="inactive" href="contact.html">Contact</a>
62             </div>
63           </li><li>
64             <div>
65               <a title="Available test suites for libvirt" class="active" href="testsuites.html">Test suites</a>
66               <ul class="l1"><li>
67                   <div>
68                     <a title="Virtualization functional test suite in Perl" class="inactive" href="testtck.html">TCK test suite</a>
69                   </div>
70                 </li><li>
71                   <div>
72                     <span class="active">Libvirt-test-API</span>
73                   </div>
74                 </li></ul>
75             </div>
76           </li><li>
77             <div>
78               <a title="Miscellaneous links of interest related to libvirt" class="inactive" href="relatedlinks.html">Related Links</a>
79             </div>
80           </li><li>
81             <div>
82               <a title="Overview of all content on the website" class="inactive" href="sitemap.html">Sitemap</a>
83             </div>
84           </li></ul>
85       </div>
86       <div id="content">
87         <h1>libvirt-test-API:  Python based test suite </h1>
88         <p>Libvirt-test-API is a powerful test tool designed to complement
89        existing libvirt test tools such as libvirt-TCK and the internal
90        test suite. It aims at functional regression testing, trying to
91        exercise nearly all the API by the way of the Python bindings.</p>
92         <p>The test API currently covers:</p>
93         <ul><li>domain: all classical lifetime operations, installation of
94           various guests OSes, snapshots</li><li>interfaces: define, create, destroy, undefine, NPIV</li><li>virtual networks: define, create, destroy, undefine</li><li>storage: regression tests for most storage types and configurations
95           dir, disk, netfs, iSCSI, multipath</li></ul>
96         <p>Some of the tests need dedicated local resources whose definitions
97        are stored in a configuration file. The tests are defined using
98        Python modules defining the code for the test, this is called
99        a <tt>test case</tt>, and test <tt>configuration files</tt> using one
100        or more test case to define a given test scenario.</p>
101         <p>For more details you can look at:</p>
102         <ul><li> A <a href="http://libvirt.org/sources/libvirt-test-API/Libvirt-test-API.pdf" shape="rect">documentation PDF</a>
103            file describing the test suite and how to write test cases
104            and test scenarios.</li></ul>
105         <p> Libvirt-test-API is maintained using
106         <a href="http://libvirt.org/git/?p=libvirt-test-API.git" shape="rect">a GIT
107         repository</a>, and comment, patches and reviews are carried
108         on the <a href="contact.html" shape="rect">libvir-list</a> development list.</p>
109       </div>
110     </div>
111     <div id="footer">
112       <p id="sponsor">
113             Sponsored by:<br /><a href="http://et.redhat.com/"><img src="et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p>
114     </div>
115   </body>
116 </html>