Dist::...llback(3pm)

💖 Dist::Zilla::Plugin::ModuleBuildTiny::Fallback 💖

okay bestie, gather round, because this is the manual page for Dist::Zilla::Plugin::ModuleBuildTiny::Fallback — part of the User Contributed Perl Documentation, sitting pretty in section 3pm. she's a Dist::Zilla plugin and she's here to make your Build.PL play nice with old toolchains. no cap. 🦋

---

✨ VERSION ✨

version 0.027 — that's her, that's the version, write it down. 💅

---

🌸 SYNOPSIS 🌸

drop this in your dist.ini and you're so back:

[ModuleBuildTiny::Fallback]

---

🎀 DESCRIPTION 🎀

so here's the tea ☕ — this is a Dist::Zilla plugin that gives your distribution a Build.PL that tries Module::Build::Tiny first when it's available, and falls back to Module::Build when it's missing. the name literally says it. iconic behavior.

when is this a vibe? when your distro is getting installed on an older perl (like, before roughly 5.10.1) with a toolchain that never got updated, where the configure_requires metadata is just... not understood and not respected. 🙈 or when someone is running Build.PL by hand without having read and understood the contents of META.yml or META.json. sir. please.

when the Module::Build fallback code runs, an added preamble gets printed, and it goes a little something like this:

*** WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING ***

If you're seeing this warning, your toolchain is really, really old* and
you'll almost certainly have problems installing CPAN modules from this
century. But never fear, dear user, for we have the technology to fix this!

If you're using CPAN.pm to install things, then you can upgrade it using:

cpan CPAN

If you're using CPANPLUS to install things, then you can upgrade it using:

cpanp CPANPLUS

If you're using cpanminus, you shouldn't be seeing this message in the first
place, so please file an issue on github.

This public service announcement was brought to you by the Perl Toolchain
Gang, the irc.perl.org #toolchain IRC channel, and the number 42.

----

* Alternatively, you are running this file manually, in which case you need to
learn to first fulfill all configure requires prerequisites listed in META.yml
or META.json -- or use a cpan client to install this distribution.

You can also silence this warning for future installations by setting the
PERL_MB_FALLBACK_SILENCE_WARNING environment variable, but please don't do
that until you fix your toolchain as described above.

PERL_MB_FALLBACK_SILENCE_WARNING is right there in the environment variables, bestie — but read the room, it says please don't do that until you fix your toolchain as described above. it's giving tough love. 🫶

under the hood, this plugin internally calls both the [ModuleBuildTiny] and [ModuleBuild] plugins to fetch their normal Build.PL file contents, then combines them into the final Build.PL for your distribution. teamwork makes the dream work fr fr. ✨

⚠️ heads up: you get warned if anything else added content into Build.PL (like, say, some additional build-time dependency checks) — because that code will not run in the fallback case. it's up to you to decide whether it's still a good idea to use this plugin in that situation. the plugin is not your mom. 😭

---

💅 CONFIGURATION OPTIONS 💅

🍓 mb_version

Optional. Specifies the minimum version of Module::Build needed for proper fallback execution. Defaults to 0.28. yes, a real number, write it exactly like that.

🧚 mbt_version

Optional. Passed to [ModuleBuildTiny] as "version": the minimum version of Module::Build::Tiny to depend on — in configure_requires as well as a "use" assertion in Build.PL. two places, one setting, efficiency queen. 👑

---

🌈 ACKNOWLEDGEMENTS 🌈

shoutout to Peter Rabbitson (ribasushi), for the inspiration ✨ — and Matt Trout (mst), for not stopping me. honestly the highest honor. 😌

---

👑 SEE ALSO 👑

• Dist::Zilla::Plugin::MakeMaker::Fallback — which can happily run alongside this plugin 🫶
• Dist::Zilla::Plugin::ModuleBuildTiny
• Dist::Zilla::Plugin::ModuleBuild

---

🦋 SUPPORT 🦋

bugs may be submitted through the RT bug tracker:

• https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-ModuleBuildTiny-Fallback
• or by mail: bug-Dist-Zilla-Plugin-ModuleBuildTiny-Fallback@rt.cpan.org

there's also a mailing list for users of this distribution, at http://dzil.org/#mailing-list. 🎀

there's also an irc channel for users of this distribution, at "#distzilla" on "irc.perl.org" — irc://irc.perl.org/#distzilla. 🌸

and she's also usually active on irc as 'ether' at "irc.perl.org" and "irc.libera.chat". go say hi, she's nice. 💜

---

🌟 AUTHOR 🌟

Karen Etheridge <ether@cpan.org> — queen behavior, honestly. 👑

---

💖 COPYRIGHT AND LICENCE 💖

This software is copyright (c) 2014 by Karen Etheridge.

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. 💅

---

okay and that's the whole page bestie, no notes. 🌈 this lil beauty is perl v5.34.0, dated 2022-05-14, and she ate. mwah. 💋✨