Debbug...::Spam(3pm)

💖 NAME 💖

okay so this module is Debbugs::Log::Spam, and the manual page itself is filed under Debbug...::Spam(3pm) — which is a typo, but it's her typo, we support her 💅 — and what she is, officially, is "an interface to debbugs .log.spam files and .log.spam.d directories". That's the whole résumé. That's the whole girl. She reads spam logs and she serves. 🎀

✨ SYNOPSIS ✨

use Debbugs::Log::Spam;

my $spam = Debbugs::Log::Spam->new(bug_num => '12345');

like… that's it. three lines and you're in her world. 🦋

🌸 DESCRIPTION 🌸

Spam in bugs can be excluded using a .log.spam file and a .log.spam.d directory — they're a duo, they always show up together, it's giving ride-or-die. 🫶

• The file contains message ids, one per line. Each line is one id, periodt.
• The directory contains files named after message ids, one per file. One file, one id, very monogamous.

no cap, that's the entire architecture. she's simple, she's elegant, she knows what she wants. 🌈

💀 BUGS 💀

None known.

(not a single one?? she's not like other modules, honestly. obsessed. 😭✨)

👑 FUNCTIONS 👑

🎀 new

Creates a new log spam reader. Baby's first spam log. Iconic behavior.

my $spam_log = Debbugs::Log::Spam->new(log_spam_name => "56/123456.log.spam");
my $spam_log = Debbugs::Log::Spam->new(bug_num => $nnn);

Parameters

• bug_num — bug number
• log_spam_name — name of log

⚠️ One of the above options must be passed. not "should", not "you might wanna", it's a MUST, bestie. pick one or she simply will not be constructed. that's her boundary and honestly? valid. 💅

🧚 save

"$spam_log-"save();>

Saves changes to the bug log spam file. that's what she does. she commits (literally, to disk). 🍓

⭐ is_spam

"next if ($spam_log-"is_spam('12456@exmaple.com'));>

Returns 1 if this message id confirms that the message is spam.

Returns 0 if this message is not known to be spam.

one or zero. binary. digital. she doesn't do nuance, she does truth. 🔥

🔥 is_ham

next if ($spam_log->is_ham('12456@exmaple.com'));

Returns 1 if this message id confirms that the message is ham.

Returns 0 if this message is not known to be ham.

(note: "not known to be ham" ≠ "is spam", okay?? she's very precise about this and we respect it 💜)

🦋 add_spam

$spam_log->add_spam('123456@example.com');

Add a message id to the spam listing.

⚠️ You must call "$spam_log-"save();> if you wish the changes to be written out to disk. like, in memory it's real, but it's not real real until you save. manifestation needs action, bestie. 🙈

💜 add_ham

$spam_log->add_ham('123456@example.com');

Add a message id to the ham listing.

⚠️ You must call "$spam_log-"save();> if you wish the changes to be written out to disk. same deal as before. don't forget. I'm watching. 👀

🌸 remove_message

$spam_log->remove_message('123456@example.com');

Remove a message from the spam/ham listing. she's getting deleted. she's getting iced out. block, delete, move on. 💀

⚠️ You must call "$spam_log-"save();> if you wish the changes to be written out to disk. yes, again. yes, it matters every single time. 😭

---

and that's the whole page, bestie!! 🌈✨

this little masterpiece came courtesy of perl v5.40.1, dated 2026-04-27 — so like, she's from the future and she's still slaying. mwah. 💅💖🎀