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
|
# $Id: Step.pm 1687 2007-06-28 22:44:07Z guillomovitch $
package Youri::Submit::Step;
=head1 NAME
Youri::Submit::Step - Abstract submission step
=head1 DESCRIPTION
This abstract class defines youri-submit plugin interface.
=cut
use warnings;
use strict;
use Carp;
=head1 CLASS METHODS
=head2 new(%args)
Creates and returns a new Youri::Submit::Plugin object.
Generic parameters:
=over
=item skip $skip
List of packages for which to skip this plugin
=over
Warning: do not call directly, call subclass constructor instead.
=cut
sub new {
my $class = shift;
croak "Abstract class" if $class eq __PACKAGE__;
my %options = (
id => '', # object id
test => 0, # test mode
verbose => 0, # verbose mode
skip => undef,
@_
);
croak "skip should be an arrayref"
if $options{skip} and ref $options{skip} ne 'ARRAY';
my $self = bless {
_id => $options{id},
_test => $options{test},
_verbose => $options{verbose},
_skip => { map { $_ => 1 } @{$options{skip}} }
}, $class;
$self->_init(%options);
return $self;
}
sub _init {
# do nothing
}
=head1 INSTANCE METHODS
=head2 get_id()
Returns plugin identity.
=cut
sub get_id {
my ($self) = @_;
croak "Not a class method" unless ref $self;
return $self->{_id};
}
=head2 run($packages, $repository, $target, $context)
Execute action on given L<Youri::Package> object.
=cut
sub run {
my ($self, $packages, $repository, $target, $context) = @_;
croak "Not a class method" unless ref $self;
croak "packages is not an array reference" unless ref $packages eq 'ARRAY';
# filter exceptions
$packages = [
grep { !$self->{_skip}->{$_->get_canonical_name()} }
@$packages
];
$self->process_packages($repository, $packages, $target, $context)
if @$packages;
}
=head1 SUBCLASSING
The following methods have to be implemented:
=over
=item run
=back
=head1 COPYRIGHT AND LICENSE
Copyright (C) 2002-2006, YOURI project
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
=cut
1;
|