1Module::Build::Tiny(3pmU)ser Contributed Perl DocumentatiMoondule::Build::Tiny(3pm)
2
3
4

NAME

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

VERSION

9       version 0.039
10

SYNOPSIS

12        use Module::Build::Tiny;
13        Build_PL();
14

DESCRIPTION

16       Many Perl distributions use a Build.PL file instead of a Makefile.PL
17       file to drive distribution configuration, build, test and installation.
18       Traditionally, Build.PL uses Module::Build as the underlying build
19       system.  This module provides a simple, lightweight, drop-in
20       replacement.
21
22       Whereas Module::Build has over 6,700 lines of code; this module has
23       less than 120, yet supports the features needed by most distributions.
24
25   Supported
26       •   Pure Perl distributions
27
28       •   Building XS or C
29
30       •   Recursive test files
31
32       •   MYMETA
33
34       •   Man page generation
35
36       •   Generated code from PL files
37
38   Not Supported
39       •   Dynamic prerequisites
40
41       •   HTML documentation generation
42
43       •   Extending Module::Build::Tiny
44
45       •   Module sharedirs
46
47   Directory structure
48       Your .pm and .pod files must be in lib/.  Any executables must be in
49       script/.  Test files must be in t/. Dist sharedirs must be in share/.
50

USAGE

52       These all work pretty much like their Module::Build equivalents.
53
54   perl Build.PL
55   Build [ build ]
56   Build test
57   Build install
58       This supports the following options:
59
60       •   verbose
61
62       •   install_base
63
64       •   installdirs
65
66       •   prefix
67
68       •   install_path
69
70       •   destdir
71
72       •   uninst
73
74       •   config
75
76       •   pure-perl
77
78       •   create_packlist
79

AUTHORING

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

CONFIG FILE AND ENVIRONMENT

86       Options can be provided in the "PERL_MB_OPT" environment variable the
87       same way they can with Module::Build. This should be done during the
88       configuration stage.
89
90   Incompatibilities
91       •   Argument parsing
92
93           Module::Build has an extremely permissive way of argument handling,
94           Module::Build::Tiny only supports a (sane) subset of that. In
95           particular, "./Build destdir=/foo" does not work, you will need to
96           pass it as "./Build --destdir=/foo".
97
98       •   .modulebuildrc
99
100           Module::Build::Tiny does not support .modulebuildrc files. In
101           particular, this means that versions of local::lib older than
102           1.006008 may break with "ERROR: Can't create /usr/local/somepath".
103           If the output of "perl -Mlocal::lib" contains "MODULEBUILDRC" but
104           not "PERL_MB_OPT ", you will need to upgrade it to resolve this
105           issue.
106

SEE ALSO

108       Module::Build
109

AUTHORS

111       •   Leon Timmermans <leont@cpan.org>
112
113       •   David Golden <dagolden@cpan.org>
114
116       This software is copyright (c) 2011 by Leon Timmermans, David Golden.
117
118       This is free software; you can redistribute it and/or modify it under
119       the same terms as the Perl 5 programming language system itself.
120
121
122
123perl v5.34.0                      2022-01-21          Module::Build::Tiny(3pm)
Impressum