NAME

SYNOPSIS

  use XML::Schematron;
  my $pseudotron = XML::Schematron->>new_with_traits( traits => ['LibXSLT'], schema => 'my_schema.xml');
  my $messages = $pseudotron->verify('my_doc.xml');

  if ($messages) {
      # we got warnings or errors during validation...
      ...
  }

  OR, in an array context:

  my $pseudotron = XML::Schematron::LibXSLT->new(schema => 'my_schema.xml');
  my @messages = $pseudotron->verify('my_doc.xml');


  OR, just get the generated xsl:

  my $pseudotron = XML::Schematron::LibXSLT->new(schema => 'my_schema.xml');
  my $xsl = $pseudotron->dump_xsl; # returns the internal XSLT stylesheet.

DESCRIPTION

A simplified example: <?xml version="1.0" ?> <schema> <pattern> <rule context="page"> <assert test="count(*)=count(title|body)">The page element may only contain title or body elements.</assert> <assert test="@name">A page element must contain a name attribute.</assert> <report test="string-length(@name) &lt; 5">A page element name attribute must be at least 5 characters long.</report> </rule> </pattern> </schema>

Note that an 'assert' rule will return if the result of the test expression is not true, while a 'report' rule will return only if the test expression evalutes to true.

METHODS

• schema

  The filename of the schema to use for generating tests.

• tests

  The tests argument is an alternative to the use of a schema as a means for defining the test stack. It should be a reference to a list of lists where the format of the sub-lists must conform to the following order:

    [$xpath_exp, $context, $message, $test_type, $pattern]
      

schema()

When called with a single scalar as its argument, this method sets/updates the schema file to be used for generatng tests. Otherwise, it simply returns the name of the schema file (if any).

The add_test() method allows you push additional a additional test on to the stack before validation. This method's argument must be an XML::Schematron::Test object or a hash reference with the following structure:

Arguments for this method:

add_tests( @tests );

The add_tests() method allows you push an additional list of tests on to the stack before validation. Each element must be an XML::Schematron::Test object or a hash reference. See above for the list of key/value pairs expected if hashrefs are used.

verify('my_xml_file.xml' or $some_xml_string)

The verify() method takes the path to the XML document that you wish to validate, or a scalar containing the entire document as a string, as its sole argument. It returns the messages that are returned during validation. When called in an array context, this method returns an array of the messages generated during validation. When called in a scalar context, this method returns a concatenated string of all output.

dump_xsl;

The dump_xsl method will return the internal XSLT script created from your schema.

CONFORMANCE

For those platforms on which libxslt is not available, please see the documentation for XML::Schematron::XPath (also in this distribution) for alternatives.

AUTHOR

COPYRIGHT

SEE ALSO

For information about how to install libxslt and the necessary XML::LibXSLT Perl module, please see http://xmlsoft.org/XSLT/ and CPAN, repectively.

For detailed information about the XPath syntax, please see the W3C XPath Specification at: http://www.w3.org/TR/xpath.html

POD ERRORS

Around line 126:

'=item' outside of any '=over'

Around line 179:

'=item' outside of any '=over'