LWP::U...KeyGen(3pm)

💖 LWP::UserAgent::Role::CHICaching::SimpleKeyGen 💖

okay so this is LWP::UserAgent::Role::CHICaching::SimpleKeyGen from the Perl docs, bestie, and it's literally the simplest little role for making cache keys when you're caching LWP::UserAgent 🎀 she's not complicated, she's not doing too much, and honestly? that's her whole vibe ✨

---

✨ SYNOPSIS ✨

go look at LWP::UserAgent::Role::CHICaching for the deets, bestie, that's where the actual story is 💅

---

🌸 DESCRIPTION 🌸

so LWP::UserAgent::Role::CHICaching is a role for building caching user agents, right? and there's this whole thing where caching the same resource in different variants gets messy — like, same content but in different natural languages, or different serializations. Section 4.1 of RFC7234 is where all that drama lives:

http://tools.ietf.org/html/rfc7234#section-4.1

and the way this role handles that whole mess is… the dumbest way possible 🙈 like, no cap, the official approach here is: just don't cache anything when the problem shows up. problem solved, queen 💀

but listen, if you actually wanna solve it properly, you'd generate a cache key based on the URI and the content — like "Content-Language: en" for example — and then you'd provide a better implementation of the key attribute. and then, and then, you'd also need to tell the system when it's chill to cache something with a Vary header, by making the cache_vary method smarter. if you want to see what an alternative looks like, peep LWP::UserAgent::Role::CHICaching::VaryNotAsterisk 👑

🦋 Attributes and Methods 🦋

• key, clear_key — the key to use for a response. this role just returns the canonical URI of the request as a string, and honestly that's a perfectly reasonable default, periodt 🫶
• cache_vary — will never allow a response with a Vary header to be cached. like, not ever. that's the rule. no exceptions, no negotiations 💅

---

⭐ AUTHOR ⭐

Kjetil Kjernsmo <kjetilk@cpan.org>. iconic behavior, we love a credited author 💜

---

👑 COPYRIGHT AND LICENCE 👑

This software is copyright (c) 2015, 2016 by Kjetil Kjernsmo.

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 go wild, bestie, it's yours 🌈

---

okay that's the whole page!! 🎀 and before you go — the footer energy: this is perl v5.34.0, dated 2022-05-28, part of the User Contributed Perl Documentation, and the page name is LWP::U...KeyGen(3pm) 💖 slay, bye bestie!! 🦋✨