TAP::PARSER::SCHEDULER::JOB(3perl)

💖 TAP::Parser::Scheduler::Job 💖

okay bestie, welcome to the Perl Programmers Reference Guide, page TAP::Parser::Scheduler::Job — it's giving "one single test job, but make it a whole object" ✨

🌸 NAME 🌸

TAP::Parser::Scheduler::Job — literally just a single testing job. that's the whole vibe. one job. one girl. 💅

🎀 VERSION 🎀

Version 3.52 — she's current, she's fresh, she's not a legacy build, periodt.

🦋 SYNOPSIS 🦋

use TAP::Parser::Scheduler::Job;

that's it. that's the whole flex. load her up and you're in. 🫶

---

✨ DESCRIPTION ✨

So like. This class represents a single test 'job'. That's it. That's the assignment. One test = one job object. No cap, no extras, just a tidy little container for one unit of testing work. 🧚

---

💅 METHODS 💅

👑 Class Methods

"new"

my $job = TAP::Parser::Scheduler::Job->new(
    $filename, $description
);

You hand her the $filename and the $description of a test — both as plain old scalars — and she blesses you with a brand new TAP::Parser::Scheduler::Job object. Constructor behavior, but make it cute. 🌈

🍓 Instance Methods

"on_finish"

$self->on_finish(\&method).

okay so this one registers a closure to get called when this job gets destroyed. 👀 The callback gets handed the TAP::Parser::Scheduler::Job object as its only argument — it's only argument, direct quote, we don't fix typos in the manpage, we honor them 💀.

So: job dies → your closure runs → your closure receives the job object. That's the deal. 🤝

"finish"

$self->finish;

You call this when a job is complete, and it unlocks the job. Here's the tea:

• If a callback was registered with "on_finish" → she calls it. 🔥
• If not → she does absolutely nothing. Silent. Iconic. Unbothered. 💅

🌟 Attributes 🌟

$self->filename;
$self->description;
$self->context;

These are all "getters" 💖 — and what do they get? They return the data set for these attributes during object construction. So whatever you fed the constructor, you can pull right back out. No extra drama, just retrieval.

• "filename" — the filename, getter'd. 📁
• "description" — the description, getter'd. 📝
• "context" — the context, getter'd. 🌀
• "as_array_ref" — For backwards compatibility in callbacks. That's the whole note. She's here for the legacy support girlies. 🫡

"is_spinner"

$self->is_spinner;

Returns false. Which is indicating that this is a real job rather than a 'spinner'. 🎯

💀 hold up, quick lore drop: Spinners are returned when the scheduler still has pending jobs but can't (because of locking) return one right now.

So a real job says "no, I'm not a spinner" (false), and a spinner is the thing you get when the scheduler is like "bestie I have jobs but the lock said no, here's a spinner instead." 🔒

---

💜 cute sign-off 💜

this page came to you from perl v5.44.0, dated 2026-10-17, filed under TAP::P...er::Job(3perl) — and that's a wrap, bestie. go schedule your jobs. slay. 🫶✨🎀