NAME

Alien::Build::Plugin - Plugin base class for Alien::Build

VERSION

version 0.16

SYNOPSIS

Create your plugin:

 package Alien::Build::Plugin::Type::MyPlugin;
 
 use Alien::Build::Plugin;
 use Carp ();
 
 has prop1 => 'default value';
 has prop2 => sub { 'default value' };
 has prop3 => sub { Carp::croak 'prop3 is a required property' };
 
 sub init
 {
   my($self, $meta) = @_;

   my $prop1 = $self->prop1;
   my $prop2 = $self->prop2;
   my $prop3 = $self->prop3;
   
   $meta->register_hook(sub {
     build => [ '%{make}', '%{make} install' ],
   });
 }

From your alienfile

 use alienfile;
 plugin 'Type::MyPlugin' => (
   prop2 => 'different value',
   prop3 => 'need to provide since it is required',
 );

DESCRIPTION

This document describes the Alien::Build plugin base class. For details on how to write a plugin, see Alien::Build::Manual::PluginAuthor.

Listed are some common types of plugins:

Alien::Build::Plugin::Build

Tools for building.

Alien::Build::Plugin::Core

Tools already included.

Alien::Build::Plugin::Download

Methods for retrieving from the internet.

Alien::Build::Plugin::Decode

Normally use Download plugins which will pick the correct Decode plugins.

Alien::Build::Plugin::Extract

Extract from archives that have been downloaded.

Alien::Build::Plugin::Fetch

Normally use Download plugins which will pick the correct Fetch plugins.

Alien::Build::Plugin::Prefer

Normally use Download plugins which will pick the correct Prefer plugins.

Alien::Build::Plugin::Probe

Look for packages already installed on the system.

CONSTRUCTOR

new

 my $plugin = Alien::Build::Plugin->new(%props);

METHODS

init

 $plugin->init($ab_class->meta); # $ab is an Alien::Build class name

You provide the implementation for this. The intent is to register hooks and set meta properties on the Alien::Build class.

has

 has $prop_name;
 has $prop_name => $default;

Specifies a property of the plugin. You may provide a default value as either a string scalar, or a code reference. The code reference will be called to compute the default value, and if you want the default to be a list or hash reference, this is how you want to do it:

 has foo => sub { [1,2,3] };

meta

 my $meta = $plugin->meta;

Returns the plugin meta object.

SEE ALSO

Alien::Build, alienfile, Alien::Build::Manual::PluginAuthor

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Alien::Build

perl -MCPAN -e shell
install Alien::Build