Sympa::Spool::Task(3Sympa)

💖 Sympa::Spool::Task(3Sympa) 💖

okay bestie, gather round, because this is the manual page for Sympa::Spool::Task — that's a section 3 library page from the sympa project, and we're living in version 6.2.80. it's the spool for tasks, and no, that's not as boring as it sounds. it's giving ✨infrastructure✨.

---

✨ NAME ✨

Sympa::Spool::Task — the spool for tasks 🎀

literally what it says on the tin. it's where tasks hang out.

---

🌈 SYNOPSIS 🌈

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

$spool->store($task);

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

see how cute that is? you make a spool, you shove a task in, you pull one back out. chef's kiss 🫶

---

💅 DESCRIPTION 💅

Sympa::Spool::Task implements the spool for tasks. that's the whole vibe. it's a spool, it holds tasks, it's iconic.

🦋 Methods 🦋

also go peek at "Public methods" in Sympa::Spool — that's the family it belongs to, iykyk.

• next ( [ no_filter => 1 ], [ no_lock => 1 ] ) — pulls the next task out. the order is decided by the date element of the file name. and listen: if no_filter isn't set, then messages whose date is newer than the current time get skipped. future tasks, not your problem yet, periodt.

also lowkey the whole system works because all the necessary tasks are created and stored into the spool in advance. no cap.

• quarantine ( $handle ) — removes a task. it's literally the same as remove(). and heads up: this spool does not have a bad/ subdirectory, so don't go looking for one bestie 💀

🌸 Context and metadata 🌸

you can also check "Marshaling and unmarshaling metadata" in Sympa::Spool for the general tea.

this class in particular hands over the following metadata:

• {date} — Unix time when the task will be executed at the next time. ⏰
• {label} — TBD.
• {model} — TBD.

(yes, two of them are literally just TBD. not me leaving them exactly as they are 🙈)

---

👑 CONFIGURATION PARAMETERS 👑

the following site configuration parameters in sympa.conf will be referred. yes, will be referred, not copied, it's fine.

• queuetask — Directory path of task spool. 📁

---

🔥 SEE ALSO 🔥

• task_manager(8)
• Sympa::Spool
• Sympa::Task

go read those, they're the friend group.

---

⭐ HISTORY ⭐

Sympa::Spool::Task appeared on Sympa 6.2.37b.2. a little baby spool. they grow up so fast 😭

---

and that's a wrap bestie 💖 this was Sympa::Spool::Task(3Sympa) from sympa 6.2.80, dated 2026-10-19. go store some tasks, slay, and remember: future-dated ones are skipped unless you say otherwise. periodt. 🎀🦋✨