/usr/share/perl5/TAP/Parser/Scheduler/Job.pm is in libtest-harness-perl 3.39-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 | package TAP::Parser::Scheduler::Job;
use strict;
use warnings;
use Carp;
=head1 NAME
TAP::Parser::Scheduler::Job - A single testing job.
=head1 VERSION
Version 3.39
=cut
our $VERSION = '3.39';
=head1 SYNOPSIS
use TAP::Parser::Scheduler::Job;
=head1 DESCRIPTION
Represents a single test 'job'.
=head1 METHODS
=head2 Class Methods
=head3 C<new>
my $job = TAP::Parser::Scheduler::Job->new(
$filename, $description
);
Given the filename and description of a test as scalars, returns a new
L<TAP::Parser::Scheduler::Job> object.
=cut
sub new {
my ( $class, $name, $desc, @ctx ) = @_;
return bless {
filename => $name,
description => $desc,
@ctx ? ( context => \@ctx ) : (),
}, $class;
}
=head2 Instance Methods
=head3 C<on_finish>
$self->on_finish(\&method).
Register a closure to be called when this job is destroyed. The callback
will be passed the C<TAP::Parser::Scheduler::Job> object as it's only argument.
=cut
sub on_finish {
my ( $self, $cb ) = @_;
$self->{on_finish} = $cb;
}
=head3 C<finish>
$self->finish;
Called when a job is complete to unlock it. If a callback has been registered
with C<on_finish>, it calls it. Otherwise, it does nothing.
=cut
sub finish {
my $self = shift;
if ( my $cb = $self->{on_finish} ) {
$cb->($self);
}
}
=head2 Attributes
$self->filename;
$self->description;
$self->context;
These are all "getters" which return the data set for these attributes during object construction.
=head3 C<filename>
=head3 C<description>
=head3 C<context>
=cut
sub filename { shift->{filename} }
sub description { shift->{description} }
sub context { @{ shift->{context} || [] } }
=head3 C<as_array_ref>
For backwards compatibility in callbacks.
=cut
sub as_array_ref {
my $self = shift;
return [ $self->filename, $self->description, $self->{context} ||= [] ];
}
=head3 C<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.
=cut
sub is_spinner {0}
1;
|