Module::Build::Tiny3pm
A tiny replacement for module::build
Usage
use Module::Build::Tiny;Build_PL();
Version
version 0.053
Overview
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 200, 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 |
•
|
Module sharedirs |
•
|
Dynamic prerequisites |
Not Supported
•
|
HTML documentation generation |
|---|---|
•
|
Extending Module::Build::Tiny |
Directory structure
Your .pm, .xs 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/, module sharedirs are under module-share (e.g. module-share/Foo-Bar for module "Foo::Bar").
".c" files in the src/ are compiled together with the .xs file matching the distribution name.
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.
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.
Releases
7 releases since Debian 8 (Jessie); the text changed 4 times.