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.

SEE ALSO

       Module::Build

AUTHORS

       •   Leon Timmermans <leont@cpan.org>

       •   David Golden <dagolden@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Leon Timmermans, David Golden.

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