The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Module-Build-Tiny-0.009
River stage five • 1644 direct dependents • 11158 total dependents
16 ++
/ Module::Build::Tiny

NAME

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

SYNOPSIS

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

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 under 100, yet supports the features needed by most pure-Perl distributions.

Supported

  * Pure Perl distributions
  * Recursive test files
  * MYMETA
  * Man page generation

Not Supported

  * Dynamic prerequisites
  * Generated code from PL files
  * Building XS or C
  * HTML documentation generation
  * Extending Module::Build::Tiny

Other limitations

  * This is an experimental module -- use at your own risk

Directory structure

Your .pm and .pod files must be in lib/. Any executables must be in script/. Test files must be in t/. Bundled test modules must be in t/lib/.

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:

  • install_base

  • installdirs

  • prefix

  • install_path

  • destdir

  • uninst

Build clean

Build realclean

AUTHORING

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

CONFIG FILE AND ENVIRONMENT

Options can be provided in a .modulebuildrc file or in the PERL_MB_OPT environment variable the same way they can with Module::Build.

SEE ALSO

Module::Build

AUTHOR

  David Golden <dagolden@cpan.org>
  Leon Timmermans <leont@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009 - 2011 by David A. Golden, Leon Timmermans

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.

# vi:et:sts=2:sw=2:ts=2