CPAN::Kwalify(3pm)

💅 CPAN::Kwalify — bestie edition

ok so this little icon is the interface between CPAN.pm and Kwalify.pm — like, it's the mutual friend that introduces them. fr fr, that's the whole name. 🫶

---

✨ SYNOPSIS ✨

use CPAN::Kwalify;
validate($schema_name, $data, $file, $doc);

that's it, that's the vibe check 🌸

---

🎀 DESCRIPTION 🎀

_validate($schema_name, $data, $file, $doc)

okay so, breaking down the cast of characters 🧚:

• $schema_name — the name of a supported schema. and bestie, currently only "distroprefs" is supported — that's the whole roster, one icon only 👑
• $data — the data that's getting validated, no cap
• $file — the absolute path to the file the data are coming from
• $doc — the index of the document within $doc that's the one being validated (yes, same name, don't @ me, that's literally what the manpage says 💀)

the last two arguments? literally only there for better error reporting. they're not doing the heavy lifting, they're just there to make the error messages ✨serve✨

this function relies on being called from within CPAN.pm — it's not a solo act, it needs its context, iykyk

and the energy of this function is very "all or nothing" 😭 — it dies if something fails, and it does not return anything useful. no results, no little gift, just vibes and validation. periodt.

yaml($schema_name)

returns the YAML text of that schema 🍓. simple, clean, iconic. and same deal — it dies if something fails. dramatic? maybe. effective? absolutely.

---

💖 AUTHOR 💖

Andreas Koenig <andk@cpan.org> — putting in the work so we can all validate our distroprefs in peace, we stan 🌈

---

👑 LICENSE 👑

This program is free software — you can redistribute it and/or modify it under the same terms as Perl itself. slay.

See <http://www.perl.com/perl/misc/Artistic.html> for the deets 📜

---

okay that's the whole page bestie, go forth and validate responsibly 💜✨

sign-off szn: this masterpiece was brought to you by perl v5.42.3, dated 2026-11-03 — CPAN::Kwalify(3pm) out 🎀🦋