Module::Build::Authoring 0.2805

Module::Build::Authoring are authoring Module::Build modules.

When creating a Build.PL script for a module, something like the following code will typically be used:

use Module::Build;
my $build = Module::Build->new
(
module_name => Foo::Bar,
license => perl,
requires => {
perl => 5.6.1,
Some::Module => 1.23,
Other::Module => >= 1.2, != 1.5, < 2.0,
},
);
$build->create_build_script;

A simple module could get away with something as short as this for its Build.PL script:

use Module::Build;
Module::Build->new(
module_name => Foo::Bar,
license => perl,
)->create_build_script;

The model used by Module::Build is a lot like the MakeMaker metaphor, with the following correspondences:

In Module::Build In ExtUtils::MakeMaker
--------------------------- ------------------------
Build.PL (initial script) Makefile.PL (initial script)
Build (a short perl script) Makefile (a long Makefile)
_build/ (saved state info) various config text in the Makefile

Any customization can be done simply by subclassing Module::Build and adding a method called (for example) ACTION_test, overriding the default test action. You could also add a method called ACTION_whatever, and then you could perform the action Build whatever.
For information on providing compatibility with ExtUtils::MakeMaker, see Module::Build::Compat and http://www.makemaker.org/wiki/index.cgi?ModuleBuildConversionGuide.