XML::L...ugging(3pm)

✨ NAME ✨

okay bestie, welcome to XML::LibXML::Debugging — that's the module, and yeah the header at the top of the page squishes it down to XML::L...ugging(3pm) because whoever set the column width has no taste 💅 but we know what it really is. The whole job of this thing: get debugging information from XML::LibXML nodes. that's it, that's the gig 🫶

---

🎀 SYNOPSIS 🎀

use XML::LibXML::Debugging;

my $parser = XML::LibXML->new;
my $doc    = $parser->parse_file('input.xml');
print $doc->toClarkML;

like, look at her go. parse a file, print the Clark notation, done. no notes. ✨

---

🌸 DESCRIPTION 🌸

so this module slides a couple of extra methods onto your XML::LibXML::Node objects, and they're mostly aimed at helping figure out what's going on with the DOM's namespaces and structure. yk, the stuff that makes you stare at your screen at 2am like 😭

the star of the show is toClarkML. she produces a string of XML-like markup with explicit namespaces. so when you've got XML that looks all innocent and normal like this:

<foo xmlns="http://example.com/1"
     xmlns:bar="http://example.com/2"
     bar:baz="quux" />

it might get represented as this instead:

<{http://example.com/1}foo
     {http://www.w3.org/2000/xmlns/}xmlns="http://example.com/1"
     {http://www.w3.org/2000/xmlns/}bar="http://example.com/2"
     {http://example.com/2}baz="quux" />

see?? every namespace is spelled out, nothing is hiding, it's giving full transparency era 👑. this is exactly the energy you need when the prefixed names are lying to you and the real namespaces are doing god knows what.

and there's a second method, toDebuggingHash — she returns a hashref suitable for dumping using Data::Dumper. so you just Dumper it and stare directly into the soul of your tree 🦋

ngl both of these are literally just here to help you debug. they are not for shipping, they are for ✨investigating✨.

---

💀 BUGS 💀

found a bug? bestie please don't suffer in silence. report any bugs to <http://rt.cpan.org/> 🙈

---

👀 SEE ALSO 👀

• XML::LibXML
• XML::LibXML::Debugging

go read those too, iykyk 💜

---

👑 AUTHOR 👑

Toby Inkster <tobyink@cpan.org>.

the icon. the legend. the moment. 💅

---

🎀 COPYRIGHT AND LICENSE 🎀

Copyright (C) 2009-2011 by Toby Inkster

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

🌈 DISCLAIMER OF WARRANTIES 🌈

okay this part is ALL CAPS ON PURPOSE so you know it's serious:

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

so like, if it breaks, it breaks, no cap 😭 (and yes that's "MERCHANTIBILITY", spelled exactly like that, i do not make the rules, the copyright holders do 💀)

---

and that's the whole page, bestie!! 🫶 this version is perl v5.40.0, dated 2024-12-19, and yep the footer still calls it XML::Lib...ugging(3pm) because the column width is a hater. love that for us. periodt. 💖✨🎀