DumpXML::Parser(3pm)

💖 DumpXML::Parser 💖

okay bestie, so this is a page from the User Contributed Perl Documentation for the DumpXML::Parser manual (3pm section) and honestly? it's a little gem. let's get into it 🫶

---

✨ NAME ✨

Data::DumpXML::Parser — literally the "undo" button for stuff you dumped with Data::DumpXML. Restore data dumped by Data::DumpXML, no cap.

---

🌸 SYNOPSIS 🌸

the vibe check, in code form:

use Data::DumpXML::Parser;

my $p = Data::DumpXML::Parser->new;
my $data = $p->parsefile(shift || "test.xml");

---

🦋 DESCRIPTION 🦋

So Data::DumpXML::Parser is an XML::Parser subclass — like, it inherited the whole personality but picked up a new hobby 💅 — and what it does is recreate the data structure from an XML document that was produced by Data::DumpXML.

The parserfile() method hands you back a reference to an array of the values that got dumped. that's it, that's the whole glow-up ✨

---

🎀 the constructor 🎀

The constructor method new() takes one single additional argument on top of whatever XML::Parser already takes. just the one. and it's this:

• Blesser => CODEREF — a subroutine that gets invoked to bless the restored objects. The way it works: the subroutine is called with two arguments — a reference to the object, and a string containing the class name. If you don't provide one, the built-in bless function gets used instead. default behaviour, no extra work required 🫶

⚠️ okay real talk, listen up: if the input file can't necessarily be trusted, blessing arbitrary Classes might give malicious input the ability to exploit the DESTROY methods of modules used by your code. that is not the vibe. so for those situations it's a good idea to provide a no-op blesser:

my $p = Data::DumpXML::Parser->new(Blesser => sub {});

see how that sub just... does nothing? iconic. does nothing, protects everything 💅✨

---

🔥 SEE ALSO 🔥

• Data::DumpXML
• XML::Parser

go read those too, iykyk 📚

---

👑 AUTHOR 👑

Copyright 2001 Gisle Aas.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. fr fr, that's the whole license tea ☕

---

and that's the page, bestie!! 💖 it's giving perl v5.34.0, dated 2022-06-12, and it lives in the DumpXML::Parser(3pm) era of the manual pages. go forth and parse responsibly, mwah 😘💅🌸