1:21 a.m.
This is really a dual mail. The main point is announcing the
availability of the livirt-test-API, a GPL'ed Python based test
suite for libvirt functional testing. It was developped independantly
of the TCK by our QA group here in Beijing China and is now made
open-source. The software requirements are relatively light and
it has been tested on RHEL various versions (5.x and 6.x) as well as
Fedora 14. It should be relatively easy to use on Centos, SL,
but use on other distributions may need a bit of porting.
It has been in use for quite some time,, it is still in development
and the public repository is in libvirt.org git at:
http://libvirt.org/git/?p=libvirt-test-API.git
and can be cloned with
git clone git://libvirt.org/libvirt-test-API.git
there is some pblican based documentation under the docs/ subtree and
we have a PDF ready ans well as snapshots in the download tree
http://libvirt.org/sources/libvirt-test-API/
ftp://libvirt.org/libvirt/libvirt-test-API/
There is a lot of improvements possible, it should be relatively
easy to glue to autotest (c.f. chapter 5 of the PDF), and there is
definitely cleanups to be done :-) , I think the best way to proceed
is to just send git patches here on the libvir-list and have them
reviewed and ACK'ed. People with commit access should be able to
push as usual, note that I added Guannan Ren <gren(a)redhat.com>
as a commiter for this purpose since he has much expertise with that
code (along with Osier).
Now for the patch itself, it add a top level section in the
navigation bar, provide a main description page for the 3 test suites
(internal, TCK and libvirt-test-API) and then add a separate full
page for the 2 independant test suite.
I hesitated between creating a new doc section and trying to reuse
one existing, but it didn't fit well in any of the existing section,
though that could have been added under "Download" or "Related links"
but it was feeling a bit weird in both case so I opted for a new top
level.
Daniel
--
Daniel Veillard | libxml Gnome XML XSLT toolkit http://xmlsoft.org/
daniel(a)veillard.com | Rpmfind RPM search engine http://rpmfind.net/
http://veillard.com/ | virtualization library http://libvirt.org/
11:46 a.m.
On 05/10/2011 12:21 AM, Daniel Veillard wrote:
I hesitated between creating a new doc section and trying to reuse
one existing, but it didn't fit well in any of the existing section,
though that could have been added under "Download" or "Related
links"
but it was feeling a bit weird in both case so I opted for a new top
level.
Seems okay to me.
Add documentation about test suites
Create a new top level entry, add a new page listing the 3
test suites, and then one page for the TCK and one page for
libvirt-test-API
diff --git a/docs/testapi.html.in b/docs/testapi.html.in
new file mode 100644
index 0000000..a71c09a
--- /dev/null
+++ b/docs/testapi.html.in
@@ -0,0 +1,34 @@
+<?xml version="1.0"?>
+<html>
+ <body>
+ <h1>libvirt-test-API: Python based test suite </h1>
+ <p>Libvirt-test-API is a powerful test tool designed to complement
+ existing libvirt test tools such as libvirt-TCK and the internal
+ test suite. It aims at functional regression testing, trying to
+ exercize nearly all the API by the way of the Python bindings.</p>
s/exercize/exercise/
(We probably already have a mix of US vs. UK spellings on the web pages,
but I think the preference has been to settle on US)
+++ b/docs/testsuites.html.in
@@ -0,0 +1,37 @@
+<?xml version="1.0"?>
+<html>
+ <body>
+ <h1>Test suites</h1>
+ <p>There is a few test suites available to developpers for testing
s/developpers/developers/
+ a given version of libvirt:</p>
+ <ul>
+ <li>the internal test suite: present in the source code, it is run
+ by developpers before submitting patches upstream, it is also
s/developpers/developers/
+++ b/docs/testtck.html.in
@@ -0,0 +1,39 @@
+<?xml version="1.0"?>
+<html>
+ <body>
+ <h1>libvirt TCK : Technology Compatibility Kit</h1>
+ <p>The libvirt TCK provides a framework for performing testing
+ of the integration between libvirt drivers, the underlying virt
+ hypervisor technology, related operating system services and system
+ configuration. The idea (and name) is motivated by the Java TCK.</p>
+ <p>In particular the libvirt TCK is intended to address the following
+ scenarios:</p>
+ <ul>
+ <li>Validate that a new libvirt driver is in compliance
+ with the (possibly undocumented!) driver API semantics</li>
+ <li>Validate that an update to an existing driver does not
+ change the API semantics in a non-compliant manner</li>
+ <li>Validate that a new hypervisor release is still providing
+ compatability with the corresponding libvirt driver usage</li>
s/compatability/compatibility/
+ <li>Validate that an OS distro deployment consisting of
a
+ hypervisor and libvirt release is configured correctly</li>
+ </ul>
+ <p>Thus the libvirt TCK will allow developers, administrators and users
+ to determine the level of compatability of their platform, and
s/compatability/compatibility/
ACK with those spelling nits fixed.
--
Eric Blake eblake(a)redhat.com +1-801-349-2682
Libvirt virtualization library http://libvirt.org
6:23 a.m.
On Tue, May 10, 2011 at 10:46:11AM -0600, Eric Blake wrote:
On 05/10/2011 12:21 AM, Daniel Veillard wrote:
> I hesitated between creating a new doc section and trying to reuse
> one existing, but it didn't fit well in any of the existing section,
> though that could have been added under "Download" or "Related
links"
> but it was feeling a bit weird in both case so I opted for a new top
> level.
Seems okay to me.
[...]
ACK with those spelling nits fixed.
Thanks ! done, I also removed 2 trailing white spaces :-)
Daniel
--
Daniel Veillard | libxml Gnome XML XSLT toolkit http://xmlsoft.org/
daniel(a)veillard.com | Rpmfind RPM search engine http://rpmfind.net/
http://veillard.com/ | virtualization library http://libvirt.org/
5114
days inactive
5115
days old
2 comments
2 participants
participants (2)
-
Daniel Veillard -
Eric Blake