Dist::...omMeta(3pm)

okay bestie, welcome to the Dist::...omMeta(3pm) manpage 💖 it's a User Contributed Perl Documentation situation, and honestly the vibe here is "tiny plugin, big responsibility." Let's get into it 🫶

---

🎀 NAME 🎀

Dist::Zilla::Plugin::Test::PrereqsFromMeta — check the prereqs from our META.json 👑

---

✨ VERSION ✨

This doc is describing version 4.23 of Dist::Zilla::Plugin::Test::PrereqsFromMeta, which dropped on December 17, 2017, and it's part of the Dist-Zilla-Plugins-CJM version 6.000 era. iconic release timeline, no notes 💅

---

🌸 SYNOPSIS 🌸

put this in your dist.ini, bestie:

[Test::PrereqsFromMeta]

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ this plugin injects t/00-all_prereqs.t into your dist. That test reads your META.json file and then attempts to load all runtime prerequisites. If any required runtime prerequisites fail to load, the test fails, periodt.

(and if the loaded version is less than the required version? it prints a warning message, but the test does not fail. so it's giving "we see you, we're just not mad about it" 😌)

---

and here's the bonus round ✨ if AUTOMATED_TESTING is set, it dumps out every module in %INC along with its version. That is genuinely so useful for figuring out the cause of failures reported by CPAN Testers. main character debugging energy fr fr 🔥

You can also get that version dump by running t/00-all_prereqs.t with the -v or --verbose option. 👀 and listen — this is not the same as passing the -v option to prove. Do not conflate them, bestie, that's a different vibe entirely 💀

---

🌈 INCOMPATIBILITIES 🌈

None reported. ✨ (clean sheet, we love to see it)

---

💜 BUGS AND LIMITATIONS 💜

No bugs have been reported. 🎀 (still true as of this doc, so, slay)

---

🌟 AUTHOR 🌟

Christopher J. Madsen <perl AT cjmweb.net> 🫶

Please report any bugs or feature requests to <bug-Dist-Zilla-Plugins-CJM AT rt.cpan.org>, or through the web interface at <http://rt.cpan.org/Public/Bug/Report.html?Queue=Dist-Zilla-Plugins-CJM>.

You can follow or contribute to Dist-Zilla-Plugins-CJM's development at <https://github.com/madsen/dist-zilla-plugins-cjm>. go be a contributor, it's giving open source queen 👑

---

📜 COPYRIGHT AND LICENSE 📜

This software is copyright (c) 2017 by Christopher J. Madsen.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🌸

---

⚠️ DISCLAIMER OF WARRANTY ⚠️

okay bestie, deep breath, this next part is the ALL-CAPS legal section and I am not paraphrasing it, because legal words are load-bearing. Read it, don't skip it, it's the fine print that actually matters 😭

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENSE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

---

and that's the whole page, bestie 💖 this one was rendered with perl v5.34.0 and dated 2022-06-13, so go forth, load your prereqs, and may your META.json always be honest with you 🦋✨ periodt 💅