HTTP::...onflict(3pm)

✨ NAME ✨

HTTP::Throwable::Role::Status::Conflict — it's giving 409 Conflict 💅

Like bestie, this is the manual page for HTTP::...onflict(3pm) from the User Contributed Perl Documentation, and it's lowkey iconic.

---

🌸 VERSION 🌸

version 0.028 ✨

---

🦋 DESCRIPTION 🦋

okay so picture this: the request could NOT be completed because of a conflict with the current state of the resource. that's the whole vibe. 😭

and listen — this code is only allowed in situations where it's expected that the user might actually be able to resolve the conflict and resubmit the request. like, we're not just throwing 409 at people for funsies, there has to be a path forward. 🫶

the response body SHOULD include enough information for the user to recognize the source of the conflict. ideally, the response entity would include enough info for the user or user agent to fix the problem — but ngl, that might not be possible and it is not required. so no pressure, but slay if you can. ✨

---

💖 when does this even happen tho

conflicts are most likely to occur in response to a PUT request. for example — say versioning were being used and the entity being PUT included changes to a resource which conflict with those made by an earlier (third-party) request. in that case, the server might use the 409 response to indicate that it can't complete the request. 🚫

and in this case, the response entity would likely contain a list of the differences between the two versions in a format defined by the response Content-Type. it's giving receipts. it's giving diff. we love to see it. 👑

---

🎀 PERL VERSION 🎀

this library should run on perls released even a long time ago. like, it should work on any version of perl released in the last five years. periodt. 💜

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 don't come for us. 🙈

⚠️ real talk: the minimum required version can go up whenever, and patches to bring it back down are not promised to be accepted. that's just the deal.

---

👑 AUTHORS 👑

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

absolute legends, both of them. 🫡

---

🌈 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 as in bestie, go wild. 🕊️

---

and that's the whole page, bestie 💖 this was perl v5.36.0, dated 2023-01-24, filed under HTTP::...onflict(3pm) — tysm for reading, ily, go fix your conflicts ✨🎀🦋