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 );
The 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.
new
Returns a new PITA::Guest object, or dies on error.
PITA::Guest
The file accessor returns the name of the file the Guest object was created from.
file
The PITA::XML file loads to a PITA::XML::Guest object which is held internally.
The guestxml accessor returns the PITA::XML::Guest object.
guestxml
The discovered method returns true if the Guest has gone through the discovery process that identifies testing platforms in the Guest, or false if not.
discovered
The driver method returns the PITA::Driver object within the PITA::Guest that the tests are run through.
driver
All guests are required to identify themselves.
The ping method is dispatched to the driver and does whatever is necesary to determine if the guest is live (and actually a PITA::Guest)
ping
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.
The discover method is dispatched to the driver, loading the Guest and interrogating it to determine the testing platforms available from it.
discover
Returns true (may take up to 5 minutes) if the testing platforms are correctly discovered, or dies if not.
$response = $guest->test( 'request.pita' );
The test method executes a single testing request.
test
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.
save
Returns true or dies on error.
Bugs should be reported via the CPAN bug tracker at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=PITA
For other issues, contact the author.
Adam Kennedy <adamk@cpan.org>
The Practical Image Testing Architecture (http://ali.as/pita/)
PITA::XML, PITA::Scheme
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.
To install PITA, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PITA
CPAN shell
perl -MCPAN -e shell install PITA
For more information on module installation, please visit the detailed CPAN module installation guide.