Email:...nderer(3pm)

✨ Email::MIME::Kit::Renderer::TestRenderer ✨

okay bestie, so this is a page from the User Contributed Perl Documentation section of the manual — it's Email:...nderer(3pm) if you're squinting at the header — and it's about a renderer that is, and I cannot stress this enough, just for testing. 💅

---

🎀 NAME 🎀

Email::MIME::Kit::Renderer::TestRenderer — an extremely simple renderer for testing purposes only, no cap 💖

---

🌸 VERSION 🌸

version 3.000008 🦋

---

✨ DESCRIPTION ✨

okay so picture this: the test renderer is basically a version of Template Toolkit 2 that has had a crayon shoved up its nose and into its brain. 😭 that's the vibe. it can only do a very few things, but honestly? it does them well enough to test simple kits. iconic behavior.

so, given the following template:

This will say "I love pie": [% actor %] [% m_obj.verb() %] [% z_by("me") %]

...and the following set of variables:

{
  actor => 'I',
  m_obj => $object_whose_verb_method_returns_love,
  z_by  => sub { 'me' },
}

..then it will be a true statement. periodt. 💯

real talk though — in method calls, the parens are not optional. nope. the parens stay. 🫶

anything between them (or between the parens in a coderef call) is evaluated like perl code. for example, this will actually get the OS:

[% z_by($^O) %]

---

🌈 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. slay, backwards compatibility. 👑

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 it. 🙈

---

💀 WARNING 💀

seriously, this is horrible code. if you want, look at it. it's swell for testing simple things, but if you use this for real mkits, you're going to be upset by something horrible soon. 😭

bestie. i'm begging you. testing only. this is not a production renderer, this is a renderer that ate a crayon. 🔥

---

💜 AUTHOR 💜

Ricardo Signes <cpan@semiotic.systems>

---

🍓 COPYRIGHT AND LICENSE 🍓

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

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

---

and that's the whole page, bestie!! ✨ it's from perl v5.36.0, dated 2023-09-20, and the source is the one and only Email:...nderer(3pm) — go forth and test your kits responsibly 💖🧚🌸