Dist::Z...leBuild(3)

πŸ’… NAME

okay so bestie, this is Dist::Zilla::Plugin::ModuleBuild β€” it builds a Build.PL that uses Module::Build. that's the whole vibe. ✨


🌸 VERSION

version 6.040 β€” yeah she's got a number, she's official, she's got a whole identity 🫢

πŸ¦‹ DESCRIPTION

so what does this plugin actually do? it creates a Build.PL for installing your dist using Module::Build. that's it, that's the job, and she does it flawlessly. main character energy, no cap. πŸ’–

πŸ’€ PERL VERSION

okay so real talk about perl versions, because this one matters:

  • this module should work on any version of perl still receiving updates from the Perl 5 Porters. so like, any perl released in the last two to three years. (if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38.) fr fr, she keeps up. 🌈
  • ngl though, even though it may work on older versions of perl, there is no guarantee that the minimum required version won't 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 about the old perls, bestie, that's just how it is 😭

πŸ‘‘ ATTRIBUTES

these are the knobs you can turn. she's configurable, she's flexible, she's everything. πŸŽ€

mb_version

Optional! ✨ Specify the minimum version of Module::Build to depend on.

Defaults to 0.3601 if a sharedir is being used, otherwise 0.28. picky about her dependencies and honestly? valid. πŸ’…

mb_class

Optional! ✨ Specify the class to use to create the build object. Defaults to "Module::Build" itself.

if you specify another class, then the value of mb_lib will be used to generate a line like use lib 'inc' to be added to the generated Build.PL file. so yes, mb_class and mb_lib are besties, they work as a duo 🫢

mb_lib

Optional! ✨ Specify the list of directories to be passed to lib when using mb_class. Defaults to "inc".

build_element

anything you give in a build_element option will be added as a build element with Module::Build's add_build_element method. iconic behavior honestly, just handing it straight over πŸ”₯


🧚 SEE ALSO

  • Core Dist::Zilla plugins: @Basic, @Filter, MakeMaker, Manifest.
  • Dist::Zilla roles: BuildPL.

go read those too, iykyk πŸ’œ

⭐ AUTHOR

Ricardo SIGNES 😏 <cpan@semiotic.systems>

(he gets an emoji in the manpage and that's so real of him 😌)

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. periodt. πŸ’–


ok that's the whole page bestie, go build something cute πŸŽ€

and that was Dist::Zilla::Plugin::ModuleBuild, version 6.040, living in the perl v5.42.3 man pages, dated 2026-10-19. slay, bye πŸ’…βœ¨

πŸ“¦ where this page comes from