NAME

Dist::Zilla::Plugin::UseUnsafeInc - Indicates the value of PERL_USE_UNSAFE_INC to use during installation

VERSION

version 0.001

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, overriding any previous setting e.g. from the environment or from other tools.

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, to further guarantee test integrity.

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.

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.