1Dist::Zilla::Plugin::PrUesreerqsC(o3n)tributed Perl DocuDmiesntt:a:tZiiolnla::Plugin::Prereqs(3)
2
3
4

NAME

6       Dist::Zilla::Plugin::Prereqs - list simple prerequisites
7

VERSION

9       version 6.017
10

SYNOPSIS

12       In your dist.ini:
13
14         [Prereqs]
15         Foo::Bar = 1.002
16         MRO::Compat = 10
17         Sub::Exporter = 0
18
19       You can specify requirements for different phases and relationships
20       with:
21
22         [Prereqs]
23         -phase = test
24         -relationship = recommends
25
26         Fitz::Fotz    = 1.23
27         Text::SoundEx = 3
28
29       Remember that if you load two Prereqs plugins, each will needs its own
30       name, added like this:
31
32         [Prereqs / PluginName]
33         -phase = test
34         -relationship = recommends
35
36         Fitz::Fotz    = 1.23
37         Text::SoundEx = 3
38
39       If the name is the CamelCase concatenation of a phase and relationship
40       (or just a relationship), it will set those parameters implicitly.  If
41       you use a custom name, but it does not specify the relationship, and
42       you didn't specify either "-phase" or "-relationship", it throws the
43       error "No -phase or -relationship specified".  This is to prevent a
44       typo that makes the name meaningless from slipping by unnoticed.
45
46       The example below is equivalent to the example above, except for the
47       name of the resulting plugin:
48
49         [Prereqs / TestRecommends]
50         Fitz::Fotz    = 1.23
51         Text::SoundEx = 3
52

DESCRIPTION

54       This module adds "fixed" prerequisites to your distribution.  These are
55       prereqs with a known, fixed minimum version that doesn't change based
56       on platform or other conditions.
57
58       You can specify prerequisites for different phases and kinds of
59       relationships.  In "RuntimeRequires", the phase is Runtime and the
60       relationship is Requires.  These are described in more detail in the
61       CPAN::Meta specification.
62
63       The phases are:
64
65       ·   configure
66
67       ·   build
68
69       ·   test
70
71       ·   runtime
72
73       ·   develop
74
75       The relationship types are:
76
77       ·   requires
78
79       ·   recommends
80
81       ·   suggests
82
83       ·   conflicts
84
85       If the phase is omitted, it will default to runtime; thus, specifying
86       "Prereqs / Recommends" in your dist.ini is equivalent to
87       RuntimeRecommends.
88
89       Not all of these phases are useful for all tools, especially tools that
90       only understand version 1.x CPAN::Meta files.
91

SEE ALSO

93       ·   Core Dist::Zilla plugins: @Basic, AutoPrereqs.
94
95       ·   The CPAN Meta specification: "PREREQUISITES" in CPAN::Meta.
96

AUTHOR

98       Ricardo SIGNES 😏 <rjbs@cpan.org>
99

101       This software is copyright (c) 2020 by Ricardo SIGNES.
102
103       This is free software; you can redistribute it and/or modify it under
104       the same terms as the Perl 5 programming language system itself.
105
106
107
108perl v5.32.0                      2020-11-03   Dist::Zilla::Plugin::Prereqs(3)
Impressum