Mail::...Listbox(3pm)

πŸ“¦
version 1.04 Β· 4 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

πŸ’– Mail::ListDetector::Detector::Listbox πŸ’–

okay bestie, welcome to the manual page for Mail::...Listbox(3pm) β€” yes that's the perl manpage name, yes it's giving "my module name is a whole sentence", we move. This is a Listbox message detector and she's here to clock whether a mail is a post to a Listbox mailing list. Let's get into it πŸ’…


✨ NAME ✨

Mail::ListDetector::Detector::Listbox β€” a Listbox message detector, periodt.


🌸 SYNOPSIS 🌸

use Mail::ListDetector::Detector::Listbox;

that's it, that's the whole vibe. one line. slay.


πŸ¦‹ DESCRIPTION πŸ¦‹

so basically this is an implementation of a mailing list detector, specifically for Listbox mailing lists. and what is Listbox, you ask? it's a commercial list hosting service β€” if you wanna know more about Listbox itself, the details live at http://www.listbox.com/. iykyk 🫢

now here's the tea, and it's important tea πŸ“: Listbox mailing list messages look like RFC2919 messages to the current RFC2919 detector β€” although they are not compliant. not compliant!! the audacity. 😭 but this module comes through with more information, and she does not test for their full compliance (unlike, say, a future RFC2919 module might β€” that's future-bestie's problem, not ours).

and because of that exact reason: this module must be installed before the RFC2919 module. no cap. that's the order. don't fight it. ✨


πŸŽ€ METHODS πŸŽ€

πŸ’œ new()

inherited from Mail::ListDetector::Detector::Base. she's not reinventing the wheel, she's borrowing it. iconic behaviour honestly.

🌈 match()

accepts a Mail::Internet object and returns either:

  • a Mail::ListDetector::List object β€” if it is a post to a Listbox mailing list πŸ”₯
  • undef β€” if it is not πŸ’€

that's it. match made, or match denied. the drama of it all.


πŸ’… BUGS πŸ’…

no known bugs. (yes we're as shocked as you are. she's flawless. πŸ‘‘)


⭐ NOTES ⭐

huge thank you to Mark Overmeer <Mark@Overmeer.net> for asking, and to Meng Weng Wong <mengwong@pobox.com> for adding the List-Software header to Listbox mails so this detector could be more robust. kings, honestly. the way they just... made it better. obsessed. 🫢


🧚 AUTHOR 🧚

  • Matthew Walker - matthew@walker.wattle.id.au
  • Michael Stevens - michael@etla.org
  • Peter Oliver - p.d.oliver@mavit.freeserve.co.uk
  • Tatsuhiko Miyagawa <miyagawa@bulknews.net>

and the licensing moment, because we respect legal besties: this library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. periodt. πŸ’–


okay that's the whole page, bestie! πŸ’– no SEE ALSO section in this one, so nothing to link out to β€” just you, me, and a very compliant-adjacent Listbox detector.

and a lil sign-off for the record books: this page comes from perl v5.36.0, dated 2022-11-29. written by the Perl documentation girlies, read by you, at Mail::...Listbox(3pm). bye bestie, go detect some lists! πŸŽ€βœ¨πŸ¦‹

πŸ“¦ where this page comes from