HTTP::...hoices(3pm)

✨ HTTP::Throwable::Role::Status::MultipleChoices — 300 Multiple Choices ✨

okay so bestie, welcome to the HTTP::...hoices(3pm) page 💖 (yes that's the title, it got truncated and honestly? iconic of it). This is HTTP::Throwable::Role::Status::MultipleChoices, the whole 300 Multiple Choices situation, and it's giving pick your own adventure. Let's go 🦋

---

🌸 VERSION 🌸

version 0.028 — that's the one, no cap 💅

---

💜 DESCRIPTION 💜

So here's the vibe: the requested resource? It corresponds to any one of a set of representations, and each one has its own specific location. And on top of that, agent-driven negotiation information is being provided, so the user (or the user agent, its little robot bestie) can select a preferred representation and redirect its request to that location. It's like a menu 🍓 — you don't get handed a plate, you get handed options.

Unless it was a HEAD request, the response SHOULD include an entity containing a list of resource characteristics and location(s) from which the user or user agent can choose the one most appropriate. The entity format is specified by the media type given in the Content-Type header field. Depending upon the format and the capabilities of the user agent, selection of the most appropriate choice MAY be performed automatically. However — and this is the important bit, don't skip it — this specification does not define any standard for such automatic selection. So like, auto-picking is allowed but nobody wrote the rules for it. Chaos, but make it RFC 🫶

If the server has a preferred choice of representation, it SHOULD include the specific URI for that representation in the Location field; user agents MAY use the Location field value for automatic redirection. And this response is cacheable unless indicated otherwise. Cute, reusable, lowkey sustainable 💖

---

🎀 PERL VERSION 🎀

This library should run on perls released even a long time ago. It should work on any version of perl released in the last five years. Five years!! That's a lot of perls, bestie 🌈

Although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl. So like... it might work on your ancient perl but don't come for them about it, fr fr 💀

---

⭐ ATTRIBUTES ⭐

💫 location 💫

This is an optional string, which, if supplied, will be used in the Location header when creating a PSGI response. Optional! You don't have to hand it over. But if you do, it goes straight into Location 🎯

⚠️ Heads up bestie — note that this is not (at present) the location attribute provided by the role HTTP::Throwable::Role::Redirect, which this role does not include. Same name, different queen. Do not confuse them, I am begging 🙈

---

👑 AUTHORS 👑

• Stevan Little <stevan.little@iinteractive.com>
• Ricardo Signes <cpan@semiotic.systems>

Two absolute legends, we stan 💅✨

---

💖 COPYRIGHT AND LICENSE 💖

This software is copyright (c) 2011 by Infinity Interactive, Inc.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. Free software rights, slay 🌸

---

and that's the whole page, bestie!! no notes, 300/300, main character energy only 🦋

this was HTTP::...hoices(3pm) from the User Contributed Perl Documentation corner of the world, documented under perl v5.36.0, dated 2023-01-24 — mwah, take care of her, she's precious 💜🎀