Web::M...iation(3pm)

💅 NAME 💅

Web::Machine::Util::ContentNegotiation — the little module that handles content negotiation for you, bestie. Yes, it's a Perl thing, it lives in the Web::Machine universe, and it's here to make your HTTP server figure out what the heck the client actually wants. 🦋

It's from User Contributed Perl Documentation, section 3pm, so you know it's the real deal. 💖

---

✨ VERSION ✨

version 0.17 — that's the one, no cap. 🎀

---

🌸 SYNOPSIS 🌸

Okay so here's literally all you gotta do:

use Web::Machine::Util::ContentNegotiation;

That's it. That's the whole vibe check. Slay. 💅

---

🫶 DESCRIPTION 🫶

This module is giving utility belt energy. It provides a set of functions that get used in content negotiation — you know, the part where your server and the client have a little chat about which media type, language, charset, and encoding they can both agree on. No drama, just matching. 👑

---

🔥 FUNCTIONS 🔥

Here's the whole squad. Every single one, no skipping, I promise. 💜

• choose_media_type ( $provided, $header ) — you hand it an ARRAY ref stuffed with media type strings, plus an HTTP header, and it returns the matching HTTP::Headers::ActionPack::MediaType instance. That's the whole job, and it eats every time. ⭐
• match_acceptable_media_type ( $to_match, $accepted ) — give it one media type string to match, plus an ARRAY ref of media type objects, and it'll hand you back the first one that matches. First come, first served, iconic behaviour honestly. 🧚
• choose_language ( $provided, $header ) — pass in a list of language codes and an HTTP header value, and it will attempt to negotiate the best language match. Multilingual queen. 🌈
• choose_charset ( $provided, $header ) — same deal but for charsets: list of charset names + an HTTP header value, and it attempts to negotiate the best charset match. 🔤
• choose_encoding ( $provided, $header ) — and again for encodings: list of encoding names + an HTTP header value, and it attempts to negotiate the best encoding match. Compressed and cute. 🎀

---

😭 SUPPORT 😭

If something's busted (it happens to the best of us, fr fr), bugs may be submitted through:

https://github.com/houseabsolute/webmachine-perl/issues

Go drop it in the issues, bestie. The maintainers are listening. 🫶

---

👑 AUTHORS 👑

The legends who made this happen:

• Stevan Little <stevan@cpan.org>
• Dave Rolsky <autarch@urth.org>

Two absolute main characters. Respect. 💖

---

🌟 COPYRIGHT AND LICENCE 🌟

This software is copyright (c) 2016 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.

So like — yes you can share it, yes you can remix it, just keep it on those same Perl 5 terms. Periodt. 💅

---

And that's a wrap, bestie!! 💖 This page came to you courtesy of perl v5.34.0, dated 2022-07-03, from that Web::Machine::Util::ContentNegotiation 3pm page in the User Contributed Perl Documentation. Go negotiate some content, you gorgeous thing. 🦋✨🎀