CPAN::Kwalify(3perl)

🦋 NAME 🦋

CPAN::Kwalify — the literal interface between CPAN.pm and Kwalify.pm. bestie it's the go-between, the group chat admin keeping those two talking 💖

---

✨ SYNOPSIS ✨

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

that's it. that's the whole vibe check 🫶

---

💅 DESCRIPTION 💅

okay so there's basically two things going on here, and I need you to lock in:

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

bestie this is the main character function. here's the tea on every argument:

• $schema_name — the name of a supported schema. and when I say "supported", I mean currently only "distroprefs" is supported. that's the whole list. one (1) schema. iconic of it honestly 👑
• $data — the actual data that needs validating. this is what we're putting under the microscope 🔍
• $file — the absolute path to the file that the data is coming from. absolute. don't come at me with relative paths 🙈
• $doc — the index of the document within $doc that is to be validated.

and lowkey? the last two arguments — $file and $doc — are only there so the error messages can be better. they're not doing the validating, they're doing the narrating 💅

⚠️ ngl this one relies on being called from within CPAN.pm. don't just call it from wherever, it's not built for that.

💀 and fr fr: it dies if something fails. like, no graceful little return code, no sad empty string, it just collapses. and even when it doesn't die — it does not return anything useful. not a vibe, just facts ✨

🎀 yaml($schema_name)

returns the YAML text of that schema. that's it, that's the whole job 💖

and yeah — it dies if something fails too. dramatic? yes. but fair. 😭

---

🌈 AUTHOR 🌈

Andreas Koenig <andk@cpan.org> — the mastermind, the blueprint, the origin story 🫶

---

💜 LICENSE 💜

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

See <http://www.perl.com/perl/misc/Artistic.html>

---

and that's the whole page, bestie 🎀 we out here on perl v5.44.0, dated 2026-10-17, and it's giving CPAN::Kwalify(3perl) the whole way through. slay 💅✨