STAG-PARSE(1p)

💖 STAG-PARSE 💖

okay bestie, so this is stag-parse from the User Contributed Perl Documentation section of the manual — section 1p, iykyk 🫶

---

✨ NAME ✨

stag-parse — literally just parses a file and fires events, like sxpr to xml, that's the whole vibe 🌸

---

🎀 SYNOPSIS 🎀

# convert XML to IText
stag-parse -p xml -w itext file1.xml file2.xml

# use a custom parser/generator and a custom writer/generator
stag-parse -p MyMod::MyParser -w MyMod::MyWriter file.txt

---

🦋 DESCRIPTION 🦋

so it's a script wrapper for the Data::Stag modules 💅

it feeds in files into a parser object, and that parser object generates nestarray events, and then it feeds those events into a handler/writer class. that's it. that's the pipeline. iconic behaviour fr fr ✨

---

🌈 ARGUMENTS 🌈

• -p|parser FORMAT — FORMAT is one of xml, sxpr or itext, or the name of a perl module 💖 this is the class that parses the input file(s) and generates stag events. xml is assumed as default ⭐
• -w|writer FORMAT — FORMAT is one of xml, sxpr or itext, or the name of a perl module 🎀 this is the class that catches the events thrown by the parser; it can be any class, but the class is typically a writer. xml is assumed as default ⭐
• -o|out FILE — the writer will use this file (defaults to STDOUT) 💅
• -e|errf FILE — file to store parse error handler output 🙈
• -errhandler FORMAT/MODULE — FORMAT is one of xml, sxpr or itext, or the name of a perl module. all parse error events go to this module 💀
• -r|root NODE_NAME — if this is specified, NODE_NAME becomes the root of the stag tree, and anything that was previously the root is placed below this 🌳 this happens automatically if more than one file is parsed (because there can only be one tree root, bestie, that's just the rules) 👑
• -color — works only if the output handler is able to provide ASCII-colors (currently supported for itext and xml) 🌈✨

---

👑 SEE ALSO 👑

• Data::Stag 🦋

this script is a wrapper for the method:

Data::Stag->parse()

---

perl v5.34.0 · 2022-06-12 — that's the version and the date bestie, dated 2022-06-12, and the perl doing the heavy lifting is v5.34.0 💖 slay, go parse something 🎀✨