view release on metacpan or  search on metacpan

lib/Dist/Zilla/Role/PluginBundle/Merged.pm  view on Meta::CPAN

       ['Plugin'],
       ['Plugin', 'NewName'],
       ['Plugin', \%new_payload ],
       ['Plugin', 'NewName', \%new_payload ],
 
       ### HASHs ###
       {},              # force no options until reset
       $self->payload,  # reset to original payload
       \%new_payload,   # only pass those arg/value pairs as the payload
 
       $self->config_slice(qw( arg1 arg2 )),                    # only pass those args -from- the payload
       $self->config_slice('arg1', { foobar_arg2 => 'arg2' }),  # only pass those args -from- the payload (with arg renaming)
 
       $self->config_rename(foobar_arg1 => 'arg1'),             # rename args in the payload (and pass everything else)
       $self->config_rename(killme => ''),                      # remove args in the payload (and pass everything else)
 
       ### Combinations ###
       $self->config_short_merge('Plugin', \%add_on_payload),   # add args to the payload, pass to Plugin, and reset to original
       $self->config_short_merge(
          [ qw( Plugin1 Plugin2 ) ],    # add args to the payload, pass to plugin list, and reset to original payload
          \%add_on_payload
       ),
    );

=head1 CAVEATS

=over

=item *

Plugins that use non-standard payload methods will not be passed their options via C<<< add_merged >>>, unless passed
an arrayref to C<<< add_merged >>> with an specific payload.  The C<<< config_merge >>> method will warn you of this, because
it knows that you really want to use that argument.  Others will not.

=back

=over

=item *

Doing things more implicitly grants greater flexibility while sacrificing control.  YMMV.

=back

=head1 AVAILABILITY

The project homepage is L<https://github.com/SineSwiper/Dist-Zilla-Role-PluginBundle-Merged/wiki>.

The latest version of this module is available from the Comprehensive Perl
Archive Network (CPAN). Visit L<http://www.perl.com/CPAN/> to find a CPAN
site near you, or see L<https://metacpan.org/module/Dist::Zilla::Role::PluginBundle::Merged/>.

=for :stopwords cpan testmatrix url annocpan anno bugtracker rt cpants kwalitee diff irc mailto metadata placeholders metacpan

=head1 SUPPORT

=head2 Internet Relay Chat

You can get live help by using IRC ( Internet Relay Chat ). If you don't know what IRC is,
please read this excellent guide: L<http://en.wikipedia.org/wiki/Internet_Relay_Chat>. Please
be courteous and patient when talking to us, as we might be busy or sleeping! You can join
those networks/channels and get help:

=over 4

=item *

irc.perl.org

You can connect to the server at 'irc.perl.org' and talk to this person for help: SineSwiper.

=back

=head2 Bugs / Feature Requests

Please report any bugs or feature requests via L<https://github.com/SineSwiper/Dist-Zilla-Role-PluginBundle-Merged/issues>.

=head1 AUTHOR

Brendan Byrd <bbyrd@cpan.org>

=head1 COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by Brendan Byrd.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

=cut