STAG-SPLITTER(1)

💖 STAG-SPLITTER(1) 💖

okay bestie, welcome to stag-splitter, a lil script from the User Contributed Perl Documentation corner of the universe. she splits a stag file into multiple files and honestly? she's iconic for it. let's get into it 🦋

---

✨ NAME ✨

stag-splitter — splits a stag file into multiple files. that's it, that's the whole job, and she does it flawlessly 💅

---

✨ SYNOPSIS ✨

stag-splitter -split person -name social_security_no file.xml

like. one line. boom. files. periodt 👑

---

✨ DESCRIPTION ✨

so here's the vibe: this thing splits a file using a user specified parser (default is xml, no cap) around a specified split node, and it names each file according to the name argument.

the files will be named anonymously unless the -name switch is specified — in which case it uses the value of the specified element as the filename. cute, right? 🎀

eg; if we have

<top>
  <a>
    <b>foo</b>
    <c>yah</c>
    <d>
      <e>xxx</e>
    </d>
  </a>
  <a>
    <b>bar</b>
    <d>
      <e>wibble</e>
    </d>
  </a>
</top>

if we run

stag-splitter -split a -name b

it will generate two files, "foo.xml" and "bar.xml". not me crying over how clean that is 😭✨

input format can be 'xml', 'sxpr' or 'itext' — and if this is left blank, the format will be guessed from the file suffix. she's psychic like that 🔮

the output format defaults to the same as the input format, but another can be chosen. your split, your rules 💁♀️

files go in the current directory, but this can be overridden with the '-dir' switch. yes bestie, you CAN put them somewhere else 🌸

---

✨ USAGE ✨

stag-splitter [-split <ELEMENT-NAME>] [-name <ELEMENT-NAME>] [-dir <DIR>] [-format <INPUT-FORMAT>] [-outformat <OUTPUT-FORMAT>] <FILENAMES>

---

🌈 OPTIONS 🌈

• -p|parser FORMAT — FORMAT is one of xml, sxpr or itext, or the name of a perl module. xml is assumed as default 🐣
• -w|writer FORMAT — FORMAT is one of xml, sxpr or itext, or the name of a perl module. (yes, you can hand her a whole module name, she's flexible like that 💜)
• -split|s NODE — the node to split on. this is the main character of the whole operation 👑
• -name|n NODE — the field/element to use when naming files. if you don't specify this argument, she'll use surrogate IDs instead 🍓
• -name|n NODE — hmm wait no bestie, scroll up, we already covered that one 🙈 the actual last one is:
• -dir|d DIR — write files to this directory. go forth and organize 📁✨

lowkey important: if -name isn't specified, the filenames come from surrogate IDs. so if your files look weird and anonymous, that's why, and it's not a bug, it's just the default vibe 💀

---

that's the whole page, bestie!! 🫶 go split some files, you absolute legend. slay 💖

---

with love, this page came from perl v5.42.0 and is dated 2025-07-25. mwah 😘 🌸🦋✨