Catman...PubMed(3pm)

💖 Catman...PubMed(3pm) 💖

okay bestie, welcome to Catmandu::Importer::PubMed, which lives in the User Contributed Perl Documentation section of your man pages. yes, the name is doing a little bit with the dots. it's giving "the terminal truncated my filename and honestly? valid." anyway. 🦋

✨ NAME ✨

Catmandu::Importer::PubMed — it's the package that imports PubMed data. that's it, that's the whole job. no cap. 🧬

🌸 SYNOPSIS 🌸

here's how you actually use it, and yes you're gonna copy this verbatim because it slays:

use Catmandu::Importer::PubMed;

my %attrs = (
  term => 'github'
);

my $importer = Catmandu::Importer::PubMed->new(%attrs);

my $n = $importer->each(sub {
  my $hashref = $_[0];
  # ...
});

so real talk: you use the module, you build yourself a %attrs hash where the term key is set to 'github' in this lil example (yes, 'github' is literally the search term here, iconic choice tbh), you hand that hash to ->new(%attrs) to spin up your $importer, and then you call $importer->each(...) with a callback. each item that comes out lands in $hashref as $_[0], and the whole thing returns $n — which is just sitting there waiting for you to do something with it. the # ... is where you live, bestie. main character energy. 💅

🎀 SEE ALSO 🎀

• Catmandu::Iterable — go look at this one too, fr fr, it's the whole vibe family your importer belongs to. 🫶

that's the whole page, no filler, no fluff, we ate and left no crumbs. 👑

ngl there are no options, no environment variables, no exit statuses, no bug notes and no license lines on this one — it's a tiny page and we're not inventing stuff that isn't there. periodt. 💀

this gorgeous little page ships with perl v5.36.0, dated 2023-02-04, and it answers to the name Catman...PubMed(3pm) forever and always 💖