MAGE::SQLUtils(3pm)

💖 MAGE::SQLUtils — ok bestie, let's talk 💖

so this page is from the MAGE::SQLUtils(3pm) manual — User Contributed Perl Documentation, to be exact — and the module it's actually about is Bio::MAGE::SQLWriter. Yes, the filename and the module name don't match. That's just how it is. We move. 🫶

✨ NAME ✨

Bio::MAGE::SQLWriter — a module for exporting MAGE-OM objects to a database. That's the whole vibe. Objects go in, database rows come out. 💅

🌸 SYNOPSIS 🌸

Here's the tea, literally:

use Bio::MAGE::SQLWriter;

my $writer = Bio::MAGE::SQLWriter->new(@args);
use dbhandle;
my $dbhandle = dbhandle->new();
$writer->obj2database($dbhandle,@object_list);

Make a writer, make a dbhandle, yeet your objects at the database. Iconic behaviour, no notes. ✨

🦋 DESCRIPTION 🦋

Methods for transforming information from a MAGE-OM objects into tuples in a MAGE database.

That's it, that's the mission statement. MAGE-OM object in, tuple in a MAGE database out. Lowkey the whole point of the module, highkey the whole point of this page. 🎀

👑 METHODS 👑

• write($MAGE_object); — write() prints the objects contained in $MAGE_object as MAGE-ML to the file handle used by the writer. Yes bestie, it says MAGE-ML even though we're in the SQL writer page. That's what it says, so that's what I'm telling you. 💖

💀 POD ERRORS 💀

Not me having to report that the document itself had some coding errors. 😭 The original page literally says this:

"Hey! The above document had some coding errors, which are explained below:"

And here's what went wrong:

Around line 249:

• '=item' outside of any '=over'
• =over without closing =back

So basically the POD got its brackets in a twist — an =item wandered off with no =over to belong to, and an =over never got its =back. Fr fr, it's giving unclosed tag energy. 🙈

And that's the whole page, bestie — written by the User Contributed Perl Documentation crew, running on perl v5.32.0 and dated 2020-12-01. Stay slaying, go export those objects. 🧚💜