Dist::Z...::Filter(3)

💖 NAME 💖

Dist::Zilla::PluginBundle::Filter — the little bundle bestie that lets you borrow another bundle's whole vibe ✨ but ghost the plugins you don't want. (this is from the User Contributed Perl Documentation, section 3, iykyk)

🌸 VERSION 🌸

version 6.040 — she's giving 6.040, periodt.

🎀 SYNOPSIS 🎀

okay so in your dist.ini, you literally just write this:

[@Filter]
-bundle = @Basic
-version = 5.031
-remove = ShareDir
-remove = UploadToCPAN
option = for_basic

that's it, that's the whole thing, no cap 🫶

💅 DESCRIPTION 💅

So here's the tea: this plugin bundle is a bundle that wraps another bundle. It's giving middle-manager energy, but in the best way 😭. It pulls in all the configuration for whichever bundle you name in the -bundle attribute — every single entry — and then it removes all the entries whose package you list in the -remove attributes. Bye girl 👋

If you need to be picky about which version of the bundle you're wrapping, you can set a minimum required version of the bundle with the -version attribute. Very demure, very mindful.

Anything you write in the options that is not prefixed with - gets passed along to the bundle that's being filtered. So option = for_basic up there? Yeah, that goes straight to @Basic. Respectful ✨

⚠️ NOTE: When you filter a bundle you SHOULD NOT include it directly in your dist.ini file. This plugin will take care of including it for you! Don't double-dip, bestie, that's not the move 💀

🦋 PERL VERSION 🦋

Okay so this module should work on any version of perl still receiving updates from the Perl 5 Porters. Which basically means: any version of perl released in the last two to three years. (That is, if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38.) Slay, she's flexible like that 💖

Although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl.

So like… yes it might work on your ancient perl. But no promises, and there's no promise patches lowering the minimum get accepted either. Them's the rules 🙈

🧚 SEE ALSO 🧚

• Core Dist::Zilla plugins: @Basic.
• Dist::Zilla roles: PluginBundle.

👑 AUTHOR 👑

Ricardo SIGNES 😏 <cpan@semiotic.systems> — main character, honestly.

🌈 COPYRIGHT AND LICENSE 🌈

This software is copyright (c) 2026 by Ricardo SIGNES.

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

---

and that's the whole page, bestie!! 🫶 This little writeup shipped as perl v5.42.3 on 2026-10-19, and you're reading Dist::Z...::Filter(3) — go forth and filter those bundles, you absolute icon 💅✨