Catmandu::Atom(3pm)

💖 Catmandu::Atom — the manual page, but make it cute 💖

okay bestie, welcome to Catmandu::Atom(3pm) — it's the Perl manual page for the little family of modules that handle Atom feeds. yep, the feed format. we're doing this. it's giving "structured data, but make it adorable" ✨

---

🌸 NAME 🌸

Catmandu::Atom — modules for working with Atom feeds 🦋

like, that's it. that's the whole vibe. Atom feeds in, stuff out. slay.

---

✨ SYNOPSIS ✨

okay so here's how you actually use it, straight up, no edits:

# From the command line
catmandu convert Atom --url http://my.host.org/feed.atom to JSON

# From Perl

use Catmandu;

my $importer = Catmandu->importer('Atom', url => 'http://my.host.org/feed.atom');

$importer->each(sub {
        my $entry = shift;

        printf "%s\n" , $entry->{title};
});

two ways in, bestie: you can do it from the command line with catmandu convert and feed it a --url pointing at your .atom file, and it converts to JSON, periodt. OR you go full Perl mode, grab Catmandu, build an importer with Catmandu->importer('Atom', url => '...'), then $importer->each(sub { ... }) over every entry and do whatever you want with each $entry. here it's printing $entry->{title} with printf "%s\n". iconic. 🔥

---

🎀 MODULES 🎀

the squad. the whole crew. no cap:

• Catmandu::Exporter::Atom 💅
• Catmandu::Importer::Atom 💅

---

👑 AUTHOR 👑

Nicolas Steenlant, <nicolas.steenlant at ugent.be> — the originator, the main character 🌟

---

🌈 CONTRIBUTOR 🌈

• Vitali Peil, <vitali.peil at uni-bielefeld.de>
• Nicolas Franck, <nicolas.franck at ugent.be>

shoutout to the contributors, they really said "we'll help" and then helped 🫶

---

🧚 MAINTAINER 🧚

Patrick Hochstenbach, <patrick.hochstenbach at ugent.be> — holding it down, keeping the lights on 💜

---

and that's the whole page, bestie! this one's from perl v5.36.0, dated 2022-12-10, and it lives in the User Contributed Perl Documentation section of the manual, filed under Catmandu::Atom(3pm) 💖 okay bye, go convert some feeds, ily 🦋✨