VERSION

SYNOPSIS

DESCRIPTION

This plugin will filter over all your declared or discovered prerequisites, contact CPAN, and adjust the version to the latest one available.

This will make sure that your module will be installed with the latest version available on CPAN at the time you built your package.

The most common use for this techinique is for Task modules. You can rebuild your Task module on a regular basis to make sure it has the latest versions of your dependencies.

Please note that this plugin only makes sure that the version of the prereq is the latest at the time you build your package, not the latest at the time the package is installed.

To do that it would require updates to the CPAN toolchain. Although I would welcome that, this plugin implements the next best thing.

Core modules options

NOTE WELL: this feature should be considered alpha. The interface might change in future versions.

The option skip_core_modules can be used to control the behaviour of this plugin with core modules (as defined by the Module::CoreList API).

If set to 1, we will skip forcing the latest version on modules that are part of the perl core, version equal or below to the one used to release the module.

An example: you have two modules on your [Prereqs] list, Digest::SHA part of the core since 5.009003, and HTTP::Tiny part of the core since 5.013009. With skip_core_modules=1, the following will happen:

If you release your module using perl 5.008009, both Digest::SHA and HTTP::Tiny will be forced to the lastest version.

If you release your module using perl 5.012003, the Digest::SHA will not be forced to the lastest version, but HTTP::Tiny will.

If you release your module using perl 5.014000, both ExtUtils::MakeMaker and HTTP::Tiny will not be forced to the lastest version.

By default (0) all modules will get the latest version.

Idealy we would make this decision based on the perl version of the person that will install your distribution, but for now that is not easy to do.

EXTRA REQUIREMENTS

This plugin uses the CPAN module, but hides the output, so make sure you have your cpan shell properly configured before trying to use this.

BUGS

This modules abuses the internals of the CPAN::Meta::Prereqs module. This is a bug, but right now that module does not provide an API to traverse its internals.