1 package C4
::Installer
::PerlModules
;
8 use C4
::Installer
::PerlDependencies
;
11 our $PERL_DEPS = $C4::Installer
::PerlDependencies
::PERL_DEPS
;
20 my $type = ref($invocant) || $invocant;
28 for (keys %$PERL_DEPS) {
29 $prereq_pm->{$_} = $PERL_DEPS->{$_}->{'min_ver'};
37 if ($params{'module'}) {
38 return -1 unless grep {m/$params{'module'}/} keys(%$PERL_DEPS);
39 return $PERL_DEPS->{$params{'module'}}->{'required'};
41 elsif ($params{'required'}) {
43 for (keys %$PERL_DEPS) {
44 push (@
$required_pm, $_) if $PERL_DEPS->{$_}->{'required'} == 1;
48 elsif ($params{'optional'}) {
50 for (keys %$PERL_DEPS) {
51 push (@
$optional_pm, $_) if $PERL_DEPS->{$_}->{'required'} == 0;
56 return -1; # unrecognized parameter passed in
61 no warnings
; # perl throws warns for invalid $VERSION numbers which some modules use
63 # Reset these arrayref each pass through to ensure current information
64 $self->{'missing_pm'} = [];
65 $self->{'upgrade_pm'} = [];
66 $self->{'current_pm'} = [];
68 if ($params{'module'}) {
69 return -1 unless grep {m/$params{'module'}/} keys(%$PERL_DEPS);
70 eval "require $params{'module'}";
71 my $pkg_version = $params{'module'} && $params{'module'}->can("VERSION") ?
$params{'module'}->VERSION : 0;
72 my $min_version = $PERL_DEPS->{$params{'module'}}->{'min_ver'} // 0;
74 return {$params{'module'} => {cur_ver
=> 0, min_ver
=> $PERL_DEPS->{$_}->{'min_ver'}, upgrade
=> 0, required
=> $PERL_DEPS->{$_}->{'required'}, usage
=> $PERL_DEPS->{$_}->{'usage'}}};
76 elsif (version
->parse("$pkg_version") < version
->parse("$min_version")) {
77 return {$params{'module'} => {cur_ver
=> $params{'module'}->VERSION, min_ver
=> $PERL_DEPS->{$params{'module'}}->{'min_ver'}, upgrade
=> 1, required
=> $PERL_DEPS->{$params{'module'}}->{'required'}, usage
=> $PERL_DEPS->{$_}->{'usage'}}};
80 return {$params{'module'} => {cur_ver
=> $params{'module'}->VERSION, min_ver
=> $PERL_DEPS->{$params{'module'}}->{'min_ver'}, upgrade
=> 0, required
=> $PERL_DEPS->{$params{'module'}}->{'required'}, usage
=> $PERL_DEPS->{$_}->{'usage'}}};
84 for (sort keys(%{$PERL_DEPS})) {
85 my $pkg = $_; # $_ holds the string
87 my $pkg_version = $params{'module'} && $params{'module'}->can("VERSION") ?
$params{'module'}->VERSION : 0;
88 my $min_version = $PERL_DEPS->{$_}->{'min_ver'} // 0;
90 push (@
{$self->{'missing_pm'}}, {$_ => {cur_ver
=> 0, min_ver
=> $PERL_DEPS->{$_}->{'min_ver'}, required
=> $PERL_DEPS->{$_}->{'required'}, usage
=> $PERL_DEPS->{$_}->{'usage'}}});
92 elsif (version
->parse("$pkg_version") < version
->parse("$min_version")) {
93 push (@
{$self->{'upgrade_pm'}}, {$_ => {cur_ver
=> $pkg->VERSION, min_ver
=> $PERL_DEPS->{$_}->{'min_ver'}, required
=> $PERL_DEPS->{$_}->{'required'}, usage
=> $PERL_DEPS->{$_}->{'usage'}}});
96 push (@
{$self->{'current_pm'}}, {$_ => {cur_ver
=> $pkg->VERSION, min_ver
=> $PERL_DEPS->{$_}->{'min_ver'}, required
=> $PERL_DEPS->{$_}->{'required'}, usage
=> $PERL_DEPS->{$_}->{'usage'}}});
104 return $_[0]->{$_[1]};
108 return scalar(keys(%$PERL_DEPS));
112 return keys(%$PERL_DEPS);
120 C4::Installer::PerlModules
124 A module for manipulating Koha Perl dependency list objects.
130 Creates a new PerlModules object
133 C<my $perl_modules = C4::Installer::PerlModules->new;>
137 Returns a hashref of a hash of module information suitable for use in Makefile.PL
140 C<my $perl_modules = C4::Installer::PerlModules->new;
144 PREREQ_PM => $perl_modules->prereq_pm,>
148 This method accepts a single parameter with three possible values: a module name, the keyword 'required,' the keyword 'optional.' If passed the name of a module, a boolean value is returned indicating whether the module is required (1) or not (0). If on of the two keywords is passed in, it returns an arrayref to an array who's elements are the names of the modules specified either required or optional.
151 C<my $is_required = $perl_modules->required(module => 'CGI::Carp');>
153 C<my $optional_pm_names = $perl_modules->required(optional => 1);>
155 =head2 version_info()
157 Depending on the parameters passed when invoking, this method will give the current status of modules currently used in Koha as well as the currently installed version if the module is installed, the current minimum required version, and the upgrade status. If passed C<module => module_name>, the method evaluates only that module. If passed C<all => 1>, all modules are evaluated.
160 C<my $module_status = $perl_modules->version_info(module => 'foo');>
162 This usage returns a hashref with a single key/value pair. The key is the module name. The value is an anonymous hash with the following keys:
164 cur_ver = version number of the currently installed version (This is 0 if the module is not currently installed.)
165 min_ver = minimum version required by Koha
166 upgrade = upgrade status of the module relative to Koha's requirements (0 if the installed module does not need upgrading; 1 if it does)
167 required = 0 of the module is optional; 1 if required
172 'cur_ver' => '1.30_01',
178 C<$perl_modules->version_info;>
180 This usage loads the same basic data as the previous usage into three accessors: missing_pm, upgrade_pm, and current_pm. Each of these may be accessed by using the C<get_attr> method. Each accessor returns an anonymous array who's elements are anonymous hashes. They follow this format (NOTE: Upgrade status is indicated by the accessor name.):
184 'Text::CSV::Encoded' => {
191 'Biblio::EndnoteStyle' => {
199 =head2 get_attr(attr_name)
201 Returns an anonymous array containing the contents of the passed in accessor. Valid accessors are:
203 missing_pm - Perl modules used by Koha but not currently installed.
205 upgrade_pm - Perl modules currently installed but below the minimum version required by Koha.
207 current_pm - Perl modules currently installed and up to date as required by Koha.
210 C<my $missing_pm = $perl_modules->get_attr('missing_pm');>
214 Returns a scalar value representing the current number of Perl modules used by Koha.
217 C<my $module_count = $perl_modules->module_count;>
221 Returns an array who's elements are the names of the Perl modules used by Koha.
224 C<my @module_list = $perl_modules->module_list;>
226 This is useful for commandline exercises such as:
228 perl -MC4::Installer::PerlModules -e 'my $deps = C4::Installer::PerlModule->new; print (join("\n",$deps->module_list));'
232 Chris Nighswonger <cnighswonger AT foundations DOT edu>
236 Copyright 2010 Foundations Bible College.
240 This file is part of Koha.
242 Koha is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software
243 Foundation; either version 2 of the License, or (at your option) any later version.
245 You should have received a copy of the GNU General Public License along with Koha; if not, write to the Free Software Foundation, Inc., 51 Franklin Street,
246 Fifth Floor, Boston, MA 02110-1301 USA.
248 =head1 DISCLAIMER OF WARRANTY
250 Koha is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
251 A PARTICULAR PURPOSE. See the GNU General Public License for more details.