Dist::Zilla::Plugin::StaticInstall - Identify a distribution as eligible for static installation
version 0.003
In your dist.ini:
; when you are confident this is correct [StaticInstall] mode = on ; be conservative; just tell us what the value should be [StaticInstall] mode = auto dry_run = 1
This is a Dist::Zilla plugin that, when mode is on, provides the following distribution metadata:
mode
on
x_static_install : "1"
The definition of a "static installation" is still being refined by the Perl Toolchain Gang. Use with discretion!
The current preconditions for x_static_install being true include:
x_static_install
dynamic_config must be false in metadata
dynamic_config
no prerequisites in configure-requires other than ExtUtils::MakeMaker, Module::Build::Tiny, or File::ShareDir::Install
no prerequisites in build-requires
no installer plugins permitted other than:
Dist::Zilla::Plugin::MakeMaker
Dist::Zilla::Plugin::MakeMaker::Fallback
Dist::Zilla::Plugin::ModuleBuildTiny
Dist::Zilla::Plugin::ModuleBuildTiny::Fallback
an installer plugin from the above list must be used (a manually-generated Makefile.PL or Build.PL is not permitted)
no other plugins may modify Makefile.PL nor Build.PL
the [MetaJSON] plugin must be used, at (the default) meta-spec version 2
[MetaJSON]
no .xs files may be present
When set to on, the value of x_static_install is set to 1 (the normal usecase).
When set to off, the value of x_static_install is set to 0, which is equivalent to not providing this field at all.
off
When set to auto, we attempt to calculate the proper value. When used with dry_run = 1, the value isn't actually stored, but just provided in a diagnostic message. This is the recommended usage in a plugin bundle, for testing against a number of distributions at once.
auto
dry_run = 1
The calculations are always performed, no matter the value of mode -- if it comes up with a different result than what you are setting, this is logged. If mode = on and the calculations discover the distribution is ineligible for this flag, the build fails, to prevent you from releasing bad metadata.
mode = on
dry_run
When true, no value is set in metadata, but verbose logging is enabled so you can see what the value would have been.
Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-StaticInstall@rt.cpan.org). I am also usually active on irc, as 'ether' at irc.perl.org.
irc.perl.org
CPAN::Meta::Spec
Karen Etheridge <ether@cpan.org>
This software is copyright (c) 2015 by Karen Etheridge.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Dist::Zilla::Plugin::StaticInstall, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::StaticInstall
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::StaticInstall
For more information on module installation, please visit the detailed CPAN module installation guide.