NAME

Dist::Zilla::Plugin::OnlyCorePrereqs - Check that no prerequisites are declared that are not part of core

VERSION

version 0.006

SYNOPSIS

In your dist.ini:

[OnlyCorePrereqs]
starting_version = 5.010

DESCRIPTION

[OnlyCorePrereqs] is a Dist::Zilla plugin that checks at build time if you have any declared prerequisites that are not shipped with Perl.

You can specify the first Perl version to check against, and which prerequisite phase(s) are significant.

If the check fails, the build is aborted.

OPTIONS

  • phase

    Indicates a phase to check against. Can be provided more than once; defaults to runtime and test. (See Dist::Zilla::Plugin::Prereqs for more information about phases.)

    Remember that you can use different settings for different phases by employing this plugin twice, with different names.

  • starting_version

    Indicates the first Perl version that should be checked against; any versions earlier than this are not considered significant for the purposes of core checks. Defaults to 5.005.

    There are two special values supported:

    • current - indicates the version of Perl that you are currently running with

    • latest - indicates the most recent (stable or development) release of Perl

    (Note: if you wish to check against all changes in core up to the very latest Perl release, you should upgrade your Module::CoreList installation. You can guarantee you are always running the latest version with Dist::Zilla::Plugin::PromptIfStale. Module::CoreList is also the mechanism used for determining the version of the latest Perl release.)

  • deprecated_ok

    A boolean flag indicating whether it is considered acceptable to depend on a deprecated module. Defaults to 0.

  • check_module_versions

    A boolean flag indicating whether the specific module version available in the starting_version of perl should also be checked. Defaults to 1.

    (For example, a prerequisite of Test::More 0.88 at starting_version 5.010 would fail with check_module_versions set, as the version of Test::More that shipped with that version of perl was only 0.72.

SUPPORT

Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-OnlyCorePrereqs@rt.cpan.org). I am also usually active on irc, as 'ether' at irc.perl.org.

AUTHOR

Karen Etheridge <ether@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 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.

CONTRIBUTOR

David Golden <dagolden@cpan.org>