Text::...::Debug(3pm)

💖 Text::...::Debug — the vibe check page 💖

okay bestie, so this is Text::MicroMason::Debug, and no cap, it's the little mixin that spills all the tea about what your templates are doing, by way of warn. It lives in the User Contributed Perl Documentation corner of the manual world. Let's get into it 🫶

---

✨ NAME ✨

Text::MicroMason::Debug — it hands the dev (that's you, main character 👑) all the info via warn.

---

🌸 SYNOPSIS 🌸

okay so real talk: you do not use this class directly, bestie. Not the move. Instead you pass its name in so it gets mixed in 💅

  use Text::MicroMason;
  my $mason = Text::MicroMason->new( -Debug );

Then you just use the standard compile and execute methods to parse and evaluate templates, like the icon you are:

  print $mason->compile( text=>$template )->( @%args );
  print $mason->execute( text=>$template, @args );

And boom, you'll see lots of warning output on STDERR — it's giving commentary track, honestly:

  MicroMason Debug create: Text::MicroMason::Base::AUTO::Debug...
  MicroMason Debug source: q(Hello <% $noun %>!)
  MicroMason Debug lex: text, q(Hello ), expr, q( $noun ), text, q(!)
  MicroMason Debug eval: sub { my @OUT; my $_out = sub { push ...

---

🦋 DESCRIPTION 🦋

This package provides numerous messages via warn, for developer use when you're debugging templates built with Text::MicroMason. It's basically your template's group chat receipts. 🍓

⭐ Supported Attributes ⭐

• debug — this activates debugging messages for many methods. By default it logs everything. Yeah, all of it, the whole feed 🙈

You can set it to 0 or 1 to log nothing or everything. Simple as.

Or — and this is the slay part — set it to a hash reference containing values for the steps you're actually interested in, so you only log those items:

  debug => { source => 1, eval => 1 }

And you can also selectively suppress some warnings, for when you want the general noise but not those specific ones:

  debug => { default => 1, source => 0, eval => 0 }

💜 Private Methods 💜

• debug_msg — this is the one that gets called to provide a debugging message for developer reference. And listen: no output is produced unless the object's 'debug' flag is true. So if you're seeing nothing, that flag is the culprit, not you. 🧚

---

👑 SEE ALSO 👑

• For an overview of this templating framework, see Text::MicroMason.
• This is a mixin class intended for use with Text::MicroMason::Base.
• For distribution, installation, support, copyright and license information, see Text::MicroMason::Docs::ReadMe.

---

and that's the whole page, bestie 💀 This one shipped with perl v5.36.0, dated 2023-08-10 — so if you're reading this from the future, hey, the lore still holds. Go forth and debug, you gorgeous genius 🎀✨🫶