Module::Build::Tiny

NAME

Module::Build::Tiny − A tiny replacement for Module::Build

VERSION

version 0.039

SYNOPSIS

 use Module::Build::Tiny;
 Build_PL();

DESCRIPTION

Many Perl distributions use a Build.PL file instead of a Makefile.PL file to drive distribution configuration, build, test and installation. Traditionally, Build.PL uses Module::Build as the underlying build system. This module provides a simple, lightweight, drop-in replacement.

Whereas Module::Build has over 6,700 lines of code; this module has less than 120, yet supports the features needed by most distributions.

Supported

	•		Pure Perl distributions
	•		Building XS or C
	•		Recursive test files
	•		MYMETA
	•		Man page generation
	•		Generated code from PL files

Not Supported

	•		Dynamic prerequisites
	•		HTML documentation generation
	•		Extending Module::Build::Tiny
	•		Module sharedirs

Directory structure
Your .pm and .pod files must be in lib/. Any executables must be in script/. Test files must be in t/. Dist sharedirs must be in share/.

USAGE

These all work pretty much like their Module::Build equivalents.

perl Build.PL
Build [ build ]
Build test
Build install
This supports the following options:

	•		verbose
	•		install_base
	•		installdirs
	•		prefix
	•		install_path
	•		destdir
	•		uninst
	•		config
	•		pure-perl
	•		create_packlist

AUTHORING

This module doesn’t support authoring. To develop modules using Module::Build::Tiny, usage of Dist::Zilla::Plugin::ModuleBuildTiny or App::ModuleBuildTiny is recommended.

CONFIG FILE AND ENVIRONMENT

Options can be provided in the "PERL_MB_OPT" environment variable the same way they can with Module::Build. This should be done during the configuration stage.

Incompatibilities

•

Argument parsing

Module::Build has an extremely permissive way of argument handling, Module::Build::Tiny only supports a (sane) subset of that. In particular, "./Build destdir=/foo" does not work, you will need to pass it as "./Build −−destdir=/foo".

•

.modulebuildrc

Module::Build::Tiny does not support .modulebuildrc files. In particular, this means that versions of local::lib older than 1.006008 may break with "ERROR: Can't create /usr/local/somepath". If the output of "perl −Mlocal::lib" contains "MODULEBUILDRC" but not "PERL_MB_OPT ", you will need to upgrade it to resolve this issue.

AUTHORS

	•		Leon Timmermans <leont AT cpan DOT org>
	•		David Golden <dagolden AT cpan DOT org>

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.

pdf

sourCEntral - mobile manpages