Test::XML(3pm) User Contributed Perl Documentation Test::XML(3pm)NAME
Test::XML - Compare XML in perl tests
SYNOPSIS
use Test::XML tests => 3;
is_xml( '<foo />', '<foo></foo>' ); # PASS
is_xml( '<foo />', '<bar />' ); # FAIL
isnt_xml( '<foo />', '<bar />' ); # PASS
is_well_formed_xml('<foo/>'); # PASS
is_well_formed_xml('<foo>'); # FAIL
DESCRIPTION
This module contains generic XML testing tools. See below for a list of other modules with functions relating to specific XML modules.
FUNCTIONS
is_xml ( GOT, EXPECTED [, TESTNAME ] )
This function compares GOT and EXPECTED, both of which are strings of XML. The comparison works semantically and will ignore
differences in syntax which are meaningless in xml, such as different quote characters for attributes, order of attributes or empty tag
styles.
Returns true or false, depending upon test success.
isnt_xml( GOT, MUST_NOT_BE [, TESTNAME ] )
This function is similiar to is_xml(), except that it will fail if GOT and MUST_NOT_BE are identical.
is_well_formed_xml( XML [, TESTNAME ] )
This function determines whether or not a given XML string is parseable as XML.
is_good_xml ( XML [, TESTNAME ] )
This is an alias for is_well_formed_xml().
NOTES
There are several features of XML::SemanticDiff that may suprise you if you are not aware of them. In particular:
o Leading and trailing whitespace is always stripped, even in elements with character content.
o Whitespace inside character content is always stripped down to a single space.
o In mixed content elements (ie: an element with both text and elements beneath it), all text is treated as a single value.
o The order of elements is ignored.
SEE ALSO
Test::XML::SAX, Test::XML::Twig.
Test::More, XML::SemanticDiff.
AUTHOR
Dominic Mitchell, <cpan2 (at) semantico.com>
COPYRIGHT AND LICENSE
Copyright 2002 by semantico
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
perl v5.14.2 2009-07-02 Test::XML(3pm)
Check Out this Related Man Page
Test::XML::Simple(3pm) User Contributed Perl Documentation Test::XML::Simple(3pm)NAME
Test::XML::Simple - easy testing for XML
SYNOPSIS
use Test::XML::Simple tests=>5;
xml_valid $xml, "Is valid XML";
xml_node $xml, "/xpath/expression", "specified xpath node is present";
xml_is, $xml, '/xpath/expr', "expected value", "specified text present";
xml_like, $xml, '/xpath/expr', qr/expected/, "regex text present";
xml_is_deeply, $xml, '/xpath/expr', $xml2, "structure and contents match";
# Not yet implemented:
# xml_like_deeply would be nice too...
DESCRIPTION
"Test::XML::Simple" is a very basic class for testing XML. It uses the XPath syntax to locate nodes within the XML. You can also check all
or part of the structure vs. an XML fragment.
TEST ROUTINES
xml_valid $xml, 'test description'
Pass an XML file or fragment to this test; it succeeds if the XML (fragment) is valid.
xml_node $xml, $xpath, 'test description'
Checks the supplied XML to see if the node described by the supplied XPath expression is present. Test fails if it is not present.
xml_is_long $xml, $xpath, $value, 'test description'
Finds the node corresponding to the supplied XPath expression and compares it to the supplied value. Succeeds if the two values match.
Uses Test::More's "is" function to do the comparison.
xml_is $xml, $xpath, $value, 'test description'
Finds the node corresponding to the supplied XPath expression and compares it to the supplied value. Succeeds if the two values match.
Uses Test::LongString's "is_string" function to do the test.
xml_like_long $xml, $xpath, $regex, 'test description'
Find the XML corresponding to the the XPath expression and check it against the supplied regular expression. Succeeds if they match. Uses
Test::More's "like" function to do the comparison.
xml_like $xml, $xpath, $regex, 'test description'
Find the XML corresponding to the the XPath expression and check it against the supplied regular expression. Succeeds if they match. Uses
Test::LongString's "like_string" function to do the test.
xml_is_deeply_long $xml, $xpath, $xml2, 'test description'
Find the piece of XML corresponding to the XPath expression, and compare its structure and contents to the second XML (fragment) supplied.
Succeeds if they match in structure and content. Uses Test::More's "is" function to do the comparison.
xml_is_deeply $xml, $xpath, $xml2, 'test description'
Find the piece of XML corresponding to the XPath expression, and compare its structure and contents to the second XML (fragment) supplied.
Succeeds if they match in structure and content. Uses Test::LongString's "is_string" function to do the test.
AUTHOR
Joe McMahon, <mcmahon@cpan.org>
LICENSE
Copyright (c) 2005 by Yahoo! and Joe McMahon
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6.1 or,
at your option, any later version of Perl 5 you may have available.
SEE ALSO
XML::XPath, Test::More, Test::Builder.
perl v5.14.2 2012-06-05 Test::XML::Simple(3pm)