XML::XPathToXML 2.1.0

XML::XPathToXML is a Perl module that generates XML document from XPath expressions. SYNOPSIS my @data = ( /project/name => The Ultimate Question, /project/comment() => generated by XPathToXML , /project/start => 2002-09-08, /project/end => 7002002-09-08, /project/@id => 42, /project/temp/pre => 41, /project/temp/pre[position()=6] => 46, /project/temp/pre[3] => 43, /project/temp/pre[2] => XML::LibXML->new->parse_xml_chunk(q(arbitrary < b>XML< /b> chunk)), ); my $xpx = new XML::XPathToXML( debug=>1 ); $xpx->parse( @data ); $xpx->parse( /project/temp/pre[last()]/@guess, tooHigh ); print $xpx->documentElement->toString(1)."n"; Result: < project id="42"> < !-- generated by XPathToXML --> < name>The Ultimate Question< /name> < start>2002-09-08< /start> < end>7002002-09-08< /end> < temp> < pre>41< /pre> < pre>arbitrary < b>XML< /b> chunk< /pre> < pre>43< /pre> < pre/> < pre/> < pre guess="tooHigh">46< /pre> < /temp> < /project> Generates an XML document or node tree from one or more XPath expressions. Returnes an XML::LibXML::Document or XML::LibXML::Element. Only a limited subset of XPath is currently supported. Namely, the XPath expression must be a location path consisting of a /-separated sequence of one or more location steps along the child, sibling, or attribute axes. The node-test part of the expression cannot be neither a wildcard (*, @*, prefix:*, ...), nor the node() function. If a namespace prefix is used, then either the namespace must already be declared in the document or registered with an XPathContext object. Location steps may contain arbitrary predicates (filters), but see the details below. The parser processes the location path as follows: For an absolute location path (starting with /) the evaluation starts on the document node. For relative location path the evaluation starts on a specified initial context node. The parser evaluates the location path from left to right, one location step at a time, starting either on the document node (in case of absolute location path) or on a specified initial context node (in case of relative location paths). If the location step (including filters) matches a child node or an attribute of the current node, then the parser moves to the first node matched and to the next location step. If no nodes are matched by the location step, then the parser creates an element or attribute with the name (and possibly namespace) specified in the node-test part of the location step and tries again. If still no nodes are matched, the parser repeats the procedure until the location step matches or the number of sibling nodes created in this way reaches the limit specified in maximumAutoSiblings. In the first case the parser moves to the first matching node. In the latter case the parser fails (removing all sibling-nodes created for the failed location-step from the tree). Hence, if a filter predicate of a location step specifies a position of a node (e.g. with [4], or [position3], etc), then the parser tries to automatically create empty siblings nodes until it finally creates one with for which the predicate is true. Note, that because the parser only processes one location step at a time and always picks the first matching node, expressions like /root/a/b are treated as /root/a[1]/b[1]. So, in case of the document < root> < a/> < a> < b/> < /a> < /root> $xpx->parse(q(/root/a/b),foo) will result in < root> < a>< b>foo< /b>< /a> < a> < b/> < /a> < /root> although an element matching /root/a/b was already present in the document. To prevent this, either explicitly state that b must exist with /root/a[b]/b or set the second element a as the context node and use a relative location path such as b: $xpx->setContextNode($xpc->document->find(/root/a[2])->get_node(1)) $xpx->parse("b","foo"); # "./b" is also ok or simply $xpx->createNode("b","foo",$xpc->document->find(/root/a[2])->get_node(1)); In the tradition of XML::LibXML errors must be trapped with eval() (the parser dies on error)..

Requirements:	No special requirements
Platforms:	Linux
Keyword:	Document,  In Case Of,  Libraries,  Libxml,  Location,  Location Path,  Node,  Parser,  Path,  Perl Module,  Xml Document,  Xmlxpathtoxml,  Xpathtoxml
Users rating:	0/10