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.