/ 
ExtUtils-Builder-0.017
River stage two • 2 direct dependents • 24 total dependents
/ ExtUtils::Builder::MakeMaker

NAME

ExtUtils::Builder::MakeMaker - A MakeMaker consumer for ExtUtils::Builder Plan objects

VERSION

version 0.017

SYNOPSIS

use ExtUtils::MakeMaker;
use ExtUtils::Builder::MakeMaker;
...
WriteMakeFile(
  NAME => 'Foo',
  VERSION => 0.001,
);

sub MY::make_plans {
  my ($self, $planner) = @_;
  $planner->load_extension('Some::Module');
  ... # Add plans to $planner
}

DESCRIPTION

This MakeMaker extension will call your MY::make_plans method with a ExtUtils::Builder::Planner as argument so that you can add entries to it; these entries will be added to your Makefile. It will also call any .pl files in /planner as DSL files, these are run in a new scope so delegates don't leak out. Entries may depend on existing MakeMaker entries and vice-versa. Typically one would make their target a dependency of a MakeMaker entry like pure_all or dynamic.

DELEGATES

By default, the following delegates are defined on your planner:

  • meta

    A CPAN::Meta object representing the META.json file.

  • distribution

    The name of the distribution

  • version

    The version of the distribution

  • main_module

    The main module of the distribution.

  • release_status

    The release status of the distribution (e.g. 'stable').

  • perl_path

    The path to the perl executable.

  • config

    The ExtUtils::Config::MakeMaker object for this build

  • is_os(@os_names)

    This returns true if the current operating system matches any of the listed ones.

  • is_os_type($os_type)

    This returns true if the type of the OS matches $os_type. Legal values are Unix, Windows and VMS.

  • verbose

    This is always false.

  • uninst

    The value of the uninst command line argument.

  • jobs

    This is always 1.

  • pureperl_only

    The value of the PUREPERL_ONLY command line argument.

These are the same ones as Dist::Build sets except install_paths is missing.

AUTHOR

Leon Timmermans <fawaka@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Leon Timmermans.

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