View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Adam Kennedy > PITA-0.60 > PITA::Guest



Annotate this POD


New  2
Open  0
View/Report Bugs
Module Version: 0.60   Source  


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.

Returns a new PITA::Guest object, or dies on error.


The file accessor returns the name of the file the Guest object was created from.


The PITA::XML file loads to a PITA::XML::Guest object which is held internally.

The guestxml accessor returns the PITA::XML::Guest object.


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.


The driver method returns the PITA::Driver object within the PITA::Guest that the tests are run through.


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)

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.

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.

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 <>


The Practical Image Testing Architecture (



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.

syntax highlighting: