HTTP::...oLarge(3pm)

💖 HTTP::Throwable::Role::Status::RequestEntityTooLarge — bestie edition 💖

okay so you're in the User Contributed Perl Documentation section of the manual, and this lil page right here is HTTP::...oLarge(3pm) — which is just the short version of the whole long name, you know how man pages do. it's a Perl module, it's a role, it does one specific thing, and honestly? it ate. let's get into it 🫶

---

✨ NAME ✨

HTTP::Throwable::Role::Status::RequestEntityTooLarge — that's the whole government name, and it means: 413 Request Entity Too Large. iconic status code, no cap. 👑

---

🌸 VERSION 🌸

version 0.028 — that's the one we're on, bestie. write it down.

---

🦋 DESCRIPTION 🦋

so here's the vibe: the server is straight up refusing to process a request because the request entity is larger than the server is willing or able to process. like, it's too much. it's giving "i can't even." 💀

and the server MAY close the connection — MAY, bestie, that's a real spec word — to stop the client from just... continuing to send that request. slamming the door, basically. 🚪

now if the condition is temporary, the server SHOULD include a Retry-After header field. and why? to signal that yes this is temporary, and here's after what time the client MAY try again. so it's a "not right now, but maybe later" moment. so real of the server to say that. ✨

lowkey pay attention to those MAY/SHOULD caps — they're doing actual work here, they're not just me being loud. (okay they're also me being loud. both. 💅)

---

🧚 PERL VERSION 🧚

this library should run on perls released even a long time ago. specifically — it should work on any version of perl released in the last five years. 🌈

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. don't come for the minimum version, it does what it wants. periodt. 🎀

---

💜 ATTRIBUTES 💜

💅 retry_after

this is an optional string. it gets used to add a Retry-After header in the PSGI response. that's it, that's the whole attribute. simple, clean, doing its job, main character energy. ⭐

---

👑 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. go forth and redistribute, bestie, legally. 💖

---

and that's the whole page fr fr 🌸 — this was HTTP::...oLarge(3pm) from perl v5.36.0, dated 2023-01-24, and yes i remembered the date, i always remember the date. mwah, bye bestie 💋✨