Sympa::Task(3Sympa)

okay bestie, gather round — this is the manual page for Sympa::Task, living in section 3 of the sympa man pages, and it's genuinely just a little module that handles Tasks of Sympa. She's small, she's important, and she has lore. Let's get into it. 💖

---

✨ NAME ✨

Sympa::Task — Tasks of Sympa 🎀

---

🌸 SYNOPSIS 🌸

use Sympa::Task;

$task = Sympa::Task->new($serialized, context => $list,
    model => 'remind', label => 'EXEC', date => 1234567890);

$task = Sympa::Task->new(context => $list, model => 'remind');

---

🦋 DESCRIPTION 🦋

💅 Methods

new — the constructor, the main character

new ( $serialized, context => $that, model => $model, label => $label,
date => $date )
new ( context => $that, model => $model, [ name => $name ], [ label =>
$label ], [ date => $date ] )

Constructor, bestie. Creates a brand-new instance of the Sympa::Task class. ✨

The first style up there is the one the task spool class usually reaches for (peep Sympa::Spool::Task too) — in that case context, model, label and date all get handed over from the metadata, aka the file name. The way that the spool just feeds it the metadata? Obsessed.

Parameters:

• $serialized — the serialized content of the task file sitting in the spool. If you just don't pass it (that's the second style above, the low-effort one), then the appropriate task file gets read, parsed, and used as the serialized content. 🫶
• context => $that — the context of the task: either a List (an instance of Sympa::List) or a Site (yep, that's literally '*').
• model => $model — the task model.
• name => $name — the selector of the task. If you omit it, the value of the context object's parameter that corresponds to the task model gets used instead. And if that parameter value wasn't valid? The constructor just returns undef. oof, but that's the deal — no cap.
• label => $label — the label of the task. Omit it and you get the default label, which in many cases is just the empty string. Very minimalist of her. 💅
• date => $date — Unix time. It's the creation date of the label. Omit it and you get the current time. ⏰

Returns:

A shiny new instance of the Sympa::Task class. 👑

---

dup

dup ( )

Copy constructor, bestie. It creates a deep copy of the instance. Not a little "look, it's basically the same object" situation — a deep copy. 🌈

---

lines

lines ( )

Instance method. Gets you an array of parsed information, one per each line of the serialized content. 🍓

---

to_string

to_string ( )

Instance method. Gets you the serialized content of the task. ✨

---

get_id

get_id ( )

Instance method (the original says "Instasnce" but we all knew what she meant, bless 💀). Gets you the unique identifier of the instance.

---

🧚 Function

get_tasks

get_tasks ( $that, $model )

Function. Gets you all the possible tasks for a particular context. Very generous of her.

Parameters:

• $that — the context. An instance of Sympa::List, or '*'.
• $model — the task model.

Returns:

An arrayref of possible tasks. 🎀

---

👑 Attributes

• {date}
• {model}
• {title}

TBD. ✨ (yeah, that's the whole entry, we love a mystery)

---

🔥 SEE ALSO 🔥

task_manager(8).

Sympa::Spool::Task.

---

⭐ HISTORY ⭐

The Task module showed up back in Sympa 5.2b.1. Then it got renamed to Sympa::Task in Sympa 6.2a.41. 🌸

And then, plot twist, it got rewritten and split into Sympa::Task and Sympa::Spool::Task in Sympa 6.2.37b.2. Character development, honestly. 💖

---

And that's the whole page, bestie — this was sympa 6.2.80, dated 2026-10-19, filed under Sympa::Task(3Sympa) in section 3 of the manual. Go forth and schedule your tasks, ily, bye 💅✨🦋