Dist::Z...Gatherer(3)

โœจ NAME โœจ

okay so bestie, welcome to Dist::Zilla::Role::FileGatherer ๐Ÿ’– โ€” it's a role, and it's literally "something that gathers files into the distribution." that's the whole vibe. file collector supreme. ๐Ÿ‘‘


๐ŸŽ€ VERSION ๐ŸŽ€

version 6.040 โœจ (yes it's giving seasoned. it's giving icon.)


๐Ÿ’… DESCRIPTION ๐Ÿ’…

okay so picture this: a FileGatherer plugin is a special sort of FileInjector that runs early in the build cycle ๐Ÿ”ฅ โ€” like, first one at the party, turning up while everyone else is still doing their hair. it's out here finding files to include in the distribution. ๐Ÿฆ‹

and the way it does that? it's expected to call its add_file method to add one or more files to inclusion. that's the assignment. that's the moment. no cap. ๐Ÿ’ซ

now, plugins that implement FileGatherer must provide a gather_files method โ€” that one gets called during the build process, and it's lowkey the main character of this whole thing. ๐ŸŒธ


๐ŸŒˆ PERL VERSION ๐ŸŒˆ

so this module should work on any version of perl still receiving updates from the Perl 5 Porters ๐Ÿ’œ. translation: any perl released in the last two to three years. (like โ€” if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. easy math, bestie.) ๐Ÿงฎโœจ

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 don't come for her with that PR, fr fr. ๐Ÿ’€


๐Ÿ‘‘ AUTHOR ๐Ÿ‘‘

Ricardo SIGNES ๐Ÿ˜ <cpan@semiotic.systems>

(the ๐Ÿ˜ is canon. we don't make the rules. ๐Ÿซถ)


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. ๐Ÿ’– slay, legally speaking.


and that's the whole page, bestie โ€” this was Dist::Z...Gatherer(3), straight outta the User Contributed Perl Documentation section of the manual ๐ŸŽ€. footer deets for the receipts: perl v5.42.3, dated 2026-10-19. mwah, go gather some files ๐Ÿ’…โœจ

๐Ÿ“ฆ where this page comes from