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 is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.