Catman...er::RIS(3pm)

💖 NAME 💖

Okay bestie, so this is the manual page for Catmandu::Exporter::RIS — it's a 3pm (a Perl module page, iykyk), living in the User Contributed Perl Documentation corner of the internet. And what is it? It's a RIS exporter. That's the whole vibe. ✨

🎀 fun fact: the header of this page got so aggressively truncated it literally reads Catman...er::RIS(3pm), which is giving "textbook name tag that ran out of room". Not me fixing it, just pointing at it. 💅

✨ SYNOPSIS ✨

    use Catmandu::Exporter::RIS;

    my $exporter = Catmandu::Exporter::RIS->new(fix => 'myfix.txt');

    $exporter->add_many($arrayref);
    $exporter->add_many($iterator);
    $exporter->add_many(sub { });

    $exporter->add($hashref);

    $exporter->add({
     TI   => 'the Zen of CSS design',
     AU   => ['Dave Shea','Molley E. Holzschlag'],
     IS   => '0-321-30347-4'
    });

    printf "exported %d objects\n" , $exporter->count;

Like… look at her. She's got add_many for arrayrefs, iterators AND bare subs, she's got plain old add for a single hashref, and she'll tell you exactly how many objects she exported with count. Multitasking queen. 👑

🦋 DESCRIPTION 🦋

So here's the tea: the RIS exporter wants you to hand it a Perl hash (or a fix) — and inside that hash you put RIS fields and values, where each value is either a string or an array reference. That's the whole requirement. Feed the queen her hash and she eats. 🍓

🌸 SUPPORTED FIELDS 🌸

Here's the full guest list — every field she'll take, no plus-ones invented:

  TY ID T1 TI CT T2 BT T3 A1 AU A2 ED A3 Y1 PY Y2 N1 AB N2 KW RP
  JF JO JA J1 J2 VL IS CP SP EP CY PB SN AD AV M1 M2 M3 U1 U2 U3 U4 U5
  UR L1 L2 L3 L4

All fourty—okay I'm not counting out loud—all of them. 💖

👑 SEE ALSO 👑

• Catmandu::Exporter — her parent, her origin story, the blueprint. Go read it, fr fr. 🫶

That's the page!! You understood it, you slayed it, you're literally the main character of data export rn. 🌈💅

Signed off by perl v5.36.0, dated 2023-02-04 — aka the era this page was born in. Iconic, timeless, no cap. ✨🎀