-
-
12 Oct 2014 08:40:17 UTC
- Distribution: Module-Build-Tiny
- Module version: 0.039
- Source (raw)
- Browse (raw)
- Changes
- How to Contribute
- Repository
- Issues (3)
- Testers (43113 / 82 / 12)
- Kwalitee
Bus factor: 1- % Coverage
- License: perl_5
- Perl: v5.6.0
- Activity
24 month- Tools
- Download (20.18KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- Dependencies
- CPAN::Meta
- DynaLoader
- Exporter
- ExtUtils::CBuilder
- ExtUtils::Config
- ExtUtils::Helpers
- ExtUtils::Install
- ExtUtils::InstallPaths
- ExtUtils::ParseXS
- File::Basename
- File::Find
- File::Path
- File::Spec::Functions
- Getopt::Long
- JSON::PP
- Pod::Man
- TAP::Harness::Env
- strict
- warnings
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- NAME
- VERSION
- SYNOPSIS
- DESCRIPTION
- USAGE
- AUTHORING
- CONFIG FILE AND ENVIRONMENT
- SEE ALSO
- AUTHORS
- COPYRIGHT AND LICENSE
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 ofperl -Mlocal::lib
containsMODULEBUILDRC
but notPERL_MB_OPT
, you will need to upgrade it to resolve this issue.
SEE ALSO
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.
Module Install Instructions
To install Module::Build::Tiny, copy and paste the appropriate command in to your terminal.
cpanm Module::Build::Tiny
perl -MCPAN -e shell install Module::Build::Tiny
For more information on module installation, please visit the detailed CPAN module installation guide.