STAG-HANDLE(1p)

💖 STAG-HANDLE ✨

okay so bestie, meet stag-handle — she's living in the User Contributed Perl Documentation, section 1p, and she is so good at what she does 🫶

---

🌸 NAME 🌸

stag-handle — streams a stag file through a handler into a writer 💅

---

🦋 SYNOPSIS 🦋

  stag-handle -w itext -c my-handler.pl myfile.xml > processed.itext
  stag-handle -w itext -p My::Parser -m My::Handler myfile.xml > processed.itext

---

🌈 DESCRIPTION 🌈

so here's the vibe: she takes a Stag compatible format (xml, sxpr or itext), turns that data into an event stream, and runs it through my-handler.pl. that's it, that's the whole main character move 👑

---

🎀 ARGUMENTS 🎀

• -help, h — shows this document 📖
• -module, -m PERLMODULE — a module that is used to transform the input events. bestie, this module should inherit from Data::Stag::BaseHandler ✨
• -unit, -u NODE_NAME — (you should always use this option if you specify -m, fr fr 🙈)

this is the unit that gets passed to the handler/transformer. it will get set automatically if you use the -c, -s or -t options — no cap 💅

multiple units can be set, like:

  -u foo -u bar -u boz

• -writer, -w WRITER — writer for the final transformed tree; can be xml, sxpr or itext 🦋
• -module, -m MODULE — perl modules for handling events 💜
• -codefile, -c FILE — a file containing a perlhashref containing event handlers — see below 👀
• -sub, -s PERL — a perl hashref containing handlers 🍓
• -trap, -t ELEMENT=SUB — 🌸

---

🔥 EXAMPLES 🔥

  unix> cat my-handler.pl
  {
    person => sub {
        my ($self, $person) = @_;
        $person->set_fullname($person->get_firstname . ' ' .
                           $person->get_lastname);
        $person;
    },
    address => sub {
        my ($self, $address) = @_;
        # remove addresses altogether from processed file
        return;
    },
  }

---

ngl that address handler is a whole mood — it literally returns nothing so the addresses get yeeted out of the processed file entirely 💀

---

and that's the tea, bestie 🫶 this icon is running under perl v5.34.0, dated 2022-06-12, and she ate, periodt ✨🎀💖