Mail::...RFC2369(3pm)

💖 Mail::ListDetector::Detector::RFC2369 💖

okay so bestie, we're reading a perl manpage here — a 3pm one, which means it's a module, not a command you run in your shell. Sit down, grab a boba, we're gonna talk about the RFC2369 message detector and it's gonna be adorable. 🧋✨

---

🌸 NAME 🌸

Mail::ListDetector::Detector::RFC2369 — it's an RFC2369 message detector, no cap. That's the whole name, that's the whole job. 💅

---

✨ SYNOPSIS ✨

the entire vibe of using this, and yes it's literally one line:

use Mail::ListDetector::Detector::RFC2369;

that's it. that's the whole thing. iconic. 🎀

---

🦋 DESCRIPTION 🦋

so this module is an implementation of a mailing list detector, and it's specifically for mailing lists that are RFC2369 compliant. if a list speaks RFC2369, this detector is the one who clocked it. 👑

---

💅 METHODS 💅

🍓 new()

Inherited from Mail::ListDetector::Detector::Base. it didn't write this one itself, it borrowed it from its parent like a hoodie it never gives back. 🫶

🔥 match()

okay this is the main character method. it accepts a Mail::Internet object and hands you back either:

• a Mail::ListDetector::List object, if what you gave it is a post to a RFC2369 compliant mailing list, or
• undef 😭

and here's the caveat bestie, listen up: the RFC2369 standard does not REQUIRE all the information we wish to extract to be present. so basically this module may not be able to return full information for all RFC2369 compliant lists. it's not being lazy, the spec just said "nah, optional." 🙈

---

💀 BUGS 💀

No known bugs. clean sheet, no drama, we love a flawless queen. ✨

---

👑 AUTHOR 👑

Michael Stevens — michael@etla.org. 💜

---

fr fr, if you're feeding this a list that doesn't put all its cards on the table, don't be shocked when you get undef or partial tea. that's the RFC's fault, not the module's. 🫠

this little gem came bundled with perl v5.36.0, dated 2022-11-29, as part of the User Contributed Perl Documentation. mwah, go detect some lists, bestie. 😘🌈⭐