Gecko [ www.vortexaion.com ]

Name	Size	Permission	Date
API	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Exception	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
FTP	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
HTTP	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Kwalify	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
LWP	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Meta	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Plugin	[ DIR ]	drwxrwxrwx	2024-07-26 17:40
Admin.pm	7.61 KB	-rw-rw-rw-	2018-11-27 04:51
Author.pm	6.68 KB	-rw-rw-rw-	2020-12-18 11:57
Bundle.pm	9.91 KB	-rw-rw-rw-	2020-12-18 11:57
CacheMgr.pm	7.48 KB	-rw-rw-rw-	2020-12-18 11:57
Complete.pm	5.88 KB	-rw-rw-rw-	2020-12-18 11:57
Config.pm	4.11 KB	-rw-rw-rw-	2024-07-26 17:42
Debug.pm	2.05 KB	-rw-rw-rw-	2020-12-18 11:57
DeferredCode.pm	189 B	-rw-rw-rw-	2020-12-18 11:57
DistnameInfo.pm	4.99 KB	-rw-rw-rw-	2011-03-12 01:36
Distribution.pm	175.59 KB	-rw-rw-rw-	2020-12-18 11:57
Distroprefs.pm	11.71 KB	-rw-rw-rw-	2020-12-18 11:57
Distrostatus.pm	972 B	-rw-rw-rw-	2020-12-18 11:57
FTP.pm	42.28 KB	-rw-rw-rw-	2020-06-13 08:47
FirstTime.pm	71.84 KB	-rw-rw-rw-	2020-06-13 08:47
HandleConfig.pm	22.98 KB	-rw-rw-rw-	2020-12-18 11:57
Index.pm	21.7 KB	-rw-rw-rw-	2020-12-18 11:57
InfoObj.pm	6.75 KB	-rw-rw-rw-	2020-12-18 11:57
Kwalify.pm	3.35 KB	-rw-rw-rw-	2020-12-18 11:57
Meta.pm	29.56 KB	-rw-rw-rw-	2020-12-18 11:57
Mirrors.pm	17.82 KB	-rw-rw-rw-	2020-12-18 11:57
Module.pm	21.87 KB	-rw-rw-rw-	2020-12-18 11:57
Nox.pm	953 B	-rw-rw-rw-	2020-12-18 11:57
Plugin.pm	3.14 KB	-rw-rw-rw-	2020-12-18 11:57
Prompt.pm	567 B	-rw-rw-rw-	2020-12-18 11:57
Queue.pm	6.96 KB	-rw-rw-rw-	2020-12-18 11:57
Shell.pm	71.96 KB	-rw-rw-rw-	2020-12-18 11:57
Tarzip.pm	16.25 KB	-rw-rw-rw-	2020-12-18 11:57
URL.pm	588 B	-rw-rw-rw-	2020-12-18 11:57
Version.pm	4.29 KB	-rw-rw-rw-	2020-12-18 11:57

Rename

package CPAN::Plugin;

use strict;
use warnings;

our $VERSION = '0.97';

require CPAN;

######################################################################

sub new {                                # ;
    my ($class, %params) = @_;

my $self = +{
        (ref $class ? (%$class) : ()),
        %params,
    };

$self = bless $self, ref $class ? ref $class : $class;

unless (ref $class) {
        local $_;
        no warnings 'once';
        $CPAN::META->use_inst ($_) for $self->plugin_requires;
    }

$self;
}

######################################################################
sub plugin_requires {                    # ;
}

######################################################################
sub distribution_object {                # ;
    my ($self) = @_;
    $self->{distribution_object};
}

######################################################################
sub distribution {                       # ;
    my ($self) = @_;

my $distribution = $self->distribution_object->id;
    CPAN::Shell->expand("Distribution",$distribution)
      or $self->frontend->mydie("Unknowns distribution '$distribution'\n");
}

######################################################################
sub distribution_info {                  # ;
    my ($self) = @_;

CPAN::DistnameInfo->new ($self->distribution->id);
}

######################################################################
sub build_dir {                          # ;
    my ($self) = @_;

my $build_dir = $self->distribution->{build_dir}
      or $self->frontend->mydie("Distribution has not been built yet, cannot proceed");
}

######################################################################
sub is_xs {                              #
    my ($self) = @_;

my @xs = glob File::Spec->catfile ($self->build_dir, '*.xs'); # quick try

unless (@xs) {
        require ExtUtils::Manifest;
        my $manifest_file = File::Spec->catfile ($self->build_dir, "MANIFEST");
        my $manifest = ExtUtils::Manifest::maniread($manifest_file);
        @xs = grep /\.xs$/, keys %$manifest;
    }

scalar @xs;
}

######################################################################

package CPAN::Plugin;

__END__

=pod

=head1 NAME

CPAN::Plugin - Base class for CPAN shell extensions

=head1 SYNOPSIS

package CPAN::Plugin::Flurb;
   use parent 'CPAN::Plugin';

sub post_test {
     my ($self, $distribution_object) = @_;
     $self = $self->new (distribution_object => $distribution_object);
     ...;
   }

=head1 DESCRIPTION

=head2 Alpha Status

The plugin system in the CPAN shell was introduced in version 2.07 and
is still considered experimental.

=head2 How Plugins work?

See L<CPAN/"Plugin support">.

=head1 METHODS

=head2 plugin_requires

returns list of packages given plugin requires for functionality.
This list is evaluated using C<< CPAN->use_inst >> method.

=head2 distribution_object

Get current distribution object.

=head2 distribution

=head2 distribution_info

=head2 build_dir

Simple delegatees for misc parameters derived from distribution

=head2 is_xs

Predicate to detect whether package contains XS.

=head1 AUTHOR

Branislav Zahradnik <barney@cpan.org>

=cut