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 = 1

or:

; this distribution does not need . to be in @INC
[UseUnsafeInc]
dot_in_INC = 0

DESCRIPTION

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

• "'.' and @INC" in perl5260delta

• Dist::Zilla::Plugin::EnsureLatestPerl

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.