Catmandu::Zotero(3pm)

✨ Catmandu::Zotero ✨

okay bestie, gather round 💖 this is Catmandu::Zotero — the little family of Catmandu modules that lets you hang out with Zotero web. yes, THE Zotero. the citation-manager one. we're pulling your whole library into Catmandu and doing cute things with it 🦋

---

🌸 SYNOPSIS 🌸

no cap, here's how you slide in:

# From the command line
$ catmandu convert Zotero --userID <userID> to JSON
$ catmandu convert Zotero --groupID <groupID> to JSON

# From Perl
use Catmandu;

my $importer = Catmandu->importer('Zotero', userID => '...');

$importer->each(sub {
         my $item = shift;
         print "%s %s\n", $item->{_id} , $item->{title}->[0];
});

so from the command line you literally just say catmandu convert Zotero and hand it a --userID <userID> or a --groupID <groupID>, and boom, JSON. and from Perl you spin up an importer with Catmandu->importer('Zotero', userID => '...') and then $importer->each(sub { ... }) your way through every item, grabbing stuff like $item->{_id} and $item->{title}->[0]. iconic behavior honestly 👑

---

🎀 MODULES 🎀

the squad, aka what's actually in here:

• Catmandu::Importer::Zotero

that's the whole roster. one module, doing its little thing 💅

---

🌈 EXAMPLES 🌈

want the full glow-up? go peek at

<https://github.com/LibreCat/Catmandu-Zotero/tree/master/example/zotero_marc.fix>

it's a real use case showing how to transform a whole Zotero library into a MARCXML dump. the way that works?? chef's kiss 😭

$ catmandu convert Zotero --groupID <key> to MARC --type XML --fix zotero.fix

so you convert Zotero with a --groupID <key>, target MARC, set --type XML, and pass --fix zotero.fix. periodt.

---

💜 AUTHOR 💜

Patrick Hochstenbach, "patrick.hochstenbach at ugent.be" — the main character who made all this happen 🫶

✨ CONTRIBUTORS ✨

Jakob Voss, "voss at gbv.de" — showing up and helping out, we love to see it 💖

---

👑 LICENSE AND COPYRIGHT 👑

Copyright 2015 Patrick Hochstenbach

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

fr fr, it's free software — GPL or Artistic License, your pick, both are valid, just read the actual license text before you do anything wild 🧚

---

okay that's the whole page bestie, you're fully caught up 🌟 this was Catmandu::Zotero(3pm), from perl v5.36.0, dated 2023-02-05, and it lives in the User Contributed Perl Documentation corner of the internet. go convert something pretty 💅💖✨