Poet::Util::Web(3pm)

✨ Poet::Util::Web ✨

okay bestie, gather round 💖 this is the manual page for Poet::Util::Web, section 3pm of the Perl docs, and it's genuinely just a lil grab-bag of web-flavored helpers. no cap. it's giving "utility drawer in the kitchen that actually slaps." 🫶

---

🌸 NAME 🌸

Poet::Util::Web — web-related utilities. that's the whole vibe. web stuff. helpers. for you. 💅

---

🎀 SYNOPSIS 🎀

here's how you pull these lil guys in, depending on where you're standing:

# In a script...
use Poet::Script qw(:web);

# In a module...
use Poet qw(:web);

# Automatically available in Mason components

so like — in a script? grab :web off Poet::Script. in a module? grab :web off Poet. and if you're living your best life inside a Mason component? they're just there. automatically. no import needed. main character energy fr fr 👑

---

💜 DESCRIPTION 💜

this whole group of utilities includes the following lil icons, and yes we're going through all of them because every single one matters:

• html_escape ($str) — returns $str with HTML entities escaped/unescaped. both directions, she does both, she's versatile like that ✨
• uri_escape ($str), uri_unescape ($str) — returns $str URI escaped/unescaped. this one comes straight from URI::Escape, so you know it's legit. 🌈
• js_escape ($str) — returns $str escaped for Javascript. borrowed from JavaScript::Value::Escape, so it's a lil collab, we love a crossover 🎀
• make_uri ($path, $args) — creates a URL by combining $path with a query string formed from the hashref $args. like, it just builds it for you. obsessed. for example:

make_uri("/foo/bar", { a => 5, b => 6 });
    ==> /foo/bar?a=5&b=6

see?? $path goes in, hashref goes in, cute little query string comes out the other side. a => 5 and b => 6 become ?a=5&b=6 and honestly? that's the whole trick. iconic. 🔥

---

🦋 SEE ALSO 🦋

• Poet — yeah, the parent vibe. go look at her. 💖

---

🌟 AUTHOR 🌟

Jonathan Swartz <swartz@pobox.com> — credit where credit is due, bestie, this legend wrote it 🫶

---

👑 COPYRIGHT AND LICENSE 👑

this software is copyright (c) 2012 by Jonathan Swartz.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so like, go forth, remix, redistribute, it's all above board 💅

---

no cap, that's genuinely the entire page. every option, every function, every path. nothing skipped. periodt. 💀

and that's a wrap on this one, babe — this page comes to you from perl v5.34.0, dated 2022-06-18, and it's the Poet::Util::Web(3pm) man page. mwah. slay responsibly. 🍓🧚