1Dist::Zilla::Role::PlugUisneBrunCdolnet:r:iEbaustye(d3D)Piesrtl::DZoiclulmae:n:tRaotlieo:n:PluginBundle::Easy(3)
2
3
4

NAME

6       Dist::Zilla::Role::PluginBundle::Easy - something that bundles a bunch
7       of plugins easily
8

VERSION

10       version 6.031
11

SYNOPSIS

13         package Dist::Zilla::PluginBundle::Example;
14         use Moose;
15         with 'Dist::Zilla::Role::PluginBundle::Easy';
16
17         sub configure {
18           my $self = shift;
19
20           $self->add_plugins('VersionFromModule');
21           $self->add_bundle('Basic');
22         }
23

DESCRIPTION

25       This role builds upon the PluginBundle role, adding methods to take
26       most of the grunt work out of creating a bundle.  It supplies the
27       "bundle_config" method for you.  In exchange, you must supply a
28       "configure" method, which will store the bundle's configuration in the
29       "plugins" attribute by calling "add_plugins" and/or "add_bundle".
30

PERL VERSION

32       This module should work on any version of perl still receiving updates
33       from the Perl 5 Porters.  This means it should work on any version of
34       perl released in the last two to three years.  (That is, if the most
35       recently released version is v5.40, then this module should work on
36       both v5.40 and v5.38.)
37
38       Although it may work on older versions of perl, no guarantee is made
39       that the minimum required version will not be increased.  The version
40       may be increased for any reason, and there is no promise that patches
41       will be accepted to lower the minimum required perl.
42

ATTRIBUTES

44   name
45       This is the bundle name, taken from the Section passed to
46       "bundle_config".
47
48   payload
49       This hashref contains the bundle's parameters (if any), taken from the
50       Section passed to "bundle_config".
51
52   plugins
53       This arrayref contains the configuration that will be returned by
54       "bundle_config".  You normally modify this by using the "add_plugins"
55       and "add_bundle" methods.
56

METHODS

58   add_plugins
59         $self->add_plugins('Plugin1', [ Plugin2 => \%plugin2config ])
60
61       Use this method to add plugins to your bundle.
62
63       It is passed a list of plugin specifiers, which can be one of a few
64       things:
65
66       •   a plugin moniker (like you might provide in your config file)
67
68       •   an arrayref of: "[ $moniker, $plugin_name, \%plugin_config ]"
69
70       In the case of an arrayref, both $plugin_name and "\%plugin_config" are
71       optional.
72
73       The plugins are added to the config in the order given.
74
75   add_bundle
76         $self->add_bundle(BundleName => \%bundle_config)
77
78       Use this method to add all the plugins from another bundle to your
79       bundle.  If you omit %bundle_config, an empty hashref will be supplied.
80
81   config_slice
82         $hash_ref = $self->config_slice(arg1, { arg2 => 'plugin_arg2' })
83
84       Use this method to extract parameters from your bundle's "payload" so
85       that you can pass them to a plugin or subsidiary bundle.  It supports
86       easy renaming of parameters, since a plugin may expect a parameter name
87       that's too generic to be suitable for a bundle.
88
89       Each arg is either a key in "payload", or a hashref that maps keys in
90       "payload" to keys in the hash being constructed.  If any specified key
91       does not exist in "payload", then it is omitted from the result.
92

AUTHOR

94       Ricardo SIGNES 😏 <cpan@semiotic.systems>
95
97       This software is copyright (c) 2023 by Ricardo SIGNES.
98
99       This is free software; you can redistribute it and/or modify it under
100       the same terms as the Perl 5 programming language system itself.
101
102
103
104perl v5.36.1                      2023-D1i1s-t2:1:Zilla::Role::PluginBundle::Easy(3)
Impressum