Bug 19735: Move Perl deps definitions into a cpanfile
[koha-ffzg.git] / C4 / Installer / PerlModules.pm
index 1f9e57f..f76bb4a 100644 (file)
@@ -4,12 +4,8 @@ use warnings;
 use strict;
 
 use File::Spec;
-
-use C4::Installer::PerlDependencies;
-
-use version; our $VERSION = qv('1.0.0_1');
-
-our $PERL_DEPS = $C4::Installer::PerlDependencies::PERL_DEPS;
+use File::Basename;
+use Module::CPANfile;
 
 sub new {
     my $invocant = shift;
@@ -18,82 +14,75 @@ sub new {
         upgrade_pm  => [],
         current_pm  => [],
     };
+
     my $type = ref($invocant) || $invocant;
     bless ($self, $type);
     return $self;
 }
 
-sub prereq_pm {
+sub prereqs {
     my $self = shift;
-    my $prereq_pm = {};
-    for (keys %$PERL_DEPS) {
-        $prereq_pm->{$_} = $PERL_DEPS->{$_}->{'min_ver'};
+
+    unless (defined $self->{prereqs}) {
+        my $filename = $INC{'C4/Installer/PerlModules.pm'};
+        my $path = dirname(dirname(dirname($filename)));
+        $self->{prereqs} = Module::CPANfile->load("$path/cpanfile")->prereqs;
     }
-    return $prereq_pm;
+
+    return $self->{prereqs};
 }
 
-sub required {
+sub prereq_pm {
     my $self = shift;
-    my %params = @_;
-    if ($params{'module'}) {
-        return -1 unless grep {m/$params{'module'}/} keys(%$PERL_DEPS);
-        return $PERL_DEPS->{$params{'module'}}->{'required'};
-    }
-    elsif ($params{'required'}) {
-        my $required_pm = [];
-        for (keys %$PERL_DEPS) {
-            push (@$required_pm, $_) if $PERL_DEPS->{$_}->{'required'} == 1;
-        }
-        return $required_pm;
-    }
-    elsif ($params{'optional'}) {
-        my $optional_pm = [];
-        for (keys %$PERL_DEPS) {
-            push (@$optional_pm, $_) if $PERL_DEPS->{$_}->{'required'} == 0;
-        }
-        return $optional_pm;
-    }
-    else {
-        return -1; # unrecognized parameter passed in
+
+    my $prereq_pm = {};
+    my $reqs = $self->prereqs->merged_requirements;
+    foreach my $module ($reqs->required_modules) {
+        $prereq_pm->{$module} = $reqs->requirements_for_module($module);
     }
+
+    return $prereq_pm;
 }
 
-sub version_info {
-    no warnings; # perl throws warns for invalid $VERSION numbers which some modules use
+sub versions_info {
     my $self = shift;
-#   Reset these arrayref each pass through to ensure current information
+
+    #   Reset these arrayref each pass through to ensure current information
     $self->{'missing_pm'} = [];
     $self->{'upgrade_pm'} = [];
     $self->{'current_pm'} = [];
-    my %params = @_;
-    if ($params{'module'}) {
-        return -1 unless grep {m/$params{'module'}/} keys(%$PERL_DEPS);
-        eval "require $params{'module'}";
-        if ($@) {
-            return {$params{'module'} => {cur_ver => 0, min_ver => $PERL_DEPS->{$_}->{'min_ver'}, upgrade => 0, required => $PERL_DEPS->{$_}->{'required'}, usage => $PERL_DEPS->{$_}->{'usage'}}};
-        }
-        elsif ($params{'module'}->VERSION lt $PERL_DEPS->{$params{'module'}}->{'min_ver'}) {
-            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'}}};
-        }
-        else {
-            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'}}};
-        }
-    }
-    else {
-        for (sort keys(%{$PERL_DEPS})) {
-            my $pkg = $_;  #  $_ holds the string
-            eval "require $pkg";
-            if ($@) {
-                push (@{$self->{'missing_pm'}}, {$_ => {cur_ver => 0, min_ver => $PERL_DEPS->{$_}->{'min_ver'}, required => $PERL_DEPS->{$_}->{'required'}, usage => $PERL_DEPS->{$_}->{'usage'}}});
-            }
-            elsif ($pkg->VERSION lt $PERL_DEPS->{$_}->{'min_ver'}) {
-                push (@{$self->{'upgrade_pm'}}, {$_ => {cur_ver => $pkg->VERSION, min_ver => $PERL_DEPS->{$_}->{'min_ver'}, required => $PERL_DEPS->{$_}->{'required'}, usage => $PERL_DEPS->{$_}->{'usage'}}});
-            }
-            else {
-                push (@{$self->{'current_pm'}}, {$_ => {cur_ver => $pkg->VERSION, min_ver => $PERL_DEPS->{$_}->{'min_ver'}, required => $PERL_DEPS->{$_}->{'required'}, usage => $PERL_DEPS->{$_}->{'usage'}}});
+
+    foreach my $phase ($self->prereqs->phases) {
+        foreach my $type ($self->prereqs->types_in($phase)) {
+            my $reqs = $self->prereqs->requirements_for($phase, $type);
+            foreach my $module ($reqs->required_modules) {
+                no warnings;  # perl throws warns for invalid $VERSION numbers which some modules use
+
+                my $module_infos = {
+                    cur_ver  => 0,
+                    min_ver  => $reqs->requirements_for_module($module),
+                    required => $type eq 'requires',
+                };
+
+                my $attr;
+
+                $Readonly::XS::MAGIC_COOKIE="Do NOT use or require Readonly::XS unless you're me.";
+                eval "require $module";
+                if ($@) {
+                    $attr = 'missing_pm';
+                } else {
+                    my $pkg_version = $module->can("VERSION") ? $module->VERSION : 0;
+                    $module_infos->{cur_ver} = $pkg_version;
+                    if ($reqs->accepts_module($module => $pkg_version)) {
+                        $attr = 'current_pm';
+                    } else {
+                        $attr = 'upgrade_pm';
+                    }
+                }
+
+                push @{ $self->{$attr} }, { $module => $module_infos };
             }
         }
-        return;
     }
 }
 
@@ -101,14 +90,6 @@ sub get_attr {
     return $_[0]->{$_[1]};
 }
 
-sub module_count {
-    return scalar(keys(%$PERL_DEPS));
-}
-
-sub module_list {
-    return keys(%$PERL_DEPS);
-}
-
 1;
 __END__
 
@@ -140,41 +121,16 @@ A module for manipulating Koha Perl dependency list objects.
 
         PREREQ_PM    => $perl_modules->prereq_pm,>
 
-=head2 required()
-
-    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.
 
-    example:
-        C<my $is_required = $perl_modules->required(module => 'CGI::Carp');>
-
-        C<my $optional_pm_names = $perl_modules->required(optional => 1);>
-
-=head2 version_info()
-
-    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.
-
-    example:
-        C<my $module_status = $perl_modules->version_info(module => 'foo');>
+=head2 versions_info
 
-        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:
+        C<$perl_modules->versions_info;>
 
-        cur_ver = version number of the currently installed version (This is 0 if the module is not currently installed.)
-        min_ver = minimum version required by Koha
-        upgrade = upgrade status of the module relative to Koha's requirements (0 if the installed module does not need upgrading; 1 if it does)
-        required = 0 of the module is optional; 1 if required
-
-        {
-          'CGI::Carp' => {
-                           'required' => 1,
-                           'cur_ver' => '1.30_01',
-                           'upgrade' => 0,
-                           'min_ver' => '1.29'
-                         }
-        };
-
-        C<$perl_modules->version_info;>
-
-        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.):
+        This loads info of required modules 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.):
 
         [
                   {
@@ -206,23 +162,6 @@ A module for manipulating Koha Perl dependency list objects.
     example:
         C<my $missing_pm = $perl_modules->get_attr('missing_pm');>
 
-=head2 module_count
-
-    Returns a scalar value representing the current number of Perl modules used by Koha.
-
-    example:
-        C<my $module_count = $perl_modules->module_count;>
-
-=head2 module_list
-
-    Returns an array who's elements are the names of the Perl modules used by Koha.
-
-    example:
-        C<my @module_list = $perl_modules->module_list;>
-
-    This is useful for commandline exercises such as:
-
-        perl -MC4::Installer::PerlModules -e 'my $deps = C4::Installer::PerlModule->new; print (join("\n",$deps->module_list));'
 
 =head1 AUTHOR