/ 
Alien-Build-0.16
River stage four • 286 direct dependents • 1572 total dependents
/ Alien::Build::Plugin

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.