lib/Gearman/Driver/Console/Basic.pm

filter: Statementstmt 94.4% 85 / 90 Branchbran 78.9% 30 / 38 Conditioncond 60.0% 18 / 30 MC/DCmcdc 26.6% 4 / 15 Subroutinesub 100% 13 / 13 Podpod 100% 8 / 8 totaltotal 81.4% 158 / 194 CC 36 SCAR 19.1
CC
36
Cov
84%
status
10.2
set_processes
9.3
killall
8.8
CRAP 6.8
« lib/Gearman/Driver/Worker/AttributeParser.pm ↑ Summary lib/Gearman/Driver/Adaptor/XS.pm »
1 package Gearman::Driver::Console::Basic;
2  
3 14 ▶use Moose::Role;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 14 ▶use DateTime;
Subroutine BEGIN: called CC=1 SCAR=0.0
5 14 ▶use Time::HiRes;
Subroutine BEGIN: called CC=1 SCAR=0.0
6  
7 =head1 NAME
8  
9 Gearman::Driver::Console::Basic - Provides basic console commands
10  
11 =head1 DESCRIPTION
12  
13 This implements the basic management console commands like C<status>,
14 C<quit>, C<shutdown>, ...
15  
16 =head1 COMMANDS
17  
18 =head2 status
19  
20 Parameters: C<none>
21  
22 status
23 GDExamples::Convert::convert_to_jpeg 0 5 0 2010-01-29T20:37:17 1970-01-01T00:00:00
24 GDExamples::Convert::convert_to_gif 0 5 0 2010-01-29T20:37:12 2010-01-29T20:37:12 some error
25 .
26  
27 Columns are separated by at least two spaces in this order:
28  
29 =over 4
30  
31 =item * job_name
32  
33 =item * min_processes
34  
35 =item * max_processes
36  
37 =item * current_processes
38  
39 =item * last_run
40  
41 =item * last_error
42  
43 =item * last_error_message
44  
45 =back
46  
47 =cut
48  
49 2 ▶sub status {
Subroutine status: called CC=10 SCAR=23.3
Pod documented
50 2 my ($self) = @_;
51  
52 # get maximum lengths
53 2 my @max = ( 0, 1, 1, 1, 1, 1, 1 );
54 2 foreach my $job ( $self->driver->get_jobs ) {
55 4 my $lasterror_msg = $job->lasterror_msg;
56 4 ▶ $max[0] = length $job->name if $max[0] < length $job->name;
Branch: 1 branch
BranchTrueFalseTotal
if $max[0] < length $job->name 2 2 4
57 4 ▶ $max[1] = length $job->min_processes if $max[1] < length $job->min_processes;
Branch: 1 branch
BranchTrueFalseTotal
if $max[1] < length $job->min_processes 0 4 4
58 4 ▶ $max[2] = length $job->max_processes if $max[2] < length $job->max_processes;
Branch: 1 branch
BranchTrueFalseTotal
if $max[2] < length $job->max_processes 1 3 4
59 4 ▶ $max[3] = length $job->count_processes if $max[3] < length $job->count_processes;
Branch: 1 branch
BranchTrueFalseTotal
if $max[3] < length $job->count_processes 0 4 4
60 4 ▶ $max[4] = length $job->lastrun if $max[4] < length $job->lastrun;
Branch: 1 branch
BranchTrueFalseTotal
if $max[4] < length $job->lastrun 1 3 4
61 4 ▶ $max[5] = length $job->lasterror if $max[5] < length $job->lasterror;
Branch: 1 branch
BranchTrueFalseTotal
if $max[5] < length $job->lasterror 0 4 4
62 }
63  
64 2 my @result = ();
65 2 foreach my $job ( $self->driver->get_jobs ) {
66 4 my $lasterror_msg = $job->lasterror_msg;
67 4 chomp $lasterror_msg;
68 4 ▶ push @result,
Branch: 1 branch
BranchTrueFalseTotal
$lasterror_msg ? : 0 4 4
69 sprintf(
70 "%-$max[0]s %$max[1]d %$max[2]d %$max[3]d %$max[4]s %$max[5]s %s",
71 $job->name, $job->min_processes, $job->max_processes, $job->count_processes,
72 DateTime->from_epoch( epoch => $job->lastrun ),
73 DateTime->from_epoch( epoch => $job->lasterror ),
74 $lasterror_msg ? "ERROR: $lasterror_msg" : ""
75 );
76 }
77  
78 2 return @result;
79 }
80  
81 =head2 set_min_processes
82  
83 Parameters: C<job_name min_processes>
84  
85 set_min_processes asdf 5
86 ERR invalid_job_name: asdf
87 set_min_processes GDExamples::Convert::convert_to_jpeg ten
88 ERR invalid_value: min_processes must be >= 0
89 set_min_processes GDExamples::Convert::convert_to_jpeg 10
90 ERR invalid_value: min_processes must be smaller than max_processes
91 set_min_processes GDExamples::Convert::convert_to_jpeg 5
92 OK
93 .
94  
95 =cut
96  
97 7 ▶sub set_min_processes {
Subroutine set_min_processes: called CC=5 SCAR=16.2
Pod documented
98 7 my ( $self, $job_name, $min_processes ) = @_;
99  
100 7 my $job = $self->get_job($job_name);
101  
102 6 ▶ if ( !defined($min_processes) || $min_processes !~ /^\d+$/ || $min_processes < 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $min_processes && $min_processes =~ /^\d+$/ or $min_processes < 0) 1 5 6
Condition66%4/6
not defined $min_processes && $min_processes =~ /^\d+$/ or $min_processes < 0
l!l&&r!l&&!r
105
defined $min_processes && $min_processes =~ /^\d+$/
!ll&&!rl&&r
015
MC/DC33%1/3
not defined $min_processes && $min_processes =~ /^\d+$/ or $min_processes < 0
defined $min_processes $min_processes =~ /^\d+$/ $min_processes < 0
Truth table50%2/4
not(A && B) or C
A= defined $min_processesB= $min_processes =~ /^\d+$/C= $min_processes < 0
ABCresult
0XX1
10X1
1111
1100
103 1 die "ERR invalid_value: min_processes must be >= 0\n";
104 }
105  
106 5 ▶ if ( $min_processes > $job->max_processes ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($min_processes > $job->max_processes) 1 4 5
107 1 die "ERR invalid_value: min_processes must be smaller than max_processes\n";
108 }
109  
110 4 $job->min_processes($min_processes);
111  
112 4 return "OK";
113 }
114  
115 =head2 set_max_processes
116  
117 Parameters: C<job_name max_processes>
118  
119 set_max_processes asdf 5
120 ERR invalid_job_name: asdf
121 set_max_processes GDExamples::Convert::convert_to_jpeg ten
122 ERR invalid_value: max_processes must be >= 0
123 set_max_processes GDExamples::Convert::convert_to_jpeg 0
124 ERR invalid_value: max_processes must be greater than min_processes
125 set_max_processes GDExamples::Convert::convert_to_jpeg 6
126 OK
127 .
128  
129 =cut
130  
131 7 ▶sub set_max_processes {
Subroutine set_max_processes: called CC=5 SCAR=16.2
Pod documented
132 7 my ( $self, $job_name, $max_processes ) = @_;
133  
134 7 my $job = $self->get_job($job_name);
135  
136 6 ▶ if ( !defined($max_processes) || $max_processes !~ /^\d+$/ || $max_processes < 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $max_processes && $max_processes =~ /^\d+$/ or $max_processes < 0) 1 5 6
Condition66%4/6
not defined $max_processes && $max_processes =~ /^\d+$/ or $max_processes < 0
l!l&&r!l&&!r
105
defined $max_processes && $max_processes =~ /^\d+$/
!ll&&!rl&&r
015
MC/DC33%1/3
not defined $max_processes && $max_processes =~ /^\d+$/ or $max_processes < 0
defined $max_processes $max_processes =~ /^\d+$/ $max_processes < 0
Truth table50%2/4
not(A && B) or C
A= defined $max_processesB= $max_processes =~ /^\d+$/C= $max_processes < 0
ABCresult
0XX1
10X1
1111
1100
137 1 die "ERR invalid_value: max_processes must be >= 0\n";
138 }
139  
140 5 ▶ if ( $max_processes < $job->min_processes ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($max_processes < $job->min_processes) 1 4 5
141 1 die "ERR invalid_value: max_processes must be greater than min_processes\n";
142 }
143  
144 4 $job->max_processes($max_processes);
145  
146 4 return "OK";
147 }
148  
149 =head2 set_processes
150  
151 Parameters: C<job_name min_processes max_processes>
152  
153 set_processes asdf 1 1
154 ERR invalid_job_name: asdf
155 set_processes GDExamples::Convert::convert_to_jpeg ten ten
156 ERR invalid_value: min_processes must be >= 0
157 set_processes GDExamples::Convert::convert_to_jpeg 1 ten
158 ERR invalid_value: max_processes must be >= 0
159 set_processes GDExamples::Convert::convert_to_jpeg 5 1
160 ERR invalid_value: max_processes must be greater than min_processes
161 set_processes GDExamples::Convert::convert_to_jpeg 1 5
162 OK
163 .
164  
165 =cut
166  
167 4 ▶sub set_processes {
Subroutine set_processes: called CC=8 SCAR=22.3
Pod documented
168 4 my ( $self, $job_name, $min_processes, $max_processes ) = @_;
169  
170 4 my $job = $self->get_job($job_name);
171  
172 3 ▶ if ( !defined($min_processes) || $min_processes !~ /^\d+$/ || $min_processes < 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $min_processes && $min_processes =~ /^\d+$/ or $min_processes < 0) 1 2 3
Condition66%4/6
not defined $min_processes && $min_processes =~ /^\d+$/ or $min_processes < 0
l!l&&r!l&&!r
102
defined $min_processes && $min_processes =~ /^\d+$/
!ll&&!rl&&r
012
MC/DC33%1/3
not defined $min_processes && $min_processes =~ /^\d+$/ or $min_processes < 0
defined $min_processes $min_processes =~ /^\d+$/ $min_processes < 0
Truth table50%2/4
not(A && B) or C
A= defined $min_processesB= $min_processes =~ /^\d+$/C= $min_processes < 0
ABCresult
0XX1
10X1
1111
1100
173 1 die "ERR invalid_value: min_processes must be >= 0\n";
174 }
175  
176 2 ▶ if ( !defined($max_processes) || $max_processes !~ /^\d+$/ || $max_processes < 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $max_processes && $max_processes =~ /^\d+$/ or $max_processes < 0) 1 1 2
Condition66%4/6
not defined $max_processes && $max_processes =~ /^\d+$/ or $max_processes < 0
l!l&&r!l&&!r
101
defined $max_processes && $max_processes =~ /^\d+$/
!ll&&!rl&&r
011
MC/DC33%1/3
not defined $max_processes && $max_processes =~ /^\d+$/ or $max_processes < 0
defined $max_processes $max_processes =~ /^\d+$/ $max_processes < 0
Truth table50%2/4
not(A && B) or C
A= defined $max_processesB= $max_processes =~ /^\d+$/C= $max_processes < 0
ABCresult
0XX1
10X1
1111
1100
177 1 die "ERR invalid_value: max_processes must be >= 0\n";
178 }
179  
180 1 ▶ if ( $max_processes < $min_processes ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($max_processes < $min_processes) 1 0 1
181 1 die "ERR invalid_value: max_processes must be greater than min_processes\n";
182 }
183  
184 0 $job->min_processes($min_processes);
185 0 $job->max_processes($max_processes);
186  
187 0 return "OK";
188 }
189  
190 =head2 show
191  
192 Parameters: C<job_name>
193  
194 show GDExamples::Convert::convert_to_jpeg
195 GDExamples::Convert::convert_to_jpeg 0 5 0 1970-01-01T00:00:00 1970-01-01T00:00:00
196 3662
197 3664
198 3663
199 .
200 show GDExamples::Convert::convert_to_gif
201 GDExamples::Convert::convert_to_gif 0 5 0 1970-01-01T00:00:00 1970-01-01T00:00:00
202 3665
203 .
204  
205 =cut
206  
207 3 ▶sub show {
Subroutine show: called CC=2 SCAR=7.0
Pod documented
208 3 my ( $self, $job_name ) = @_;
209  
210 3 my $job = $self->get_job($job_name);
211  
212 3 my @result = ();
213  
214 3 my $lasterror_msg = $job->lasterror_msg;
215 3 chomp $lasterror_msg;
216  
217 3 ▶ push @result,
Branch: 1 branch
BranchTrueFalseTotal
$lasterror_msg ? : 0 3 3
218 sprintf(
219 "%s %d %d %d %s %s %s",
220 $job->name, $job->min_processes, $job->max_processes, $job->count_processes,
221 DateTime->from_epoch( epoch => $job->lastrun ),
222 DateTime->from_epoch( epoch => $job->lasterror ),
223 $lasterror_msg ? "ERROR: $lasterror_msg" : ""
224 );
225  
226 3 push @result, $job->get_pids;
227  
228 3 return @result;
229 }
230  
231 =head2 kill
232  
233 Parameters: C<pid> [<pid> <pid> ...]
234  
235 kill 1
236 ERR invalid_value: the given PID(s) do not belong to us
237 kill 3662
238 OK
239 .
240  
241 =cut
242  
243 3 ▶sub kill {
Subroutine kill: called CC=5 SCAR=16.1
Pod documented
244 3 my ( $self, @pids ) = @_;
245  
246 3 my @valid_pids = ();
247 3 foreach my $job ( $self->driver->get_jobs ) {
248 6 my @job_pids = $job->get_pids;
249 6 foreach my $pid (@pids) {
250 6 ▶ if ( grep $_ eq $pid, @job_pids ) {
Branch: 1 branch
BranchTrueFalseTotal
if (grep(($_ eq $pid), @job_pids)) 2 4 6
251 2 push @valid_pids, $pid;
252 }
253 }
254 }
255  
256 3 ▶ die "ERR invalid_value: the given PID(s) do not belong to us\n" unless @valid_pids;
Branch: 1 branch
BranchTrueFalseTotal
unless @valid_pids 1 2 3
257  
258 2 CORE::kill 15, @valid_pids;
259  
260 2 return "OK";
261 }
262  
263 =head2 killall
264  
265 Kills all childs/pids of given job.
266  
267 Parameters: C<job_name> [<job_name> <job_name> ...]
268  
269 killall GDExamples::Convert::convert_to_jpeg
270 OK
271 .
272  
273 It also accepts C<*> as parameter to kill all jobs, so be careful
274 with that!
275  
276 =cut
277  
278 1 ▶sub killall {
Subroutine killall: called CC=7 SCAR=21.8
Pod documented
279 1 my ( $self, @job_names ) = @_;
280  
281 1 ▶ die "ERR invalid_value: no job_names given\n" unless scalar(@job_names);
Branch: 1 branch
BranchTrueFalseTotal
unless scalar @job_names 0 1 1
282  
283 1 ▶ my $kill = sub {
Subroutine __ANON__: called CC=1 SCAR=0.0
284 1 my ($job) = @_;
285 1 my @pids = $job->get_pids;
286 1 CORE::kill 15, @pids;
287 1 Time::HiRes::usleep(50); # prevent POE from freaking out
288 1 };
289  
290 1 ▶ if ( defined $job_names[0] && $job_names[0] eq '*' && scalar(@job_names) == 1 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $job_names[0] and $job_names[0] eq '*' and scalar @job_names == 1) { } 0 1 1
Condition33%2/6
defined $job_names[0] and $job_names[0] eq "*" and scalar @job_names == 1
!ll&&!rl&&r
100
defined $job_names[0] and $job_names[0] eq "*"
!ll&&!rl&&r
010
MC/DC0%0/3
defined $job_names[0] and $job_names[0] eq "*" and scalar @job_names == 1
defined $job_names[0] $job_names[0] eq "*" scalar @job_names == 1
Truth table25%1/4
A and B and C
A= defined $job_names[0]B= $job_names[0] eq "*"C= scalar @job_names == 1
ABCresult
0XX0
10X0
1100
1111
291 0 foreach my $job ( $self->driver->get_jobs ) {
292 0 $kill->($job);
293 }
294 }
295  
296 else {
297 1 foreach my $job_name (@job_names) {
298 1 my $job = $self->get_job($job_name);
299 1 $kill->($job);
300 }
301 }
302  
303 1 return "OK";
304 }
305  
306 =head2 quit
307  
308 Parameters: C<none>
309  
310 Closes your connection gracefully.
311  
312 =head2 shutdown
313  
314 Parameters: C<none>
315  
316 Shuts L<Gearman::Driver> down.
317  
318 =cut
319  
320 12 ▶sub shutdown {
Subroutine shutdown: called CC=1 SCAR=0.0
Pod documented
321 12 my ($self) = @_;
322 12 $self->driver->shutdown;
323 }
324  
325 =head1 AUTHOR
326  
327 See L<Gearman::Driver>.
328  
329 =head1 COPYRIGHT AND LICENSE
330  
331 See L<Gearman::Driver>.
332  
333 =head1 SEE ALSO
334  
335 =over 4
336  
337 =item * L<Gearman::Driver>
338  
339 =item * L<Gearman::Driver::Adaptor>
340  
341 =item * L<Gearman::Driver::Console>
342  
343 =item * L<Gearman::Driver::Console::Client>
344  
345 =item * L<Gearman::Driver::Job>
346  
347 =item * L<Gearman::Driver::Job::Method>
348  
349 =item * L<Gearman::Driver::Loader>
350  
351 =item * L<Gearman::Driver::Observer>
352  
353 =item * L<Gearman::Driver::Worker>
354  
355 =back
356  
357 =cut
358  
359 14 ▶no Moose::Role;
Subroutine BEGIN: called CC=1 SCAR=0.0
360  
361 14 1;
« lib/Gearman/Driver/Worker/AttributeParser.pm ↑ Summary lib/Gearman/Driver/Adaptor/XS.pm »