PITA::XML::SAXParser - Implements a SAX Parser for PITA::XML files

Although you won't need to use it directly, this class provides a "SAX Parser" class that converts a stream of SAX events (most likely from an XML file) and populates a PITA::XML with PITA::XML::Install objects.

Please note that this class is incomplete at this time. Although you can create objects and parse some of the tags, many are still ignored at this time (in particular the <output> and <analysis> tags.

In addition to the following documented methods, this class implements a large number of methods relating to its implementation of a XML::SAX::Base subclass. These are not considered part of the public API, and so are not documented here.

  # Create the SAX parser
  my $parser = PITA::XML::SAXParser->new( $report );

The new constructor takes a single PITA::XML object and creates a SAX Parser for it. When used, the SAX Parser object will fill the empty PITA::XML object with PITA::XML::Install reporting objects.

If used with a PITA::XML that already has existing content, it will add the new install reports in addition to the existing ones.

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

Bugs should be reported via the CPAN bug tracker at

http://rt.cpan.org/NoAuth/ReportBug.html?Queue=PITA-XML

For other issues, contact the author.

Adam Kennedy <adamk@cpan.org>, http://ali.as/

PITA::XML, PITA::XML::SAXDriver

The Perl Image-based 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.