NAME
Dist::Zilla::Plugin::UseUnsafeInc - Indicates in metadata the value of PERL_USE_UNSAFE_INC to use during installation
VERSION
version 0.002
SYNOPSIS
In your dist.ini:
; this distribution still requires . to be in @INC
[UseUnsafeInc]
dot_in_INC = 1or:
; this distribution does not need . to be in @INC
[UseUnsafeInc]
dot_in_INC = 0DESCRIPTION
This is a Dist::Zilla plugin that populates the x_use_unsafe_inc key in your distribution metadata. This indicates to components of the toolchain that PERL_USE_UNSAFE_INC should be set to a certain value during installation and testing. If PERL_USE_UNSAFE_INC has already been set in the environment, it is unchanged, but the metadata is respected at a higher precedence than any setting that other tools e.g. Test::Harness might have done.
The environment variable is also set in Dist::Zilla while building and testing the distribution, to ensure that local testing behaves in an expected fashion.
Additionally, the release must be performed using a Perl version that supports PERL_USE_UNSAFE_INC (that is, 5.26), to further guarantee test integrity. To bypass this check, set DZIL_ANY_PERL=1 in the environment.
CONFIGURATION OPTIONS
use_unsafe_inc
This configuration value must be set in your dist.ini, to either 0 or 1. PERL_USE_UNSAFE_INC will be set to the same value by tools that support it.
DZIL_ANY_PERL
When this environment variable is true, the Perl version check at release time (see above) is skipped.
BACKGROUND
SEE ALSO
SUPPORT
Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-UseUnsafeInc@rt.cpan.org).
There is also a mailing list available for users of this distribution, at http://dzil.org/#mailing-list.
There is also an irc channel available for users of this distribution, at #distzilla on irc.perl.org.
I am also usually active on irc, as 'ether' at irc.perl.org and irc.libera.chat.
AUTHOR
Karen Etheridge <ether@cpan.org>
COPYRIGHT AND LICENCE
This software is copyright (c) 2017 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.