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

🎀 NAME 🎀

okay so this is the TAP::Parser::Scheduler::Job(3pm) page from the Perl Programmers Reference Guide, and the NAME is literally A single testing job. 💅

✨ VERSION ✨

Version 3.50 — that's the version, bestie. 🫶

🦋 SYNOPSIS 🦋

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

🌸 DESCRIPTION 🌸

Represents a single test 'job'. That's the whole vibe. 🎀

💜 METHODS 💜

🌟 Class Methods 🌟

🧚 new 🧚

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

Given the filename and description of a test as scalars, this returns a brand-new TAP::Parser::Scheduler::Job object. Slay. ✨

💅 Instance Methods 💅

🔥 on_finish 🔥

$self->on_finish(\&method).

Register a closure to be called when this job is destroyed. The callback will be passed the TAP::Parser::Scheduler::Job object as its only argument. No cap. 🫶

⭐ finish ⭐

$self->finish;

Called when a job is complete to unlock it. If a callback has been registered with on_finish, it calls it. Otherwise, it does nothing. 💀

🌈 Attributes 🌈

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

These are all "getters" which return the data set for these attributes during object construction. Periodt. 💖

• filename — getter name, bestie. 🎀
• description — getter name. 🌸
• context — getter name. 🦋
• as_array_ref — for backwards compatibility in callbacks. 💅

🦋 is_spinner 🦋

$self->is_spinner;

Returns false indicating that this is a real job rather than a 'spinner'. Spinners are returned when the scheduler still has pending jobs but can't (because of locking) return one right now. It's giving "locked and pending," honestly. 🔒

---

cute sign-off time: this page is from perl v5.42.3, dated 2026-11-03, and it's the TAP::Parser::Scheduler::Job(3pm) manual page. Go test something iconic. 👑💖