Kent Fredric > Dist-Zilla-Plugin-Prereqs-SyncVersions > Dist::Zilla::Plugin::Prereqs::SyncVersions

Download:
Dist-Zilla-Plugin-Prereqs-SyncVersions-0.003000.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.003000   Source  

NAME ^

Dist::Zilla::Plugin::Prereqs::SyncVersions - DEPRECATED Homogenize prerequisites so dependency versions are consistent

VERSION ^

version 0.003000

DEPRECATED ^

This module is deprecated as equivalent behavior is now part of Dist::Zilla.

However, this module will keep maintained for anyone who wants this behavior without upgrading to DZil 5

SYNOPSIS ^

    ; <bunch of metaprereq providing modules>

    [Prereqs::SyncVersions]

Note: This must come after packages that add their own prerequisites in order to work as intended.

DESCRIPTION ^

This module exists to pose mostly as a workaround for potential bugs in downstream tool-chains.

Namely, CPAN.pm is confused when it sees:

    runtime.requires : Foo >= 5.0
    test.requires    : Foo >= 6.0

It doesn't know what to do.

This is an easy enough problem to solve if you're using [Prereqs] directly, and [AutoPrereqs] already does the right thing, but it gets messier when you're working with plugins that inject their own prerequisites

So this plugin will homogenize dependencies to be the same version in all phases which infer the dependency, matching the largest one found, so the above becomes:

    runtime.requires : Foo >= 6.0
    test.requires    : Foo >= 6.0

METHODS ^

mvp_multivalue_args

The following attributes exist, and may be specified more than once:

    applyto
    applyto_relation
    applyto_phase

register_prereqs

This method is called during Dist::Zilla prerequisite generation, and it injects supplementary prerequisites to make things match up.

ATTRIBUTES ^

applyto_phase

A multi-value attribute that specifies which phases to iterate and homogenize.

By default, this is:

    applyto_phase = build
    applyto_phase = test
    applyto_phase = runtime
    applyto_phase = configure

However, you could extend it further to include develop if you wanted to.

    applyto_phase = build
    applyto_phase = test
    applyto_phase = runtime
    applyto_phase = configure
    appyyto_phase = develop

applyto_relation

A multi-value attribute that specifies which relations to iterate and homogenize.

By default, this is:

    applyto_relation = requires

However, you could extend it further to include suggests and recommends if you wanted to. You could even add conflicts ... but you really shouldn't.

    applyto_relation = requires
    applyto_relation = suggests
    applyto_relation = recommends
    applyto_relation = conflicts ; Danger will robinson.

applyto

A multi-value attribute that by default composites the values of

applyto_relation and applyto_phase.

This is if you want to be granular about how you specify phase/relations to process.

    applyto = runtime.requires
    applyto = develop.requires
    applyto = test.suggests

AUTHOR ^

Kent Fredric <kentnl@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2014 by Kent Fredric <kentfredric@gmail.com>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: