Scroll to navigation

Dist::Zilla::Role::PluginBundle::Config::Slicer(3pm) User Contributed Perl Documentation Dist::Zilla::Role::PluginBundle::Config::Slicer(3pm)


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


version 0.201


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

  with (
    'Dist::Zilla::Role::PluginBundle', # or PluginBundle::Easy

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


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

  # dist.ini
  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.


  • Config::MVP::Slicer
  • Dist::Zilla
  • Dist::Zilla::Config::Slicer
  • Dist::Zilla::Role::PluginBundle
  • Dist::Zilla::Role::PluginBundle::Easy
  • Dist::Zilla::PluginBundle::ConfigSlicer


Randy Stauner <>


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.

2017-02-12 perl v5.24.1