Email:...sugarer(3pm)

💖 Email::MIME::Kit::Role::ManifestDesugarer 💖

okay so bestie, welcome to the manual page for Email::MIME::Kit::Role::ManifestDesugarer, a lil Perl module that lives in the Email::MIME::Kit::Role family and is, and I cannot stress this enough, a helper for desugaring manifests. that's the whole vibe. it's giving "small role, big responsibility" ✨

---

🌸 NAME 🌸

Email::MIME::Kit::Role::ManifestDesugarer — a helper for desugaring manifests 🍓

---

✨ VERSION ✨

version 3.000008 💅

---

🧚 PERL VERSION 🧚

okay so this library is designed to run on perls released even a long time ago. like, it should work on any version of perl released in the last five years. she's flexible, she's forgiving, she's lowkey immortal. 💜

and like — although it may work on older versions of perl, there is no guarantee that the minimum required version won't get bumped up. 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 her with a "please support perl from 1997" PR, bestie, it's not happening. 🙈

---

👑 IMPLEMENTING 👑

this role also performs Email::MIME::Kit::Role::Component. yes she does both. multitasking queen. 💅

now listen — this is a role that is more likely to be consumed than implemented. like, you're probably gonna use it, not write it. iykyk.

what she does is wrap around the read_manifest method in the consuming class, and then desugars the contents of the loaded manifest before handing it back to you. so the manifest goes in kinda extra, and comes out clean and normalized. ✨

at present, desugaring is the thing that lets you put a type attribute in attachments and alternatives instead of writing a content_type entry inside the attributes entry. so in other words, desugaring turns this:

{
  header => [ ... ],
  type   => 'text/plain',
}

into this:

{
  header => [ ... ],
  attributes => { content_type => 'text/plain' },
}

same energy, less typing. slay. 🎀

and fr fr — more behavior may be added to the desugarer later. so watch this space, bestie. 👀

---

🦋 AUTHOR 🦋

Ricardo Signes <cpan@semiotic.systems> 💖

---

🌈 COPYRIGHT AND LICENSE 🌈

this software is copyright (c) 2023 by Ricardo Signes.

it's free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so like, go forth and remix, just keep the receipts. 🫶

---

and that's the whole page, bestie!! this was Email:...sugarer(3pm) from the User Contributed Perl Documentation, perl v5.36.0, dated 2023-09-20. mwah 💋 go desugar something iconic 👑✨