STAG-JOIN(1)

📦
version 0.14 · 3 versions
, in fedora 43

✨ STAG-JOIN(1) ✨

okay bestie, welcome to the stag-join manual page 💖 it's a User Contributed Perl Documentation situation, and it's lowkey iconic, so let's get into it 🫶

🌸 NAME 🌸

stag-join — joins two stag files together based around common key ✨

🎀 SYNOPSIS 🎀

no cap, it's giving "just two lines and a dream":

stag-join  -w xml country/city_id=capital/capital_id countries.xml capitals.xml

stag-join  -w itext gene/tax_id=species/tax_id genedb.itext speciesdb.itext

🦋 DESCRIPTION 🦋

so what does it do, bestie? stag-join performs a relational-style INNER JOIN between two stag trees 🌳🌳 and fr fr, that effectively merges two files together, based on some kind of ID in the file 💅

it's the glow-up your two lonely data files have been waiting for. they meet. they match on ID. they become one. main character energy 👑

🌈 ARGUMENTS 🌈

  • -p|parser FORMAT — FORMAT is one of xml, sxpr or itext, or the name of a perl module 🧚 and heads up: xml is assumed as default, so if you don't say anything, xml is what you get 💖
  • -w|writer FORMAT — FORMAT is one of xml, sxpr or itext, or the name of a perl module ✨
ngl, the manual does not tell us a default for -w, so don't come for me — I'm just reporting what's on the page 🙈

💀 LIMITATIONS 💀

okay so real talk, currently not event based, so it may not be memory efficicent 😭 (that's a direct quote, typo and all, and yes I'm obsessed with it). the good news? it could be easily rewritten to be event based 🌈 so like, the potential is there, bestie.

🍓 SEE ALSO 🍓

  • Data::Stag 👑
  • This script is a wrapper for the method:
Data::Stag->ijoin()

iykyk 💅

🧚 POD ERRORS 🧚

Hey! The above document had some coding errors, which are explained below 😭 not me snitching on the docs, but here we are:

  • Around line 108:
    • '=item' outside of any '=over'
  • Around line 118:
    • You forgot a '=back' before a '=head1'
periodt. the pod parser said what it said 💀

🌸 and that's the whole page, bestie 🌸 this one came from perl v5.42.0, dated 2025-07-25 — slay, go join some trees 💖🦋🎀

📦 where this page comes from