PITA::Guest - The PITA Guest abstract, a container for running tests
All testing is run inside a Guest, a container object usually involving a system image and a configuration.
This class implements the Guest abstraction.
$guest = PITA::Guest->new( 'guest-51231.pita' ); $guest = PITA::Guest->new( \$file_content ); $guest = PITA::Guest->new( $guest_xml_object );
new constructor creates a new PITA::Guest object from an XML description. It takes a single param of either a PITA::XML::Guest object, a string which is the name of a PITA file containing the XML description, or a SCALAR reference (which may be a constant SCALAR ref) containing the XML.
Returns a new
PITA::Guest object, or dies on error.
file accessor returns the name of the file the Guest object was created from.
guestxml accessor returns the PITA::XML::Guest object.
discovered method returns true if the Guest has gone through the discovery process that identifies testing platforms in the Guest, or false if not.
All guests are required to identify themselves.
ping method is dispatched to the driver and does whatever is necesary to determine if the guest is live (and actually a
Returns true (may take up to 5 minutes) or false if not.
Most often the detailed of a Guest are provided without identifying what is set up inside them.
discover method is dispatched to the driver, loading the Guest and interrogating it to determine the testing platforms available from it.
Returns true (may take up to 5 minutes) if the testing platforms are correctly discovered, or dies if not.
$response = $guest->test( 'request.pita' );
test method executes a single testing request.
It takes as argument the name of a PITA::XML file with a <request> at the root. Loads the request and dispatches it to the driver, which will load the Guest, inject the test request and package, and then hand back the response once it is completed.
Depending on the package, this could take from minutes to hours to run.
Returns a PITA::XML::Report object, or dies on error.
The PITA::Guest object remembers the name of the file it was loaded from.
If you run
discover, then afterwards your can run
save to save the now-discovered Guest back to a file.
Returns true or dies on error.
Bugs should be reported via the CPAN bug tracker at
For other issues, contact the author.
Adam Kennedy <firstname.lastname@example.org>
The Practical Image Testing Architecture (http://ali.as/pita/)
Copyright 2005 - 2011 Adam Kennedy.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.