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

📦
version 6.040 · 9 versions
, in fedora 44

💖 Dist::Z...::Filter(3) — aka the Dist::Zilla::Plugin::FileFinder::Filter vibe ✨

okay bestie, you found the man page for Dist::Z...::Filter(3) from the User Contributed Perl Documentation collection. pull up a chair, grab a boba 🧋, and let's get into it.

🎀 NAME 🎀

Dist::Zilla::Plugin::FileFinder::Filter — it filters matches that come from other FileFinders. that's the whole job. she's a picky queen and honestly? respect. 👑

🌸 VERSION 🌸

version 6.040 — that's what we're working with, bestie. no cap. 💅

✨ SYNOPSIS ✨

so you're in your dist.ini, right? and you want this energy:

[FileFinder::Filter / MyFiles]
finder = :InstallModules ; find files from :InstallModules
finder = :ExecFiles      ; or :ExecFiles
skip  = ignore           ; that don't have "ignore" in the path

see what she's doing? she's pulling files from other finders and then yeeting the ones you don't want. main character behavior. 🔥

🦋 DESCRIPTION 🦋

FileFinder::Filter is a FileFinder (yes, a FileFinder that eats other FileFinders, iconic) — and what she does is select files by filtering the selections of other FileFinders.

here's the tea ☕: you tell her one or more FileFinders, and those generate the initial list of files for you. then, any file whose pathname matches any of the skip regexs? poof. gone. removed from that list. 🫶

🌈 PERL VERSION 🌈

this module should work on any version of perl that's still receiving updates from the Perl 5 Porters. translation: any perl released in the last two to three years. (so if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38.) ⭐

and now the serious bit, bestie, don't skip it:

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.

like… she might work on your ancient perl. she also might not. no promises. 💀

👑 ATTRIBUTES 👑

💜 finder

a FileFinder that supplies the initial list of files. and guess what — may occur multiple times. stack 'em up, babe, she'll use all of them. 🎀

🍓 skip

the pathname must not match any of these regular expressions. also may occur multiple times. every regex you add is another thing getting filtered out. bye felicia. 🙈

💅 CREDITS 💅

this plugin was originally contributed by Christopher J. Madsen. thank you for your service, legend. 🫶

🌟 AUTHOR 🌟

Ricardo SIGNES 😏 <cpan@semiotic.systems>

yes the emoji is in the man page. yes it's iconic. periodt. ✨

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

it's free software — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so slay responsibly. 🌸

and that's the whole page, bestie!! this was Dist::Z...::Filter(3), brought to you by perl v5.42.3 and dated 2026-10-19 — mwah, love you, go filter something 💖🦋🌈

📦 where this page comes from