NAME

Dist::Zilla::Role::PluginBundle::Config::Slicer - Pass Portions of Bundle Config to Plugins

VERSION

version 0.202

SYNOPSIS

  # in Dist::Zilla::PluginBundle::MyBundle

  with (
    'Dist::Zilla::Role::PluginBundle', # or PluginBundle::Easy
    'Dist::Zilla::Role::PluginBundle::Config::Slicer'
  );

  # Config::Slicer should probably be last
  # (unless you're doing something more complex)

DESCRIPTION

This role enables your Dist::Zilla Plugin Bundle to accept configuration customizations for the plugins it will load and merge them transparently.

  # dist.ini
  [@MyBundle]
  option = 1
  Included::Plugin.attribute = overwrite value
  AnotherPlug.array[0] = append value
  AnotherPlug.array[1] = append another value

See "CONFIGURATION SYNTAX" in Config::MVP::Slicer for details on how the configurations are handled.

This role adds a method modifier to bundle_config, which is the method that the root PluginBundle role requires, and that PluginBundle::Easy wraps.

After bundle_config is called the modifier will update the returned plugin configurations with any values that were customized in the main bundle config.

Most of the work is done by Dist::Zilla::Config::Slicer (a subclass of Config::MVP::Slicer). Check out those modules if you want the same functionality but don't want to consume this role in your bundle.

SEE ALSO

• Config::MVP::Slicer

• Dist::Zilla

• Dist::Zilla::Config::Slicer

• Dist::Zilla::Role::PluginBundle

• Dist::Zilla::Role::PluginBundle::Easy

• Dist::Zilla::PluginBundle::ConfigSlicer

AUTHOR

Randy Stauner <rwstauner@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Randy Stauner.

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