Sympa::Spool::Incoming(3Sympa)

💌 Sympa::Spool::Incoming(3Sympa)

okay bestie, this is a page from the sympa 6.2.80 manuals (yes the whole "3Sympa" thing is just the section, we don't gotta talk about it) and it's all about the spool where your incoming messages land. group chat for email, basically. let's get into it 💅

---

✨ NAME ✨

Sympa::Spool::Incoming — the spool for incoming messages. that's it, that's the vibe. it's the inbox pile before anything else touches it 🎀

---

🌸 SYNOPSIS 🌸

use Sympa::Spool::Incoming;
my $spool = Sympa::Spool::Incoming->new;

$spool->store($message);

my ($message, $handle) = $spool->next;

literally four lines and you're already storing and pulling messages. iconic behavior, no notes 🫶

---

💖 DESCRIPTION 💖

Sympa::Spool::Incoming implements the spool for incoming messages. think of it as the landing zone — messages show up here first and then the rest of the pipeline deals with them. main character energy fr fr ✨

🦋 Methods

also peep "Public methods" in Sympa::Spool for the stuff it inherits, bc this class is not doing all the work alone.

• next ( [ no_filter => 1 ], [ no_lock => 1 ] ) — grabs the next message off the spool. the order is controlled by the modification time of the file and the delivery date, and then — if no_filter is not set — messages that might have higher priority get picked first, and the messages with the lowest priority ("z" or "Z") get skipped entirely. so like, it's a whole queue with opinions and we respect that 💅
• store ( $message, [ original => $original ] ) — puts a message into the spool. in most cases it's the queue(8) program that stores messages into the incoming spool, but a daemon like sympa_automatic(8) also uses this method to store messages. team effort bestie 🌈

🎀 Context and metadata

also check "Marshaling and unmarshaling metadata" in Sympa::Spool for how this whole metadata thing works, iykyk.

this class is extra special and hands you this one piece of metadata in particular:

• {date} — Unix time for when the message would be delivered. the when, the moment, the timestamp of it all ⭐

---

👑 CONFIGURATION PARAMETERS 👑

these site configuration parameters in sympa.conf get referred to, so write them down bestie:

• queue — the directory path of the incoming spool. that's where the messages live 🏠

---

🌟 SEE ALSO 🌟

sympa_automatic(8), sympa_msg(8), Sympa::Message, Sympa::Spool. go read them, they're part of the lore 💜

---

📜 HISTORY 📜

Sympa::Spool::Incoming appeared on Sympa 6.2.5. baby's first release, and now look at it 😭🔥

---

🫶 friendly little heads-up: next skips the "z" / "Z" lowest-priority messages unless you pass no_filter => 1 — so don't come for me when they don't show up, that's just the filtering doing its thing, periodt.

---

k that's the whole page bestie, go slay some spooling 💖✨ this was sympa 6.2.80, dated 2026-10-19 — catch you on the next manpage, mwah 🎀🦋