Dist::Z...dRunner(3)

๐Ÿ’– Dist::Zilla::Role::BuildRunner(3) ๐Ÿ’–

okay bestie, welcome to the User Contributed Perl Documentation section, this is Dist::Zilla::Role::BuildRunner(3) and she's a whole vibe ๐ŸŽ€

โœจ NAME โœจ

Dist::Zilla::Role::BuildRunner โ€” something used as a delegating agent during dzil run ๐Ÿซถ

like. that's literally her whole job description. delegating. queen behavior honestly ๐Ÿ‘‘


๐ŸŒธ VERSION ๐ŸŒธ

version 6.040 โœจ

๐Ÿฆ‹ DESCRIPTION ๐Ÿฆ‹

so here's the tea โ˜• โ€” plugins that implement this role get their build method called during dzil run. that's it. that's the moment. main character energy fr ๐Ÿ’…

and what does build get handed? the root directory of the build test dir. it's giving "here's the keys, go off" ๐Ÿ”‘

๐Ÿ’œ 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 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. simple math, no cap ๐Ÿงฎ

โš ๏ธ now the serious part, bestie. even though it might work on older perls, there is no guarantee that the minimum required version won't get bumped. and it can get bumped for any reason whatsoever. and no โ€” patches to lower the minimum required perl are not promised to be accepted. periodt ๐Ÿ’€

๐ŸŒŸ REQUIRED METHODS ๐ŸŒŸ

๐ŸŽ€ build

this method will throw an exception on failure ๐Ÿ˜ญ

that's the whole spec. if it fails, it throws. no silent sad-girl behavior, it tells you. iconic.


๐Ÿ‘‘ AUTHOR ๐Ÿ‘‘

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

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. ๐Ÿซถ


that's the whole page, babe โ€” perl v5.42.3, dated 2026-10-19, and it's the Dist::Zilla::Role::BuildRunner(3) manual page. go build something cute ๐Ÿ’–โœจ๐ŸŽ€

๐Ÿ“ฆ where this page comes from