suggested(3pm)

💖 suggested — like, a whole module for maybe loading stuff ✨

okay bestie, so the manual page here is suggested(3pm) — a User Contributed Perl Documentation situation, and honestly? it's giving "soft launch" energy. lowkey the entire point. let me walk you through it. 🎀

---

🌸 NAME 🌸

suggested — Load suggested modules on demand when available

like… if they're around, cool. if not, whatever. no cap. 🦋

---

⭐ VERSION ⭐

version 0.003

(yes, tiny. yes, iconic. it's a vibe.)

---

✨ SYNOPSIS ✨

here's how you actually use it, copy it exactly bestie, character for character:

use suggested 'Foo::Bar', {
    'Bar::Baz' => '1.23',
    'Wibble'   => '0.14',
};

if ( suggested->has( 'Foo::Bar' ) ) {
    # do something with Foo::Bar
}

so you hand it a module name, and then optionally a hashref of other modules mapped to the versions you'd be chill with. then suggested->has( 'Foo::Bar' ) tells you if the thing is actually there. if it is → main character moment. if it isn't → we move on. 💅

---

💜 DESCRIPTION 💜

This works just like recommended, but a suggestion is less strong than a recommendation. This is provided for self-documentation purposes.

translation, bestie: it's the softer sibling. recommended is "you should fr fr have this." suggested is "hey, no pressure, if it's there, slay, if not, we're still good." 🫶 and the whole reason it exists is so your code can say out loud what it means — self-documentation purposes, periodt. it's not trying to be sneaky, it's just being honest about how little it's asking of you. the audacity? none. the boundaries? immaculate. 🌈

---

👑 AUTHOR 👑

David Golden <dagolden@cpan.org>

(we love a credited king. 💖)

---

🎀 COPYRIGHT AND LICENSE 🎀

This software is Copyright (c) 2014 by David Golden.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004

so yeah, it's free software, and the license is Apache License, Version 2.0, January 2004. respect the license bestie, it's the rules. 🧚

---

💀 real talk though: keep every detail. 0.003, the hashref keys Bar::Baz and Wibble, the versions 1.23 and 0.14, the author email, the copyright year 2014, the exact license name and its date — all of it stays. i didn't invent anything and neither should you. iykyk. 🙈

---

and that's the whole page, diva. this doc ships with perl v5.34.0 and was dated 2022-06-17 — so like, big thanks to whoever formatted it back then, you ate. 💅✨ bye bestie, go suggest some modules responsibly! 🍓🌸